Solana上でサンドボックスのx402ペイメントを実行する

Payを使用して、x402 V2 APIを実行し、Claude Codeにペイメント対応のHTTPクライアントを提供します。API、支払いウォレット、決済はすべてSolanaサンドボックスを使用するため、このチュートリアルではアカウントや実際の資金は必要ありません。

ターミナル、Pay、Claude Codeがインストールされている必要があります。

1. Payをインストールする

macOSでは、ビルド済みバイナリをインストールします:

brew install pay
pay --version

その他のプラットフォームでは、npmパッケージをインストールします:

npm install --global @solana/pay
pay --version

2. x402サンドボックスAPIを起動する

x402-demo.yamlを作成します:

name: x402-demo
subdomain: x402-demo
title: "x402 Demo"
description: "Minimal x402 V2 sandbox endpoint."
category: devtools
version: v1
routing:
  type: respond
operator:
  currencies:
    usd: ["USDC"]
  network: "localnet"
  fee_payer: true
endpoints:
  - method: GET
    path: "report"
    description: "Return a sandbox report."
    metering:
      schemes: [x402-exact]
      dimensions:
        - direction: usage
          unit: requests
          scale: 1
          tiers:
            - price_usd: 0.001

APIを起動し、そのまま実行し続けます:

pay --sandbox server start x402-demo.yaml --bind 127.0.0.1:1402

x402-exactスキームにより、これはx402専用のエンドポイントになります。サンドボックスモードでは、一時的なオペレーターアカウントと支払いアカウントが自動的に作成され、資金が補充されます。

3. Payでエージェントを起動する

別のターミナルで、サンドボックスモードでClaude Codeを起動します:

pay --sandbox claude

Payは、ローカルのMCPツールをエージェントセッションに接続します。エージェントが秘密鍵を受け取ることはありません。

4. x402リクエストを1回実行する

次のプロンプトをエージェントに貼り付けます:

Use Pay to make exactly one sandbox x402 API request to
http://127.0.0.1:1402/report.

Before paying, show me the amount and ask for approval. Then return the API
result and payment receipt. Do not make any other paid requests.

このリクエストは、x402 V2の完全なペイメントループを1回たどります:

APIは、PAYMENT-REQUIREDチャレンジとともに402 Payment Requiredを返します。
Payはx402の要件を検証し、支払い条件を表示します。
承認後、サンドボックスウォレットが署名し、PayはPAYMENT-SIGNATUREを付けてリクエストを再試行します。
APIは、PAYMENT-RESPONSEレシートとともに結果を返します。

実際の資金は動きません。承認を拒否すると、リクエストは停止します。

次はSolanaでのX402に進み、x402 V2クライアントとリソースサーバーを構築するか、x402ファシリテーターになる方法をご覧ください。

x402ペイメントの実行

1. Payをインストールする

2. x402サンドボックスAPIを起動する

3. Payでエージェントを起動する

4. x402リクエストを1回実行する

目次