Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/axelarnetwork/axelar-core/llms.txt

Use this file to discover all available pages before exploring further.

The axelard query evm command group provides read-only access to the state of Axelar’s EVM module. Use these subcommands to inspect supported chains, gateway contracts, command batches, registered tokens, on-chain events, and chain-specific parameters — all without submitting any transaction.
All EVM query subcommands accept --node, --grpc-addr, --height, and --output flags. The --height flag lets you query historical state at a specific block, which may fail if the node has pruned that data.

​
Global Flags

The following flags are inherited by every axelard query evm subcommand.
​
--home
string
Directory for config and data. Defaults to $HOME/.axelar.
​
--log_format
string
Logging format: json or plain. Defaults to plain.
​
--log_level
string
Logging level: trace, debug, info, warn, error, fatal, or panic. Defaults to info.
​
--output
string
Output format: text or json. Defaults to text.
​
--trace
boolean
Print full stack trace on errors.

​
Subcommands

Returns the supported EVM chains, optionally filtered by activation status.Syntax
axelard query evm chains [flags]
Flags
​
--status
string
Filter chains by status. Accepted values: activated or deactivated.
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels. If not set, the server must use TLS.
​
--height
integer
Query state at a specific block height. May error if the node is pruning state.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
# List all activated EVM chains
axelard query evm chains --status activated

# List all deactivated EVM chains
axelard query evm chains --status deactivated

# List all chains regardless of status
axelard query evm chains
Example output
chains:
- Ethereum
- Avalanche
- Polygon
- Fantom
- Moonbeam
Queries the Axelar Gateway contract address deployed on the specified EVM chain. This address is the entry point for cross-chain calls originating from that chain.Syntax
axelard query evm gateway-address [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain whose Gateway contract address you want to retrieve (e.g., Ethereum, Avalanche).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm gateway-address Ethereum
axelard query evm gateway-address Avalanche --output json
Example output
address: 0x4F4495243837681061C4743b74B3eEdf548D56A5
Retrieves the signed batched commands for a given chain and batch ID. The returned data can be wrapped in an EVM transaction and submitted to the Axelar Gateway contract for execution.Syntax
axelard query evm batched-commands [chain] [batchedCommandsID] [flags]
Arguments
​
chain
string
required
The name of the EVM chain (e.g., Ethereum).
​
batchedCommandsID
string
required
The hex-encoded ID of the command batch to retrieve.
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm batched-commands Ethereum 0000000000000000000000000000000000000000000000000000000000000001
Example output
id: "0000000000000000000000000000000000000000000000000000000000000001"
status: BATCHED_COMMANDS_STATUS_SIGNED
key_id: "Ethereum-key-2024"
command_ids:
- "abc123..."
data: "0x..."
sig_hash: "0x..."
execute_data: "0x..."
Use execute_data from the response to build the EVM transaction that calls execute() on the Axelar Gateway contract.
Retrieves the most recently created batched commands for the specified EVM chain. This is a shortcut that avoids needing to know the batch ID.Syntax
axelard query evm latest-batched-commands [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain (e.g., Ethereum, Polygon).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm latest-batched-commands Ethereum
axelard query evm latest-batched-commands Polygon --output json
Returns the list of commands that have not yet been included in a command batch for the specified chain. These are queued and waiting to be batched and signed.Syntax
axelard query evm pending-commands [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain to query (e.g., Ethereum).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm pending-commands Ethereum
Example output
commands:
- id: "abc123..."
  type: "approveContractCall"
  params: "..."
  key_id: "Ethereum-key-2024"
  max_gas_cost: 100000
Returns detailed information about a specific EVM gateway command given its chain and command ID.Syntax
axelard query evm command [chain] [id] [flags]
Arguments
​
chain
string
required
The name of the EVM chain (e.g., Ethereum).
​
id
string
required
The hex-encoded command ID to look up.
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm command Ethereum abc123def456
Example output
id: "abc123def456"
type: "mintToken"
params: "..."
key_id: "Ethereum-key-2024"
max_gas_cost: 50000
Returns the status and details of a specific on-chain event that Axelar has observed for the given EVM chain. Events include token transfers, contract calls, and other Gateway interactions.Syntax
axelard query evm event [chain] [event-id] [flags]
Arguments
​
chain
string
required
The name of the EVM chain where the event occurred (e.g., Ethereum).
​
event-id
string
required
The ID of the event to retrieve. Typically formatted as txHash-logIndex.
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm event Ethereum 0xabc123...def-1
Example output
event:
  chain: Ethereum
  tx_id: "0xabc123..."
  index: 1
  status: EVENT_STATUS_COMPLETED
Returns the list of ERC20 tokens registered on the given EVM chain. Results can be filtered by token type (external or internal).Syntax
axelard query evm erc20-tokens [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain to query (e.g., Ethereum, Avalanche).
Flags
​
--token-type
string
Filter tokens by type. Accepted values: external or internal.
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
# List all registered ERC20 tokens on Ethereum
axelard query evm erc20-tokens Ethereum

# List only external tokens
axelard query evm erc20-tokens Ethereum --token-type external
Example output
tokens:
- asset: "uaxl"
  symbol: "AXL"
  address: "0x..."
  is_external: false
  burner_code_hash: "0x..."
- asset: "wbtc-satoshi"
  symbol: "WBTC"
  address: "0x..."
  is_external: true
  burner_code_hash: "0x..."
Returns detailed information about a specific token on an EVM chain. You can look up by symbol, asset name, or contract address. Exactly one lookup flag must be provided.Syntax
axelard query evm token-info [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain to query (e.g., Ethereum).
Flags
​
--symbol
string
Look up the token by its ticker symbol (e.g., AXL, WBTC).
​
--asset
string
Look up the token by its asset name (e.g., uaxl, wbtc-satoshi).
​
--address
string
Look up the token by its EVM contract address.
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
# Lookup by symbol
axelard query evm token-info Ethereum --symbol AXL

# Lookup by asset name
axelard query evm token-info Ethereum --asset uaxl

# Lookup by contract address
axelard query evm token-info Ethereum --address 0x467719ad09025fcc6cf6f8311755809d45a5e5f3
Example output
asset: "uaxl"
symbol: "AXL"
address: "0x467719ad09025fcc6cf6f8311755809d45a5e5f3"
is_external: false
burner_code_hash: "0x..."
Returns the minimum number of block confirmations required before Axelar will process events from the given EVM chain. A higher confirmation height increases security by reducing the risk of chain reorganizations.Syntax
axelard query evm confirmation-height [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain to query (e.g., Ethereum, Polygon).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm confirmation-height Ethereum
axelard query evm confirmation-height Polygon --output json
Example output
height: 35
Returns the EVM address corresponding to the key used by the Axelar network for the specified chain, optionally for a specific key ID.Syntax
axelard query evm address [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain (e.g., Ethereum).
Flags
​
--key-id
string
The ID of the key to retrieve the address for.
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm address Ethereum
axelard query evm address Ethereum --key-id Ethereum-key-2024
Example output
address: "0x1234567890abcdef1234567890abcdef12345678"
key_id: "Ethereum-key-2024"
Fetches the token bytecode registered for the given EVM chain. This bytecode is used when deploying new token contracts through the Axelar Gateway.Syntax
axelard query evm bytecode [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain to query (e.g., Ethereum).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm bytecode Ethereum
axelard query evm bytecode Avalanche --output json
Example output
bytecode: "0x608060405234801561001057600080fd5b50..."
Returns the on-chain parameters for a specific EVM chain registered in Axelar’s EVM module. Parameters include network details, confirmation requirements, and voting thresholds.Syntax
axelard query evm params [chain] [flags]
Arguments
​
chain
string
required
The name of the EVM chain whose parameters you want to retrieve (e.g., Ethereum).
Flags
​
--grpc-addr
string
The gRPC endpoint to use for this chain.
​
--grpc-insecure
boolean
Allow gRPC over insecure channels.
​
--height
integer
Query state at a specific block height.
​
--node
string
<host>:<port> to CometBFT RPC interface. Defaults to tcp://localhost:26657.
​
-o / --output
string
Output format: text or json. Defaults to text.
Example
axelard query evm params Ethereum
axelard query evm params Polygon --output json
Example output
params:
  chain: Ethereum
  confirmation_height: 35
  network: "mainnet"
  token_code: "0x..."
  burnable: "0x..."
  revote_locking_period: 50
  voting_threshold: "51/100"
  min_voter_count: 1
  commands_gas_limit: 5000000
  end_blocker_limit: 50
  transfer_limit: 50

Build docs developers (and LLMs) love

Get started for freeTalk to us