show

Supported chain families:

EVMSolanaAptos

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

Synopsis

Bash

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

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

Bash

ccip-cli <tx-hash-or-id>

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-or-id>	string	Yes	Transaction hash or message ID. Accepts source chain transaction hashes (EVM hex, Solana Base58) or 32-byte message IDs (0x + 64 hex chars).

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.
--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 (32-byte hex) instead of the transaction hash:

Bash

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

The CLI automatically detects whether the input is a transaction hash or message ID and queries the appropriate source (RPC or CCIP API).

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 validates the input using isSupportedTxHash() to ensure it's a valid transaction hash format
2. If the input is a 32-byte hex string (message ID format), the CLI races both:
   • Local RPC lookup via getMessagesInTx()
   • CCIP API lookup via getMessageById()
3. Uses the first source that responds with valid data
4. If destination RPC is available, fetches commit and execution status
5. For multi-message transactions without --log-index, displays an interactive selection menu

Use --no-api (see Configuration) to disable API fallback and use only RPC endpoints.

See Also

• manual-exec - 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"