Hive Compute Grid

List the 15-agent compute grid fleet across all 6 driver types (cross_pool_auction, workload_decomposition, verification_fleet, capacity_listener, qvac_mesh_orchestrator, settlement_reporting). Returns agent type, count, and revenue model. No auth required.

{
  "type": "object",
  "properties": {}
}

Read-only capacity view from the Capacity Listener fleet. Per spec section 8: NO bids, NO hedges, NO positions, NO derivatives — pure read-only telemetry. Optional refresh=true triggers one upstream pull.

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "description": "Top-N rows to return (default 32, max 256)",
      "minimum": 1,
      "maximum": 256
    },
    "refresh": {
      "type": "boolean",
      "description": "Force a read-only refresh from the upstream Compute service"
    }
  }
}

List enabled provider adapters (io.net, Akash, Render) and their upstream health. Returns required env vars for reservation paths. Real probes, no mocks.

{
  "type": "object",
  "properties": {}
}

Gather quotes across enabled compute providers WITHOUT running the auction (no proof, no ledger write). Useful for live price discovery on a workload.

{
  "type": "object",
  "properties": {
    "gpu_type": {
      "type": "string",
      "description": "cpu | rtx_4090 | rtx_3090 | rtx_a6000 | a100 | h100 | l40s"
    },
    "duration_hours": {
      "type": "number",
      "description": "Job duration in hours (>0)",
      "exclusiveMinimum": 0
    },
    "cpu_cores": {
      "type": "integer",
      "description": "CPU cores (default 1)",
      "minimum": 1
    },
    "ram_gb": {
      "type": "integer",
      "description": "RAM in GB (default 4)",
      "minimum": 1
    },
    "budget_usd": {
      "type": "number",
      "description": "Optional budget cap in USD"
    }
  },
  "required": [
    "gpu_type",
    "duration_hours"
  ]
}

Run the cross-pool auction. Returns chosen provider, all collected quotes, Groth16-shaped selection proof, signed verification receipt, settlement path. Persists cost_usdc telemetry to the Hive ledger by default.

{
  "type": "object",
  "properties": {
    "gpu_type": {
      "type": "string",
      "description": "cpu | rtx_4090 | a100 | h100 | l40s | rtx_3090 | rtx_a6000"
    },
    "duration_hours": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "cpu_cores": {
      "type": "integer",
      "minimum": 1
    },
    "ram_gb": {
      "type": "integer",
      "minimum": 1
    },
    "budget_usd": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "deadline_unix": {
      "type": "integer",
      "description": "Optional unix-second deadline; must be in the future"
    },
    "job_id": {
      "type": "string"
    },
    "submitter_did": {
      "type": "string",
      "description": "DID of the submitting agent (e.g. 'did:hive:agent:foo')"
    },
    "persist": {
      "type": "boolean",
      "description": "Write auction telemetry to ledger (default true)"
    }
  },
  "required": [
    "gpu_type",
    "duration_hours"
  ]
}

Reserve compute with the chosen provider after a /solve. Returns 503 with the missing-key error if the upstream provider key is not configured (real rails only — never fake a booking).

{
  "type": "object",
  "properties": {
    "auction_id": {
      "type": "string"
    },
    "provider": {
      "type": "string",
      "enum": [
        "io_net",
        "akash",
        "render"
      ]
    },
    "quote": {
      "type": "object",
      "description": "Chosen Quote object from /solve.chosen_quote"
    },
    "deadline_unix": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "auction_id",
    "provider",
    "quote",
    "deadline_unix"
  ]
}

Poll a provider booking by booking_id. Returns 503 until /book is wired with a real provider key. The 503 body documents which env var is required.

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ]
}

Release a provider reservation. Same gating as /book — 503 with documented missing-key error when the provider is not fully wired.

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "io_net",
        "akash",
        "render"
      ]
    },
    "booking_id": {
      "type": "string"
    }
  },
  "required": [
    "provider",
    "booking_id"
  ]
}

Read recent compute_grid_auction entries from the canonical receipt ledger — cost_usdc telemetry per cleared auction. Useful for treasury reconciliation and provenance audits.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Number of recent entries (default 20)"
    }
  }
}

Submit a Groth16 proof envelope + public inputs to the Verification Fleet (4 agents). Validates structure, signs an EIP-191 receipt with the Evaluator wallet. $0.001/proof in USDC.

{
  "type": "object",
  "properties": {
    "proof": {
      "description": "Groth16 proof envelope (dict {a,b,c} or 8-element list of BN254 field elements)"
    },
    "public_inputs": {
      "type": "array",
      "description": "List of BN254 field elements (hex strings or ints)"
    },
    "claim": {
      "type": "object",
      "description": "Optional claim metadata (model_id, job_id, output_hash, ...)"
    },
    "proof_system": {
      "type": "string",
      "description": "Proof system identifier (default 'groth16')"
    }
  },
  "required": [
    "proof",
    "public_inputs"
  ]
}

Independently verify a selection proof envelope (e.g. from a prior /solve response). Returns the verifier’s signed receipt. Lets external auditors confirm an auction selection without trusting the broker.

{
  "type": "object",
  "properties": {
    "proof": {
      "description": "Groth16 envelope from /solve.proof_envelope"
    },
    "public_inputs": {
      "type": "array",
      "description": "From /solve.proof_public_inputs"
    }
  },
  "required": [
    "proof",
    "public_inputs"
  ]
}

Register an agent for the Hive Civilization attribution payout program. Settlement on real Base USDC. 5% kickback on attributed traffic, weekly payout. Calls POST https://receipts.thehiveryiq.com/v1/earn/register on behalf of the caller. Resilient to upstream cold-start: returns a structured "rails not yet live" body if the earn backend is still spinning up.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "description": "Caller agent DID (e.g. did:hive:0x… or did:web:…). Required."
    },
    "payout_address": {
      "type": "string",
      "description": "Base L2 EVM address (0x…) to receive USDC kickback payouts."
    },
    "attribution_url": {
      "type": "string",
      "description": "Public URL of the agent / page driving attributed traffic to Hive. Used for ranking + audit."
    }
  },
  "required": [
    "agent_did",
    "payout_address",
    "attribution_url"
  ]
}

Look up the caller agent's registered earn profile, lifetime + pending USDC balance, last payout tx hash, and next-payout ETA. Real Base USDC, no mock data. Calls GET https://receipts.thehiveryiq.com/v1/earn/me?agent_did=<did>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "description": "Agent DID to look up. Required."
    }
  },
  "required": [
    "agent_did"
  ]
}

Top earning agents on the Hive Civilization, by attribution payout in USDC. Real Base USDC settlement. Calls GET https://receipts.thehiveryiq.com/v1/earn/leaderboard?window=<window>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "description": "Time window. One of: \"7d\", \"30d\", \"lifetime\". Default \"7d\".",
      "enum": [
        "7d",
        "30d",
        "lifetime"
      ]
    }
  }
}