HiveTrust

Register a new AI agent identity with HiveTrust KYA (Know Your Agent). Assigns a unique agent ID, anchors the public key, and initializes the trust score.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable agent name"
    },
    "description": {
      "type": "string",
      "description": "What this agent does"
    },
    "public_key": {
      "type": "string",
      "description": "Ed25519 public key (base58 encoded)"
    },
    "public_key_format": {
      "type": "string",
      "enum": [
        "ed25519-base58",
        "ed25519-hex",
        "jwk"
      ],
      "description": "Encoding format of the public key",
      "default": "ed25519-base58"
    },
    "checksum": {
      "type": "string",
      "description": "SHA-256 checksum of the agent (system prompt + tools + model config)"
    },
    "owner_id": {
      "type": "string",
      "description": "ID of the owning organization or user"
    },
    "owner_type": {
      "type": "string",
      "enum": [
        "organization",
        "individual",
        "dao"
      ],
      "default": "organization"
    },
    "model_provider": {
      "type": "string",
      "description": "e.g. openai, anthropic, google"
    },
    "model_name": {
      "type": "string",
      "description": "e.g. gpt-4o, claude-3-5-sonnet"
    },
    "model_version": {
      "type": "string",
      "description": "Specific model version"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of capability tags (e.g. [\"finance\", \"trading\", \"research\"])"
    },
    "verticals": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Industry verticals this agent operates in"
    },
    "delegation_scope": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Scope of delegated authority"
    },
    "eu_ai_act_class": {
      "type": "string",
      "enum": [
        "minimal_risk",
        "limited_risk",
        "high_risk",
        "unacceptable_risk"
      ],
      "default": "minimal_risk",
      "description": "EU AI Act risk classification"
    },
    "hiveagent_id": {
      "type": "string",
      "description": "Cross-reference ID from HiveAgent platform"
    },
    "metadata": {
      "type": "object",
      "description": "Additional key-value metadata"
    }
  },
  "required": [
    "name",
    "owner_id"
  ]
}

Retrieve a registered agent's full identity profile, including public key, checksum, trust tier, capabilities, and compliance status.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID or DID (e.g. \"did:hivetrust:abc123\")"
    }
  },
  "required": [
    "agent_id"
  ]
}

Verify an agent's cryptographic identity by checking public key ownership and checksum integrity. Returns a verification result with confidence score and reason codes.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID or DID to verify"
    },
    "challenge": {
      "type": "string",
      "description": "Optional challenge string to verify live key possession"
    },
    "signature": {
      "type": "string",
      "description": "Agent's signature of the challenge (base58 encoded)"
    },
    "checksum": {
      "type": "string",
      "description": "Current agent checksum to compare against registered value"
    }
  },
  "required": [
    "agent_id"
  ]
}

Retrieve an agent's current multi-pillar trust score (0–1000 scale). Returns composite score, tier, per-pillar breakdown (identity, behavior, fidelity, compliance, provenance), verdict, and max recommended transaction value.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID or DID"
    }
  },
  "required": [
    "agent_id"
  ]
}

Quick risk assessment for payment processors and marketplace operators. Returns verdict (ALLOW/REVIEW/BLOCK), trust tier, and max transaction limit. This is the free public endpoint — no API key required.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID or DID to assess"
    }
  },
  "required": [
    "agent_id"
  ]
}

Bulk ingest behavioral telemetry events for an agent. These events feed into the trust scoring engine. Supports transaction completions, SLA violations, dispute events, tool calls, and more.

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "description": "Array of behavioral events to ingest",
      "items": {
        "type": "object",
        "properties": {
          "agent_id": {
            "type": "string",
            "description": "Agent UUID"
          },
          "event_type": {
            "type": "string",
            "enum": [
              "transaction_completed",
              "transaction_failed",
              "sla_violation",
              "dispute_filed",
              "dispute_resolved",
              "tool_call",
              "auth_success",
              "auth_failure",
              "checksum_mismatch",
              "fidelity_probe",
              "capital_staked",
              "capital_withdrawn"
            ],
            "description": "Type of behavioral event"
          },
          "source": {
            "type": "string",
            "description": "Platform or system emitting the event"
          },
          "source_platform": {
            "type": "string",
            "description": "Platform name"
          },
          "action": {
            "type": "string",
            "description": "Specific action performed"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "success",
              "failure",
              "partial",
              "disputed"
            ],
            "description": "Outcome of the action"
          },
          "counterparty_id": {
            "type": "string",
            "description": "ID of the other party in the transaction"
          },
          "transaction_value": {
            "type": "number",
            "description": "Transaction value in USDC"
          },
          "evidence": {
            "type": "object",
            "description": "Supporting evidence for the event"
          },
          "metadata": {
            "type": "object",
            "description": "Additional event metadata"
          }
        },
        "required": [
          "agent_id",
          "event_type",
          "source"
        ]
      }
    }
  },
  "required": [
    "events"
  ]
}

Issue a W3C-compatible verifiable credential to an agent. Credentials represent verified claims such as identity verification, compliance certification, or domain expertise.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID to issue the credential to"
    },
    "credential_type": {
      "type": "string",
      "enum": [
        "IdentityVerification",
        "ComplianceCertification",
        "DomainExpertise",
        "CapitalVerification",
        "HumanOversight",
        "ThirdPartyAudit"
      ],
      "description": "Type of verifiable credential"
    },
    "issuer_id": {
      "type": "string",
      "description": "ID of the issuing entity"
    },
    "claims": {
      "type": "object",
      "description": "Credential claims (key-value pairs specific to the credential type)"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 expiration date (optional)"
    }
  },
  "required": [
    "agent_id",
    "credential_type",
    "issuer_id",
    "claims"
  ]
}

Verify a previously issued verifiable credential. Checks signature validity, revocation status, and expiration.

{
  "type": "object",
  "properties": {
    "credential_id": {
      "type": "string",
      "description": "UUID of the credential to verify"
    }
  },
  "required": [
    "credential_id"
  ]
}

Revoke a verifiable credential. Records the revocation in the registry. Revoked credentials immediately fail verification checks.

{
  "type": "object",
  "properties": {
    "credential_id": {
      "type": "string",
      "description": "UUID of the credential to revoke"
    },
    "agent_id": {
      "type": "string",
      "description": "Agent UUID that owns the credential"
    },
    "reason": {
      "type": "string",
      "description": "Reason for revocation (e.g. \"compromised_key\", \"expired_compliance\")"
    },
    "evidence": {
      "type": "object",
      "description": "Supporting evidence for the revocation"
    }
  },
  "required": [
    "credential_id",
    "reason"
  ]
}

Get a dynamic insurance premium quote for an agent transaction. Premium is calculated based on trust score, transaction value, and risk tier. HiveTrust takes a 1.5% spread on insured transactions.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID being insured"
    },
    "counterparty_id": {
      "type": "string",
      "description": "ID of the counterparty agent or user (optional)"
    },
    "transaction_value": {
      "type": "number",
      "description": "Value of the transaction in USDC",
      "minimum": 0
    }
  },
  "required": [
    "agent_id",
    "transaction_value"
  ]
}

Bind (activate) an insurance policy for an agent. Locks in the premium, creates the policy record, and deploys the escrow contract on Base L2.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID to insure"
    },
    "quote_details": {
      "type": "object",
      "description": "Quote object returned by hivetrust_get_insurance_quote"
    },
    "transaction_value": {
      "type": "number",
      "description": "Transaction value in USDC",
      "minimum": 0
    }
  },
  "required": [
    "agent_id",
    "transaction_value"
  ]
}

File an insurance claim against an active policy. Triggers claims adjudication workflow. Payouts are made in USDC via the Base L2 escrow contract.

{
  "type": "object",
  "properties": {
    "policy_id": {
      "type": "string",
      "description": "Insurance policy UUID"
    },
    "claimant_id": {
      "type": "string",
      "description": "ID of the entity filing the claim"
    },
    "claim_type": {
      "type": "string",
      "enum": [
        "non_delivery",
        "fraud",
        "sla_breach",
        "data_loss",
        "unauthorized_action"
      ],
      "description": "Type of claim being filed"
    },
    "amount": {
      "type": "number",
      "description": "Claim amount in USDC",
      "minimum": 0
    },
    "description": {
      "type": "string",
      "description": "Detailed description of the claim"
    },
    "evidence": {
      "type": "object",
      "description": "Supporting evidence (transaction IDs, logs, screenshots)"
    }
  },
  "required": [
    "policy_id",
    "claimant_id",
    "claim_type",
    "amount"
  ]
}

File a dispute or appeal against a trust score decision, credential revocation, or behavioral event. Initiates the dispute resolution workflow.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent UUID filing the dispute"
    },
    "dispute_type": {
      "type": "string",
      "enum": [
        "score_dispute",
        "credential_dispute",
        "event_dispute",
        "policy_dispute"
      ],
      "description": "Category of the dispute"
    },
    "target_type": {
      "type": "string",
      "enum": [
        "trust_score",
        "credential",
        "behavioral_event",
        "insurance_policy",
        "insurance_claim"
      ],
      "description": "Type of the resource being disputed"
    },
    "target_id": {
      "type": "string",
      "description": "UUID of the resource being disputed"
    },
    "reason": {
      "type": "string",
      "description": "Detailed reason for the dispute"
    },
    "evidence": {
      "type": "object",
      "description": "Supporting evidence for the dispute"
    }
  },
  "required": [
    "agent_id",
    "dispute_type",
    "target_type",
    "target_id",
    "reason"
  ]
}

Retrieve HiveTrust platform-wide statistics: total registered agents, verified count, average trust score, total insured value, active policies, claims filed, and more.

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

Create a Data Oracle Context Lease — "Sign Once, Settle Many". Grants unlimited access to a data stream for a fixed period (24h/72h/168h). Returns a cryptographic lease token (SHA-256) for zero-friction verification. Available streams: construction_pricing, simpson_catalog, compliance_feeds, market_data, pheromone_signals.

{
  "type": "object",
  "properties": {
    "lessee_did": {
      "type": "string",
      "description": "DID of the agent acquiring the lease (e.g. \"did:hivetrust:abc123\")"
    },
    "data_stream": {
      "type": "string",
      "enum": [
        "construction_pricing",
        "simpson_catalog",
        "compliance_feeds",
        "market_data",
        "pheromone_signals"
      ],
      "description": "The data stream to lease access to"
    },
    "duration_hours": {
      "type": "number",
      "enum": [
        24,
        72,
        168
      ],
      "description": "Lease duration in hours (24h, 72h, or 168h / 1 week)"
    }
  },
  "required": [
    "lessee_did",
    "data_stream",
    "duration_hours"
  ]
}

Stake USDC to back an agent's reputation via HiveBond. Creates a trust bond with a specified tier (bronze/silver/gold/platinum) and lock period. Phase 1: declared stake amount tracked in-memory; flat $0.25 registration fee via x402. Longer lock periods earn higher simulated yield (2–5% APY). Slashing is permanent — if an agent fails, stake is slashed and paid to injured parties.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "description": "DID of the agent staking (e.g. \"did:hive:abc123\")"
    },
    "amount_usdc": {
      "type": "number",
      "description": "Amount of USDC to stake. Must meet tier minimum: bronze $100, silver $500, gold $2000, platinum $10000.",
      "minimum": 100
    },
    "tier": {
      "type": "string",
      "enum": [
        "bronze",
        "silver",
        "gold",
        "platinum"
      ],
      "description": "Bond tier. Determines max bounty access: bronze $1k, silver $10k, gold $50k, platinum unlimited."
    },
    "lock_period_days": {
      "type": "number",
      "enum": [
        30,
        90,
        180,
        365
      ],
      "description": "Lock period in days. Longer lock = higher APY: 30d 2%, 90d 3%, 180d 4%, 365d 5%."
    }
  },
  "required": [
    "agent_did",
    "amount_usdc",
    "tier",
    "lock_period_days"
  ]
}

Quick bond verification — check if an agent is bonded and at what tier. Returns bonded status, tier, staked amount, slash count, and max bounty access. This is the key integration point — other services call this to check bond status before assigning bounties. Free endpoint, no x402 payment required.

{
  "type": "object",
  "properties": {
    "did": {
      "type": "string",
      "description": "DID of the agent to verify (e.g. \"did:hive:abc123\")"
    }
  },
  "required": [
    "did"
  ]
}