parse

Supported chain families:

EVMSolanaAptosTONCanton

Decode hex-encoded error bytes, revert reasons, function calls, or event data from CCIP contracts.

Synopsis

Bash

ccip-cli parse <data> [options]

Aliases: parseBytes, parseData, parse-bytes, parse-data

Description

The parse command decodes hex-encoded bytes into human-readable format. It supports custom errors from CCIP contracts, standard Solidity revert reasons, function call data, and event log data.

Arguments

Argument	Type	Required	Description
<data>	string	Yes	Data to parse (hex, base64, or chain-specific format)

Options

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

Command Builder

Build your parse command interactively:

ccip-cli parse Builder

Decode hex-encoded error bytes, revert reasons, or call data from CCIP contracts

Required Arguments

These values are required to build the command

Data to Parse*

Data to parse (hex, base64, or chain-specific format)

Output Options

Control command output format

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 parse <data> --format pretty

Supported Data Types

Type	Description	Example Output
Custom errors	CCIP contract-specific errors	EVM2EVMOnRamp_1.2.0.UnsupportedToken(address)
Revert reasons	Error(string) and Panic(uint256)	Error: "Insufficient balance"
Function calls	Decoded function parameters	ccipSend(destinationChainSelector, message)
Event data	Decoded event parameters	CCIPSendRequested(message)

Use Cases

Use Case	Description
Debug failed transactions	Decode revert reasons from failed CCIP operations
Analyze execution failures	Understand why manual execution failed
Inspect call data	Decode function parameters from transaction input

Examples

Decode an error

Bash

ccip-cli parse 0xbf16aab6000000000000000000000000779877a7b0d9e8603169ddbd7836e478b4624789

Output:

Error: EVM2EVMOnRamp_1.2.0.UnsupportedToken(address)
Args: { token: '0x779877A7B0D9E8603169DdbD7836e478b4624789' }

Output as JSON

Bash

ccip-cli parse 0xbf16aab6... --format json

Behavior

1. Tries each supported chain's ABI decoders
2. Returns the first successful decode
3. Recursively decodes nested returnData and error arguments
4. Returns "Unknown data" if no decoder matches

See Also

• show - View full message details including any errors
• manual-exec - Retry failed executions

Exit Codes

Code	Meaning
0	Success - data decoded
1	Error (no decoder matched, invalid hex input, missing arguments)

Use in scripts:

Bash

DECODED=$(ccip-cli parse $ERROR_DATA --format json)