Hive Civilization

Hive Civilization Attest API

The attest API from Hive Civilization — 20 operation(s) for attest.

GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/attest/passport/issue Issue a pre-action attestation passport · Passport Issue #
Ask an LLM
“How do I get a signed passport declaring what my agent intends to do before it acts?”
“Can a pre-action attestation manifest expire after a set number of seconds?”
Tell an agent
Issue a pre-action passport for agent {agent_did} to run {intended_op} on {target_resource} as action {action_id}.
Create a passport manifest for action {action_id} by {agent_did} doing {intended_op} on {target_resource}, valid for {ttl_seconds} seconds.
POST /v1/attest/passport/verify Verify a pre-action attestation passport · Passport Verify #
Ask an LLM
“How can I check that a pre-action passport manifest is genuine before letting the agent act?”
“Can I compare the inputs an agent actually used against what its passport declared?”
Tell an agent
Verify this pre-action passport manifest: {manifest}.
Check passport {manifest} against the inputs I observed: {observed_inputs}.
POST /v1/attest/custody/append Append a step to a custody chain · Custody Append #
Ask an LLM
“How do I record a new transform step in a data custody chain?”
“Can I mark a custody node as tainted when I append it?”
Tell an agent
Append transform {transform_id} by agent {agent_did} to custody chain {chain_id}.
Add a node to custody chain {chain_id} for transform {transform_id} by {agent_did} with taint status {taint_status}.
POST /v1/attest/custody/verify Verify a whole custody chain · Custody Verify #
Ask an LLM
“How do I confirm a custody chain's hash links and signatures are all intact?”
“Does custody verification check whether taint propagated correctly through the chain?”
Tell an agent
Verify the custody chain made of these nodes: {nodes}.
Check hash linkage, signatures and taint propagation for custody nodes {nodes}.
GET /v1/attest/custody/{chain_id}/proof/{index} Get a Merkle inclusion proof for a custody node · Custody Proof #
Ask an LLM
“How do I prove a single node belongs to a custody chain without sharing the whole chain?”
“Can I get a Merkle inclusion proof for a node by its position in the chain?”
Tell an agent
Get the inclusion proof for node {index} in custody chain {chain_id}.
Fetch a Merkle proof that position {index} is part of chain {chain_id}.
POST /v1/attest/cargo/register Register a versioned cargo type · Cargo Register #
Ask an LLM
“How do I register a new payload type with a schema and sensitivity level?”
“Can a new cargo type version supersede an older one?”
Tell an agent
Register cargo type {id} named {name}, version {version}, sensitivity {sensitivity}, with schema {schema}.
Register version {version} of cargo type {id} ({name}, {sensitivity}) using {schema}, superseding {supersedes}.
POST /v1/attest/cargo/validate Validate a payload against a cargo type · Cargo Validate #
Ask an LLM
“How do I check a payload conforms to a registered cargo type before sending it?”
“Which cargo type version will my payload be validated against?”
Tell an agent
Validate {payload} against cargo type {cargo_type_id} version {version}.
Check whether this payload fits cargo type {cargo_type_id} v{version}: {payload}.
GET /v1/attest/cargo/snapshot Snapshot the cargo type registry · Cargo Snapshot #
Ask an LLM
“What cargo types are registered right now?”
“Can I get the Merkle root of the whole cargo taxonomy registry?”
Tell an agent
Get a snapshot of the cargo type registry with its Merkle root.
Show me every registered cargo type.
POST /v1/attest/warranty/issue Issue an attestation warranty for an action · Warranty Issue #
Ask an LLM
“How do I have an agent warrant a claim about an action it took?”
“Can an attestation warranty be scoped and given an expiry date?”
Tell an agent
Issue a warranty from agent {agent_did} for action {action_id} claiming {claim}.
Warrant claim {claim} on action {action_id} by {agent_did}, expiring {expires_at}.
POST /v1/attest/warranty/breach Report a breach of a warranty · Warranty Breach #
Ask an LLM
“How do I report that an agent's attestation warranty turned out to be false?”
“Can I attach evidence when filing a warranty breach?”
Tell an agent
Report a breach of warranty {warranty_id}: {breach_description}.
File a breach on warranty {warranty_id} saying {breach_description}, with evidence {evidence}.
GET /v1/attest/warranty/{warranty_id} Look up a warranty by ID · Warranty Get #
Ask an LLM
“How do I see the details of a warranty that was issued earlier?”
“Where can I check what claim a given warranty ID covers?”
Tell an agent
Get warranty {warranty_id}.
Show me the claim and scope recorded on warranty {warranty_id}.
POST /v1/attest/gate/evaluate Decide whether an agent may pass the attest gate · Gate Evaluate #
Ask an LLM
“How do I decide whether an agent is allowed to proceed based on its passport and custody proofs?”
“Do I get a signed receipt even when the gate denies the agent?”
Tell an agent
Evaluate the gate for passport manifest {passport_manifest}.
Decide allow or deny for passport {passport_manifest} with custody root {custody_root} and warranties {warranty_ids}.
POST /v1/attest/inspect/sample Run a random secondary inspection on records · Inspect Sample #
Ask an LLM
“How can I spot-check a random subset of records instead of inspecting all of them?”
“Can I set the sample rate and a seed so the inspection is reproducible?”
Tell an agent
Run a secondary inspection on sample {sample_id} over these records: {records}.
Inspect {records} for sample {sample_id} at rate {sample_rate} using seed {seed}.
POST /v1/attest/smsh/verify Verify an SMSH-Stamp receipt · Smsh Verify #
Ask an LLM
“How do I check that an SMSH-Stamp v1 receipt is authentic?”
“Can I reject stamp receipts older than a maximum age?”
Tell an agent
Verify SMSH-Stamp receipt {receipt}.
Verify stamp receipt {receipt} with public key {pubkey_b64url}, rejecting it if older than {max_age_seconds} seconds.
POST /v1/attest/absence/build Build an audit window tree for absence proofs · Absence Build #
Ask an LLM
“How do I seal a window of audit events so I can later prove something did not happen?”
“What do I need to build a sorted Merkle tree for an audit window?”
Tell an agent
Build the audit window {window_id} from these events: {events}.
Seal events {events} into a sorted Merkle tree as window {window_id}.
POST /v1/attest/absence/prove Prove an event is absent from an audit window · Absence Prove #
Ask an LLM
“Can I prove a particular event never appeared in an audit window?”
“How do I get a non-membership proof for an event?”
Tell an agent
Prove that event {query} is absent from audit window {window_id}.
Generate a non-membership proof for {query} in window {window_id}.
POST /v1/attest/absence/verify Verify a non-membership proof · Absence Verify #
Ask an LLM
“How do I check someone's absence proof against the audit window root I trust?”
“What happens if a non-membership proof doesn't match the expected root?”
Tell an agent
Verify absence proof {proof} against root {root_hex}.
Check that non-membership proof {proof} is valid for window root {root_hex}.
POST /v1/attest/sanctions/screen Screen a name against sanctions and PEP lists · Sanctions Screen #
Ask an LLM
“How do I check a person or company against sanctions and PEP lists before my agent transacts?”
“Can I narrow a sanctions screen by country or adjust the match threshold?”
Tell an agent
Screen {name} against sanctions and PEP lists.
Run a sanctions check on {name} in {country} with match threshold {threshold}.
POST /v1/attest/agentkit/lookup Check if an agent wallet is human-backed · Agentkit Lookup #
Ask an LLM
“How can I tell whether an agent's wallet is registered as human-backed in AgentBook?”
“Is the AgentKit lookup read directly from the chain?”
Tell an agent
Look up wallet {address} in AgentBook.
Check whether agent wallet {address} is backed by a registered human.
POST /v1/attest/address/screen Screen a crypto address for risk · Address Screen #
Ask an LLM
“How do I check a wallet address for scam, phishing or other risk flags before paying it?”
“Can I screen an on-chain address on a specific chain?”
Tell an agent
Screen address {address} for on-chain risk.
Run a risk screen on wallet {address} on chain {chain_id}.

Documentation

📖
Documentation
https://thehiveryiq.com/developers
📖
APIReference
https://receipts.thehiveryiq.com/docs
📖
GettingStarted
https://thehiveryiq.com/agents
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/authentication/thehiveryiq-com-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/rate-limits/thehiveryiq-com-rate-limits.yml
📖
Documentation
https://thehiveryiq.com/sdk-quickstart/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-attest-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-receipts-llms.txt
🔗
LLMsTxt
https://receipts.thehiveryiq.com/llms.txt
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/data-model/thehiveryiq-com-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/asyncapi/thehiveryiq-com-webhooks.yml
🔗
StatusPage
https://receipts.thehiveryiq.com/status
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/errors/thehiveryiq-com-problem-types.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/sandbox/thehiveryiq-com-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-hivecompute-llms.txt
🔗
LLMsTxt
https://api.thehiveryiq.com/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/mcp/thehiveryiq-com-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/thehiveryiq-com:thehiveryiq-com-attest-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thehiveryiq-com-attest-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Attest API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: attest
paths:
  /v1/attest/passport/issue:
    post:
      tags:
      - attest
      summary: Passport Issue
      description: Issue a Pre-Action Attestation Manifest (C15 — hive-passport).
      operationId: passport_issue_v1_attest_passport_issue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PassportIssueRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/passport/verify:
    post:
      tags:
      - attest
      summary: Passport Verify
      description: Verify a Pre-Action Attestation Manifest (C15 — hive-passport).
      operationId: passport_verify_v1_attest_passport_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PassportVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/custody/append:
    post:
      tags:
      - attest
      summary: Custody Append
      description: Append a node to a custody chain (C16 — hive-custody).
      operationId: custody_append_v1_attest_custody_append_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustodyAppendRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/custody/verify:
    post:
      tags:
      - attest
      summary: Custody Verify
      description: Verify a custody chain (hash linkage + signatures + taint propagation, C16).
      operationId: custody_verify_v1_attest_custody_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustodyVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/custody/{chain_id}/proof/{index}:
    get:
      tags:
      - attest
      summary: Custody Proof
      description: Return a Merkle inclusion proof for node[index] in a chain (C16).
      operationId: custody_proof_v1_attest_custody__chain_id__proof__index__get
      parameters:
      - name: chain_id
        in: path
        required: true
        schema:
          type: string
          title: Chain Id
      - name: index
        in: path
        required: true
        schema:
          type: integer
          title: Index
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/cargo/register:
    post:
      tags:
      - attest
      summary: Cargo Register
      description: Register a versioned cargo type (C17 — hive-cargo-taxonomy).
      operationId: cargo_register_v1_attest_cargo_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoRegisterRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/cargo/validate:
    post:
      tags:
      - attest
      summary: Cargo Validate
      description: Validate a payload against a registered cargo type (C17).
      operationId: cargo_validate_v1_attest_cargo_validate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoValidateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/cargo/snapshot:
    get:
      tags:
      - attest
      summary: Cargo Snapshot
      description: Return a registry snapshot with Merkle root (C17).
      operationId: cargo_snapshot_v1_attest_cargo_snapshot_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/attest/warranty/issue:
    post:
      tags:
      - attest
      summary: Warranty Issue
      description: Issue an attestation warranty (C18 — hive-attestation-warranty).
      operationId: warranty_issue_v1_attest_warranty_issue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WarrantyIssueRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/warranty/breach:
    post:
      tags:
      - attest
      summary: Warranty Breach
      description: Report a warranty breach (C18).
      operationId: warranty_breach_v1_attest_warranty_breach_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WarrantyBreachRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/warranty/{warranty_id}:
    get:
      tags:
      - attest
      summary: Warranty Get
      description: Retrieve a warranty by ID (C18).
      operationId: warranty_get_v1_attest_warranty__warranty_id__get
      parameters:
      - name: warranty_id
        in: path
        required: true
        schema:
          type: string
          title: Warranty Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/gate/evaluate:
    post:
      tags:
      - attest
      summary: Gate Evaluate
      description: 'Evaluate whether an agent may proceed through the HiveAttest gate (C19).


        Every response (allow OR deny) includes a signed C18-format receipt of

        the gate decision. Decision bytes = JCS({decision, reasons, passport_fingerprint,

        manifest_fingerprint, timestamp}); signed with hivemorph signing key.'
      operationId: gate_evaluate_v1_attest_gate_evaluate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GateEvaluateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/inspect/sample:
    post:
      tags:
      - attest
      summary: Inspect Sample
      description: Perform probabilistic secondary inspection on a sample (C20).
      operationId: inspect_sample_v1_attest_inspect_sample_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InspectSampleRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/smsh/verify:
    post:
      tags:
      - attest
      summary: Smsh Verify
      description: Verify a SMSH-Stamp v1 receipt (C8/C12 — smsh-stamp-verifier).
      operationId: smsh_verify_v1_attest_smsh_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmshVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/absence/build:
    post:
      tags:
      - attest
      summary: Absence Build
      description: Build a sorted Merkle tree for an audit window (C13 — prov-absence).
      operationId: absence_build_v1_attest_absence_build_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AbsenceBuildRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/absence/prove:
    post:
      tags:
      - attest
      summary: Absence Prove
      description: Prove that a query event is absent from a built window (C13).
      operationId: absence_prove_v1_attest_absence_prove_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AbsenceProveRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/absence/verify:
    post:
      tags:
      - attest
      summary: Absence Verify
      description: Verify a non-membership proof against an expected root (C13).
      operationId: absence_verify_v1_attest_absence_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AbsenceVerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/sanctions/screen:
    post:
      tags:
      - attest
      summary: Sanctions Screen
      description: 'C21 — Pre-action sanctions/PEP screening with signed receipt.


        REAL RAIL. Proxies OpenSanctions consolidated dataset (OFAC SDN, EU, UK HMT, UN,

        PEPs, debarment). Every decision (clear or flagged) returns a C18-format signed

        receipt suitable for custody-chain pinning.


        No mock. No simulation. Production OpenSanctions match endpoint.'
      operationId: sanctions_screen_v1_attest_sanctions_screen_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SanctionsScreenRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/agentkit/lookup:
    post:
      tags:
      - attest
      summary: Agentkit Lookup
      description: 'C22 — AgentKit / AgentBook lookup with signed receipt.


        REAL RAIL. Reads the canonical AgentBook contract on World Chain via JSON-RPC

        eth_call (no SDK, no sidecar — direct on-chain read using web3.py-compatible

        raw RPC). Returns whether the agent wallet is human-backed (registered) and

        the anonymous human identifier if so.


        No mock. No simulation. Direct chain read.'
      operationId: agentkit_lookup_v1_attest_agentkit_lookup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentBookLookupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/attest/address/screen:
    post:
      tags:
      - attest
      summary: Address Screen
      description: 'C23 — On-chain address risk screening with signed receipt.


        REAL RAIL. Proxies GoPlus Security public address-security API (the same

        engine MetaMask and Trust Wallet use for wallet-level risk warnings).

        Screens 17+ risk vectors per address. No mock. No simulation. Live upstream.


        Decision logic:

        - FLAG if any boolean risk vector returns "1"

        - CLEAR otherwise'
      operationId: address_screen_v1_attest_address_screen_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddressRiskScreenRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CargoValidateRequest:
      properties:
        cargo_type_id:
          type: string
          title: Cargo Type Id
          description: Registered cargo type ID
        version:
          type: string
          title: Version
          description: Cargo type version
        payload:
          additionalProperties: true
          type: object
          title: Payload
          description: Payload to validate
      type: object
      required:
      - cargo_type_id
      - version
      - payload
      title: CargoValidateRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    WarrantyBreachRequest:
      properties:
        warranty_id:
          type: string
          title: Warranty Id
          description: Warranty ID to report breach on
        breach_description:
          type: string
          title: Breach Description
          description: Description of the breach
        evidence:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Evidence
          description: Optional evidence dict
      type: object
      required:
      - warranty_id
      - breach_description
      title: WarrantyBreachRequest
    AbsenceProveRequest:
      properties:
        window_id:
          type: string
          title: Window Id
          description: Audit window identifier (must have been built)
        query:
          additionalProperties: true
          type: object
          title: Query
          description: Event to prove absent
      type: object
      required:
      - window_id
      - query
      title: AbsenceProveRequest
    AgentBookLookupRequest:
      properties:
        address:
          type: string
          title: Address
          description: EVM wallet address (0x-prefixed) to look up in AgentBook
      type: object
      required:
      - address
      title: AgentBookLookupRequest
      description: 'AgentKit / AgentBook lookup — verify whether an agent wallet is human-backed.


        Real rail: reads the canonical AgentBook contract on World Chain

        (0xA23aB2712eA7BBa896930544C7d6636a96b944dA, lookupHuman(address) view).'
    AbsenceBuildRequest:
      properties:
        window_id:
          type: string
          title: Window Id
          description: Audit window identifier
        events:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Events
          description: Observed events to commit to the sorted Merkle tree
      type: object
      required:
      - window_id
      - events
      title: AbsenceBuildRequest
    PassportIssueRequest:
      properties:
        action_id:
          type: string
          title: Action Id
          description: Caller-supplied action correlation ID
        agent_did:
          type: string
          title: Agent Did
          description: DID of the attesting agent
        intended_op:
          type: string
          title: Intended Op
          description: Operation name, e.g. 'tool_invocation'
        target_resource:
          type: string
          title: Target Resource
          description: URI or identifier of the target
        inputs:
          additionalProperties: true
          type: object
          title: Inputs
          description: Declared inputs (hashed)
        ttl_seconds:
          type: integer
          minimum: 1.0
          title: Ttl Seconds
          description: Validity window in seconds
          default: 300
      type: object
      required:
      - action_id
      - agent_did
      - intended_op
      - target_resource
      title: PassportIssueRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PassportVerifyRequest:
      properties:
        manifest:
          additionalProperties: true
          type: object
          title: Manifest
          description: Full passport manifest object
        observed_inputs:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Observed Inputs
          description: Optional inputs to check against declared hash
      type: object
      required:
      - manifest
      title: PassportVerifyRequest
    SanctionsScreenRequest:
      properties:
        name:
          type: string
          title: Name
          description: Full legal name of person or entity to screen
        schema_type:
          type: string
          enum:
          - Person
          - Company
          - Organization
          - LegalEntity
          title: Schema Type
          description: Entity type per FollowTheMoney ontology
          default: Person
        country:
          anyOf:
          - type: string
          - type: 'null'
          title: Country
          description: ISO-3166 country code (improves matching)
        threshold:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Threshold
          description: Match score threshold above which to flag
          default: 0.7
      type: object
      required:
      - name
      title: SanctionsScreenRequest
      description: 'Pre-action sanctions/PEP screening — gate decision before any USDC transfer or counterparty onboarding.


        Real rail: proxies OpenSanctions consolidated dataset (OFAC SDN, EU, UK HMT, UN, PEPs, debarment).'
    AddressRiskScreenRequest:
      properties:
        address:
          type: string
          title: Address
          description: EVM wallet address (0x-prefixed) to screen
        chain_id:
          type: integer
          title: Chain Id
          description: EVM chain ID (default 8453 = Base, where Hive USDC settles)
          default: 8453
      type: object
      required:
      - address
      title: AddressRiskScreenRequest
      description: 'Pre-settlement on-chain address risk screening — 19-vector check before any USDC transfer.


        Real rail: proxies GoPlus Security public address-security API (the same engine used

        inside MetaMask and Trust Wallet for wallet-level risk warnings).


        Returns flags for: cybercrime, money_laundering, sanctioned, mixer, phishing,

        darkweb_transactions, financial_crime, blackmail_activities, stealing_attack,

        fake_kyc, blacklist_doubt, honeypot_related_address, malicious_mining_activities,

        fake_token, fake_standard_interface, gas_abuse, reinit, contract_address,

        number_of_malicious_contracts_created.'
    AbsenceVerifyRequest:
      properties:
        proof:
          additionalProperties: true
          type: object
          title: Proof
          description: Non-membership proof from /absence/prove
        root_hex:
          type: string
          title: Root Hex
          description: Expected Merkle root (hex)
      type: object
      required:
      - proof
      - root_hex
      title: AbsenceVerifyRequest
    CargoRegisterRequest:
      properties:
        id:
          type: string
          title: Id
          description: Unique cargo type ID, e.g. 'pii'
        name:
          type: string
          title: Name
          description: Human-readable cargo type name
        version:
          type: string
          title: Version
          description: Semver version string, e.g. '1.0.0'
        sensitivity:
          type: string
          enum:
          - public
          - internal
          - confidential
          - restricted
          - critical
          title: Sensitivity
        schema:
          additionalProperties: true
          type: object
          title: Schema
          description: JSON Schema for payload
        supersedes:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Supersedes
          description: Optional {id, version} of superseded type
      type: object
      required:
      - id
      - name
      - version
      - sensitivity
      - schema
      title: CargoRegisterRequest
    SmshVerifyRequest:
      properties:
        receipt:
          additionalProperties: true
          type: object
          title: Receipt
          description: SMSH-Stamp v1 receipt object
        pubkey_b64url:
          anyOf:
          - type: string
          - type: 'null'
          title: Pubkey B64Url
          description: Override trust anchor Ed25519 public key (base64url, 32 bytes)
        max_age_seconds:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          title: Max Age Seconds
          description: Reject receipts older than this many seconds
      type: object
      required:
      - receipt
      title: SmshVerifyRequest
    GateEvaluateRequest:
      properties:
        passport_manifest:
          additionalProperties: true
          type: object
          title: Passport Manifest
          description: C15 passport manifest
        cargo_manifest:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Cargo Manifest
          description: C17 cargo manifest (optional)
        custody_root:
          anyOf:
          - type: string
          - type: 'null'
          title: Custody Root
          description: Expected custody chain Merkle root (optional)
        warranty_ids:
          items:
            type: string
          type: array
          title: Warranty Ids
          description: Active warranty IDs to verify
        context:
          additionalProperties: true
          type: object
          title: Context
          description: Additional gate evaluation context
      type: object
      required:
      - passport_manifest
      title: GateEvaluateRequest
    CustodyVerifyRequest:
      properties:
        nodes:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Nodes
          description: Ordered list of custody chain nodes
      type: object
      required:
      - nodes
      title: CustodyVerifyRequest
    CustodyAppendRequest:
      properties:
        chain_id:
          type: string
          title: Chain Id
          description: Chain identifier (create new or append to existing)
        transform_id:
          type: string
          title: Transform Id
          description: Transform identifier for this step
        agent_did:
          type: string
          title: Agent Did
          description: DID of the agent performing the transform
        payload:
          additionalProperties: true
          type: object
          title: Payload
          description: Transform payload (will be hashed)
        taint_status:
          type: string
          enum:
          - clean
          - tainted
          - unknown
          title: Taint Status
          description: Declared taint status for this node
          default: clean
      type: object
      required:
      - chain_id
      - transform_id
      - agent_did
      title: CustodyAppendRequest
    InspectSampleRequest:
      properties:
        sample_id:
          type: string
          title: Sample Id
          description: Identifier for the sample batch
        records:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Records
          description: Records to probabilistically inspect
        sample_rate:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Sample Rate
          description: Fraction to inspect (0.0–1.0)
          default: 0.1
        seed:
          anyOf:
          - type: integer
          - type: 'null'
          title: Seed
          description: Optional RNG seed for reproducibility
      type: object
      required:
      - sample_id
      - records
      title: InspectSampleRequest
    WarrantyIssueRequest:
      properties:
        agent_did:
          type: string
          title: Agent Did
          description: DID of the warranting agent
        action_id:
          type: string
          title: Action Id
          description: Action correlation ID being warranted
        claim:
          type: string
          title: Claim
          description: Human-readable warranty claim
        scope:
          additionalProperties: true
          type: object
          title: Scope
          description: Scope constraints
        expires_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Expires At
          description: ISO-8601 expiry UTC
      type: object
      required:
      - agent_did
      - action_id
      - claim
      title: WarrantyIssueRequest
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)