Wormhole GitHub 仓库导航：核心模块与上手编译完全指南

Wormhole 是开源项目，所有协议代码都托管在 GitHub 上的 wormhole-foundation 组织下。仓库目录庞大、模块众多，新人很容易迷路。本文按模块依赖顺序，把仓库结构与上手编译路径梳理清楚。

一、组织与主仓库

GitHub 组织 wormhole-foundation 下的核心仓库是 wormhole，其余仓库覆盖 SDK、SDK 文档、Spy 监控、Token Bridge 等。建议第一次访问先 fork 主仓库到自己账号，再 clone 到本地。

二、目录结构速览

• ethereum/：Solidity 合约，包括 Core Bridge、Token Bridge；
• solana/：Solana 程序，Rust 实现；
• node/：Guardian 节点的 Go 代码；
• sdk/：JS、Rust、Python 多语言 SDK；
• relayer/：通用 Relayer 服务；
• proto/：Protocol Buffers 定义。

三、本地编译第一个示例

按以下步骤可以在 30 分钟内跑通最小示例：

git clone https://github.com/wormhole-foundation/wormhole
cd wormhole/ethereum && pnpm install && pnpm build
cd ../solana && cargo build-bpf

如果做联调需要 ETH，直接从 Binance官网 提一些到主网钱包即可，Binance提币 选择 ERC20 网络一般 5 分钟内到账。

四、SDK 与工具仓库

• wormhole-sdk-ts：TypeScript SDK，前端集成首选；
• wormhole-sdk-rust：Rust SDK，适合后台服务；
• relayer-engine：基于 TypeScript 的通用 Relayer；
• wormhole-explorer：浏览器与索引器。

如果你的项目涉及与中心化交易所对接，记得在 PR 描述里同步 Binance合约 与 Binance现货 团队所需的合约 ABI 与白名单地址，方便上币审核团队复用。

五、贡献流程与文档

Wormhole 采用标准的 GitHub Flow：fork → 新分支 → PR → CI → review → merge。所有 PR 必须附上单元测试与 changelog。社区在 Discord 的 #contributor 频道有专门 channel，新人可以先做 documentation 类 PR 熟悉流程。

上线后建议把 Binance充值 入金事件与 wormhole-explorer 索引到的桥事件做日终对账，差异 > 0.05% 立即报警；同时通过 GitHub Actions 跑安全扫描，把审计左移到代码评审阶段。

写在最后

Wormhole 仓库虽然庞大，但只要按照模块依赖顺序逐层探索，新人也能在两周内成为有效的贡献者。结合本文提供的目录导航、编译路径与对账实践，你的多链工程能力可以快速积累到上线水准。