対象
AI agent、有料API、machine-to-machine commerceを研究する開発チーム
← すべてのプロダクトLocal R&D
INFRASTRUCTURE · PRODUCT BRIEF
Base x402 Agent Payments
AIエージェントがUSDC価格のAPIを安全に理解し支払う経路を研究します。
Base x402 Agent Paymentsは、APIが402 challengeで価格と条件を示し、agentが限定的な支払承認を作成し、サーバーがrequest fingerprint、nonce、policyを検証するR&D製品です。mock E2EとBase Sepolia readinessのみ検証済みで、funded wallet settlement、facilitator運用、Mainnet決済は未検証です。
x402 v2EIP-3009Base SepoliaUSDCSDK
SAMPLE UI · NO LIVE TRANSACTION
LOCAL R&D PROTOCOL
HTTP 402402から検証済み応答まで
GET
/v1/agent/data40201PAYMENT-REQUIRED
02EIP-3009 · STRUCTURAL
03Replay · protected
04Settlement · MOCK
payment-required → authorize → verify
すべてのhashとsettlement結果はサンプルであり、onchain取引ではありません。
目指す結果
支払要件、限定承認、API応答、replay protectionを1つの検証可能なprotocol flowに整理
PRODUCT FLOW
ユーザーが理解できる4ステップ
01 · API request
agentが価格付き保護APIを呼び出します。
02 · 402 challenge
サーバーが正確なasset、amount、network、expiry条件を返します。
03 · 限定承認
agent walletがrequestに結び付くEIP-3009 authorizationを準備します。
04 · 検証後に応答
gatewayがpolicyとreplayを確認した後のみAPI結果を返します。
INTERFACE TEMPLATE
サンプルプロダクト画面
実キー、取引、顧客情報を使わずに構造を確認できるコードベースのサンプルです。SAMPLE UI · NO LIVE TRANSACTION
LOCAL R&D PROTOCOL
HTTP 402402から検証済み応答まで
GET
/v1/agent/data40201PAYMENT-REQUIRED
02EIP-3009 · STRUCTURAL
03Replay · protected
04Settlement · MOCK
payment-required → authorize → verify
すべてのhashとsettlement結果はサンプルであり、onchain取引ではありません。
CAPABILITIES
設計済みの機能
x402 v2 header flow
PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE境界をmodel化します。
Request fingerprint
価格、route、server request IDをpayment identifierへ結び付けます。
Replay protection
同一retryはidempotentに処理し、nonce競合は拒否します。
Gateway・SDK
serverとagent integration向けtyped client境界を提供します。
Mock Playground
実資産なしで402からmock settlementまでの状態を確認します。
INTEGRATION SEQUENCE
実装・連携の順序
- resource価格を定義API routeへ固定asset、amount、network policyを関連付けます。
- 402 middleware未払いrequestには正規化challengeのみ返します。
- Agent clientclientがchallengeを検証し限定authorizationを作ります。
- 検証・settlement adapter現在はdeterministic mockで、live adapterは別途承認対象です。
SERVER-SIDE PSEUDOCODE · NO CREDENTIALS
サーバー連携例
秘密情報はブラウザーへ渡さず、外部応答をサーバーで検証してから状態を進めます。
const challenge = await agent.fetch(resourceUrl); // HTTP 402
const payment = await policy.authorize(challenge);
const response = await agent.retry({ payment });
await verifier.record(response.receipt);SECURITY
セキュリティと責任範囲
非カストディ
gatewayはwallet private keyやseedを受け取りません。
厳格なschema
challengeとauthorizationのfield、chain、token、amount、expiryを検証します。
Policy first
未承認requestへ既存nonce conflict状態を公開しません。
Mock明示
mock identifierをtransaction hashや実settlementとして表示しません。
READINESS
現在の制約
Local R&D
公開production gatewayや顧客SLAはありません。
Funded settlement未検証
funded walletとfacilitatorによるE2E settlementは未実行です。
Mainnet未検証
Base Mainnet決済やproduction providerを主張しません。
商用運用レビューが必要
billing、support、abuse、legal、独立security reviewが必要です。
市場・運用の境界