Synthex Forge — x402 Paid Agent Services

synthex-x402

Synthex Forge 付费 x402 服务的客户端 SDK。 使用 Base 主网上的 USDC。

只需一次调用。402 → EIP-3009 签名 → 重试的整个流程都由你处理，而 verify() 会在本地重新验证答案的 Ed25519 签名， 无需网络调用，也不会产生费用。

from synthex_x402 import call, verify

result = call("/v1/preflight", {"target": "example.com"})
print(result["body"]["verdict"])        # 'go' | 'caution' | 'avoid' | 'unknown'
print(verify(result["body"])["valid"])   # True — re-checked locally

import { call, verify } from 'synthex-x402'

const result = await call('/v1/preflight', { target: 'example.com' })
console.log(result.body.verdict)         // 'go' | 'caution' | 'avoid' | 'unknown'
console.log(verify(result.body).valid)   // true — re-checked locally

安装

pip install synthex-x402          # Python 3.9+
npm install synthex-x402          # Node 18+

无需花费即可试用

python3 -m synthex_x402 --mock     # Python
cd sdk/typescript && npm install && npm run mock

模拟会使用一次性密钥，通过本地模拟服务运行完整流程——402、指令解析、签名、重试、 签名结果、本地验证。任何数据都不会离开你的计算机，也不会产生费用。

远程 MCP 服务

同样的工具也可通过 MCP 的可流式 HTTP 传输方式使用：

POST https://x402.synthexforge.com/mcp

curl -X POST https://x402.synthexforge.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

• 清单：https://x402.synthexforge.com/.well-known/mcp.json
• A2A Agent 卡片：https://x402.synthexforge.com/.well-known/agent.json
• 注册表：官方 MCP 注册表（registry.modelcontextprotocol.io）中的 com.synthexforge.x402/paid-agent-services

服务

每个工具都是对同一个付费 HTTP 路由的轻量适配器，因此 MCP 接口与 HTTP 接口的价格和行为绝不会不一致。

工具	路由	价格	回答的问题
preflight	POST /v1/preflight	$0.01	我应该向这个交易对手付款吗？
edge_prior	POST /v1/edge/prior	$0.05	这里之前测试过什么？
x402_index	POST /v1/x402/index	$0.02	Agent 经济体提供什么服务？这些服务有效吗？
data_validate	POST /v1/data/validate	$0.02	此负载是否符合此架构？
policy_check	POST /v1/policy/check	$0.10	此操作是否符合此策略？
rates_reference	GET /v1/rates/reference	$0.01	此金额值多少，并标注截至时间？
verify_signature	POST /v1/settlement/verify	免费	重新验证你持有的签名收据。
health	GET /health	免费	服务是否正常运行，运行在哪个网络上？

支付通道

协议	x402 v2，exact 方案
资产	USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
网络	Base 主网（eip155:8453）
方法	EIP-3009 transferWithAuthorization
payTo	0xc8fF67FAE72596478599EAAcfad8656fAe1113c8

配置

变量	含义
SYNTHEX_X402_PRIVATE_KEY	你的 EIP-3009 签名密钥。绝不会记录日志，也绝不会返回。
SYNTHEX_X402_KEY_FILE	密钥文件的路径。

未配置密钥时，call() 不会付款——它会返回 payment_required 指令，供你自行决定。

文档

六篇操作指南，可通过 https://x402.synthexforge.com/docs 在线查阅：

1. 在 Base 上验证结算收据
2. 付款前检查端点
3. 信任负载前先进行验证
4. 读取带有过期状态的参考汇率
5. 购买并兑换通行证
6. 证明判定结果确实由我们作出

目录结构

sdk/python/          the Python package (PyPI: synthex-x402)
sdk/typescript/      the TypeScript package (npm: synthex-x402)
glama.json           Glama registry metadata

开发

# Python
cd sdk/python && pip install -e . && python3 -m synthex_x402 --self-test

# TypeScript
cd sdk/typescript && npm install && npm run self-test

两个自测都会离线运行，并断言 EIP-3009 摘要与 x402 库自身生成的摘要逐字节相同，以及其他内容。

许可证

MIT