tryx402

tryx402 — 面向 Agent 支付的 OpenRouter

采用 MIT 许可。在法国打造。首个面向 AI Agent 的开源支付治理层。

AgentCash / x402 的安全、与提供商无关的封装。不仅限于潜在客户开发—— 它可以驱动任何端点，并补上 AgentCash 本身缺少、且我们吃过亏才学到需要的功能：

• 硬性预算上限 — 避免超支
• 幂等性 — 同一次调用绝不重复付款（$0.83 重复扣费的教训）
• 成本账本 — 按来源 / 账户分组，记录并核对已花费的 USD
• 计划估算 — 在花出一分钱之前，为多次调用的工作流定价
• 签名收据 — 每笔付款都有可离线验证的 Ed25519 证明
• 会话令牌 + 熔断器 — 按任务设置支出上限，并提供半开冷却机制
• 透明的 402→付款→重试 — 原生 httpx 传输，仅重试一次，不会循环
• 发现流水线 — 实时为 x402 集市编制索引（Onyx Bazaar、gold-402）

开源，无需担忧

此仓库是开源 SDK：安全调用器、预算保护、幂等性、账本、CLI 和 MCP 服务。采用 MIT 许可。

我们不会把功能藏在付费墙后面，也不会将 SDK 拆分成“核心版”和“专业版”。 所有内容都在这里。随你使用、分叉并在此基础上构建。

托管服务（https://www.tryx402.app）是商业引擎： 多币种法币计费、利润空间、外汇、Stripe 充值、已验证工具目录和提供商门户。定价由 服务器通过 /v1/quote 决定——客户端设置的利润空间，没人会为之买单。

营收模式：通过托管服务路由的每笔按调用付费交易都会收取佣金。SDK 免费。服务收取一部分费用。仅此而已。

定位

tryx402 是 x402 生态系统中首个面向 AI Agent 支付治理的开源 SDK。 在法国打造，以 MIT 许可发布，并得到社区采用。

面对专有聚合器（treg.to 等），tryx402 坚持不同的立场：不锁定、不使用限制性许可，也不搞“仅限商业用途”。 代码是自由的。信任来自服务，而非许可。

| 方面 | 对象 | 位置 |\n|---|---|---|\n| 强力工具 | 你 / Agent 安全地驱动付费端点 | 此 SDK（gateway.cli、gateway.client） |\n| 法币网关 | 终端用户用本币付款，你加价转售 x402 | 托管服务（闭源） |

嵌入使用（面向 Agent）

Python — 一次导入：

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

终端 — 一条命令（类似 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 — 两种模式（按需选择）：

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。

网关 MCP（克隆仓库）— 10 个工具，管理托管账户

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

包含全部 6 个 SDK 工具，另加 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，以帮助我们了解使用情况： 安装 ID（随机生成，保存在本地）、软件包版本、Python 版本、平台。

不含个人身份信息。不跨站点跟踪。不收集个人数据。

随时停用：

export TRYX402_NO_TELEMETRY=1

也可以设置空 URL 来停用：

export TRYX402_TELEMETRY_URL=""