.png%3Falt%3Dmedia%26token%3De6bb9831-f128-47e4-93d6-29d42e36344a)
.png%3Falt%3Dmedia%26token%3De6bb9831-f128-47e4-93d6-29d42e36344a)
Comment on page
Withdraw Funds from Escrow
To withdraw funds deposited previously to an escrow account associated to a chainlet, you will need the
chain-id associated to the chainlet.Please note that unlike escrow deposits, that allow you to specify a specific amount, withdrawing of funds from an escrow account withdraws all the funds you deposited. This is an all-or-nothing operation. It will only allow you to withdraw funds that have been deposited from an account that you own or control.
To withdraw funds from an escrow account, use
sagacli account withdraw-escrow <chain-id> \
--from <account address or key name making the withdrawal>
Let us step through the withdrawal with the help of an example.
Let us assume that we have a chainlet with a
chain-id of magicwarriors_1698795593524888-1Prior to making the withdrawal, this chainlet had access to funds from two separate accounts i.e. one belonging to the chainlet owner, and the other belonging to a different user with a key named
fundkey.$ sagacli account get-escrow magicwarriors_1698795593524888-1
ChainId TotalBalance Funder FunderDeposit
------- ------------ ------ -------------
magicwarriors_1698795593524888-1 290000000upsaga saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn 10000000.0000upsaga
magicwarriors_1698795593524888-1 290000000upsaga saga1yuvju0cztlahsf6f37z9j83vwyzgj6pzhx090f 280000000.0000upsaga
Now, the user with the key
fundkey wishes to withdraw his/her contribution of10,000,000,000 upsaga tokens from the chainlet's escrow.Before we process this withdrawal, let us take a look at the account balance associated with the key
fundkey:$ sagacli account balance --address saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn
Amount Denom
------ -----
8000000000 upsaga
Account
saga14hyhswxf0shnpzup406yvjejmfsrjnvzq897re (associated with key fundkey) has a balance of 8,000,000,000 upsaga tokens.Now, we will process an escrow withdrawal from chainlet
magicwarriors_1698795593524888-1To do so, we will execute a
withdraw-escrow transaction in the following manner:$ sagacli account withdraw-escrow magicwarriors_1698795593524888-1 --from saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn
You are about to sign and broadcast a transaction, with the following configurations:
* Keyname: fundkey
* Keyring: file
* Address: saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn
* Network RPC: https://spc.testnet-sp1.sagarpc.io
* Platform chain id: spc-testnet-1
* Ledger: false
* Gas limit: 250000
* Message Detail:
creator:"saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn"
chainId:"magicwarriors_1698795593524888-1"
Do you want to proceed? (y/N):
y
2023-03-23T15:13:23-05:00 INF tx broadcasted to the remote node code=0 gas_used=69449 gas_wanted=200000 hash=DFA654213E4402D5D6B716847D83CF0F851CBF0E1891F51638D57A8386B9B67B
ChainId TotalBalance Funder FunderDeposit
------- ------------ ------ -------------
magicwarriors_1698795593524888-1 280000000upsaga saga1yuvju0cztlahsf6f37z9j83vwyzgj6pzhx090f 280000000.0000upsaga
As can be seen from the output above, the withdrawal returned the funds to the account with the key
fundkey whose account address is saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn.We can also check whether the account address
saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn received the funds back and that its account balance was updated:$ sagacli account balance --address saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn
Amount Denom
------ -----
8010000000 upsaga
Yes, the account
saga17gk4chqd0lrkyamrxdmu62czmu0dpnemmxlymn received all of the funds (10,000,000,000upsaga tokens) from the escrow, and its balance was correctly updated.IMPORTANT: Withdrawing all of the funds in a chainlet escrow account, on behalf of all funders, will change the escrow account balance to zero which will instruct the SAGA Platform to stop running the chainlet and its related RPC and Chainlet Explorer infrastructure and services. In order to keep your chainlet live, make sure the chainlet escrow account has always enough funds to pay for the epoch fees.
For further details and options on escrow withdrawal, please see
sagacli account withdraw-escrow --help