使用 ERPC CLI 运行 validator、RPC 节点和您自己的应用

ERPC CLI 是一个命令行,用于管理 18 条链的 RPC 节点、13 条链的 validator、您自己的应用以及您的 ERPC 账户。您提出请求时,ERPC AI 会替您运行它。
本页介绍 ERPC CLI v0.1.0-rc.4,这是一个预发布版本(状态)。
bash
curl -fsSL https://install.erpc.global | sh

使用 ERPC CLI 可以做什么

  • 运行 validator 和 RPC 节点。erpc rpc 在全部 18 条链上运行 RPC 节点,erpc validator 在其中 13 条链上运行 validator,每条链都使用相同的子命令。它们的生命周期命令免费,且无需账户。
  • 在服务器上运行您自己的应用。erpc worker 将您的应用编译为原生 Linux 二进制文件,并在 ERPC VPS 或您自己的服务器上,以经过加固的 systemd 单元运行,中间没有 Docker,也没有运行时。
  • 让应用的密钥不落在服务器的磁盘上。应用的交易密钥和 Secret 从 1Password、您的钥匙串或 erpc 的加密密钥库直接进入 worker 的内存。没有 wallet.json,也没有 .env。
  • 向 ERPC AI 提问。erpc ai 根据 ERPC 的文档和您的账户作答。经您批准,它可以启动按小时计费的 VPS、安装您的 SSH 密钥、关闭密码登录,并只允许来自您地址的 SSH。
  • 调用 RPC 并接收 Webhook。erpc rpc call 使用您已登录的账户调用 Solana 或 Ethereum 主网,或通过 x402 按次付费。erpc webhook 以 POST 方式将 RPC 事件发送到您的 URL。
  • 存储和备份文件。erpc storage 和 erpc backup 将您的文件保存在 ERPC Global Storage 中,文件在离开您的机器之前就已在本机加密。

安装

在 macOS 和 Linux 上:
bash
curl -fsSL https://install.erpc.global | sh
在 Windows 上,于 PowerShell 中运行:
powershell
irm https://install.erpc.global/ps1 | iex
这些 URL 会选择最新稳定版。在项目只有预发布版本期间,它们会选择最近发布的预发布版本。要固定某个版本,请使用 https://install.erpc.global/v0.1.0-rc.4,在 Windows 上使用 https://install.erpc.global/v0.1.0-rc.4/ps1。新版本发布后,边缘缓存和客户端缓存可能会使客户端看到的内容出现延迟。
安装程序会将 erpc 放入 ~/.erpc/bin,并将 ERPC AI 的技能写入 ~/.erpc/skills。已发布的构建适用于 Linux(x86_64、arm64)、macOS(Intel、Apple silicon)和 Windows(x86_64)。

为主网 validator 安装

上面的安装程序不做任何验证。高保障安装路径会在任何内容运行之前检查已签名的发布清单,而且它是目前唯一会做验证的路径,因此主网 validator 的运营者应使用它。每个版本都附带已签名的 release-manifest.json(minisign)、CycloneDX SBOM 和 GitHub 构建来源证明。具体步骤见验证版本。

从源代码构建

bash
git clone https://github.com/elsoul/erpc-cli
cd erpc-cli
cargo build --release
./target/release/erpc --help

免费开始使用

validator 和 RPC 节点的生命周期命令免费,且无需账户。dashboard.erpc.global 上的账户可解锁其余功能:
命令无账户有账户
validator 和 RPC 节点的生命周期是是
erpc ai是
erpc worker是
erpc storage, erpc backup是
bash
erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami
登录与密钥介绍会话和您的密钥保存在哪里。

ERPC CLI 如何保管您的密钥

ERPC CLI 使用 1Password 保存节点清单和受管理的签名密钥备份,并支持使用操作系统的钥匙串保存运营者的凭据。API 令牌和 RPC 密钥在 erpc.toml 中以引用方式指定,从不以值的形式写入;这些值通过标准输入到达服务器,从不出现在命令行上。
节点清单也保存在 1Password 中。共享保险库后,团队中的每个人都可以在自己的机器上管理同一批节点。节点服务器上保留什么取决于链:表格见登录与密钥。

状态

ERPC CLI 处于预发布阶段,版本为 v0.1.0-rc.4。它的命令已经存在,并通过了离线检查。在真实主机上的验收仍在进行中:各链的现状和各链的指南给出了每条链的状态。
只有最新版本会获得安全修复,且迄今为止的每个版本都是预发布版本。请通过 GitHub 私密漏洞报告私下报告漏洞,不要在公开 issue 中报告。
ERPC CLI 是 SLV 的后继者,使用 Rust 编写。其源代码位于 elsoul/erpc-cli,采用 Apache-2.0 许可证。

了解 ERPC CLI

  • 登录与密钥:登录,选择会话的保存位置,并查看每个密钥保存在哪里。
  • erpc ai:在终端中向 ERPC AI 提问,并选择它可以做什么。
  • RPC 与 Webhook:调用 Solana 或 Ethereum 主网,通过 x402 按次付费,并将事件发送到您的 URL。
  • erpc worker 快速开始:制作 HelloWorld,在本机运行,并将其部署到服务器。
  • 导入应用:无需修改代码,部署您已有的应用。
  • 密钥与 Secret:将应用的交易密钥和 Secret 保存在 1Password、钥匙串或密钥库中。
  • 防火墙与 WAF:限制对服务器的访问,并在公开 API 前放置 WAF。
  • 状态与计费:监视应用,查看按小时计算的费用,并备份其状态数据。
  • 出错时:错误消息及处理方法,以及如何恢复服务器。
  • 节点:运行 validator 和 RPC 节点,并找到各链的指南。
  • 命令:所有命令组、全局选项、退出码、存储和备份。