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 요청 한 번 보내기

다음 프롬프트를 에이전트에 붙여넣으세요.

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 결제의 전체 과정을 한 번 거칩니다.

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 요청 한 번 보내기

목차