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 nexus command group exposes read-only queries into Axelar’s Nexus module — the cross-chain routing layer that manages registered chains, assets, fees, and pending transfers. Use these subcommands to inspect the state of any supported chain or asset pair without submitting any transaction.
All Nexus query subcommands share common flags for node connection (--node, --grpc-addr), historical queries (--height), and output formatting (--output). Omitting --height queries the latest committed state.

​
Global Flags

The following flags are inherited by every axelard query nexus 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 list of chain names registered in the Nexus module, optionally filtered by activation status.Syntax
axelard query nexus chains [flags]
Flags
​
--status
string
Filter chains by activation 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 chains regardless of status
axelard query nexus chains

# List only activated chains
axelard query nexus chains --status activated

# List deactivated chains in JSON format
axelard query nexus chains --status deactivated --output json
Example output
chains:
- Ethereum
- Avalanche
- Osmosis
- Axelarnet
- cosmoshub
Returns the current state of a chain registered in the Nexus module, including whether it is active, its supported assets, and its maintainer set.Syntax
axelard query nexus chain-state [chain] [flags]
Arguments
​
chain
string
required
The name of the chain to query (e.g., Ethereum, Osmosis).
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 nexus chain-state Ethereum
axelard query nexus chain-state Osmosis --output json
Example output
state:
  chain:
    name: Ethereum
    supports_foreign_assets: true
    key_type: KEY_TYPE_MULTISIG
    module: evm
  activated: true
  assets:
  - denom: "uaxl"
Returns the set of validators currently maintaining (i.e., running infrastructure for and voting on events from) the specified chain. Validators must maintain chains they are assigned to in order to earn rewards.Syntax
axelard query nexus chain-maintainers [chain] [flags]
Arguments
​
chain
string
required
The name of the chain to query maintainers for (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 nexus chain-maintainers Ethereum
axelard query nexus chain-maintainers Avalanche --output json
Example output
maintainers:
- axelarvaloper1abc...
- axelarvaloper1def...
- axelarvaloper1ghi...
A chain must have a sufficient number of active maintainers to process cross-chain transfers. If too many maintainers go offline, transfer processing may be delayed.
Returns the list of assets (by denomination) that are registered for cross-chain transfers on the specified chain.Syntax
axelard query nexus assets [chain] [flags]
Arguments
​
chain
string
required
The name of the chain to query registered assets for (e.g., Ethereum, cosmoshub).
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 nexus assets Ethereum
axelard query nexus assets cosmoshub --output json
Example output
assets:
- denom: "uaxl"
  is_native_asset: false
- denom: "weth-wei"
  is_native_asset: true
- denom: "uusdc"
  is_native_asset: false
Returns all chains on which the specified asset is registered. This is useful for discovering which chains support a particular cross-chain asset.Syntax
axelard query nexus chain-by-asset [asset] [flags]
Arguments
​
asset
string
required
The asset denomination to search for (e.g., uaxl, weth-wei, uusdc).
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 nexus chain-by-asset uaxl
axelard query nexus chain-by-asset uusdc --output json
Example output
chains:
- Ethereum
- Avalanche
- Polygon
- Axelarnet
- Osmosis
Returns the per-chain fee configuration for a registered asset. The fee info includes the fee rate, minimum fee, and maximum fee applied when transferring the asset through the specified chain.Syntax
axelard query nexus fee-info [chain] [asset] [flags]
Arguments
​
chain
string
required
The name of the chain (e.g., Ethereum, Avalanche).
​
asset
string
required
The asset denomination to query fees for (e.g., uaxl, uusdc).
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 nexus fee-info Ethereum uaxl
axelard query nexus fee-info Avalanche uusdc --output json
Example output
fee_info:
  chain: "Ethereum"
  asset: "uaxl"
  fee_rate: "0.001"
  min_fee: "100000"
  max_fee: "100000000"
Use transfer-fee to compute the actual fee for a specific transfer amount between two chains, rather than inspecting raw fee parameters here.
Returns the total fee that would be incurred on a cross-chain transfer of a specified amount between two chains. This helps users and integrators estimate net received amounts before initiating a transfer.Syntax
axelard query nexus transfer-fee [source-chain] [destination-chain] [amount] [flags]
Arguments
​
source-chain
string
required
The name of the chain where the transfer originates (e.g., Ethereum).
​
destination-chain
string
required
The name of the destination chain (e.g., Avalanche, Osmosis).
​
amount
string
required
The amount to transfer, including denomination (e.g., 1000000uaxl, 500000uusdc).
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 nexus transfer-fee Ethereum Avalanche 1000000uaxl
axelard query nexus transfer-fee Ethereum Osmosis 500000uusdc --output json
Example output
fee:
  denom: "uaxl"
  amount: "1000"
Returns the list of cross-chain transfers for a given chain, filtered by transfer state. Supports pagination for large result sets. The state must be one of pending, archived, or insufficient_amount.Syntax
axelard query nexus transfers-for-chain [chain] [state] [flags]
Arguments
​
chain
string
required
The name of the chain to query transfers for (e.g., Ethereum).
​
state
string
required
The transfer state to filter by. Accepted values: pending, archived, or insufficient_amount.
Flags
​
--count-total
boolean
Count the total number of records matching the query.
​
--limit
integer
Number of records to return per page. Defaults to 100.
​
--offset
integer
Pagination offset — number of records to skip.
​
--page
integer
Pagination page number. Sets offset to page * limit. Defaults to 1.
​
--page-key
string
Pagination cursor key for keyset pagination.
​
--reverse
boolean
Return results in descending order.
​
--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 pending transfers for Ethereum
axelard query nexus transfers-for-chain Ethereum pending

# List archived transfers with pagination
axelard query nexus transfers-for-chain Ethereum archived --limit 50 --page 2

# List transfers in reverse order
axelard query nexus transfers-for-chain Ethereum pending --reverse
Example output
transfers:
- id: 123
  sender:
    chain: "Ethereum"
    address: "0xabc..."
  recipient:
    chain: "Avalanche"
    address: "0xdef..."
  asset:
    denom: "uaxl"
    amount: "500000"
  state: TRANSFER_STATE_PENDING
pagination:
  total: 1
Returns the cross-chain message corresponding to the given message ID. Messages represent general message passing (GMP) payloads routed through Axelar’s network.Syntax
axelard query nexus message [id] [flags]
Arguments
​
id
string
required
The unique identifier of the cross-chain message 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 nexus message 0xabc123def456...
axelard query nexus message some-message-id --output json
Example output
message:
  id: "0xabc123..."
  source_chain: "Ethereum"
  source_address: "0x1234..."
  destination_chain: "Avalanche"
  destination_address: "0x5678..."
  payload_hash: "0xdeadbeef..."
  status: APPROVED
  asset:
    denom: "uusdc"
    amount: "1000000"
Returns the on-chain governance parameters for the Nexus module. These parameters control cross-chain routing behaviour, including chain and asset management policies.Syntax
axelard query nexus params [flags]
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 nexus params
axelard query nexus params --output json
Example output
params:
  chain_activation_threshold: "60/100"
  chain_maintainer_missing_vote_penalty_count: 1000
  chain_maintainer_incorrect_vote_penalty_count: 50
  chain_maintainer_check_period: 100
  gateway: "axelar1..."
  end_blocker_limit: 50

Build docs developers (and LLMs) love

Get started for freeTalk to us