Skip to content

CLI - Managing Tokens

Querying your balance

Once fetchd is configured for the desired network. The user can query there balance using the following command:

fetchd query bank balances fetch1akvyhle79nts4rwn075t85xrwmp5ysuqynxcn4

If the address exists on the network then the user will expect to see an output in the following form:

balances:
- amount: "8000000000000000000"
  denom: atestfet
pagination:
  next_key: null
  total: "0"

Sending funds

To send funds from one address to another address then you would use the tx send subcommand. As shown below:

fetchd tx bank send <from address or key name> <target address> <amount>

In a more concrete example if the user wanted to send 100atestfet from main key/address to fetch106vm9q6ezu9va7v7e0cvq0nedc54egjm692fcp then the following command would be used.

fetchd tx bank send main fetch106vm9q6ezu9va7v7e0cvq0nedc54egjm692fcp 100atestfet

When you run the command you will get a similar output and prompt. The user can check the details of the transfer and then press 'y' to confirm the transfer.

{"body":{"messages":[{"@type":"/cosmos.bank.v1beta1.MsgSend","from_address":"fetch12cjntwl32dry7fxck8qlgxq6na3fk5juwjdyy3","to_address":"fetch1hph8kd54gl6qk0hy5rl08qw9gcr4vltmk3w02v","amount":[{"denom":"atestfet","amount":"100"}]}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[],"gas_limit":"200000","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

Once the transfer has been made a summary is presented to the user. An example is shown below:

code: 0
codespace: ""
data: ""
gas_used: "0"
gas_wanted: "0"
height: "0"
info: ""
logs: []
raw_log: '[]'
timestamp: ""
tx: null
txhash: 77C7382A0B1B9FE39257A6C16C7E3169A875CB3A87F2CE9D947D7C1335B53E76

On failure, the response will have a non zero code, as well as some logs under the raw_log key:

code: 4
codespace: sdk
data: ""
gas_used: "0"
gas_wanted: "0"
height: "0"
info: ""
logs: []
raw_log: 'signature verification failed; please verify account number (5815) and chain-id
  (stargateworld-1): unauthorized'
timestamp: ""
tx: null
txhash: 23701B052B423D63EB4AC94773B5B8227B03A576692A57999E92F2554F2372D4