WAX icon

WAX

Interact with the WAX blockchain

Actions9

Overview

This node interacts with the WAX blockchain, specifically to retrieve the token balance of a given WAX account. It is useful in scenarios where you need to programmatically check how many tokens (such as WAX tokens or other tokens issued on the WAX blockchain) an account holds. For example, it can be used in automated workflows that monitor account balances for triggering alerts, managing funds, or integrating blockchain data into other systems.

Properties

Name Meaning
API Endpoint The URL of the WAX blockchain API endpoint to connect to (default: https://wax.greymass.com).
Account Name The WAX blockchain account name whose token balance you want to retrieve.
Token Contract The smart contract that manages the token, e.g., "eosio.token" for standard WAX tokens.
Symbol The symbol of the token to check the balance for, e.g., "WAX".

Output

The node outputs JSON data containing the token balance information for the specified account and token symbol. The exact structure depends on the response from the WAX blockchain API but typically includes fields such as the amount of tokens held by the account.

If the node encounters an error during execution, it outputs a JSON object with an error field describing the issue.

Dependencies

  • Requires access to a WAX blockchain API endpoint (default is https://wax.greymass.com).
  • No explicit external API keys or credentials are mandatory for this operation, but the node supports optional private key credentials for other operations.
  • Network connectivity to the specified API endpoint is necessary.

Troubleshooting

  • Common issues:
    • Incorrect or misspelled account names will result in errors or empty balances.
    • Using an invalid or unreachable API endpoint will cause connection failures.
    • Specifying a token contract or symbol that does not exist or is not associated with the account will return zero or no balance.
  • Error messages:
    • Errors related to network connectivity or timeouts indicate problems reaching the API endpoint; verify the endpoint URL and network status.
    • Errors about missing or invalid parameters suggest required properties were not set correctly; ensure all required fields are filled.
  • To resolve errors, double-check input values, confirm the API endpoint is correct and accessible, and verify the account and token details on the WAX blockchain.

Links and References

Discussion