x402 Primitives Catalog

const block = await client.post(
  "/api/v1/rpc", {
    chain: "base",
    method: "eth_blockNumber",
    params: []
  }
);
// { result: "0x1a2b3c" }

const pin = await client.post(
  "/api/v1/storage/pin", {
    content: { receipt: "...", tx: "0x..." },
    name: "payroll-receipt-march",
    backend: "ipfs"
  }
);
// { cid: "Qm...", url: "https://..." }

await client.post("/api/v1/cron/schedule", {
  cron: "0 9 1 * *",  // 1st of month
  action: {
    endpoint: "/api/v1/payroll/run",
    body: { name: "Monthly" }
  },
  max_runs: 12
});
// { job_id: "cron_...", next: "..." }

await client.post("/api/v1/logs", {
  action: "ingest",
  entries: [{
    level: "info",
    msg: "Batch sent to 50 recipients",
    tx: "0x..."
  }]
});
// { stored: 1, id: "log_..." }

const img = await client.post(
  "/api/v1/gpu/run", {
    model: "flux-pro",
    input: {
      prompt: "a serene mountain lake"
    }
  }
);
// { id: "abc123", status: "succeeded",
//   output: ["https://replicate.delivery/..."] }

const status = await client.get(
  "/api/v1/gpu/status/abc123xyz"
);
// { id: "abc123xyz", status: "succeeded",
//   output: [...], metrics: { predict_time: 4.2 } }

const models = await client.get(
  "/api/v1/gpu/models"
);
// { total: 13, categories: {
//   image: [{ shortcut: "flux-pro", ... }],
//   video: [...], llm: [...], ... } }

const robot = await client.post(
  "/api/v1/robots/register", {
    name: "WarehouseBot-01",
    capabilities: ["pick", "place", "scan"],
    price_per_task: "0.05",
    payment_address: "0xYourWallet",
    connection: {
      type: "webhook",
      webhookUrl: "https://yourserver.com/rtp/task"
    }
  }
);
// { status: "registered",
//   robot_id: "robo_138fd1f8e0ee51a",
//   rtp_uri: "rtp://gateway.spraay.app/robo_..." }

const result = await client.post(
  "/api/v1/robots/task", {
    robot_id: "robo_138fd1f8e0ee51a",
    task: "pick",
    parameters: {
      item: "SKU-00421",
      from_location: "bin_A3"
    },
    timeout_seconds: 60
  }
);
// { status: "DISPATCHED",
//   task_id: "task_xyz789",
//   escrow_id: "escrow_001" }

await client.post(
  "/api/v1/robots/complete", {
    task_id: "task_xyz789",
    status: "COMPLETED",
    result: {
      success: true,
      output: "Picked SKU-00421 from bin_A3"
    }
  }
);
// { task_id: "task_xyz789",
//   status: "COMPLETED", escrow: "released" }

const robots = await client.get(
  "/api/v1/robots/list?capability=pick&max_price=0.10"
);
// { robots: [{ robot_id: "robo_...",
//   name: "WarehouseBot-01",
//   capabilities: ["pick","place","scan"],
//   price_per_task: "0.05" }], total: 1 }

const status = await client.get(
  "/api/v1/robots/status?task_id=task_xyz789"
);
// { task_id: "task_xyz789",
//   status: "COMPLETED",
//   result: { success: true, output: "..." } }

const profile = await client.get(
  "/api/v1/robots/profile?robot_id=robo_138fd1f8e0ee51a"
);
// { robot_id: "robo_...", name: "WarehouseBot-01",
//   capabilities: ["pick","place","scan"],
//   price_per_task: "0.05", status: "online",
//   rtp_uri: "rtp://gateway.spraay.app/robo_..." }

const updated = await client.patch(
  "/api/v1/robots/update", {
    robot_id: "robo_138fd1f8e0ee51a",
    price_per_task: "0.08",
    capabilities: ["pick", "place", "scan", "deliver"]
  }
);
// { status: "updated",
//   robot_id: "robo_138fd1f8e0ee51a",
//   updated_fields: ["price_per_task", "capabilities"] }

await client.post(
  "/api/v1/robots/deregister", {
    robot_id: "robo_138fd1f8e0ee51a"
  }
);
// { status: "deregistered",
//   robot_id: "robo_138fd1f8e0ee51a",
//   name: "WarehouseBot-01" }