SolidRPC

SolidRPC Agent 工具包

让 Agent 在你批准的预算内将应用连接到区块链 RPC。SolidRPC 通过一次 RPC 集成，处理路由、故障转移、监控和恢复。

此仓库包含 Node.js 管理客户端、本地 MCP 服务、Agent 技能以及可运行的 RPC 示例。也可使用托管的 MCP 端点：https://api.solidrpc.io/agent/mcp。

从这里开始

阅读 Agent 入门指南和设置指南。实时入门响应会提供可用性、支付网络、条款、定价、限制和恢复步骤。请在设置时读取这些信息。

对于现有账户，请从付费套餐或 PAYG 账户委托 Agent 凭证。免费账户无法委托 Agent 控制权限。对于新账户，请取得账户所有者的电子邮箱、账户创建和条款批准，以及单独的支付和使用限额。创建账户本身不会产生任何费用。激活 Agent 不需要验证电子邮箱，也不需要密码。所有者之后可以认领控制面板访问权限。

凭证	用途	目标地址
sa_ 管理令牌	账户、密钥、使用情况和账单	https://api.solidrpc.io/agent/v1 和 /agent/mcp
ak_ RPC 密钥	区块链请求	/networks 返回的 RPC URL

安装

需要 Node.js 22.20 或更高版本。在此工具包的下载副本中：

npm ci --ignore-scripts
npm test
node src/cli.mjs request GET /onboarding

从 npm 安装固定版本：

npm install --global @solidrpc/[email protected]
solidrpc --help
solidrpc request GET /onboarding

CLI 和本地 MCP 服务包含在这一个软件包中。运行 solidrpc mcp 即可启动 MCP 服务。发行版下载包含 npm 压缩包、源代码 ZIP 和桌面 MCP 软件包。该软件包包含运行时依赖，并需要 Node.js 22.20 或更高版本。

进行开发时，请使用上面的源码命令，或安装本地构建的压缩包。已发布的下载文件可在 GitHub Releases 获取。有关审核和验证，请参阅发行流程。

向 Agent 授予访问权限

仅将 sa_ 令牌保存在仓库之外、仅所有者可访问的文件中。将 SOLIDRPC_TOKEN_FILE 配置为该文件的绝对路径。也可以通过密钥管理器提供 SOLIDRPC_TOKEN。请选择其中一种来源。

export SOLIDRPC_TOKEN_FILE=/absolute/private/solidrpc-management.key
solidrpc request GET /me
solidrpc request GET /networks
solidrpc mcp

从源码检出版本运行时，将 solidrpc 替换为 node src/cli.mjs。

Codex、Claude Code/Desktop 和 Cursor 的 MCP 设置模板位于 configs。这些模板使用本地进程和令牌文件。服务会读取该文件，并默认将令牌发送到 SolidRPC 管理 API。显式设置 SOLIDRPC_URL 可将其指向环回开发服务器。切勿在环回测试中使用真实凭证。重定向会被拒绝。

设置 SOLIDRPC_READ_ONLY=1 可在本地强制启用只读会话。服务仍会公布完整的工具目录，但会在发起网络调用之前阻止所有变更操作、凭证操作和 RPC 密钥机密读取。账户权限仍以服务端凭证范围为准。

账户开通与恢复

在入门流程中阅读条款 URL 和当前修订版本。获得所有者批准后，通过标准输入发送 JSON：

node src/cli.mjs provision < /absolute/private/approved-account.json

输入包含 email、termsRevision 和 acceptTerms: true。CLI 会在发起网络请求前保存引导密钥。如果响应丢失，请使用相同的输入和配置文件重试。使用 SOLIDRPC_PROFILE 区分不同账户。

按照实时入门步骤签署已批准的预算并为账户充值。已发布的付款示例介绍了外部钱包流程。此工具包不会持有钱包密钥，也不会自动付款。提交前，请私下保存幂等键和付款证明。对于状态不确定的付款，请检查现有充值意向，并按照其中的恢复说明操作。切勿为了猜测第一次付款是否成功而再次付款。

充值结算后，轮换引导凭据以获取操作范围。solidrpc rotate 会在停用旧凭据前保存替换凭据和私有轮换记录。其输出包含范围和引导状态。如果停用失败，它会返回 replacementSaved:true 和 oldRevoked:false，并以退出代码 2 结束。运行 solidrpc retire-previous 可重试停用，而无需创建其他凭据。对于外部令牌文件或密钥管理器，请使用显式管理请求，并在撤销旧令牌前保存替换令牌。如果轮换请求的响应丢失，旧令牌仍可使用。重复轮换可能产生未关联的凭据，因此请仔细检查并停用这些凭据。

solidrpc request 会输出 API 响应。创建密钥和轮换凭据可能会返回机密信息。在 POSIX shell 中，请使用仅所有者可访问的目录，并创建权限受限的新输出文件。例如，使用已批准的密钥创建输入：

(umask 077; set -C; solidrpc request POST /keys \
  < /absolute/private/approved-key-request.json \
  > /absolute/private/created-key.json)

每次尝试都使用新的输出文件名；重试同一请求时，重复使用相同的幂等键。在 Windows 上，请使用仅所有者可访问的目录和文件 ACL。仅凭 sa_ 凭据无法批准钱包预算。购买卡订阅仍须由所有者操作。

工具

MCP 服务提供网络发现、RPC 密钥列表／创建／撤销、用量、账单、充值报价、支持工单以及通用管理请求工具。充值报价不会转移 USDC。创建支持工单会发送消息，因此只有在所有者要求联系时才使用。对于写入操作和付款，客户端必须保留自己的审批控制。

示例

使用单独的 ak_ 密钥，并将其保存在由 RPC_KEY_FILE 指定的私有文件中，同时设置 RPC_ORIGIN=https://rpc.solidrpc.io。这些脚本会发起计费读取请求，需要已批准的用量预算。运行前请阅读 examples/README.md。

• Base 上的 ETH 和 USDC 余额
• Ethereum USDC 转账导出
• Ethereum、Base 和 Arbitrum 连通性

Agent 技能

该技能位于 skills/solidrpc/SKILL.md。若要从其他项目安装此本地检出版本，请使用 skills CLI：

npx skills add /absolute/path/to/agent-toolkit --skill solidrpc -a codex claude-code cursor

对于 Cursor，如果共享技能未列出，请将同一个 SKILL.md 复制到项目中的 .cursor/skills/solidrpc/SKILL.md，然后启动新会话。Codex 使用 .agents/skills/solidrpc/SKILL.md，Claude Code 使用 .claude/skills/solidrpc/SKILL.md。

直接从此公开仓库安装该技能：

npx skills add SolidRPC/agent-toolkit --skill solidrpc -a codex claude-code cursor

同一技能也包含在 npm 包和发布下载文件中。安装技能后，它会在该客户端中可用，但这并不意味着每个 Agent 都会发现或优先选择 SolidRPC。

开发

运行 npm test 和 npm run check:public。切勿将凭据、本地配置文件、钱包密钥、私有基础设施配置或未公开的运维记录添加到此代码库。公开软件包是从现有的 SolidRPC 客户端提取而来，并针对本地安全性和打包方式进行了调整。

通用 MCP 工具故意不提供凭据操作。请使用 CLI，或使用显式 API 工作流，在停用旧凭据前先保存替换凭据。只读模式也会阻止检索机密信息。在普通 MCP 模式下创建 RPC 密钥时，工具结果仍会返回新密钥，因此客户端的对话记录可能会包含该密钥。如果需要避免密钥出现在模型对话记录中，请将 CLI 请求的输出重定向到私有文件。

配置必须存储在专用私有目录中。CLI 会拒绝使用共享目录，而不会更改其权限。在 POSIX 系统上，它还会拒绝其他用户可访问或归属他人的令牌文件。在 Windows 上，请自行配置仅限所有者访问的 ACL。帮助和版本命令不会加载凭据。