View Chainlet Billing History
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>
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.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.To get further details and options associated with getting billing history, please refer to
sagacli account get-billing-history --help