On this page

Tendermint Token Activation Task Status

API-v2task::enable_tendermint_token::status

After running the task::enable_tendermint_token::init method, you can query the status of activation to check its progress. The response will return the following:

  • Result of the task (success or error)
  • Progress status (what state the task is in)
  • Required user action (what user should do before the task can continue)

ParameterTypeRequiredDefaultDescription
task_idinteger-The identifying number returned when initiating the initialisation process.
forget_if_finishedbooleantrueIf false, will return the final response for completed tasks.

Tendermint Token Activation Status

POST
task::enable_tendermint_token::status
{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "task::enable_tendermint_token::status",
  "params": {
    "task_id": 5,
    "forget_if_finished": false
  }
}

ParameterTypeDescription
statusTaskActivationStatusEnumA short indication of how the enabling is progressing.
detailsobjectDepending on the state of enabling progress, this will contain different information as shown in the responses below.

Once complete, status will be Ok, and the details object will have the following structure:

ParameterTypeDescription
current_blockintegerBlock height of the Tendermint chain
platform_coinstringPlatform coin used to support the token (e.g., ATOM, KAVA).
tickerstringTicker of the Tendermint token being activated.
token_ibc_denomstringFull IBC denomination or contract address for the token.
wallet_balanceobjectA standard WalletBalanceInfo object. Note: the structure may vary based on the get_balances parameter value in the activation request.

ParameterTypeDescription
statusstringA short indication of how the requested process is progressing.
details.resultobjectDepending on the state of process progress, this will contain different information as detailed in the items below.
.errorstringThe ticker of the token being activated
.error_pathstringUsed for debugging. A reference to the function in code base which returned the error
.error_tracestringUsed for debugging. A trace of lines of code which led to the returned error
.error_typestringAn enumerated error identifier to indicate the category of error
.error_datastringAdditional context for the error type

Possible Error Cases:

  • TaskTimedOut – Timed out waiting for token activation, connecting to the device, or for user confirmation on the hardware wallet.
  • CoinCreationError – Error during platform coin activation or RPC communication.
  • HwErrorThis is the most important error type. Unlike other error types, HwError requires the GUI / User to check the details in error_data field to know which action is required. View the HwError error type details for more info.