Nexus CLI：向Nexus网络提供证明的命令行工具

Nexus CLI：向Nexus网络提供证明的命令行工具

技术背景

Nexus CLI 是一个高性能的命令行界面，用于向 Nexus 网络贡献证明。Nexus 是一个全球分布式证明者网络，旨在联合全球的计算机，为一种全新且更优的互联网——可验证互联网提供支持。目前已经有多个测试网和开发网，包括 Testnet 0（2024 年 10 月 8 日 - 28 日）、Testnet I（2024 年 12 月 9 日 - 13 日）、Testnet II（2025 年 2 月 18 日 - 22 日）、Devnet（2025 年 2 月 22 日 - 6 月 20 日）以及正在进行的 Testnet III。

实现步骤

安装

预编译二进制文件（推荐）

使用以下命令进行最简单且可靠的安装：

1
curl https://cli.nexus.xyz/ | sh

此命令将完成以下操作：

  1. 为你的平台下载并安装最新的预编译二进制文件。
  2. 提示你接受使用条款。
  3. 以交互模式启动 CLI。确切的安装脚本可在此处查看。

非交互式安装

对于自动化安装（例如在 CI 中）：

1
2
3
curl -sSf https://cli.nexus.xyz/ -o install.sh
chmod +x install.sh
NONINTERACTIVE=1 ./install.sh

证明

使用现有节点 ID 启动

若要使用现有的节点 ID 开始证明，运行以下命令：

1
nexus-cli start --node-id <your-node-id>

注册钱包地址并创建节点 ID

你可以使用 CLI 注册钱包地址并创建节点 ID，或者在 app.nexus.xyz 上进行操作。

1
2
3
nexus-cli register-user --wallet-address <your-wallet-address>
nexus-cli register-node
nexus-cli start

register-user 和 register-node 命令会将你的凭证保存到 ~/.nexus/config.json。若要清除凭证，运行：

1
nexus-cli logout

若要进行故障排除或查看可用的命令行选项，运行：

1
nexus-cli --help

核心代码

预编译二进制文件安装

1
curl https://cli.nexus.xyz/ | sh

非交互式安装

1
2
3
curl -sSf https://cli.nexus.xyz/ -o install.sh
chmod +x install.sh
NONINTERACTIVE=1 ./install.sh

使用现有节点 ID 启动

1
nexus-cli start --node-id <your-node-id>

注册钱包地址并创建节点 ID

1
2
3
nexus-cli register-user --wallet-address <your-wallet-address>
nexus-cli register-node
nexus-cli start

清除凭证

1
nexus-cli logout

查看帮助信息

1
nexus-cli --help

最佳实践

  • 推荐使用预编译二进制文件进行安装，因为这种方式简单且可靠。
  • 对于自动化安装，使用非交互式安装脚本。
  • 若要跳过交互式环境中的提示，可手动创建 ~/.nexus/config.json 文件并按以下格式填写：
1
2
3
{
    "node_id": "<YOUR NODE ID>"
}

常见问题

  • 使用 CLI 有什么限制？
    若要向网络提交程序进行证明，请联系 [email protected]。
  • 如何触发 GitHub Actions 发布工作流？
    通过命令行创建并推送新的（带注释的）标签，例如：
1
2
git tag -a v0.1.2 -m "Release v0.1.2"
git push origin v0.1.2

通过 GitHub UI 创建发布不会触发工作流，这会导致发布没有 Docker 镜像或二进制文件，从而破坏安装脚本。