Synthex Forge — x402 Paid Agent Services

synthex-x402

Synthex Forge の有料 x402 サービス向けクライアント SDK。 Base メインネットの USDC を使用します。

1 回の呼び出しで完了します。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 エージェントカード：https://x402.synthexforge.com/.well-known/agent.json
• レジストリ：公式 MCP Registry（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	エージェント経済圏では何が提供されていて、実際に機能しますか？
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 の指示を返します。

ドキュメント

6 つのハウツーガイドを、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