manualExec

Supported chain families:

EVMSolanaAptos

Manually execute pending or failed CCIP messages on the destination chain.

Synopsis

Bash

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

Description

The manualExec command allows you to manually trigger the execution of a CCIP message that is stuck or has failed. It retrieves the original request, calculates the merkle proof, fetches any required offchain data, and submits the execution transaction.

Arguments

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

Options

Message Selection

Option	Type	Default	Description
--log-index	number	-	Select a specific message by log index when multiple messages exist in one transaction

Gas Options

Option	Alias	Type	Default	Description
--gas-limit	-L, --compute-units	number	-	Override gas limit for receiver callback. 0 keeps the original request value.
--tokens-gas-limit	-	number	-	Override gas limit for token pool releaseOrMint calls. 0 keeps original.
--estimate-gas-limit	-	number	-	Estimate gas limit with percentage margin (e.g., 10 for +10%). Conflicts with --gas-limit.

Wallet

Option	Alias	Type	Description
--wallet	-w	string	Wallet for signing transactions. See Configuration.

Solana-Specific Options

Option	Type	Default	Description
--force-buffer	boolean	false	Use buffer for messages too large for a single transaction.
--force-lookup-table	boolean	false	Create a lookup table for accounts to fit in transaction.
--clear-leftover-accounts	boolean	false	Clear buffers or lookup tables from previous attempts.

Sui-Specific Options

Option	Type	Default	Description
--receiver-object-ids	string[]	-	Receiver object IDs for Sui execution (e.g., 0xabc...).

Queue Execution

Option	Type	Default	Description
--sender-queue	boolean	false	Execute all pending messages from the same sender, starting from the provided transaction.
--exec-failed	boolean	false	Include failed messages in queue execution. Requires --sender-queue.

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

Command Builder

Build your manualExec command interactively:

ccip-cli manualExec Builder

Manually execute pending or failed CCIP messages

Required Arguments

These values are required to build the command

Transaction Hash*

Transaction hash of the original CCIP request

Message Options

Configure the CCIP message payload

Log Index

Select specific message by log index

Gas & Execution

Control gas limits and execution behavior

Gas Limit

Override gas limit for receiver callback (0 = original). Alias: --compute-units

Tokens Gas Limit

Override gas limit for token pool releaseOrMint calls

Estimate Gas Limit

Estimate gas with margin % (e.g., 10 for +10%). Conflicts with --gas-limit.

Solana Options

Options specific to Solana chains

Force Buffer

Use buffer for large messages on Solana

Force Lookup Table

Create lookup table for accounts on Solana

Clear Leftover Accounts

Clear buffers/tables from previous attempts

Wallet & Transaction

Configure wallet and transaction settings

Wallet

Wallet source: ledger[:index], trezor[:index], or private key in USER_KEY env var

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 manualExec <tx-hash> --rpcs-file ./.env --format pretty

When to Use

Manual execution is needed when:

Scenario	Description
Message stuck pending	DON hasn't executed it within expected timeframe
Previous execution failed	Need to retry with different gas parameters
Out-of-order execution blocked	Earlier message in sender queue failed

Danger

Manual execution requires the message to be committed but not yet executed. Attempting to manually execute an already-executed message will fail.

Examples

Execute a pending message

Bash

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

Override gas limit

Bash

ccip-cli manualExec 0xabc123... \
  --gas-limit 500000 \
  --wallet ledger

Estimate and apply gas limit with margin

Bash

ccip-cli manualExec 0xabc123... \
  --estimate-gas-limit 15 \
  --wallet ledger

Solana execution with buffer

For large messages on Solana:

Bash

ccip-cli manualExec 0xabc123... \
  --wallet ledger \
  --gas-limit 500000 \
  --force-buffer \
  --clear-leftover-accounts

Sui execution with receiver objects

For Sui destinations that require receiver object IDs:

Bash

ccip-cli manualExec 0xabc123... \
  --wallet ledger \
  --receiver-object-ids 0xabc... 0xdef...

Execution Flow

1. Fetches the original request from the source chain
2. Retrieves the commit report from the destination chain
3. Calculates the merkle proof for manual execution
4. Fetches any required offchain token data (e.g., CCTP attestations)
5. Submits the execution transaction to the destination chain

Solana Considerations

Solana transactions have size limits. For large messages:

Step	Option	Description
1	--force-buffer	Sends report in chunks
2	--force-lookup-table	Creates address lookup table for accounts
3	--clear-leftover-accounts	Cleans up from aborted attempts

After successful execution, buffers auto-clear. Lookup tables require a grace period before deletion.

See Also

• show - Check message status before executing
• Configuration - Wallet setup

Exit Codes

Code	Meaning
0	Success - execution transaction submitted
1	Error (network failure, execution failed, invalid arguments)

Use in scripts:

Bash

ccip-cli manualExec $TX_HASH --wallet ledger --format json || exit $?