show

Supported chain families:

EVMSolanaAptos

Display details of a CCIP request, including commit status and execution receipts.

Synopsis

Bash

ccip-cli show <tx-hash> [options]

show is the default command, so you can also use:

Bash

ccip-cli <tx-hash>

Description

The show command retrieves and displays comprehensive information about a CCIP cross-chain message. It queries the source chain for the original request, then checks the destination chain for commit and execution status.

Arguments

Argument	Type	Required	Description
<tx-hash>	string	Yes	Transaction hash containing the CCIP request on the source chain

Options

Option	Type	Default	Description
--log-index	number	-	Select a specific message by log index when multiple CCIP messages exist in one transaction. If omitted, an interactive menu is displayed.
--id-from-source	string	-	Search by message ID instead of transaction hash. Format: [onRamp@]sourceNetwork. The onRamp address may be required for some chains.
--wait	boolean	-	Wait for finality, commit, and first execution of pending requests before returning.

See Configuration for global options (--rpcs, --format, etc.).

Command Builder

Build your show command interactively:

ccip-cli show Builder

Display details of a CCIP request

Required Arguments

These values are required to build the command

Transaction Hash*

Transaction hash containing the CCIP request

Output Options

Control command output format

Log Index

Pre-select a message request by log index (when multiple CCIP messages exist in one transaction)

Message ID from Source

Search by messageId instead of txHash. Format: [onRamp@]sourceNetwork (onRamp address may be required for some chains)

Wait for Execution

Wait for finality, commit, and first execution before returning

Output Format-- Select --Pretty (human-readable tables)JSON (machine-readable)Log (console.log style)

Format for command output

Verbose

Enable debug logging

Fill in required fields to generate command

Generated Command

ccip-cli show <tx-hash> --rpcs-file ./.env --format pretty

Examples

Track a message by transaction hash

Bash

ccip-cli show 0xafd36a0b99d5457e403c918194cb69cd070d991dcbadc99576acfce5020c0b6b \
  --rpc https://eth-sepolia.example.com \
  --rpc https://arb-sepolia.example.com

Select a specific message in a multi-message transaction

When a transaction contains multiple CCIP messages, use --log-index to select one:

Bash

ccip-cli show 0xabc123... --log-index 2

Search by message ID

If you have the message ID instead of the transaction hash:

Bash

ccip-cli show 0xmessageId... --id-from-source ethereum-testnet-sepolia

Output as JSON for scripting

Bash

ccip-cli show 0xabc123... --format json

Wait for message execution

Monitor a message until it's fully executed on the destination chain:

Bash

ccip-cli show 0xabc123... --wait

Output

The command displays three sections:

Section	Description
Request	Message details from the source chain (sender, receiver, data)
Commit	Commit report from destination chain (merkle root, sequences)
Receipts	Execution receipts showing success or failure status

Behavior

1. The CLI attempts all configured RPCs in parallel
2. Uses the first network that responds with the transaction
3. If destination RPC is available, fetches commit and execution status
4. For multi-message transactions without --log-index, displays an interactive selection menu

See Also

• manualExec - Execute pending or failed messages
• Configuration - RPC and output format options

Exit Codes

Code	Meaning
0	Success - message details retrieved
1	Error (network failure, message not found, invalid arguments)

Use in scripts:

Bash

ccip-cli show $TX_HASH --format json && echo "Message found" || echo "Failed"