Links

View Chainlet Billing History

Command

Chainlets are billed at a pre-determined interval depending on the type of chainlet it is and the duration of each epoch. Typically, a chainlet would be billed each day for the resources it consumes.
As each billing cycle is processed, the funds available to the chainlet inside the escrow account get depleted. Make sure you keep your escrow account funded to prevent your chainlet from being shutdown.
As a user, you can view the billing history associated with any chainlet you have launched or contributed funds toward. To view the billing history of a chainlet, simply type:
sagacli account get-billing-history <chain-id>

Billing History Example

For example, to view the billing history of a chainlet with a chain-id of magicwarriors_1679599719-1:
$ sagacli account get-billing-history magicwarriors_1679599719-1
ChainletId ChainletName ChainletOwner BilledAmount EpochIdentifier EpochNumber EpochStartTime
---------- ------------ ------------- ------------ --------------- ----------- --------------
magicwarriors_1679599719-1 chainletash saga1rdssl22ysxyendrkh2exw9zm7hvj8d2ju346g3 1000tsaga minute 91 2023-03-25T14:48:59Z
magicwarriors_1679599719-1 chainletash saga1rdssl22ysxyendrkh2exw9zm7hvj8d2ju346g3 1000tsaga minute 92 2023-03-25T14:49:59Z
magicwarriors_1679599719-1 chainletash saga1rdssl22ysxyendrkh2exw9zm7hvj8d2ju346g3 1000tsaga minute 93 2023-03-25T14:50:59Z
This output shows you the chainlet information along with the amount billed and the time the chainlet was billed.
This is a paginated query. Then, if you need to navigate through the chainlet billing history you have to change the value of --page and --limit flags.

Export all billing history

If for some reason you need to export all chainlet billing history in a single step, you can da that as well, just specifying the --csv-file flag:
$ sagacli account get-billing-history magicwarriors_1679599719-1 --csv-file /tmp/billing_history.csv
The csv file specified now contains all the billing history of magicwarriors_1679599719-1 chainlet recorded so far.

Further Details

To get further details and options associated with getting billing history, please refer to
sagacli account get-billing-history --help