Tuum Est“é seu”Solicitar uma alocação
x402 · em breveBase SepoliaUSDC

Alugue um computador Mac com x402.

O checkout via x402 ainda não está habilitado neste ambiente. A API retorna 404 até X402_ENABLED ser definido; os exemplos abaixo descrevem a API de testnet.

1. Solicite uma alocação

Envie JSON com uma máquina, um prazo e a chave pública SSH do agente. Sem pagamento, a API responde 402 Payment Required.

curl -i -X POST https://tuumest.net/v1/allocations \
  -H 'content-type: application/json' \
  -d "{\"machine\":\"studio-max\",\"term_months\":1,\"ssh_public_key\":\"$(cat ~/.ssh/id_ed25519.pub)\"}"

2. Leia a cotação

O cabeçalho PAYMENT-REQUIRED é JSON em base64. Ele pede apenas o primeiro mês.Na testnet isso é reduzido 1000×: 0.499 USDC de teste (499000 unidades base).

Testnet: os preços são reduzidos 1000× (0.499 USDC de teste).

PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly90dXVtZXN0Lm5ldC92MS9hbGxvY2F0aW9ucyIsImRlc2NyaXB0aW9uIjoiTWFjIFN0dWRpbyBjb20gTTUgTWF4ICg2NCBHQik6IGZpcnN0IG1vbnRoIG9mIGEgMS1tb250aCB0ZXJtLiBUZXN0bmV0OiBwcmljZXMgYXJlIHNjYWxlZCBkb3duIDEwMDDDlyAoMC40OTkgdGVzdCBVU0RDKSIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MzIiLCJhbW91bnQiOiI0OTkwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhlMjNiNWExODMyY2JkMDA3M2ZiNzIzNGFmNWYwODRmNDJlODg1ODVlIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fV19
{
  "x402Version": 2,
  "resource": {
    "url": "https://tuumest.net/v1/allocations",
    "description": "Mac Studio com M5 Max (64 GB): first month of a 1-month term. Testnet: prices are scaled down 1000× (0.499 test USDC)",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:84532",
      "amount": "499000",
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "payTo": "0xe23b5a1832cbd0073fb7234af5f084f42e88585e",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USDC",
        "version": "2"
      }
    }
  ]
}
Rede
eip155:84532 (Base Sepolia)
Ativo
0x036CbD53842c5426634e7929541eC2318f3dCF7e
Pagar para
0xe23b5a1832cbd0073fb7234af5f084f42e88585e
Tempo limite
120 segundos

3. Assine e tente novamente

Use um cliente x402 ou assine uma autorização de transferência USDC EIP-3009, depois repita a mesma solicitação com um cabeçalho PAYMENT-SIGNATURE. O payload em accepted deve corresponder à cotação.

PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly90dXVtZXN0Lm5ldC92MS9hbGxvY2F0aW9ucyIsImRlc2NyaXB0aW9uIjoiTWFjIFN0dWRpbyBjb20gTTUgTWF4ICg2NCBHQik6IGZpcnN0IG1vbnRoIG9mIGEgMS1tb250aCB0ZXJtLiBUZXN0bmV0OiBwcmljZXMgYXJlIHNjYWxlZCBkb3duIDEwMDDDlyAoMC40OTkgdGVzdCBVU0RDKSIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRlZCI6eyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MzIiLCJhbW91bnQiOiI0OTkwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhlMjNiNWExODMyY2JkMDA3M2ZiNzIzNGFmNWYwODRmNDJlODg1ODVlIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fSwicGF5bG9hZCI6eyJzaWduYXR1cmUiOiIweOKApmRlbW8tc2lnbmF0dXJlIiwiYXV0aG9yaXphdGlvbiI6eyJmcm9tIjoiMHjigKZhZ2VudC13YWxsZXQiLCJ0byI6IjB4ZTIzYjVhMTgzMmNiZDAwNzNmYjcyMzRhZjVmMDg0ZjQyZTg4NTg1ZSIsInZhbHVlIjoiNDk5MDAwIiwidmFsaWRBZnRlciI6IjAiLCJ2YWxpZEJlZm9yZSI6IjE3OTUzMTc0MzIiLCJub25jZSI6IjB44oCmMzItYnl0ZS1ub25jZSJ9fX0=

A assinatura de exemplo não é válida; use uma carteira de teste com fundos e um cliente x402 real.

4. Receba a alocação

Um pagamento bem-sucedido retorna 202 Accepted com um token de acesso de uso único. Apenas o hash é armazenado; mantenha o token em segredo.

PAYMENT-RESPONSE: eyJzdWNjZXNzIjp0cnVlLCJ0cmFuc2FjdGlvbiI6IjB44oCmdHJhbnNhY3Rpb24iLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMyIiwicGF5ZXIiOiIweOKApmFnZW50LXdhbGxldCIsImFtb3VudCI6IjQ5OTAwMCJ9
{
  "allocation_id": "<uuid>",
  "status": "paid",
  "status_url": "https://tuumest.net/v1/allocations/<uuid>",
  "access_token": "<shown once>",
  "sandbox": true
}

Consulte a URL de status com o token:

curl https://tuumest.net/v1/allocations/<uuid> \
  -H 'authorization: Bearer <access_token>'

Na testnet a alocação fica active após cerca de 30 segundos. O SSH é agent@sandbox.tuumest.net. Nenhuma máquina física é provisionada e nenhuma tarefa de operações é criada. Se a resposta em vez disso disser pending_settlement, continue consultando a status_url retornada; não pague de novo.

A liquidação só é confirmada quando a transação é canônica e final na Base, então uma resposta confirmada do facilitador ainda pode ser pending_settlement por um tempo. Repetir o mesmo pagamento assinado sempre retorna a operação original, mesmo depois do validBefore da autorização; uma autorização expirada nunca transforma um pagamento em andamento em uma nova cotação. Se o status da operação passar a needs_review, a equipe de operações já foi alertada: pare e contate o suporte em vez de assinar um novo pagamento.

Perdeu o token?

Solicite um desafio de uso único em POST /v1/allocations/:id/token/challenge. Assine o message retornado com a carteira pagadora usando personal_sign, depois envie a mensagem e a assinatura para POST /v1/allocations/:id/token. Os desafios expiram em cinco minutos e são consumidos uma vez. O token antigo é invalidado e a mesma assinatura não pode ser reutilizada.

Cliente TypeScript

O cliente TypeScript funciona com este endpoint. O limite de gasto padrão do SDK é $1, então aumente-o explicitamente acima do mês mais caro ($749).

npm i @x402/core @x402/evm viem

import { x402Client } from '@x402/core/client';
import { x402HTTPClient } from '@x402/core/http';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { privateKeyToAccount } from 'viem/accounts';

const signer = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const core = x402Client.fromConfig({
  schemes: [{ network: 'eip155:84532', client: new ExactEvmScheme(signer) }],
  spendControls: { maxAmountPerPayment: '$800' },
});
const client = new x402HTTPClient(core);

Use uma carteira de teste dedicada. Nunca coloque uma chave de mainnet em um agente que lê páginas não confiáveis.

Semântica da testnet

  • Use USDC de teste da Base Sepolia; não tem valor real.
  • O endereço de pagamento é provisório até os fundadores confirmarem a carteira receptora.
  • Não trate uma alocação sandbox como uma máquina real ou uma promessa de produção.
  • A mainnet exige um X402_PAY_TO real, um facilitador de mainnet e uma mudança de configuração deliberada.

Índice da API: /v1