tryx402

tryx402 — エージェント決済の OpenRouter

MIT ライセンス。フランスで開発。AI エージェント向け初のオープンソース決済ガバナンスレイヤーです。

AgentCash / x402 を安全に利用する、プロバイダーに依存しないラッパーです。見込み客の開拓に限らず、あらゆるエンドポイントを呼び出せます。さらに、AgentCash 自体にはない機能と、私たちが苦労して学んだ必要な機能を追加しています。

• 厳格な予算上限 — 使いすぎる前に停止します
• 冪等性 — 同じ呼び出しに二度支払うことはありません（$0.83 の二重請求から学びました）
• コスト台帳 — 支出額（USD）を照合し、発生元／アカウント別に集計します
• プランの見積もり — 1 セントも使う前に、複数回の呼び出しを含むワークフローの料金を見積もります
• 署名付きレシート — すべての支払いを Ed25519 でオフライン検証できる証明
• セッショントークン＋サーキットブレーカー — タスクごとの支出上限と、半開状態でのクールダウン
• 透過的な 402→支払い→再試行 — ネイティブの httpx トランスポートで、再試行は厳密に 1 回、ループはありません
• ディスカバリーパイプライン — x402 bazaar のリアルタイムインデックス（Onyx Bazaar、gold-402）

オープンソースだから安心

このリポジトリは、オープンソース SDK です。安全な呼び出し機能、予算ガード、冪等性、台帳、CLI、MCP サーバーを備えています。MIT ライセンスです。

有料プランの壁の向こうに機能を隠すことはありません。SDK を「コア」と「プロ」に分割することもありません。すべてここにあります。自由に使い、フォークし、構築できます。

ホステッドサービス（https://www.tryx402.app）は、複数通貨での法定通貨決済、マージン、為替、Stripe によるチャージ、検証済みツールのカタログ、プロバイダーポータルを提供する商用サービスです。料金は /v1/quote を通じてサーバー側で決定されます。クライアント側のマージンでは、誰も支払いません。

収益モデル：ホステッドサービスを経由する、すべての従量課金取引から手数料を得ます。SDK は無料です。サービスが手数料を受け取ります。それだけです。

位置づけ

tryx402 は、x402 エコシステムにおけるAI エージェント向け初のオープンソース決済ガバナンス SDKです。フランスで開発され、MIT ライセンスで配布され、コミュニティに採用されています。

treg.to などのプロプライエタリなアグリゲーターに対し、tryx402 は異なる方針を掲げています。ベンダーロックインなし、制限的なライセンスなし、「商用利用のみ」なし。コードは自由です。信頼はライセンスではなく、サービスから生まれます。

| 比較項目 | 対象 | 提供場所 |\n|---|---|---|\n| 高機能ツール | ユーザー／エージェントが有料エンドポイントを安全に呼び出す | この SDK（gateway.cli、gateway.client） |\n| 法定通貨ゲートウェイ | エンドユーザーが自国通貨で支払い、x402 をマージン付きで再販する | ホステッドサービス（クローズド） |

エージェントへの組み込み

Python — インポート 1 つ：

from gateway import Gateway
gw = Gateway(max_budget_usd=1.0)               # safe by default
data = gw.call("https://stable-deepline.dev/api/email/validate",
               body={"email": "[email protected]"}, price=0.03)
print(gw.spent_usd)                            # 0.03

ターミナル — コマンド 1 つ（agentcash のように使用できます）。事前に pip install tryx402 を実行してください。

gateway call https://stable-deepline.dev/api/email/validate \
  --body '{"email":"[email protected]"}' --price 0.03 --max-budget 0.10

MCP — 2 つのモード（必要な方を選んでください）：

SDK MCP（pip install）— 6 個のツール、安全な呼び出し機能のみ

{
  "command": "python3",
  "args": ["-m", "tryx402.mcp_server"],
  "env": { "TRYX402_MAX_BUDGET_USD": "1.00" }
}

6 個のツール：gateway_search、gateway_discover、gateway_call、gateway_spent、 gateway_plan、gateway_receipt。x402 / AgentCash の暗号資産ウォレットと直接連携し、ホステッドアカウントは不要です。

pip install tryx402 では gateway_check_balance、gateway_recharge、 gateway_lookup、gateway_proxy_call は表示されません。 これは意図的な仕様であり、バグではありません。これらのツールは、Stripe 経由でチャージする ホステッドアカウントのクレジット（暗号資産ウォレットとは別）を管理します。SDK MCP は安全な x402 呼び出し機能であり、ホステッドゲートウェイが法定通貨のクレジット レイヤーを処理します。10 個すべてのツールを使える MCP については、以下のオプション B をご覧いただくか、 https://www.tryx402.app/api/mcp に接続してください。

Gateway MCP（リポジトリをクローン）— 10 個のツール、ホステッドアカウント管理

{
  "mcpServers": {
    "tryx402": {
      "command": "python3",
      "args": ["-m", "gateway.mcp_server"],
      "env": {
        "GATEWAY_MAX_BUDGET_USD": "1.00"
      }
    }
  }
}

SDK の 6 個のツールに加えて、gateway_session、gateway_check_balance、 gateway_recharge、gateway_proxy_call を利用できます。API キーは不要で、匿名の セッション認証を使用します。check_balance／recharge は、ホステッドアカウントのクレジット（Stripe 経由で EUR/USD でチャージ。暗号資産ではありません）を管理します。

ディレクトリ構成

gateway/
├── client.py    # SafeClient: any endpoint + budget + idempotency + timeout + ledger
├── ledger.py    # cost events, USD/EUR totals, by-origin
├── catalog.py   # search(intent) / discover(origin) over the AgentCash catalogue
├── api.py       # Gateway facade: one-import embed + quote() for server pricing
├── cli.py       # search / discover / call / quote
└── tests/       # offline: budget, idempotency, on_paid hook, quote client

使い方

ディスカバー（無料 — 支払い不要）：

python3 -m gateway.cli search "find work email"
python3 -m gateway.cli discover https://stable-deepline.dev

あらゆるエンドポイントを安全に呼び出す（USDC を使用 — 予算上限あり、冪等）：

python3 -m gateway.cli call https://stable-deepline.dev/api/email/validate \
  --body '{"email":"[email protected]"}' --price 0.03 --max-budget 0.10

アカウントでの呼び出し料金をホステッドサービスに問い合わせる（為替＋マージンはサーバー側で適用）：

export TRYX402_API_KEY="gw_..."        # from https://www.tryx402.app
gateway quote 0.04
#  -> {"account":"acme","currency":"EUR","charge_minor":5,"charge":"0.05 EUR"}

実装済みの機能とホスト側の機能

• 実装済み（この SDK）： 安全な呼び出し、予算上限、冪等性、コスト台帳、カタログの検索／検出。
• ホスト側： アカウント、残高、法定通貨による入金（Stripe）、為替換算、マージン。これらはすべてサーバー側で決定され、SDK は quote() で問い合わせるだけです。
• 意図的に無効： 有料呼び出しの自動再試行（デフォルトは max_retries=0）。課金された可能性のある呼び出しを再試行すると二重課金が発生するためです。サーバーが Idempotency-Key ヘッダーに対応している場合に限り、有効にしてください。

テレメトリ（任意）

tryx402 は使用状況の把握に役立てるため、初回のインポート時に匿名の ping を 1 回送信します。 インストール ID（ランダムに生成され、ローカルに保存）、パッケージのバージョン、Python のバージョン、プラットフォームが送信されます。

個人を特定できる情報はありません。サイトをまたいだ追跡はありません。個人データはありません。

いつでも無効にできます：

export TRYX402_NO_TELEMETRY=1

または、空の URL を設定して無効にします：

export TRYX402_TELEMETRY_URL=""