Shardeum测试网指南:如何快速获取并使用SHM测试币
【免费下载链接】shardeumShardeum is an EVM based autoscaling blockchain项目地址: https://gitcode.com/GitHub_Trending/sh/shardeum
如果你想在 Shardeum 测试网(Testnet ITN)上开发或体验 DApp,第一步就是搞定SHM 测试币的获取与使用。本文面向新手,用最少代码、最短路径讲清楚:Shardeum 各网络的区别、公共测试网怎么领测试币、本地测试网如何通过 genesis 文件"自助铸造"代币,以及 MetaMask 连接测试网的正确配置方法。跟着做,几分钟内就能在 Shardeum 测试网上跑通第一笔 SHM 转账。
一、先搞懂:Shardeum 有 4 个网络,别连错
Shardeum 是 EVM 兼容的自动扩缩容(autoscaling)区块链,官方仓库里为不同部署场景维护了独立的环境配置文件,位于 environments/ 目录,详细说明见 environments/README.md:
| 网络 | 配置文件 | Chain ID | 用途 |
|---|---|---|---|
| Local(本地) | local.config.json | 8081 | 单机本地开发调试 |
| DevNet(开发网) | devnet.config.json | 8083 | 开发网络部署 |
| TestNet(ITN 测试网) | testnet.config.json | 8082 | 公共测试网,申领测试币 |
| MainNet(主网) | mainnet.config.json | 8080 | 生产环境(真币,勿用于测试) |
💡新手提示:Chain ID 连错是测试网最常见的"坑"。Shardeum 节点会校验每笔交易的 chainId,校验逻辑见 src/utils/validateChainId.ts —— 如果你把钱包指向 8082 却签了主网 8080 的交易,交易会被直接拒绝。
二、公共测试网获取 SHM 测试币(ITN Faucet)
Shardeum 测试网(ITN,Incentivized Test Network)面向所有开发者和用户开放,SHM 测试币在测试网上没有任何真实价值,可以免费申领。
1. 在 MetaMask 中添加 Shardeum 测试网
安装 MetaMask 浏览器插件后,进入"网络设置",手动添加一条自定义网络:
- 网络名称:Shardeum Testnet
- Chain ID:8082
- 货币符号:SHM
- RPC 地址:填 Shardeum ITN 官方公开的 RPC 端点(以官方社区发布的地址为准)
2. 申请测试币(Faucet)
- 复制你在 MetaMask 中的钱包地址(
0x开头); - 通过 Shardeum 官方社区渠道(Discord 等官方入口)找到测试币水龙头(Faucet)申领入口;
- 提交钱包地址,等待发放后刷新 MetaMask 即可看到 SHM 余额。
⚠️ 测试币只在Chain ID 8082的 Shardeum 测试网上有效。转错网络或转错代币都找不回来——反正它也不值钱,但请养成正确配置的习惯。
三、本地测试网"自助铸造":改 genesis 文件直接发币
不想排队等 Faucet?Shardeum 支持在本地跑一套完整的 10 节点测试网络,初始 SHM 余额由 genesis(创世)文件直接决定,想给谁发多少就写多少。
各网络对应的创世文件位于 src/config/ 目录,例如本地网络使用 src/config/local.genesis.json,文件格式如下:
{ "你的钱包地址": { "wei": "200000000000000000000000000" } }3 步给自己发 200,000 枚 SHM
- 写入地址:打开 src/config/genesis.json(本地网络同理),在文件中加入你的钱包地址与余额。余额单位是
wei,注意数量级:上面示例的200000000000000000000000000即 200,000 个 SHM(1 SHM = 10^18 wei); - 重启本地网络,让新创世状态生效;
- 用 MetaMask 连上本地 RPC(默认
http://localhost:8080),余额立刻到账 ✅
这套 genesis 机制同样适用于 devnet.genesis.json、testnet.genesis.json 等各网络文件,区别只是目标网络不同。
四、快速启动 Shardeum 本地测试网
本地网络是整个测试流程的"沙盒",推荐流程如下(完整环境要求见 local-environment-setup.md):
克隆仓库(需要 Node.js 18.19.1 / Rust 1.74.1 环境):
git clone https://gitcode.com/gh_mirrors/sh/shardeum cd shardeum npm ci npm run prepare用环境脚本一键启动,项目提供了 scripts/run-env.sh 便利脚本:
./scripts/run-env.sh local 10 # 本地环境,10 个节点 ./scripts/run-env.sh devnet 15 # 开发网,15 个节点脚本内部通过
LOAD_JSON_CONFIGS环境变量加载 environments/ 下对应的配置并调用shardus start,无需手动改文件。部署 JSON-RPC 服务端:按 README.md 中的 "Running the JSON-RPC Server" 章节安装并启动 RPC 服务(默认
http://localhost:8080),这是 MetaMask 与本地链通信的桥梁。测试完成后清理:
shardus stop && shardus clean
如果你是验证者(validator)开发者,仓库还附带了一套远程调试脚本,可自动建立 SSH 隧道并在 VS Code 中挂载断点,运行效果如下:
在 VS Code 中添加 launch 配置后即可附着到远程节点进程:
脚本说明见 scripts/shardeumValidatorDebuggingScript/README.md。
五、使用测试币的第一笔 SHM 转账
一切就绪后,最简单的验证方式是"给自己转一笔":
- MetaMask 确认当前网络为Shardeum Testnet(8082),余额大于 0;
- 发起一笔 SHM 转账(可转给第二个钱包地址);
- 通过 RPC 或区块浏览器确认交易上链。
常见问题排查 🔧
| 现象 | 原因与解决 |
|---|---|
| 交易被拒绝 / 无效 | 钱包网络 Chain ID 不是 8082,回到 MetaMask 网络设置核对 |
| 余额为 0 | 测试币只对应所在网络;本地网请检查 genesis 文件中是否写入了正确地址并重启网络 |
| RPC 连不上 | 确认 JSON-RPC 服务已启动且端口为http://localhost:8080(本地网) |
| 交易卡住不上链 | 查看节点日志;本地网可用shardus stop后重启 |
六、小结
- 公共测试网(ITN):Chain ID 8082,通过官方 Faucet 免费申领 SHM,适合日常 DApp 联调;
- 本地测试网:通过 src/config/genesis.json 写入地址即可自助发币,完全可控,适合开发调试;
- 配置全部集中在 environments/ 与 src/config/ 两个目录,配合 scripts/run-env.sh 脚本即可在几秒内切换环境。
掌握以上流程,你就拥有了在 Shardeum 生态中"拿币—转账—调试"的完整能力,可以开始部署你自己的智能合约了 🚀
【免费下载链接】shardeumShardeum is an EVM based autoscaling blockchain项目地址: https://gitcode.com/GitHub_Trending/sh/shardeum
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考