Skip to main content
Version: v2

MessageSearchResult

Message search result summary returned by search queries. Contains essential message information.

messageIdstringrequired

Globally unique message identifier.

Possible values: Value must match regular expression ^0x[a-fA-F0-9]{64}$

Example: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
originstringrequired

Address of the user account that originally initiated the transaction (tx.origin) on the source chain.

Example: 0x742d35Cc6634C0532925a3b8D5c8C22C5B2D8a3E
senderstringrequired

Address of the account that called ccipSend() on the source chain router.

Example: 0x742d35Cc6634C0532925a3b8D5c8C22C5B2D8a3E
receiverstringrequired

Address of the intended recipient contract/account on the destination chain.

Example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
statusstringrequired

The current status of the CCIP message through its lifecycle:

  • SENT: Transaction submitted and waiting for source chain confirmation
  • SOURCE_FINALIZED: Transaction confirmed on source chain and ready for CCIP processing
  • COMMITTED: Message committed to destination chain's commit store and staged for execution (CCIP v1.6 and below)
  • BLESSED: Message approved by CCIP network and ready for execution (CCIP v1.6 and below)
  • VERIFYING: Message is being verified by the CCIP network (CCIP v1.7+)
  • VERIFIED: Message has been verified by the CCIP network (CCIP v1.7+)
  • SUCCESS: Message successfully executed on destination chain
  • FAILED: Message execution failed but can be manually retried
Example: SUCCESS
sourceNetworkInfo objectrequired

Information about the blockchain network where the message originated

namestringrequired

Human-readable name identifier for the blockchain network. Used for display purposes and network identification.

Example: ethereum-mainnet
chainSelectorstringrequired

The CCIP chain selector identifier (uint64 as string). Example Selectors (non-exhaustive):

ChainSelector
Arbitrum4949039107694359620
Base15971525489660198786
Ethereum5009297550715157269
Optimism3734403246176062136
Polygon4051577828743386545
Solana124615329519749607

For the complete list of chain selectors, see: CCIP Directory

Possible values: Value must match regular expression ^[0-9]+$

Example: 5009297550715157269
chainIdstringrequired

Native chain identifier (EIP-155 for EVM, genesis hash for SVM, etc.).

Example: 1
chainFamilystringrequired

Blockchain family/architecture type. Determines message format, address encoding, and execution model.

Example: EVM
destNetworkInfo objectrequired

Information about the blockchain network where the message will be executed

namestringrequired

Human-readable name identifier for the blockchain network. Used for display purposes and network identification.

Example: ethereum-mainnet
chainSelectorstringrequired

The CCIP chain selector identifier (uint64 as string). Example Selectors (non-exhaustive):

ChainSelector
Arbitrum4949039107694359620
Base15971525489660198786
Ethereum5009297550715157269
Optimism3734403246176062136
Polygon4051577828743386545
Solana124615329519749607

For the complete list of chain selectors, see: CCIP Directory

Possible values: Value must match regular expression ^[0-9]+$

Example: 5009297550715157269
chainIdstringrequired

Native chain identifier (EIP-155 for EVM, genesis hash for SVM, etc.).

Example: 1
chainFamilystringrequired

Blockchain family/architecture type. Determines message format, address encoding, and execution model.

Example: EVM
sendTransactionHashstringrequired

Transaction hash of the ccipSend() call on the source chain. Format depends on source chain family.

Example: 0x9428deb1234567890abcdef1234567890abcdef1234567890abcdef1234567890
sendTimestampstring<date-time>required

ISO 8601 timestamp when the message was sent.

Example: 2023-12-01T10:30:00Z
receiptTransactionHashstringnullable

Transaction hash of the message execution on the destination chain. Null if message hasn't been executed yet.

Example: 3vZ8qJ1234567890abcdef1234567890abcdef1234567890abcdef1234567890
receiptTimestampstring<date-time>nullable

ISO 8601 timestamp when the message was executed on destination chain. Null if message hasn't been executed yet.

Example: 2023-12-01T10:45:00Z
sourceTokenAmount objectnullable

Source token information including address and amount. Null if no token was transferred.

tokenAddressstringrequired

Address of the token contract on the source chain. Format depends on source chain family.

Example: 0x742d35Cc6634C0532925a3b8D5c8C22C5B2D8a3E
tokenAmountstringrequired

Amount of tokens transferred in the token's smallest unit (wei, lamports, etc.).

Example: 1000000
JSON
MessageSearchResult
{
  "messageId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "sender": "0x742d35Cc6634C0532925a3b8D5c8C22C5B2D8a3E",
  "receiver": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "origin": "0x742d35Cc6634C0532925a3b8D5c8C22C5B2D8a3E",
  "status": "SUCCESS",
  "sourceNetworkInfo": {
    "name": "ethereum-mainnet",
    "chainSelector": "5009297550715157269",
    "chainId": "1",
    "chainFamily": "EVM"
  },
  "destNetworkInfo": {
    "name": "solana-mainnet",
    "chainSelector": "124615329519749607",
    "chainId": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d",
    "chainFamily": "SVM"
  },
  "sendTransactionHash": "0x9428deb1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "sendTimestamp": "2023-12-01T10:30:00Z",
  "receiptTransactionHash": "3vZ8qJ1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "receiptTimestamp": "2023-12-01T10:45:00Z"
}