> ## Documentation Index
> Fetch the complete documentation index at: https://docs.canton.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Splice.Wallet.TopUpState

> Documentation for Splice.Wallet.TopUpState

## Templates

<div id="type-splice-wallet-topupstate-validatortopupstate-56541">
  **template** ValidatorTopUpState
</div>

> The state of a given top-up loop.
>
> Records the last time when this validator purchased traffic for this sequencer member in order to:
>
> 1. allow for crash fault tolerant deduplication of traffic purchases
> 2. allow enforcing a rate limit to prevent the validator from spending too much on traffic purchases.
>
> Signatory: validator
>
> | Field           | Type                                                                                     | Description                                                                                   |
> | --------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
> | dso             | [Party](/appdev/reference/daml-standard-library/prelude#type-da-internal-lf-party-57932) |                                                                                               |
> | validator       | [Party](/appdev/reference/daml-standard-library/prelude#type-da-internal-lf-party-57932) | The validator operator purchasing traffic for the given sequencer member                      |
> | memberId        | [Text](/appdev/reference/daml-standard-library/prelude#type-ghc-types-text-51952)        | The id of the sequencer member (participant or mediator) for which traffic has been purchased |
> | synchronizerId  | [Text](/appdev/reference/daml-standard-library/prelude#type-ghc-types-text-51952)        | The id of the synchronizer for which this contract tracks purchased extra traffic             |
> | migrationId     | [Int](/appdev/reference/daml-standard-library/prelude#type-ghc-types-int-37261)          | The migration id of the synchronizer for which this contract tracks purchased extra traffic   |
> | lastPurchasedAt | [Time](/appdev/reference/daml-standard-library/prelude#type-da-internal-lf-time-63886)   | Time when the traffic was last purchased by the validator for the given sequencer member      |
>
> * **Choice** Archive
>
>   Controller: validator
>
>   Returns: ()
>
>   (no fields)

## Functions

<div id="function-splice-wallet-topupstate-initialvalidatortopupstate-90212">
  initialValidatorTopUpState
  : [Party](/appdev/reference/daml-standard-library/prelude#type-da-internal-lf-party-57932) -> [Party](/appdev/reference/daml-standard-library/prelude#type-da-internal-lf-party-57932) -> [Text](/appdev/reference/daml-standard-library/prelude#type-ghc-types-text-51952) -> [Text](/appdev/reference/daml-standard-library/prelude#type-ghc-types-text-51952) -> ValidatorTopUpState
</div>