Alquila una computadora Mac con x402.
El pago por x402 no está habilitado en este entorno todavía. La API devuelve 404 hasta que se configure X402_ENABLED; los ejemplos de abajo describen la API de testnet.
1. Solicita una asignación
Envía JSON con una máquina, un plazo y la clave pública SSH del agente. Sin pago, la 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. Lee la cotización
El encabezado PAYMENT-REQUIRED es JSON en base64. Pide solo el primer mes.En testnet esto se reduce 1000×: 0.499 USDC de prueba (499000 unidades base).
Testnet: los precios se reducen 1000× (0.499 USDC de prueba).
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly90dXVtZXN0Lm5ldC92MS9hbGxvY2F0aW9ucyIsImRlc2NyaXB0aW9uIjoiTWFjIFN0dWRpbyBjb24gTTUgTWF4ICg2NCBHQik6IGZpcnN0IG1vbnRoIG9mIGEgMS1tb250aCB0ZXJtLiBUZXN0bmV0OiBwcmljZXMgYXJlIHNjYWxlZCBkb3duIDEwMDDDlyAoMC40OTkgdGVzdCBVU0RDKSIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MzIiLCJhbW91bnQiOiI0OTkwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhlMjNiNWExODMyY2JkMDA3M2ZiNzIzNGFmNWYwODRmNDJlODg1ODVlIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fV19{
"x402Version": 2,
"resource": {
"url": "https://tuumest.net/v1/allocations",
"description": "Mac Studio con 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"
}
}
]
}- Red
- eip155:84532 (Base Sepolia)
- Activo
- 0x036CbD53842c5426634e7929541eC2318f3dCF7e
- Pagar a
- 0xe23b5a1832cbd0073fb7234af5f084f42e88585e
- Tiempo de espera
- 120 segundos
3. Firma y reintenta
Usa un cliente x402 o firma una autorización de transferencia USDC EIP-3009, luego reintenta la misma solicitud con un encabezado PAYMENT-SIGNATURE. La carga en accepted debe coincidir con la cotización.
PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly90dXVtZXN0Lm5ldC92MS9hbGxvY2F0aW9ucyIsImRlc2NyaXB0aW9uIjoiTWFjIFN0dWRpbyBjb24gTTUgTWF4ICg2NCBHQik6IGZpcnN0IG1vbnRoIG9mIGEgMS1tb250aCB0ZXJtLiBUZXN0bmV0OiBwcmljZXMgYXJlIHNjYWxlZCBkb3duIDEwMDDDlyAoMC40OTkgdGVzdCBVU0RDKSIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRlZCI6eyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MzIiLCJhbW91bnQiOiI0OTkwMDAiLCJhc3NldCI6IjB4MDM2Q2JENTM4NDJjNTQyNjYzNGU3OTI5NTQxZUMyMzE4ZjNkQ0Y3ZSIsInBheVRvIjoiMHhlMjNiNWExODMyY2JkMDA3M2ZiNzIzNGFmNWYwODRmNDJlODg1ODVlIiwibWF4VGltZW91dFNlY29uZHMiOjEyMCwiZXh0cmEiOnsibmFtZSI6IlVTREMiLCJ2ZXJzaW9uIjoiMiJ9fSwicGF5bG9hZCI6eyJzaWduYXR1cmUiOiIweOKApmRlbW8tc2lnbmF0dXJlIiwiYXV0aG9yaXphdGlvbiI6eyJmcm9tIjoiMHjigKZhZ2VudC13YWxsZXQiLCJ0byI6IjB4ZTIzYjVhMTgzMmNiZDAwNzNmYjcyMzRhZjVmMDg0ZjQyZTg4NTg1ZSIsInZhbHVlIjoiNDk5MDAwIiwidmFsaWRBZnRlciI6IjAiLCJ2YWxpZEJlZm9yZSI6IjE3OTUzMTc0MzEiLCJub25jZSI6IjB44oCmMzItYnl0ZS1ub25jZSJ9fX0=La firma de ejemplo no es válida; usa una billetera de prueba con fondos y un cliente x402 real.
4. Recibe la asignación
Un pago exitoso devuelve 202 Accepted con un token de acceso de un solo uso. Solo se guarda su hash; mantén el token en secreto.
PAYMENT-RESPONSE: eyJzdWNjZXNzIjp0cnVlLCJ0cmFuc2FjdGlvbiI6IjB44oCmdHJhbnNhY3Rpb24iLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMyIiwicGF5ZXIiOiIweOKApmFnZW50LXdhbGxldCIsImFtb3VudCI6IjQ5OTAwMCJ9{
"allocation_id": "<uuid>",
"status": "paid",
"status_url": "https://tuumest.net/v1/allocations/<uuid>",
"access_token": "<shown once>",
"sandbox": true
}Consulta la URL de estado con el token:
curl https://tuumest.net/v1/allocations/<uuid> \
-H 'authorization: Bearer <access_token>'En testnet la asignación se vuelve active después de unos 30 segundos. SSH es agent@sandbox.tuumest.net. No se aprovisiona ninguna máquina física ni se crea ninguna tarea de operaciones. Si la respuesta en cambio dice pending_settlement, sigue consultando la status_url devuelta; no pagues de nuevo.
La liquidación se confirma solo cuando la transacción es canónica y final en Base, así que una respuesta confirmada del facilitador todavía puede ser pending_settlement durante un rato. Reintentar el mismo pago firmado siempre devuelve la operación original, incluso después del validBefore de la autorización; una autorización vencida nunca convierte un pago en curso en una nueva cotización. Si el estado de la operación pasa a needs_review, el equipo de operaciones ya fue alertado: detente y contacta a soporte en lugar de firmar un pago nuevo.
¿Perdiste el token?
Solicita un desafío de un solo uso en POST /v1/allocations/:id/token/challenge. Firma el message devuelto con la billetera que pagó usando personal_sign, luego envía el mensaje y la firma a POST /v1/allocations/:id/token. Los desafíos caducan a los cinco minutos y se consumen una vez. El token anterior se invalida y la misma firma no se puede reutilizar.
Cliente TypeScript
El cliente TypeScript funciona con este endpoint. El límite de gasto predeterminado del SDK es de $1, así que súbelo explícitamente por encima del mes más 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);Usa una billetera de prueba dedicada. Nunca pongas una clave de mainnet en un agente que lee páginas no confiables.
Semántica de testnet
- Usa USDC de prueba de Base Sepolia; no tiene valor real.
- La dirección de pago es provisional hasta que los fundadores confirmen la billetera receptora.
- No trates una asignación sandbox como una máquina real ni como una promesa de producción.
- Mainnet requiere un
X402_PAY_TOreal, un facilitador de mainnet y un cambio de configuración deliberado.
Índice de la API: /v1