UseCases_tokens_Token balance.md

Use Cases, Scenario’s, Walkthroughts - for tokens

Case "Token balances"

Scenario: Perform basic operations with tokens

Feature: View token balance

Actor: Any user

Summary:

The wallet's per-token balance can be retrieved with the command: token balance (TOKENGROUPID) (IONADDRESS). If a wallet contains token authorities, the per-token total set of authorities is included in the output. the total of the token authorities available in the wallet. The list can be limited by tokengroup or by tokengroup and ION address.

Preconditions:

No preconditions.

Steps:

To show all tokens in a wallet, use the following command:

$ gettokenbalance
[
  {
    "groupIdentifier": "tion1zdrdupsksyucmpr7a9gcn5stn0h5m3j26l8k24t52khm5pp9jutssmkpl7v",
    "ticker": "ATOM",
    "name": "Atoms",
    "balance": "100"
  },
  {
    "groupIdentifier": "tion1zwgakvjxnx5trszs9lhpp2j5jn9xnt26jvqd5ffvd33pf44xve7sqg8dyar",
    "ticker": "HULK",
    "name": "HulkToken",
    "balance": "99990",
    "authorities": "mint melt child rescript subgroup configure"
  },
  {
    "groupIdentifier": "tion1zv08wr3jqdyqp03vwhq6v4jccyzxqvc0vlyacfcpmtmxuygj2fgsszyfkxj",
    "ticker": "XDM",
    "name": "DarkMatter",
    "balance": "99.0000000000000"
  }
]

This wallet holds 99 XDM, 100 ATOM, full authority HULK, and balance of 99990 HULK

If you want to retrieve the token group info connected to the tokengroup ID returned by the token balance command, use the tokeninfo groupid command:

$ tokeninfo groupid tion1zwgakvjxnx5trszs9lhpp2j5jn9xnt26jvqd5ffvd33pf44xve7sqg8dyar
[
  {
    "groupIdentifier": "tion1zwgakvjxnx5trszs9lhpp2j5jn9xnt26jvqd5ffvd33pf44xve7sqg8dyar",
    "txid": "680d43bf3e5e7cadd5664651193e9323c65bcba0b6f7a446fede3352e4945101",
    "ticker": "HULK",
    "name": "HulkToken",
    "decimalPos": 0,
    "URL": "https://raw.githubusercontent.com/CeForce/hulktoken/master/hulk.json",
    "documentHash": "367750e31cb276f5218c013473449c9e6a4019fed603d045b51e25f5db29283a",
    "status": [
    ]
  }
]

To retrieve only the balance of a specific group, specify the tokengroup ID as a parameter as follows:

$ gettokenbalance ionrt1z08suycj85usle25z7c8fy0pvqg82759dkant22edca55z5c8q0qc3czz0g
[
  {
  "groupIdentifier": "tion1zv08wr3jqdyqp03vwhq6v4jccyzxqvc0vlyacfcpmtmxuygj2fgsszyfkxj",
  "balance": "99.0000000000000"
}
]

To retrieve only the balance of a specific group at a specific address, specify both parameters:

$ gettokenbalance tion1zv08wr3jqdyqp03vwhq6v4jccyzxqvc0vlyacfcpmtmxuygj2fgsszyfkxj g7hdTS73rTb8HB1NUB9aicaUm6vvWDGg8t
[
  {
  "groupIdentifier": "tion1zv08wr3jqdyqp03vwhq6v4jccyzxqvc0vlyacfcpmtmxuygj2fgsszyfkxj",
  "balance": "99.0000000000000"
}
]

Postconditions: