Send Tokens

Search…
Send Tokens
Testnet Faucet
On a testnet, getting tokens is usually done via a faucet. You can get tokens for testing purposes using the Secret Network faucet.
Query Account Balance
After receiving tokens to your address, you can view your account's balance by typing:
secretcli query bank balances <secret-address>
# secretcli query bank balances secret1kcy20p0cs2wakeqz00xgs5m0cmj65283xqmvfs | jq
​
{
  "balances": [
    {
      "denom": "uscrt",
      "amount": "99942000"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "0"
  }
}
Get your <secret-address> using:
# Use the -a flag to display the addres only
secretcli keys show -a <key-alias>
You can also supply your address with the following command:
# This grabs the desired acount address and uses it as an input to the 
# secretcli query bank balances command
secretcli query bank balances $(secretcli keys show -a <key-alias>)
Note: When querying an account balance with zero tokens, you will get the error: No account with address <secret-address> was found in the state. This can also happen if you fund the account before your node is fully synced. These are both normal.
Send Tokens
Use the following command to send tokens from one account to another:
secretcli tx bank send <sender-key-alias-or-address> <recipient-address> 10uscrt
Note: The amount argument accepts the format <value|coin_name>. You may want to cap the maximum gas consumed by transactions via the --gas flag.
If you pass --gas=auto, the gas supply is automatically estimated before transaction execution.
Inaccurate gas estimates may occur in-between the end of the simulation and the actual execution of a transaction. An adjustment needs to be applied on top of the original estimate for the transaction to be broadcasted successfully. Adjustment are controlled via the --gas-adjustment flag, with a default value of 1.0.
To view updated balances of origin and destination accounts use:
secretcli query bank balances <secret-address>
secretcli query bank balances <recipient-address>
Flags
Height
You can also check balances at any block height using the --height flag:
secretcli query bank balances <secret-address> --height=<block_height>
Example 
secretcli query bank balances \ 
  secret1kcy20p0cs2wakeqz00xgs5m0cmj65283xqmvfs \
  --height=3415892 | jq
Example Output
{
  "balances": [
    {
      "denom": "uscrt",
      "amount": "2000"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "0"
  }
}
Note 
You can add a note (previously called 'memo') to any transaction using the --note flag: 
secretcli tx bank send \ 
    <sender-key-alias-or-address> \
    <recipient-address> \
    <amount> \ 
    --note '<note contents>'
 secretcli tx bank send \
    secret1kcy20p0cs2wakeqz00xgs5m0cmj65283xqmvfs \
    secret193w2cdzhjt9vf9ehw9clmmyg5jvnj7dslaqcd0 \
    10uscrt \
    --note 'Hello this is a test' | jq
​
confirm transaction before signing and broadcasting [y/N]: y
​
{
  "height": "0",
  "txhash": "9E41B419CAFDC245706B0B6C689299AFEF932F2864F88F6FBA417DE516F39B2A",
  "codespace": "",
  "code": 0,
  "data": "",
  "raw_log": "[]",
  "logs": [],
  "info": "",
  "gas_wanted": "0",
  "gas_used": "0",
  "tx": null,
  "timestamp": "",
  "events": []
}
Dry Run 
You can simulate a transaction without actually broadcasting it by appending the --dry-run flag:
secretcli tx bank send \
  <sender-key-alias-or-address> \
  <recipient-address> \
  10uscrt \
  --chain-id=<chain-id> \
  --dry-run
// Some code
Generate Only
Furthermore, you can build a transaction and print its JSON format to STDOUT by appending --generate-only to the list of arguments:
secretcli tx bank send <sender-key-alias-or-address> <recipient-address> 10uscrt \
  --chain-id=<chain-id> \
  --generate-only > unsignedSendTx.json
secretcli tx sign \
  --chain-id=<chain-id> \
  --from=<key-alias> \
  unsignedSendTx.json > signedSendTx.json
Note: The --generate-only flag prevents secretcli from accessing the local keybase. When the flag is supplied <sender-key-alias-or-address> must be an address.
Validate Signatures 
You can validate transaction signatures by typing the following:
secretcli tx sign --validate-signatures --from=<key-alias> signedSendTx.json
Broadcast Signed Transaction
You can broadcast the signed transaction to a node by providing the JSON file using:
secretcli tx broadcast --node=<node> signedSendTx.json
Query Transactions
Multisig Keys
Last modified 3mo ago
Export as PDF
Copy link
Edit on GitHub
On this page
Testnet Faucet
Query Account Balance
Send Tokens
Flags
Height
Note
Dry Run
Generate Only