x402-maksun tekeminen

Käytä Payta x402 V2 -rajapinnan ajamiseen ja anna Claude Codelle maksutietoinen HTTP-asiakas. Rajapinta, maksajan lompakko ja selvitys käyttävät kaikki Solanan hiekkalaatikkoa, joten tämä läpikäynti ei vaadi tiliä eikä oikeita varoja.

Tarvitset päätteen sekä asennetut Payn ja Claude Coden.

1. Asenna Pay

Asenna macOS:llä valmiiksi käännetty binääritiedosto:

brew install pay
pay --version

Muilla alustoilla asenna npm-paketti:

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

2. Käynnistä x402-hiekkalaatikko-API

Luo tiedosto 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

Käynnistä API ja jätä se käyntiin:

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

x402-exact-skeema tekee tästä pelkästään x402:ta käyttävän päätepisteen. Hiekkalaatikkotila luo ja rahoittaa väliaikaiset operaattori- ja maksajatilit automaattisesti.

3. Käynnistä agentti Payn avulla

Käynnistä toisessa päätteessä Claude Code hiekkalaatikkotilassa:

pay --sandbox claude

Pay liittää paikalliset MCP-työkalunsa agentin istuntoon. Agentti ei saa yksityistä avainta.

4. Tee yksi x402-pyyntö

Liitä tämä kehote agentille:

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.

Pyyntö noudattaa yhtä täydellistä x402 V2 -maksusilmukkaa:

1. API palauttaa vastauksen 402 Payment Required sekä PAYMENT-REQUIRED-haasteen.
2. Pay validoi x402-vaatimukset ja näyttää maksuehdot.
3. Hyväksynnän jälkeen hiekkalaatikkolompakko allekirjoittaa, ja Pay yrittää pyyntöä uudelleen otsakkeella PAYMENT-SIGNATURE.
4. API palauttaa tuloksen sekä PAYMENT-RESPONSE-kuitin.

Oikeita varoja ei siirry. Hyväksynnän hylkääminen pysäyttää pyynnön.

Jatka oppaaseen x402 Solanassa rakentaaksesi x402 V2 -asiakkaan ja resurssipalvelimen tai ryhdy x402-facilitatoriksi.