用途:面向在 Hedera 与 EVM 链之间构建 OFT / OApp 跨链桥的场景,基于 LayerZero V2 与 Hedera HTS 提供操作指引。
主要能力:OFT 模式部署成对的全链同质化代币——EVM 侧标准 OFT 与 Hedera 侧 HTS 连接器 OFT,双向 setPeer 后以 LayerZero V2 费用发送。涉及 Endpoint V2、ULN、DVN、Executor 配置,以及 quoteSend→send 发送流程。
关键规则:每条链使用 ILayerZeroEndpointV2;两侧均调用 setPeer(remoteEid, bytes32(uint256(uint160(remoteOApp))));发送用 quoteSend(SendParam, payInLzToken) 后 send{value: nativeFee}(SendParam, fee, refund);SendParam 中 to 为 bytes32 补齐地址;peer 与 dstEid 使用 LayerZero EID 而非 EVM chain ID。
Hedera 侧语义:不要用普通 ERC-20 OFT 作主路径,应使用 HTS 连接器:构造函数经预编译 0x167 创建 HTS 代币(供应方为连接器),_debit 时转入并销毁,_credit 时铸造并转出;金额须适配 int64;EVM→Hedera 前接收账户需先关联该 HTS 代币;部署需带原生值支付 createFungibleToken 费用:new HTSConnectorOFT{ value: htsCreateValue }(name, symbol, lzEndpoint, owner);Hedera→EVM 发送前用户须 approve(connector, amount)。
使用方式与配置:为每个本地 OApp 完成 setPeer、setSendLibrary / setReceiveLibrary(ULN302)、setConfig(发送库 ExecutorConfig type 1;收发库 UlnConfig type 2)、setEnforcedOptions(如 msgType 1 的 lzReceive gas),并在两侧用 peers(remoteEid) 校验。部署清单含 EVM OFT、HTS 连接器 OFT、workers、双向接线、关联代币、同步前端配置、小额试发并用 LayerZero Scan 跟踪。
限制:教育模板可能使用简单 worker 与手动/UI lzReceive 中继,不等同于生产级 LayerZero Labs 验证;Hedera JSON-RPC 的 wei/tinybar 缩放可能使 forge 费用模拟与实际不符,该方向常需用 cast 报价并按比例调整原生费用。资料明确标注模板未经审计、不可用于主网资金。