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: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly90dXVtZXN0Lm5ldC92MS9hbGxvY2F0aW9ucyIsImRlc2NyaXB0aW9uIjoiTWFjIFN0dWRpbyBjb20gTTUgTWF4ICg2NCBHQik6IGZpcnN0IG1vbnRoIG9mIGEgMS1tb250aCB0ZXJtLiBUZXN0bmV0OiBwcmljZXMgYXJlIHNjYWxlZCBkb3duIDEwMDDDlyAoMC40OTkgdGVzdCBVU0RDKSIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRlZCI6eyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MzIiLCJhbW91bnQiOiI0OTkwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhlMjNiNWExODMyY2JkMDA3M2ZiNzIzNGFmNWYwODRmNDJlODg1ODVlIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fSwicGF5bG9hZCI6eyJzaWduYXR1cmUiOiIweOKApmRlbW8tc2lnbmF0dXJlIiwiYXV0aG9yaXphdGlvbiI6eyJmcm9tIjoiMHjigKZhZ2VudC13YWxsZXQiLCJ0byI6IjB4ZTIzYjVhMTgzMmNiZDAwNzNmYjcyMzRhZjVmMDg0ZjQyZTg4NTg1ZSIsInZhbHVlIjoiNDk5MDAwIiwidmFsaWRBZnRlciI6IjAiLCJ2YWxpZEJlZm9yZSI6IjE3OTUzMTY3MjEiLCJub25jZSI6IjB44oCmMzItYnl0ZS1ub25jZSJ9fX0=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_TOreal, um facilitador de mainnet e uma mudança de configuração deliberada.
Índice da API: /v1