SolidRPC

SolidRPC エージェントツールキット

承認済みの予算内で、エージェントがアプリケーションをブロックチェーン RPC に接続できるようにします。SolidRPC は、1 つの RPC 統合の背後でルーティング、フェイルオーバー、監視、復旧を処理します。

このリポジトリには、Node.js 管理クライアント、ローカル MCP サーバー、エージェントスキル、実行可能な RPC の例が含まれています。ホスト型 MCP エンドポイントも https://api.solidrpc.io/agent/mcp で利用できます。

まずはこちら

エージェントのオンボーディングとセットアップガイドをお読みください。オンボーディングのライブレスポンスには、利用可能状況、決済ネットワーク、利用規約、料金、制限、復旧手順が含まれます。セットアップ時にこれらの値を確認してください。

既存アカウントの場合は、有料プランまたは PAYG アカウントからエージェント認証情報を委任してください。無料アカウントではエージェント制御を委任できません。新しいアカウントの場合は、所有者のメールアドレス、アカウント作成と利用規約への承認、決済上限と利用上限を別々に取得してください。アカウントのプロビジョニング自体に費用はかかりません。エージェントを有効化するために、メール確認やパスワードは必要ありません。所有者は後からダッシュボードへのアクセス権を取得できます。

認証情報	用途	接続先
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 サーバーは、この 1 つのパッケージに含まれています。solidrpc mcp を実行して MCP サーバーを起動します。リリースのダウンロードには、npm tarball、ソース ZIP、デスクトップ MCP バンドルが含まれます。このバンドルにはランタイム依存関係が含まれており、Node.js 22.20 以降が必要です。

開発には、上記のソースコマンドを使用するか、ローカルでビルドした tarball をインストールしてください。公開済みのダウンロードはGitHub Releasesで利用できます。レビューと検証については、リリース手順を参照してください。

エージェントにアクセス権を付与する

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 は、置き換え用の認証情報と非公開の廃止ジャーナルを保存してから、古い認証情報を廃止します。出力にはスコープとブートストラップのステータスが含まれます。廃止に失敗した場合、終了コード 2 で replacementSaved:true および oldRevoked:false が返されます。新たな認証情報を作成せずに廃止を再試行するには、solidrpc retire-previous を実行します。外部のトークンファイルまたはシークレットマネージャーを使用する場合は、明示的な管理リクエストを使用し、古いトークンを失効させる前に置き換え用のトークンを保存してください。ローテーションの応答が失われた場合、古いトークンは引き続き使用できます。ローテーションを繰り返すと孤立した認証情報が作成されることがあるため、確認して慎重に廃止してください。

solidrpc request は API の応答を出力します。キーの作成と認証情報のローテーションでは、シークレットが返される場合があります。POSIX シェルでは、所有者のみがアクセスできるディレクトリを使用し、プライベートなアクセス権で新しい出力ファイルを作成してください。たとえば、承認済みのキー作成入力を使用する場合は、次のようにします。

(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 が送金されることはありません。サポートチケットを作成するとメッセージが送信されるため、オーナーから連絡を依頼された場合にのみ使用してください。クライアントは、書き込みと支払いに対する独自の承認制御を維持する必要があります。

使用例

RPC_KEY_FILE で指定したプライベートファイルに別の ak_ キーを保存し、RPC_ORIGIN=https://rpc.solidrpc.io を設定してください。これらのスクリプトは課金対象の読み取りリクエストを実行するため、承認済みの使用予算が必要です。実行前に examples/README.md をお読みください。

• Base の ETH および USDC 残高
• Ethereum の USDC Transfer エクスポート
• Ethereum、Base、Arbitrum の接続性

エージェントスキル

スキルは 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 パッケージとリリースのダウンロードにも含まれています。スキルをインストールすると、そのクライアントで利用できるようになります。ただし、すべてのエージェントが SolidRPC を検出したり、優先的に使用したりするわけではありません。

開発

npm test と npm run check:public を実行してください。認証情報、ローカルプロファイル、ウォレットキー、非公開のインフラストラクチャ設定、または未公開の運用記録を、このリポジトリに追加しないでください。公開パッケージは、既存の SolidRPC クライアントを抽出し、ローカルでの安全対策とパッケージングの調整を加えたものです。

認証情報の操作は、汎用 MCP ツールでは意図的に利用できないようになっています。CLI、または古い認証情報を無効にする前に新しい認証情報を保存する明示的な API ワークフローを使用してください。読み取り専用モードでは、シークレットの取得もブロックされます。通常の MCP モードで RPC キーを作成すると、新しいキーは引き続きツールの結果として返されるため、そのクライアントのトランスクリプトに含まれる可能性があります。キーをモデルのトランスクリプトに含めたくない場合は、CLI のリクエストを非公開ファイルにリダイレクトしてください。

設定を保存する場所には、専用の非公開ディレクトリを使用する必要があります。CLI は共有ディレクトリの権限を変更せず、そのようなディレクトリを拒否します。POSIX システムでは、他のユーザーがアクセスできるトークンファイルや、所有者が異なるトークンファイルも拒否します。Windows では、所有者のみがアクセスできる ACL を自分で設定してください。ヘルプコマンドとバージョンコマンドは、認証情報を読み込みません。