Hyperlane 极简教程

2025年6月6日 · 阅读需 5 分钟

YaCo

PraxisGrove Founder / HyperlaneCC Builder

marcus

Hyperlane APEC Lead

hyperlane 中文

Hyperlane 中文团队

什么是 Hyperlane

Hyperlane 被描述为跨链基础设施, 它提供命令行工具用于将 Hyperlane 合约部署到新链以及与已部署合约和注册表交互, 它是构建跨链代币桥 (如 Warp Routes) 的基础。今天我们就来使用hyperlane 推荐 warp 工具构建自己专属的 warp route。

Hyperlane 跨链最佳实践

明确目标

我们的目标是将 Monad 的原生代币跨链到 Sepolia，MON 在 monadtestnet 上是原生代币(native)，而在 sepolia 上并不存在，那么怎么做呢，我们授权给 hyperlane 直接发一个(synthetic)

这是我做的最终结果，打开看看吧

Hyperlane Bridge MonadTestNet Sepolia

superbridge.mon.monadtest2sepolia

部署 Hyperlane 环境

在国内搞开发的同学可能都知道，最复杂的不是coding环节，而是环境部署以及网络代理，来吧，跟着我一起 cook吧

领水(买菜)

monad

https://faucet.monad.xyz/ (免费)
https://faucet.openbuild.xyz/monad (免费)

sepolia

如果以上方法都不行，请关注下方公众号，加入 hyperlane 中文社区的微信群，或者直接微信添加好友搜 hyperlane 添加小助手

hyperlane_wechat_rpc

环境搭建(准备好锅碗)

Linux/Windows/Mac/WSL 均可

Hyperlane 提供了完备兼容的环境供开发者使用(如果使用体验不佳请及时找到我们)，保证你只要有一台电脑，都可以执行。

如果你担心在本地部署不安全而且没有云服务器，笔者推荐：推荐使用 https://labs.play-with-docker.com/ 免费的在线 linux docker 参与实践，保证你在任何条件下都可以参与

Node 下载 ⏬

https://nodejs.org/zh-cn/download

Hyperlane CLI 环境部署 🚀

安装 🐚

npm install -g @hyperlane-xyz/cli

检查 ✔️

hyperlane --version

# 实际操作
npm install -g @hyperlane-xyz/cli
added 1 package in 2s
hyperlane --version
Hyperlane CLI
13.2.1

恭喜你，环境已经部署好了，我们现在已经完成一半了，下面大概10条命令就结束了。

开始跨链

看看案例 👉 https://explorer.hyperlane.xyz/

我现在在看的是sepolia 和 monadtestnet

hyperlane.testmonad2sepolia

可以看到有许多已经跨链成功的案例，好吧，我们也行动吧

初始化(洗菜)

hyperlane warp init

warp.init.mon.testmonad2sepolia

选择测试网

monadtestnet
sepolia

根据提示输入地址(Enter the desired owner address): 输入你自己的地址

确认并选择公链代理地址 ⬇️

https://github.com/hyperlane-xyz/hyperlane-registry/blob/main/chains/

选择对应链，复制并输入

proxyAdmin.monadtestnet.hyperlane.registry

下面给出终端实际操作情况，仅供参考

$/ hyperlane warp init
Hyperlane CLI
Hyperlane Warp Configure
________________________
Creating a new warp route deployment config...
? Select network type Testnet
? Select chains to connect monadtestnet, sepolia
? Is this chain selection correct?: monadtestnet, sepolia yes
monadtestnet: Configuring warp route...
? Enter the desired owner address: 0x459115d03992914fDc832A14a03da78a1e4d87B8
? Use an existing Proxy Admin contract for the warp route deployment on chain "monadtestnet"? yes
? Please enter the address of the Proxy Admin contract to be used on chain "monadtestnet": 0x6966b0E55883d49BFB24539356a2f8A673E02039
? Do you want to use a trusted ISM for warp route? yes
? Select monadtestnet's token type native
sepolia: Configuring warp route...
? Enter the desired owner address: 0x459115d03992914fDc832A14a03da78a1e4d87B8
? Use an existing Proxy Admin contract for the warp route deployment on chain "sepolia"? yes
? Please enter the address of the Proxy Admin contract to be used on chain "sepolia": 0x97Bbc6bBaFa5Ce3b2FA966c121Af63bD09e940f8
? Do you want to use a trusted ISM for warp route? yes
? Select sepolia's token type synthetic
Warp Route config is valid, writing to file undefined:

    monadtestnet:
      type: native
      owner: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
      interchainSecurityModule:
        type: staticAggregationIsm
        modules:
          - type: trustedRelayerIsm
            relayer: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
          - owner: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
            type: defaultFallbackRoutingIsm
            domains: {}
        threshold: 1
      proxyAdmin:
        owner: "0xfaD1C94469700833717Fa8a3017278BC1cA8031C"
        address: "0x6966b0E55883d49BFB24539356a2f8A673E02039"
    sepolia:
      type: synthetic
      owner: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
      interchainSecurityModule:
        type: staticAggregationIsm
        modules:
          - type: trustedRelayerIsm
            relayer: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
          - owner: "0x459115d03992914fDc832A14a03da78a1e4d87B8"
            type: defaultFallbackRoutingIsm
            domains: {}
        threshold: 1
      proxyAdmin:
        owner: "0xfaD1C94469700833717Fa8a3017278BC1cA8031C"
        address: "0x97Bbc6bBaFa5Ce3b2FA966c121Af63bD09e940f8"
    
? Using warp route ID as MON/sepolia from warp deployment config, is this correct? yes
Skipping adding warp route deploy config at github registry
Now adding warp route deploy config at filesystem registry at /root/.hyperlane
Done adding warp route deploy config at filesystem registry
✅ Successfully created new warp route deployment config with warp route id: MON/sepolia

最终的结果是输出一个 warp route id：MON/sepolia，记住它

部署(开炒)

hyperlane warp deploy

warp.deploy.mon.testmonad2sepolia

我是直接输入的私钥，你可以提前使用命令，设置私钥，更加方便

export HYP_KEY=<your_private_key>

设置好之后，就是等待了，你会看到非常漂亮的界面刷新，再等等，大概2分钟

pass.warp.deploy.mon.monadtest2sepolia

最后，我们等到合约在两个链上都成功部署，显然，我们很顺利。

最后输出了下面的注册信息，这个很关键。

complete.warp.deploy.mon.monadtest2sepolia

接下来，我们复制下方从 token 开始到结束的 yml 信息。

tokens:
  - chainName: monadtestnet
    standard: EvmHypNative
    decimals: 18
    symbol: MON
    name: MON
    addressOrDenom: "0xc842d08f315C9b3fC3EFc8E33898C88BB2d01b7B"
    connections:
      - token: ethereum|sepolia|0x7871782876A2Ebe383cF157eCD4aB58f37c3659D
  - chainName: sepolia
    standard: EvmHypSynthetic
    decimals: 18
    symbol: MON
    name: MON
    addressOrDenom: "0x7871782876A2Ebe383cF157eCD4aB58f37c3659D"
    connections:
      - token: ethereum|monadtestnet|0xc842d08f315C9b3fC3EFc8E33898C88BB2d01b7B