Peer

peer-cli

Peer の標準エージェントインターフェースです。JSON を優先する単一の CLI、ローカルおよびホスト型 MCP サーバー、プロトコル、インデクサー、マーケット、チェックアウト、Peer Cash のワークフローに対応する単一の生成済みコントラクトを提供します。

• ドキュメントとエージェントが読み取り可能なテキスト：https://agents.peer.xyz
• CLI の正確なスキーマ：agents/tool-catalog.json
• エラーコントラクト：agents/error-catalog.json
• ランタイムプロファイルと件数： agents/runtime-manifest.json

生成ファイルはランタイムレジストリをもとに作成されます。ドキュメント内で別のコマンド一覧を手作業で管理しないでください。

インストール

Node.js 22 以降が必要です。

パッケージ名は peer-protocol-cli です。無関係なスコープなしの peer-cli パッケージはインストールしないでください。

npm install --global [email protected]
peer --help

グローバルにインストールせずに実行するには：

npx -y [email protected] quote --from USD --amount 100 --platform wise

成功時の出力は、デフォルトで JSON です。エラーは常に stderr に標準の JSON エラーエンベロープを出力します。--format table を指定すると、成功時のユーザー向け出力のみが変更されます。

安全性モデル

読み取りコマンドは即時に実行されます。状態を変更する可能性のあるコマンドは、最初にトランザクションまたは API のプレビューを返し、プロセスに --yes が渡された場合にのみ実行されます。

署名者の情報は PEER_PRIVATE_KEY または --wallet-path から取得されます。コマンドラインで秘密鍵を渡すこともできますが、プロセス一覧に表示されます。環境変数または所有者のみが読み取り可能なウォレットファイルの使用を推奨します。永続設定とチェックアウトキャッシュは、所有者のみがアクセスできる権限で書き込まれます。

書き込み可能な MCP プロセス内のすべての書き込みツールが、2 回目の CLI プレビューなしにブロードキャストすることを意図的に許可している場合を除き、--yes を指定してそのプロセスを起動しないでください。

MCP プロファイル

peer mcp では、次の 3 つのプロファイルのいずれかを明示的に指定する必要があります。

• read-only — デフォルトのプロトコル読み取りと Peer Cash の読み取りに対応します。署名やブロードキャストは行いません。
• cash — カストディを分離した peer_cash_* の全機能に対応します。署名なしのトランザクションプランを準備しますが、秘密鍵の受け取り、署名、ブロードキャストは行いません。
• full — 汎用の CLI ベース MCP ツールすべてと Peer Cash に対応します。MCP プロセスの起動時にグローバル --yes が指定されていない限り、汎用の書き込みツールはプレビューを行います。

現在のツール件数は agents/runtime-manifest.json に生成されています。

{
  "mcpServers": {
    "peer": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "mcp",
        "--profile",
        "read-only"
      ]
    }
  }
}

ポータブルな Peer Cash ワークフローには --profile cash を、オペレーター向けの全機能には --profile full を使用してください。

ホスト型 MCP サーバーは、Streamable HTTP 経由で read-only プロファイルのみを公開します。

https://mcp.peer.xyz/mcp

peer mcp --transport http を使うと、同じトランスポートを自分で実行できます。HTTP では cash および full プロファイルは使用できません。これらの権限を持つプロファイルは、ローカルの stdio プロセスとしてのみ実行できます。

Peer Cash

廃止されたスタンドアロンの peer-cash-mcp サーバーは、現在ここに統合されています。ツール名とカストディの境界に変更はありません。

1. peer_cash_capabilities / peer_cash_source_capabilities — 利用可能な出金手段と、Relay がサポートする送金元チェーンおよびトークンを取得します。
2. peer_cash_fill_stats / peer_cash_buyer — 過去の約定情報と購入者のプロトコル履歴を確認します。
3. peer_cash_quote_source / peer_cash_relay_status — 署名権限を付与せずに、Base USDC へのクロスチェーンルートを見積もり、追跡します。
4. peer_cash_estimate — 現在のオラクルレートで受け取る法定通貨の額を見積もります。
5. peer_cash_prepare — 順序付けられた、署名なしの承認および入金トランザクションを返します。
6. peer_cash_finalize — 確認済みのレシートを、永続的な depositId に関連付けます。
7. peer_cash_order / peer_cash_orders — 注文を再開して確認します。
8. peer_cash_prepare_access_policy、peer_cash_prepare_withdraw、peer_cash_prepare_top_up — 後続のトランザクションを準備します。

Base USDC の金額は、小数点以下 6 桁の基本単位を表す10進文字列です。100 USDC は 100000000 です。見積もりは確定レートではありません。適用される Chainlink レートは、購入者が約定を行う時点で確定します。

エージェントホストが Agent Skills に対応している場合は、 skills/peer-cash/SKILL.md からパッケージ化されたポータブルスキルをインストールしてください。

設定

設定は次の順序で解決されます。

1. CLI フラグ
2. 環境変数
3. ~/.peer/config.json
4. 実行時のデフォルト値

一般的な設定：

• PEER_ENV：production、preproduction、または staging
• PEER_PRIVATE_KEY / PEER_WALLET_PATH：汎用の書き込み コマンドで使用する署名者の情報
• PEER_RPC_URL：Base RPC の上書き設定
• PEER_API_KEY：必要な場合に使用する Curator API キー
• PEER_INDEXER_API_KEY / PEER_INDEXER_URL：インデクサーの上書き設定
• PEER_MARKET_API_KEY / PEER_MARKET_BASE_URL：Peerlytics へのアクセス
• PEER_PAY_API_KEY / PEER_PAY_BASE_URL：ホスト型チェックアウトへのアクセス
• PEER_BASE_API_URL：Curator の上書き設定。デフォルト値は PEER_ENV に従い、 api.zkp2p.xyz、api-preprod.zkp2p.xyz、または api-staging.zkp2p.xyz です。
• PEER_CASH_RPC_URL、PEER_CASH_API_KEY、PEER_CASH_REFERRAL_CODE、および PEER_CASH_REFERRER：cash プロファイルの上書き設定

永続的なローカル設定には、peer config show、set、unset、および reset を使用してください。peer config show はシークレット値をマスクします。認証情報には環境変数を使用することを推奨します。

コマンドファミリー

CLI では次の操作が可能です。

• 見積もり、受取人の登録、および受取人ハッシュの解決
• デポジットのライフサイクル、支払い方法、通貨、オラクル設定、および 一括更新
• インテント、事前インテントフック、履行、リリース、およびクリーンアップ
• StakeVault のデポジット、引き出し、認可、インデックス済みデータの鮮度、および 成熟したチャージバックのリリース
• IntentGuardian のポリシー、リアルタイムの拡張見積もり、支払者による資金調達、および プレビューを優先するインテント拡張
• ProtocolViewer とインデクサーの読み取り（raw GraphQL の代替手段を含む）
• Vault、レートマネージャー、委任、手数料、およびスナップショット
• Peerlytics の市場、エクスプローラー、履歴、アトリビューション、および API キー操作
• USDC の残高と送金
• ホスト型チェックアウトの作成、読み取り、キャンセル、およびローカルの再開キャッシュ
• ローカル設定と環境の確認

正確な現行パス、フラグ、スキーマ、認証要件、および危険性マーカーを確認するには、peer --help、peer <family> --help を実行するか、生成されたツールカタログを確認してください。

すべてのコマンドで --params <json> と --params-file <path> も使用できます。型付きフラグは raw 値より優先されます。

開発

このリポジトリでは npm と、コミット済みの package-lock.json を使用します。

npm install
npm run dev -- quote --from USD --amount 100 --platform wise
npm run check

npm run build は、peer と公開 MCP ライブラリのエントリーポイントをバンドルする前に、すべてのエージェントカタログを再生成します。ネットワークを使用するフローやチェックアウトの動作を変更した場合は、npm run test:e2e を実行してください。

agents.peer.xyz のドキュメントアプリケーションは clients/agents にある zkp2p/zkp2p-clients が管理しています。このリポジトリが管理するのは、実行可能なランタイム、パッケージマニフェスト、ポータブルなスキル、およびドキュメント化されている生成済みコントラクトです。

UPI

UPI/INR は本番、プレプロダクション、およびステージングで利用でき、@zkp2p/sdk のカタログと一致しています。peer config platforms を実行すると、ほかの決済手段とともに表示されます。また、peer quote --from INR --amount 100 --platform upi を実行すると、見積もりをリクエストできます。デポジットの作成、受取人の登録、およびインテントのプレビューでも同じ決済手段を使用できます。