agon-protocol

Ryvo Agentic Tools

Ryvo Gateway のルートを検出、認証、呼び出しするためのエージェント向けツールです。

ワンステップセットアップ

setup --target all は、Ryvo エージェントに必要なものをすべてインストールするコマンドです。

• 同梱のスキルを ~/.agents/skills、~/.codex/skills、~/.claude/skills にインストールします。
• デフォルトの SIWX 署名者ウォレットを ~/.ryvo/wallets/default.json に作成します。
• グローバル CLI バイナリを PATH に追加します：Ryvo、ryvo-gateway、ryvo-wallet、ryvo-protocol（npm install -g @ryvonetwork/gateway-cli @ryvonetwork/agent-wallet @ryvonetwork/protocol-cli を使用）。
• エージェント向けのローカルリファレンスを ~/.ryvo/llm.txt に作成します。
• Codex、Claude Desktop、Claude Code、Cursor、Windsurf、および汎用設定に Ryvo MCP サーバーを登録します（既存のエントリーは保持され、バックアップが作成されます）。

npx -y @ryvonetwork/agentic@latest setup --target all

完了後、エージェントのクライアントを再起動すると、エージェントから次の方法で Ryvo を直接呼び出せるようになります。

• Ryvo MCP ツール（ryvo_token_quote、ryvo_token_resolve、ryvo_token_chart、ryvo_token_search、ryvo_token_batch_quote、ryvo_gateway_call、ryvo_gateway_auth_call、...）。
• 単体で実行できる CLI：ryvo -p bitcoin、ryvo quote bitcoin solana usdt、ryvo-gateway auth call GET ... など。

オプトアウト用フラグ：

• --skip-global-cli — npm install -g を実行しません。単体で実行できる CLI バイナリは PATH に追加されないため、代わりに npx -y @ryvonetwork/gateway-cli ... を使用してください。
• --skip-wallet-setup — すでに別の署名者ウォレットが設定されている場合に限り、install-skills で有効です。

対応するセットアップ対象：

npx -y @ryvonetwork/agentic setup --target codex            # ~/.codex/config.toml
npx -y @ryvonetwork/agentic setup --target claude-desktop   # standalone Claude Desktop GUI app config
npx -y @ryvonetwork/agentic setup --target claude-code      # ~/.claude.json (Claude Code CLI agent)
npx -y @ryvonetwork/agentic setup --target cursor           # ~/.cursor/mcp.json
npx -y @ryvonetwork/agentic setup --target windsurf
npx -y @ryvonetwork/agentic setup --target generic          # ~/.ryvo/mcp.json
npx -y @ryvonetwork/agentic setup --target all --dry-run

--target all は、上記のすべてのアダプターに書き込みます。Claude Desktop（macOS／Windows 向けのスタンドアロン GUI アプリ）と Claude Code（ターミナル用 CLI エージェント）は、異なるファイルから MCP サーバーを読み込みます。--target all は両方に登録します。セットアップ後、MCP サーバーのリストを再読み込みするために、エージェントのクライアントを再起動してください。

セットアップにより ~/.ryvo/wallets/default.json が作成されます。@ryvonetwork/agent-wallet が署名するのは、Tokens API の SIWX チャレンジ（sign-in-with-x）のみです。x402 exact payment またはその他の認証を必要とする Gateway ルートでは、PAYMENT-SIGNATURE／X-PAYMENT を返す署名者を RYVO_SIGNER_COMMAND に設定してください。

RYVO_SIGNER_COMMAND の実行タイミング

• Gateway MCP： ryvo_gateway_auth_call の呼び出し時に Gateway が HTTP 402 を返した場合に限り実行されます。MCP は正規化された認証リクエスト JSON を stdin に渡して、RYVO_SIGNER_COMMAND を 1 回 起動します（ryvo_gateway_prepare_auth と同じ形式です）。プロセスは終了コード 0 で終了し、認証 ヘッダー または SIWX フォールバック（address、signature、任意の signatureEncoding）を JSON 形式で stdout に出力する必要があります。
• gateway-cli： ryvo-gateway auth call と batch は、同じ requestGateway パスを使用します。Gateway から 402 が返された後、設定されている場合は RYVO_SIGNER_COMMAND（または --auth-driver）が実行されます。auth prepare／doctor は署名者を起動しません。

Windows では、署名者コマンドが npx／npm／pnpm／yarn で始まる場合、Node が cmd シェル経由で実行することがあります。攻撃者が RYVO_SIGNER_COMMAND を制御できる場合、シェルスニペットを信頼するのと同等の扱いをしてください。

Skills とウォレット

サポートされているすべてのエージェントスキルディレクトリ（~/.agents/skills、~/.codex/skills、~/.claude/skills）に Ryvo のスキルをすべてインストールし、SIWX／認証呼び出しに使用するデフォルトの便利なウォレットを作成します。

npx -y @ryvonetwork/agentic install-skills

その他のインストール先：

npx -y @ryvonetwork/agentic install-skills --target agents
npx -y @ryvonetwork/agentic install-skills --target codex
npx -y @ryvonetwork/agentic install-skills --target claude
npx -y @ryvonetwork/agentic install-skills --target all
npx -y @ryvonetwork/agentic list
npx -y @ryvonetwork/agentic doctor

別の署名用ウォレットがすでに設定されている場合に限り、--skip-wallet-setup を使用してください。インストーラーは Ryvo のスキルフォルダーのみをコピーし、必要に応じて対象ディレクトリを作成して、次の Ryvo 所有のスキル名のみを上書きします。

• ryvo-gateway
• ryvo-protocol
• ryvo-gateway-payment-channels

install-skills はスキルをインストールし、~/.ryvo/wallets/default.json を作成します。setup はスキル、ウォレット、MCP 登録を実行します。

setup --target all の実行後、CLI の実行ファイルは PATH に追加されます。直接使用してください。

Ryvo -p bitcoin
Ryvo quote usdt --json
Ryvo price bitcoin solana usdt
Ryvo volume tesla gold --json
Ryvo liquidity usdc usdt
Ryvo search "bitcoin etf" --limit 5
Ryvo profile tesla
Ryvo variants gold
Ryvo risk usdt
Ryvo chart solana --interval 1D
ryvo-gateway catalog
ryvo-gateway agent-prompt
ryvo-gateway auth prepare GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1 --json
ryvo-gateway auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1
ryvo-gateway batch '[{"method":"GET","path":"/v1/x402/tokens/assets/solana/price-chart","query":{"interval":"1D"}},{"method":"GET","path":"/v1/x402/tokens/assets/bitcoin/price-chart","query":{"interval":"1D"}}]'
ryvo-gateway auth call GET /v1/x402/tokens/assets/tesla/profile
ryvo-gateway auth call GET /v1/x402/tokens/assets/gold/price-chart --query interval=1D
ryvo-wallet authorize --stdin
ryvo-protocol config
ryvo-protocol token show

単独の実行ファイルが PATH にない場合（setup --skip-global-cli を実行した場合、グローバルインストールで権限エラーが発生した場合、またはまだ setup を実行していない場合）も、npx -y @ryvonetwork/gateway-cli ...、npx -y @ryvonetwork/agent-wallet ...、npx -y @ryvonetwork/protocol-cli ... を使って同じ呼び出しを実行できます。MCP サーバーのエントリでも npx -y を使用するため、MCP ツールを動作させるのにグローバルインストールは不要です。

ライブカタログ（https://gateway.ryvo.network/v1/catalog）に掲載されている API 呼び出しでは、Ryvo Gateway を最初の情報源として使用してください。Tokens API は、暗号資産、通貨、米国債、ETF、金属、株式、およびそれらの Solana トークン版の市場データをサポートしています。エージェントは、未加工のルート文字列を使う前に、一般的な Tokens データ取得には高水準の Gateway CLI コマンド（quote、price、volume、liquidity、mcap、search、resolve、curated、profile、variants、markets、tickers、risk、chart、ohlcv、snapshots）を使用し、値の取得元が canonicalMarket、stats、primaryVariant.market、profile.data、ティッカー、ローソク足のいずれかを明記してください。

MCP サーバーは別のパッケージです。

{
  "mcpServers": {
    "ryvo-gateway": {
      "command": "npx",
      "args": ["-y", "@ryvonetwork/gateway-mcp"],
      "env": {
        "RYVO_GATEWAY_BASE_URL": "https://gateway.ryvo.network",
        "RYVO_SIGNER_COMMAND": "npx -y @ryvonetwork/agent-wallet authorize",
        "RYVO_WALLET_PROFILE": "default"
      }
    },
    "ryvo-protocol": {
      "command": "npx",
      "args": ["-y", "@ryvonetwork/protocol-mcp"]
    }
  }
}

RYVO_PAYMENT_MAX_AMOUNT_USD と RYVO_PAYMENT_DAILY_LIMIT_USD は任意です。一部の x402 認証準備レスポンスには、人による確認用としてこれらが含まれます。ryvo-wallet はこれらを強制しません。

決済チャネルのフローは、v1 では devnet 専用です。Tokens の SIWX ルートでは決済チャネルを使用しません。 Gateway の認証ドライバーは、ウォレットに依存しないヘルパーコマンドです。Gateway CLI は、正規化された認証リクエスト JSON を stdin 経由でドライバーに送信し、返されたヘッダー、または SIWX のアドレス／署名 JSON を stdout 経由で受け取ります。ドライバーは、ブラウザーウォレット、ローカルキーペア、MPC、カストディシステム、x402 決済サービス、または Ryvo チャネルのコミットメントビルダーをラップできます。Ryvo CLI／MCP パッケージは、鍵を保持したり、ウォレット／MCP の設定を変更したりしません。

一般的な認証付き呼び出しのフロー：

1. 既知のエンドポイントを使用するか、/v1/catalog を取得してエンドポイントを見つけます。
2. リクエストを正確に送信し、402 チャレンジを受け取ります。
3. 正規化された認証リクエストを RYVO_SIGNER_COMMAND に渡します。
4. 返された SIGN-IN-WITH-X、PAYMENT-SIGNATURE、X-PAYMENT、またはチャネルヘッダーを付けて、同じリクエストを正確に再試行します。

Gateway MCP は、このフロー用に ryvo_gateway_auth_call を提供します。独自のウォレットポリシーを持つエージェント向けに、低レベルの prepare／complete／call ツールも引き続き利用できます。

パッケージ

• package root は、ワンステップでエージェントをセットアップするインストーラー @ryvonetwork/agentic を公開します。
• agent-wallet/ は、デフォルトで SIWX のみに対応する Tokens API 署名者フック @ryvonetwork/agent-wallet を公開します（x402 の正確な支払いルートでは、RYVO_SIGNER_COMMAND に置き換えてください）。
• cli/ は、汎用署名者フックを備えた Gateway コマンドライン @ryvonetwork/gateway-cli を公開します。
• mcp/ は、ルート汎用の認証呼び出しに対応する stdio MCP サーバー @ryvonetwork/gateway-mcp を公開します。
• protocol-cli/ は、読み取り専用および準備専用の Ryvo Protocol コマンドライン @ryvonetwork/protocol-cli を公開します。
• protocol-mcp/ は、読み取り専用および準備専用の Ryvo Protocol MCP サーバー @ryvonetwork/protocol-mcp を公開します。
• skills/ryvo-gateway/ は、Gateway のワークフロー向けエージェントスキルです。
• skills/ryvo-protocol/ は、プロトコルアカウント、チャネル、決済、および BLS に関する注意点向けのエージェントスキルです。
• skills/ryvo-gateway-payment-channels/ は、ゲートウェイの支払いチャネル認証向けのエージェントスキルです。
• llm.txt と llms.txt は、ウェブサイト向けの LLM 可読形式のゲートウェイドキュメントです。

クイックチェック

node cli/ryvo-gateway.js health
node cli/ryvo-gateway.js catalog --provider helius
node cli/ryvo-gateway.js auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1
node agent-wallet/ryvo-wallet.js setup --profile default
node protocol-cli/ryvo-protocol.js token show
node mcp/server.js
node protocol-mcp/server.js

CLI と MCP サーバーは、設定されている場合に RYVO_SIGNER_COMMAND を使用します。同梱のエージェントウォレットは置き換え可能です。外部ウォレットは、同じフックを通じてヘッダーまたは署名を返すことができます。 プロトコル CLI と MCP サーバーは読み取りおよび準備のみを行い、トランザクションへの署名やブロードキャストは行いません。