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