Tuum Est“es tuyo”Solicitar una asignación
x402 · próximamenteBase SepoliaUSDC

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_TO real, un facilitador de mainnet y un cambio de configuración deliberado.

Índice de la API: /v1