跳转到主要内容
Bridge Module 连接 Multichain Virtual Environment 中的各个网络。启用后,源链上一笔发出桥事件的交易会触发同一 Virtual Environment 内目标链上的对应投递。中继以您配置的模式(立即或延迟)运行,并且不使用真实资金。
Bridge Module 在包含多链能力的计划中可用。联系我们以在您的账户上启用。

启用 Bridge Module

打开您的 Virtual Environment 的 Settings 页面并展开 Advanced 面板。勾选 Bridge(“Enable cross-network bridge”),然后 Save Changes。启用后,中继覆盖附加到 Virtual Environment 的网络上所有受支持的协议。 两个设置控制消息中继方式:
  • Relay mode:Auto relay 一旦检测到源事件就立即投递目标交易。Delayed relay 将投递延迟一个固定间隔,以便您测试在途时序和目标链延迟。
  • Delayed relay seconds:Delayed relay 模式下应用的延迟(例如 3600)。
Bridge settings Advanced panel showing the Bridge enable checkbox, a Relay mode dropdown set to Delayed relay, a Delayed relay seconds field set to 3600, and the supported protocols Layer Zero, Chainlink, Across, and CCTP with descriptions

Bridge Settings → Advanced:Bridge 启用复选框,Relay mode(Auto relay / Delayed relay)以及一个延迟秒数字段,还有支持的协议 Layer Zero、Chainlink、Across 和 CCTP。

该模块只在协议合约已部署的地方中继。如果协议在您 Virtual Environment 的某个网络上不存在,则该路由不可用。Bridge contracts 面板显示每个网络上部署了哪些协议路由合约。

支持的协议

LayerZero 中继覆盖标准全链消息和组合消息。LayerZero Read 请求仅在 Ethereum Mainnet 上中继。 当接收方 OApp 在 lzReceive 期间通过 endpoint.sendCompose 将组合调用加入队列时,模块会在目标链上以单独的 lzCompose 交易投递每个排队的调用,并转发消息 compose 选项中设置的 gas 和 value。只有在所有组合调用都执行完毕后,桥接操作才会完成。如果某个组合调用回滚,模块会通过 lzComposeAlert 在目标端点记录该失败,并将操作标记为失败,同时注明该组合调用的索引、OApp 和 composer。 Chainlink CCIP 中继会自动跟随 lane 的版本:模块检测每个 ramp 版本的发送事件,并通过匹配的 OffRamp 投递,因此从 v1.6 迁移到 v2.0 的 lane 无需更改配置即可继续中继。在 v2.0 lane 上,模块在 Virtual Environment 内部处理 Cross-Chain Verifier(CCV)步骤,无需链下委员会签名。需要链下认证的代币转移(例如通过 CCTP 支持的代币池转移 USDC)在任何 CCIP 版本上都不会被中继。

支持的网络

Bridge 协议的可用性比整体网络支持范围要窄,因为 Bridge Module 依赖于给定网络上存在真实的协议合约。初始覆盖: 各网络的 protocol 支持情况取决于 protocol 自身的部署。对于 Chainlink CCIP,请查阅 CCIP Directory 以确认 CCIP 支持哪些网络。 覆盖范围会根据客户需求扩展。如果您需要为某个桥协议启用特定网络,请通过 support@tenderly.co 联系我们。

Bridge 仪表板

Overview 选项卡为您提供对 Virtual Environment 中所有桥活动的运维可见性:
  • Top routes:每个源到目标的网络对、其协议以及已中继的操作数量。
  • Bridge contracts:每个网络上部署的协议路由合约,包括网络、合约名称、地址和协议。
  • Bridge transactions:每笔已中继操作的列表,包含其状态、源网络和交易、目标网络和交易、协议以及相对时间。自动刷新间隔控件让列表保持最新。
Bridge Overview tab showing a Top routes panel (route, protocol, relayed count), a Bridge contracts panel (network, name, address, protocol), and a transaction list with status, source and destination networks and transactions, protocol, and relative time

Bridge Overview:Top routes 和 Bridge contracts 面板位于已中继操作列表上方,包含 Layer Zero、Across、Chainlink 和 CCTP 在 Ethereum、Arbitrum、Optimism、Base 和 Polygon 上的路由。

要确认一次往返,找到源交易(例如一次 LayerZero PacketSent),并沿着它所在的行找到匹配的目标交易(lzReceive)。

桥操作详情

选择某一行会打开桥操作,其中显示协议、总体状态以及构成跨链消息的一系列交易:每一步的网络、状态、函数(例如 verify、lzReceive)、区块、交易哈希、发送方、接收方和使用的 gas。Input 查看器呈现已解码的消息载荷(srcEid、dstEid、guid、options、sendLibrary),并有 Decoded/Raw 切换。
Bridge operation detail page showing protocol layerzero with completed status, a table of constituent transactions with functions verify and lzReceive and their gas used, and a decoded input payload with srcEid, dstEid, guid, options, and sendLibrary fields

单个桥操作:协议和状态、组成它的各笔交易及其函数和 gas 使用量,以及已解码的消息载荷。

被 curse 的 CCIP lane:CursedByRMN 与 BadARMSignal

以 CursedByRMN 或 BadARMSignal 回滚的 CCIP 消息遇到了 curse,也就是 Chainlink 对 CCIP 的链上暂停机制。Chainlink 的 Risk Management Network(RMN)通过把 chain selector 加入 RMN 合约中的 cursed subjects 来暂停一条 lane。Virtual Environment 会连同其余链状态一起分叉该合约,因此在分叉区块处被 curse 的 lane 在您的 Virtual Environment 中同样被 curse。要使用这条 lane,请通过 Admin RPC 在 Virtual Environment 中解除 curse。 每个网络检查自己的 RMN 合约,因此 lane 可能在源网络、目标网络或两者上被 curse: Subject 是填充到 16 字节的 chain selector。全局 subject 0x01000000000000000000000000000001 会暂停其所在网络上的 CCIP。

在 Virtual Environment 上解除 curse

针对需要修复的网络运行此脚本。它需要该网络的 Admin RPC URL、该网络的 CCIP Router 地址,以及 lane 另一端网络的 chain selector。CCIP Directory 列出了每个网络的 Router 地址和 chain selector。示例中的值会在 Virtual Environment 的 Ethereum Mainnet 网络上解除对 OP Mainnet selector 的 curse。 只有 RMN 的 owner 才能调用 uncurse。脚本使用 tenderly_setStorageAt 把调用方地址写入 owner 存储槽,从该地址调用 uncurse,然后写回原来的 owner。
lift-curse.sh
脚本从 Router 读取 RMN 合约地址。CCIP Directory 中的 RMN 地址是一个代理,对它调用 uncurse 会失败。 当该 subject 不再出现在 getCursedSubjects() 中后,请重新发送消息。在 lane 被 curse 期间发送的消息,在 curse 解除后不会被中继。

对 lane 施加 curse 以测试暂停的桥

要测试您的应用如何处理暂停的 lane,请运行同一脚本,并把 uncurse(bytes16[]) 换成 curse(bytes16[])。在源网络上 curse 目标链的 chain selector 会使 ccipSend 回滚。在目标网络上 curse 源链的 chain selector 时,ccipSend 成功,而目标交易回滚。 运行原始脚本即可解除 curse。

何时使用桥接

另请参阅