XCM 预编译（XCM Precompile）

最新推荐文章于 2026-06-24 22:22:12 发布

原创最新推荐文章于 2026-06-24 22:22:12 发布 · 1.1k 阅读

18 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#智能合约 #区块链 #solidity #web3 #测试用例

原文作者：PaperMoon团队
XCM（Cross-Consensus Message，跨共识消息）预编译允许 Polkadot Hub 的开发者通过 Solidity 接口，在智能合约中直接使用 XCM 功能。

该预编译部署在一个固定地址：

0x00000000000000000000000000000000000a0000

XCM 预编译提供了三个核心函数：
   •   execute：在本链上执行 XCM 消息
   •   send：向其他链发送跨链消息
   •   weighMessage：估算 XCM 消息的执行成本

本指南将演示如何使用 Remix IDE，通过 Solidity 智能合约与 XCM 预编译进行交互。

注意
XCM 预编译仅提供最底层（barebones）的 XCM 能力。
它具备高度灵活性，但不会帮你封装或抽象 XCM 细节，这些抽象需要由开发者在上层自行构建。

预编译接口

XCM 预编译实现了 IXcm 接口，该接口定义了与 XCM 功能交互所需的结构和方法。接口源码如下：

IXcm.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

/// @dev XCM（跨共识消息）预编译在链上的固定地址
address constant XCM_PRECOMPILE_ADDRESS = address(0xA0000);

/// @title XCM 预编译接口
/// @notice 与 `pallet_xcm` 交互的底层接口
///         调用会直接转发到对应的 dispatchable 函数
/// @dev 文档：
/// @dev - XCM: https://docs.polkadot.com/develop/interoperability
/// @dev - SCALE 编码: https://docs.polkadot.com/polkadot-protocol/parachain-basics/data-encoding
/// @dev - Weight: https://docs.polkadot.com/polkadot-protocol/parachain-basics/blocks-transactions-fees/fees/#transactions-weights-and-fees
interface IXcm {
    /// @notice XCM 执行所使用的 Weight v2 结构
    struct Weight {
        /// @custom:property 基于参考硬件的计算时间消耗
        uint64 refTime;
        /// @custom:property 执行所需的证明大小
        uint64 proofSize;
    }

    /// @notice 使用调用者的 origin 在当前链上执行 XCM 消息
    /// @dev 内部调用 `pallet_xcm::execute`
    /// @param message SCALE 编码的 Versioned XCM 消息
    /// @param weight 执行所允许的最大 Weight
    /// @dev 建议先调用 weighMessage(message) 以确保分配足够的 weight
    function execute(bytes calldata message, Weight calldata weight) external;

    /// @notice 向其他平行链或共识系统发送 XCM 消息
    /// @dev 内部调用 `pallet_xcm::send`
    /// @param destination SCALE 编码的 MultiLocation 目标地址
    /// @param message SCALE 编码的 Versioned XCM 消息
    function send(bytes calldata destination, bytes calldata message) external;

    /// @notice 估算执行某条 XCM 消息所需的 Weight
    /// @param message SCALE 编码的 Versioned XCM 消息
    /// @return weight 包含 refTime 与 proofSize 的 Weight 结构
    function weighMessage(bytes calldata message) external view returns (Weight memory weight);
}

Weight 结构说明

Weight 用于描述 XCM 操作的计算成本，由两个部分组成：
• refTime：在参考硬件上执行所需的计算时间
• proofSize：执行所需的证明数据大小

所有 XCM 消息都必须使用 SCALE 编码（Polkadot 的标准序列化格式）。

如需更多信息，可查看 pallet-xcm 中的 precompiles/IXCM.sol 文件。

与 XCM 预编译交互

你可以在 Remix IDE 中直接使用该接口与 XCM 预编译交互：
1. 在 Remix 中新建一个文件 IXcm.sol

2. 将上面的接口代码粘贴进去
3. 编译该接口（点击按钮或使用 Ctrl + S）

在 Deploy & Run Transactions 面板中：
1. 在合约下拉框中选择 IXcm
2. 在 At Address 输入框中填入预编译地址

0x00000000000000000000000000000000000a0000

3. 点击 At Address 连接到预编译合约

连接成功后，你就可以在 Remix 界面中调用：
   •   execute
   •   send
   •   weighMessage

称重（Weigh）一个消息

weighMessage 用于估算执行某条 XCM 消息所需的计算成本。这一步对于在执行或发送消息前评估资源消耗非常关键。

在 Remix 中，你可以使用一个 SCALE 编码的 XCM 消息来测试，例如：

0x050c000401000003008c86471301000003008c8647000d010101000000010100368e8759910dab756d344995f1d3c79374ca8f70066d3a709e48029f6bf0ee7e

该编码消息表示一组 XCM 指令：
   •   Withdraw Asset
从本链的主权账户或调用者账户中提取资产，供后续 XCM 指令使用
   •   Buy Execution
使用提取的资产购买目标链上的执行时间
   •   Deposit Asset
在扣除执行费用后，将剩余资产存入目标链上的指定账户

该编码消息仅作为示例。你可以根据自己的业务需求构造任意 XCM 消息。

调用成功后，函数会返回一个 Weight 结构，其中包含：
• refTime
• proofSize

它们表示执行该消息所需的预估计算成本。