CCIP Adapter

Lucid has developed an adapter that integrates with Chainlink’s Cross-Chain Interoperability Protocol (CCIP) to send and receive messages across chains.

Fees

CCIP supports on-chain fee quoting, which this adapter uses to estimate the fees required for message delivery.

When sending or exporting a transaction from the Lucid App, Lucid automatically calculates the total fees for the transaction, including any applicable protocol fees.

Unlike some bridges, CCIP does not refund excess gas fees by default. However, using the on-chain quote, the CCIP Adapter contract will determine if any excess Ether was sent and refund it to the refundAddress specified in the options field.

Interfaces

Each adapter implements the following public functions:

relayMessage

function relayMessage( uint256 destChainId, address destination, bytes memory options, bytes calldata message ) external payable returns (bytes32)

Sends a message through the CCIP bridge, deducts the protocol fee, and pays the required CCIP fee.

• The refundAddress must be ABI-encoded within the options bytes.

• The Ether sent by the calling contract must cover both the CCIP fee and the Lucid protocol fee.

• If excess funds are sent, the contract will refund the difference to the refundAddress.

• Returns a bytes32 value representing the transferId generated by CCIP.

Input Params:

Type	Name	Description
uint256	destChainId	The destination chain ID.
address	destination	The destination address.
bytes	options	Additional params to be used by each adapter. Usually the refund address and the gas limit.
bytes	message	The message to be relayed.

---

quoteMessage

function quoteMessage( address destination, uint256 chainId, uint256 gasLimit, bytes calldata message, bool includeFee ) external view returns (uint256)

Calculates the total fee required to send a message using CCIP’s on-chain quoting functionality. Returns the estimated fee amount in Ether.

Input Params:

Type	Name	Description
address	destination	The destination address
uint256	chainId	The destination chain ID
uint256	gasLimit	The gas limit required for the execution in the destination chain
bytes	message	The message data that is sent across
bool	includeFee	Whether to include the protocol fee in the calculation