ZetaChain Docs

在 ZetaChain 上，你可以构建全链应用：这些智能合约能够跨多条区块链读取、写入并管理资产。全链应用极大降低了跨链开发复杂度，让你可以一次构建、处处运行，打造无缝的用户体验。

本页面将帮助你完成环境配置、安装核心工具，并根据你的目标指引合适的教程。

准备工作

开始之前，请确保系统已安装以下工具：

Node.js (opens in a new tab)（建议 v21 及以上）：用于运行 ZetaChain CLI 并管理 JavaScript 依赖。
Yarn (opens in a new tab) 或 npm：项目依赖安装与更新的包管理器，两者任选其一。
Git (opens in a new tab)：项目源码管理与协作的必备工具。
jq (opens in a new tab)：轻量级命令行 JSON 处理器，便于解析 Localnet 输出与编写脚本。
Foundry (opens in a new tab)：快速、模块化的以太坊开发工具包，用于编译合约、管理依赖并运行 Localnet。

安装 ZetaChain CLI：

npm install -g zetachain

ZetaChain CLI 是与你的主要交互工具。你将用它来发起跨链调用、转移代币、追踪跨链交易、在多网络间管理账户、查询余额等。

尝试运行：

zetachain query chains list

该命令会输出当前已接入 ZetaChain 的所有区块链，是验证环境是否配置成功的便捷方式。

对于本地开发，推荐启动 Localnet——一个自包含环境，集成了 ZetaChain、EVM、Solana、Sui 与 TON。无需依赖公共测试网，就能以最快速度构建、测试全链应用。

要运行 Localnet，请确保已安装 Foundry (opens in a new tab)。它提供核心的 EVM 工具链，也是启动本地网络的前提。

如需在 Localnet 中加入非 EVM 链，请参考 Localnet 文档中的额外先决条件。

环境就绪后，以下资源将帮助你与 ZetaChain 交互并开展开发工作。

ZetaChain 同时兼具 Cosmos 链与 EVM 链的特性。你可以使用 Cosmos 浏览器查看区块、验证者与治理活动，也可以使用 EVM 浏览器追踪合约与交易。两类链接均整理在浏览器参考中。

在测试网部署或测试前，你需要获取代币。水龙头页面列出了所有可用水龙头，既提供 ZETA Gas，也提供连接链上的测试代币。

ZetaChain 同时运行主网与测试网。本教程主要针对测试网，但你可随时切换。RPC、链 ID 等信息见网络参考。

若需连接应用、钱包或 Foundry、Hardhat 等框架，需要使用 RPC 节点。ZetaChain 主网与测试网的公共 RPC 均列于 RPC 参考。

Gateway 等核心协议合约已部署在 ZetaChain 上，其地址汇总在协议合约参考。

所有已列入白名单的 ZRC-20 代币及其合约地址，均可在代币参考中查看。

通过 ZetaChain 的 Model Context Protocol (MCP) 服务器，将 Cursor 或 Claude Code 与链上查询、操作相连接。详见 MCP 参考。

环境配置完成后，可直接开始构建。根据目标选择合适的路线：