跳到主要内容

加入网络

HyMatrix 是一个支持全球节点异步参与的去中心化计算网络。任何用户都可以通过运行节点参与网络计算、日志提交与经济激励。

本章节将指导你如何将本地节点接入 HyMatrix 测试网络（Testnet），完成身份注册、质押和上线验证。

节点加入前的准备条件​

加入网络前，请确保你已满足以下条件：

  • ✅ 拥有一台具备公网 IP 或域名的服务器：网络中所有其他用户需能访问你的节点地址；
  • ✅ 已完成节点环境部署，具备运行能力；
  • ✅ 钱包密钥已安全保存，避免私钥泄露导致节点身份丢失或质押资产被盗；
  • ✅ 已拥有至少 1 枚 tAX 测试代币，用于节点注册时质押。

🔐 HyMatrix 节点注册流程涉及签名、身份绑定与质押转账，请确保你的密钥不会暴露于日志、公网或他人控制下的服务。

第一步：获取 tAX 测试代币​

HyMatrix 测试网使用 tAX（Test AX）代币作为质押与注册凭证。

目前，获取方式如下：

  • 方式一：联系 Hymatrix 开发者获取 tAX；
  • 方式二（即将开放）：通过水龙头领取测试币（Faucet Service）；

📌 请确保你的钱包地址中拥有至少 1 个 tAX，否则无法完成网络注册。

第二步：配置测试网参数​

将以下配置保存为 config.yaml 文件：

# 节点服务
port: :80
ginMode: release  # 可选值: "debug", "release"

# Redis 配置
redisURL: redis://@localhost:6379/0

# 存储与网络
arweaveURL: https://arweave.net
hymxURL: https://hymatrix.ai  # 主节点地址，必须为主网接入地址

# 节点身份（钱包）
# 请填写你的 Ethereum 私钥或 Arweave 钱包路径，二选一
prvKey: <your private key>
keyfilePath:

# 节点信息
nodeName: mynode
nodeDesc: join the test network
nodeURL: https://mynode.com     # 必须为公网可访问地址

# 网络接入
joinNetwork: true

📌 重点说明：

字段要求与说明
nodeURL必须为公网地址或域名，能被其他用户访问
hymxURL请填写当前主节点地址，作为注册与通讯入口
prvKey用于节点注册与签名身份，确保私钥安全
joinNetwork: true必须开启，表示自动完成节点注册流程

第三步：启动并验证节点​

在配置完成后，运行如下命令启动节点：

./hymx --config ./config.yaml

启动成功后，节点将自动完成以下操作：

  • 提交注册信息至 Registry；
  • 使用钱包自动质押 1 枚 tAX；
  • 节点信息在网络中公开，其他用户可向该节点请求服务。

✅ 验证是否注册成功：

curl https://mynode.com/info

查看返回信息中包含你设置的节点名称、地址，即表示节点已注册成功。

还可以查看全网节点列表：

curl https://mynode.com/nodes

若返回包含你的 nodeURL，说明注册信息已同步至网络。

⏹️ 关闭节点：

  • 在 Linux 或 Windows 系统中：使用 Ctrl + C 停止节点进程；
  • 在 macOS 系统中：使用 Command (⌘) + C 停止节点进程。

节点停止后，系统会自动释放质押的 tAX 并退出网络注册状态。