如何使用Chainlink CCIP发送ABI编码消息并实现跨链代币转账带函数调用？

要实现从Mumbai（源链）转代币至Avalanche（目标链）同时触发合约函数，核心是将函数调用的ABI编码数据作为CCIP消息内容传递——CCIP支持bytes类型消息，这正是承载可编程指令的关键。以下是具体实现步骤：

1. 编码目标合约的函数调用 #

首先需要将目标链合约的函数调用转换为ABI编码的字节数组，Solidity内置的编码工具可以直接完成这个操作：

示例：编码指定函数调用 #

假设目标合约有如下函数：

function executeAction(address recipient, uint256 amount) external {
    // 自定义业务逻辑（如转币、更新状态等）
}

在源链合约中，使用abi.encodeWithSignature或abi.encodeWithSelector生成编码数据：

// 方式1：用函数签名编码
bytes memory functionCallData = abi.encodeWithSignature(
    "executeAction(address,uint256)",
    0xYourRecipientAddress,
    100e18 // 示例参数
);

// 方式2：用函数选择器编码（更高效）
bytes4 selector = bytes4(keccak256("executeAction(address,uint256)"));
bytes memory functionCallData = abi.encodeWithSelector(
    selector,
    0xYourRecipientAddress,
    100e18
);

2. 调整源链的CCIP转账逻辑 #

将之前传递字符串消息的逻辑替换为编码后的functionCallData，调用sendMessageWithTokens完成带指令的代币转账：

import "@chainlink/contracts-ccip/src/v0.8/ccip/interfaces/IRouterClient.sol";
import "@chainlink/contracts-ccip/src/v0.8/ccip/libraries/Client.sol";

contract SourceTransferContract {
    IRouterClient public immutable ccipRouter;
    uint64 public constant AVALANCHE_CHAIN_SELECTOR = 14767482510784806043; // Fuji测试网，主网为1538667150

    constructor(address _router) {
        ccipRouter = IRouterClient(_router);
    }

    function transferTokensWithAction(
        address token,
        uint256 amount,
        address targetContract,
        address recipient,
        uint256 actionAmount
    ) external payable {
        // 1. 编码目标函数调用
        bytes memory functionCallData = abi.encodeWithSignature(
            "executeAction(address,uint256)",
            recipient,
            actionAmount
        );

        // 2. 构建代币转账参数
        Client.EVMTokenAmount[] memory tokenAmounts = new Client.EVMTokenAmount[](1);
        tokenAmounts[0] = Client.EVMTokenAmount({
            token: token,
            amount: amount
        });

        // 3. 构建CCIP消息
        Client.EVM2AnyMessage memory evm2AnyMessage = Client.EVM2AnyMessage({
            receiver: abi.encode(targetContract), // 目标链合约地址
            data: functionCallData, // 编码后的函数调用数据
            tokenAmounts: tokenAmounts,
            extraArgs: Client._argsToBytes(
                Client.EVMExtraArgsV1({gasLimit: 200000}) // 给目标函数执行预留Gas
            ),
            feeToken: address(0) // 用原生代币支付手续费，可替换为CCIP支持的手续费代币
        });

        // 4. 计算手续费并发送消息
        uint256 fee = ccipRouter.getFee(AVALANCHE_CHAIN_SELECTOR, evm2AnyMessage);
        ccipRouter.sendMessageWithTokens{value: fee}(
            AVALANCHE_CHAIN_SELECTOR,
            evm2AnyMessage,
            fee
        );
    }
}

3. 目标合约处理CCIP消息 #

目标合约需要继承CCIPReceiver，并实现_ccipReceive函数来解码消息并执行对应逻辑：

import "@chainlink/contracts-ccip/src/v0.8/ccip/applications/CCIPReceiver.sol";
import "@chainlink/contracts-ccip/src/v0.8/ccip/libraries/Client.sol";

contract TargetActionContract is CCIPReceiver {
    address public trustedSourceContract; // 仅允许指定源合约触发

    constructor(address _router, address _trustedSource) CCIPReceiver(_router) {
        trustedSourceContract = _trustedSource;
    }

    function _ccipReceive(Client.Any2EVMMessage memory message) internal override {
        // 验证发送者权限
        address sender = abi.decode(message.sender, (address));
        require(sender == trustedSourceContract, "Unauthorized source");

        // 解码消息并执行函数
        (address recipient, uint256 amount) = abi.decode(message.data, (address, uint256));
        executeAction(recipient, amount);
    }

    function executeAction(address recipient, uint256 amount) internal {
        // 自定义业务逻辑，例如：
        // IERC20(token).transfer(recipient, amount);
    }
}

关键注意事项 #

• Chain Selector正确性：确认使用对应网络的Chain Selector（Avalanche Fuji测试网为14767482510784806043，主网为1538667150）。
• Gas Limit设置：根据目标函数的执行复杂度调整gasLimit，不足会导致函数执行失败。
• 权限控制：在_ccipReceive中验证发送者地址，避免恶意合约触发你的业务逻辑。
• 代币兼容性：确保转账的代币是CCIP支持的跨链代币，或符合标准的自定义代币。

内容的提问来源于stack exchange，提问作者Nicksta