Hive Civilization

Hive Civilization Salvage API

The salvage API from Hive Civilization — 23 operation(s) for salvage.

GitHub OpenAPI

Operations 23

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/salvage/listener/observe Inject a failure signal for a transaction · Listener Observe #
Ask an LLM
“How do I manually feed a transaction signal into the Salvage listener from an external source?”
“Can I report that a transaction reverted along with the proof type and signal source?”
Tell an agent
Inject a signal for transaction {tx_id} from source {source_id} of type {source_type} with proof {proof_type}.
Record that transaction {tx_id} has status {tx_status}, observed by {source_id} ({source_type}) with {proof_type} proof.
POST /v1/salvage/listener/observe/bridge Report a cross-chain bridge observation · Listener Observe Bridge #
Ask an LLM
“How do I tell Salvage a bridge transfer left the source chain but never arrived at the destination?”
“Is there a shorthand for reporting bridge transfers without building a full signal?”
Tell an agent
Report bridge transaction {tx_id} from {source_chain} to {dest_chain}: source confirmed {source_confirmed}, arrived {dest_arrived}.
Flag bridge transfer {tx_id} from {source_chain} to {dest_chain} as confirmed at source ({source_confirmed}) but not arrived ({dest_arrived}).
GET /v1/salvage/listener/queue List verified failures awaiting recovery · Listener Queue #
Ask an LLM
“Which verified transaction failures are still waiting to be recovered?”
“What's in the listener queue right now?”
Tell an agent
Show me the verified failures waiting in the recovery queue.
List every failed transaction the listener has verified but not yet recovered.
GET /v1/salvage/listener/sources View the signal source trust registry · Listener Sources #
Ask an LLM
“How much does Salvage trust each of my signal sources?”
“Where can I see the registry of signal sources and their trust levels?”
Tell an agent
Show the trust registry for all signal sources.
List the signal sources the listener knows about and their trust standing.
GET /v1/salvage/listener/quarantine List permanently quarantined signal sources · Listener Quarantine #
Ask an LLM
“Which signal sources have been permanently quarantined?”
“Has any of my feeds been banned from submitting signals?”
Tell an agent
List the quarantined signal sources.
Show me every signal source that has been permanently quarantined.
POST /v1/salvage/recovery/file File a recovery claim for a failed transaction · Recovery File #
Ask an LLM
“How do I file a claim to recover funds from a failed transaction?”
“Can I set a commission rate when filing a recovery claim?”
Tell an agent
File a recovery claim for transaction {tx_id} worth {amount_usd} USD for victim wallet {victim_wallet}, claimant {claimant_did} against {counterparty_did}.
File claim {claim_id} on transaction {tx_id} for {amount_usd} USD, wallet {victim_wallet}, claimant {claimant_did} vs {counterparty_did}.
GET /v1/salvage/recovery/status Check the status of a recovery claim · Recovery Status #
Ask an LLM
“Where does my recovery claim stand right now?”
“Has my salvage claim been settled or is it still in negotiation?”
Tell an agent
Check the status of recovery claim {claim_id}.
Tell me where claim {claim_id} is in the recovery process.
POST /v1/salvage/recovery/auto Auto-process the top verified failures · Recovery Auto #
Ask an LLM
“Can I automatically process the top verified failures in the queue instead of filing claims one by one?”
“How many queued failures can I batch into recovery at once?”
Tell an agent
Auto-process the top {n} verified failures from the queue.
Run automatic recovery on the top {n} queued failures as claimant {claimant_did}.
GET /v1/salvage/recovery/agents View the recovery agent roster · Recovery Agents #
Ask an LLM
“Which recovery agents are active and how large are their bonds?”
“Is any recovery agent currently suspended, and what are their clean streaks?”
Tell an agent
Show the recovery agent roster with bonds and suspension status.
List all recovery agents with their clean streaks.
POST /v1/salvage/recovery/slash Slash an agent's bond for a fraudulent claim · Recovery Slash #
Ask an LLM
“How do I emergency-slash a recovery agent's bond for fraud?”
“What happens to an agent when its bond is slashed?”
Tell an agent destructive · confirm first
Slash the bond of agent {agent_id} because {reason}.
Suspend recovery agent {agent_id} and slash its full bond, citing {reason}.
GET /v1/salvage/reinforcement/risk Get the risk score for an agent or counterparty · Reinforcement Risk #
Ask an LLM
“How risky is a given agent or counterparty according to the reinforcement layer?”
“What risk score has Salvage assigned to this counterparty?”
Tell an agent
Get the risk score for agent {agent_id}.
How risky is counterparty {agent_id}? Pull its reinforcement score.
GET /v1/salvage/reinforcement/patterns View clustered transaction failure patterns · Reinforcement Patterns #
Ask an LLM
“What recurring failure patterns has the Pattern Analyzer found?”
“Are my transaction failures clustering around common causes?”
Tell an agent
Show the clustered failure patterns.
List the failure clusters identified by the Pattern Analyzer.
GET /v1/salvage/reinforcement/run Run a full reinforcement cycle · Reinforcement Run #
Ask an LLM
“Can I trigger a full analyze, score and bond-proposal cycle on demand?”
“How do I refresh risk scores and bond proposals in one pass?”
Tell an agent
Run a full reinforcement cycle now.
Analyze failures, rescore agents and propose new bonds in one reinforcement run.
GET /v1/salvage/reinforcement/bond_proposals List pending bond adjustment proposals · Bond Proposals #
Ask an LLM
“Which HiveBond adjustments are waiting for human approval?”
“What bond changes has the reinforcement system proposed?”
Tell an agent
Show pending bond adjustment proposals.
List the HiveBond proposals awaiting my approval.
POST /v1/salvage/fleet/preset Instantiate a named salvage fleet preset · Fleet Preset #
Ask an LLM
“Which fleet presets can I spin up, like salvage_starter or salvage_standard?”
“Why does the salvage_tier2_blocked preset always fail?”
Tell an agent
Instantiate the {name} fleet preset.
Spin up a salvage fleet using preset {name}.
GET /v1/salvage/fleet/projections Project daily earnings for the fleet · Fleet Projections #
Ask an LLM
“How much could my salvage fleet earn per day at its current configuration?”
“Can I project daily revenue for a preset at a given daily volume?”
Tell an agent
Project fleet earnings per day at {daily_volume_usd} USD daily volume.
Show projected dollars per day for preset {preset}.
POST /v1/salvage/self_tune/tick Run the fleet self-tune rules once · Self Tune Tick #
Ask an LLM
“How do I run the fleet self-tune rules from a cron job?”
“Which self-tune rules fire when false positives spike?”
Tell an agent
Run one self-tune tick.
Run a self-tune tick with {false_positive_count} false positives out of {total_signals} signals.
GET /v1/salvage/self_tune/state View fleet self-tune state and history · Self Tune State #
Ask an LLM
“What has the fleet self-tuner changed recently?”
“Where can I see the self-tune tick history?”
Tell an agent
Show the current self-tune state and tick history.
List past self-tune ticks and what each one changed.
GET /v1/salvage/economics View live salvage economics and tier progress · Economics #
Ask an LLM
“What is the salvage operation actually earning per day versus projections?”
“How close is the fleet to its next tier target?”
Tell an agent
Show live salvage economics, projected versus actual.
Report tier progress and anti-bloat status for the salvage operation.
GET /v1/salvage/compliance/queue List frozen claims awaiting compliance review · Compliance Queue #
Ask an LLM
“Which recovery claims are frozen pending human compliance review?”
“Do I have any frozen claims that need a reviewer?”
Tell an agent
Show the frozen claims in the compliance queue.
List claims waiting for a human compliance reviewer.
POST /v1/salvage/compliance/review Record a compliance review outcome for a claim · Compliance Review #
Ask an LLM
“How do I clear a frozen claim after reviewing it?”
“Can I mark a frozen claim as confirmed fraud?”
Tell an agent
Mark frozen claim {claim_id} as {outcome}.
Record reviewer {reviewer}'s outcome {outcome} on frozen claim {claim_id}.
GET /v1/salvage/registry Read the full append-only claim registry · Registry #
Ask an LLM
“Where can I see every recovery claim ever filed?”
“Is the claim registry append-only?”
Tell an agent
Pull the full claim registry.
Export every entry in the append-only salvage claim registry.
GET /v1/salvage/stats Get salvage totals, commission and hit rate · Stats #
Ask an LLM
“How much has been recovered in total and what commission was earned?”
“What's the claim hit rate and dead-letter count?”
Tell an agent
Show salvage stats: total recovered, commission, and hit rate.
Summarize listener, recovery, reinforcement and compliance numbers.

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-salvage-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-salvage-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-salvage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Salvage API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: salvage
paths:
  /v1/salvage/listener/observe:
    post:
      tags:
      - salvage
      summary: Listener Observe
      description: Manually inject a signal for a transaction (testing + external feed).
      operationId: listener_observe_v1_salvage_listener_observe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignalBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Listener Observe V1 Salvage Listener Observe Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/listener/observe/bridge:
    post:
      tags:
      - salvage
      summary: Listener Observe Bridge
      description: 'Shorthand: inject bridge observation via HiveGateInterceptor.'
      operationId: listener_observe_bridge_v1_salvage_listener_observe_bridge_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BridgeObserveBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Listener Observe Bridge V1 Salvage Listener Observe Bridge Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/listener/queue:
    get:
      tags:
      - salvage
      summary: Listener Queue
      description: Return all verified failures awaiting recovery.
      operationId: listener_queue_v1_salvage_listener_queue_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Listener Queue V1 Salvage Listener Queue Get
  /v1/salvage/listener/sources:
    get:
      tags:
      - salvage
      summary: Listener Sources
      description: Return source trust registry.
      operationId: listener_sources_v1_salvage_listener_sources_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Listener Sources V1 Salvage Listener Sources Get
  /v1/salvage/listener/quarantine:
    get:
      tags:
      - salvage
      summary: Listener Quarantine
      description: Return permanently quarantined signal sources.
      operationId: listener_quarantine_v1_salvage_listener_quarantine_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Listener Quarantine V1 Salvage Listener Quarantine Get
  /v1/salvage/recovery/file:
    post:
      tags:
      - salvage
      summary: Recovery File
      description: 'File a recovery claim.

        If claim_id param provided, validates it matches computed deterministic ID.

        Uses DirectNegotiationAgent with full three-gate + compliance + escrow.'
      operationId: recovery_file_v1_salvage_recovery_file_post
      parameters:
      - name: claim_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Claim Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileClaimBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Recovery File V1 Salvage Recovery File Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/recovery/status:
    get:
      tags:
      - salvage
      summary: Recovery Status
      description: Return current status of a claim.
      operationId: recovery_status_v1_salvage_recovery_status_get
      parameters:
      - name: claim_id
        in: query
        required: true
        schema:
          type: string
          title: Claim Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Recovery Status V1 Salvage Recovery Status Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/recovery/auto:
    post:
      tags:
      - salvage
      summary: Recovery Auto
      description: Auto-process top N verified failures from the listener queue.
      operationId: recovery_auto_v1_salvage_recovery_auto_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutoProcessBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Recovery Auto V1 Salvage Recovery Auto Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/recovery/agents:
    get:
      tags:
      - salvage
      summary: Recovery Agents
      description: Return agent roster with bonds, clean streaks, suspension status.
      operationId: recovery_agents_v1_salvage_recovery_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Recovery Agents V1 Salvage Recovery Agents Get
  /v1/salvage/recovery/slash:
    post:
      tags:
      - salvage
      summary: Recovery Slash
      description: 'Manual emergency slash of an agent''s bond.

        Simulates HiveLaw ruling: fraudulent claim → 100% bond slashed → suspended.'
      operationId: recovery_slash_v1_salvage_recovery_slash_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SlashBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Recovery Slash V1 Salvage Recovery Slash Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/reinforcement/risk:
    get:
      tags:
      - salvage
      summary: Reinforcement Risk
      description: Return risk score for a specific agent/counterparty.
      operationId: reinforcement_risk_v1_salvage_reinforcement_risk_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Reinforcement Risk V1 Salvage Reinforcement Risk Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/reinforcement/patterns:
    get:
      tags:
      - salvage
      summary: Reinforcement Patterns
      description: Return clustered failure patterns from the Pattern Analyzer.
      operationId: reinforcement_patterns_v1_salvage_reinforcement_patterns_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Reinforcement Patterns V1 Salvage Reinforcement Patterns Get
  /v1/salvage/reinforcement/run:
    get:
      tags:
      - salvage
      summary: Reinforcement Run
      description: Run full reinforcement cycle (analyze → score → propose bonds).
      operationId: reinforcement_run_v1_salvage_reinforcement_run_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Reinforcement Run V1 Salvage Reinforcement Run Get
  /v1/salvage/reinforcement/bond_proposals:
    get:
      tags:
      - salvage
      summary: Bond Proposals
      description: Return pending HiveBond adjustment proposals (awaiting human approval).
      operationId: bond_proposals_v1_salvage_reinforcement_bond_proposals_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Bond Proposals V1 Salvage Reinforcement Bond Proposals Get
  /v1/salvage/fleet/preset:
    post:
      tags:
      - salvage
      summary: Fleet Preset
      description: 'Instantiate a named fleet preset.

        Available: salvage_starter, salvage_standard, salvage_tier2_blocked

        salvage_tier2_blocked will always error (gate: HiveLaw adoption).'
      operationId: fleet_preset_v1_salvage_fleet_preset_post
      parameters:
      - name: name
        in: query
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Fleet Preset V1 Salvage Fleet Preset Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/fleet/projections:
    get:
      tags:
      - salvage
      summary: Fleet Projections
      description: 'Return projected $/day at current fleet config.

        Refuses to project beyond current tier ceiling.'
      operationId: fleet_projections_v1_salvage_fleet_projections_get
      parameters:
      - name: daily_volume_usd
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Daily Volume Usd
      - name: preset
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Preset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Fleet Projections V1 Salvage Fleet Projections Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/self_tune/tick:
    post:
      tags:
      - salvage
      summary: Self Tune Tick
      description: 'Run all 3 self-tune rules once. Idempotent, single-pass. Cron-friendly.

        Returns which rules fired and what changed.'
      operationId: self_tune_tick_v1_salvage_self_tune_tick_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SelfTuneTickBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Self Tune Tick V1 Salvage Self Tune Tick Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/self_tune/state:
    get:
      tags:
      - salvage
      summary: Self Tune State
      description: Return current fleet self-tune state and tick history.
      operationId: self_tune_state_v1_salvage_self_tune_state_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Self Tune State V1 Salvage Self Tune State Get
  /v1/salvage/economics:
    get:
      tags:
      - salvage
      summary: Economics
      description: 'Live $/day, projected vs actual, tier progress, anti-bloat status.

        Honest framing: Tier 1 targets $400/day. $5K/day is 12-18 months out.'
      operationId: economics_v1_salvage_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Economics V1 Salvage Economics Get
  /v1/salvage/compliance/queue:
    get:
      tags:
      - salvage
      summary: Compliance Queue
      description: Return frozen claims awaiting human review. NEVER auto-processed.
      operationId: compliance_queue_v1_salvage_compliance_queue_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Compliance Queue V1 Salvage Compliance Queue Get
  /v1/salvage/compliance/review:
    post:
      tags:
      - salvage
      summary: Compliance Review
      description: Mark a frozen claim as reviewed.
      operationId: compliance_review_v1_salvage_compliance_review_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ComplianceReviewBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Compliance Review V1 Salvage Compliance Review Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/salvage/registry:
    get:
      tags:
      - salvage
      summary: Registry
      description: Return full claim registry (read-only). Append-only; no deletions.
      operationId: registry_v1_salvage_registry_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Registry V1 Salvage Registry Get
  /v1/salvage/stats:
    get:
      tags:
      - salvage
      summary: Stats
      description: 'Total recovered, commission earned, claim count, hit rate, dead-letter count.

        Includes listener, recovery, reinforcement, and compliance summaries.'
      operationId: stats_v1_salvage_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Stats V1 Salvage Stats Get
components:
  schemas:
    FileClaimBody:
      properties:
        tx_id:
          type: string
          title: Tx Id
        claimant_did:
          type: string
          title: Claimant Did
        counterparty_did:
          type: string
          title: Counterparty Did
        victim_wallet:
          type: string
          title: Victim Wallet
        amount_usd:
          type: number
          exclusiveMinimum: 0.0
          title: Amount Usd
        proof_type:
          type: string
          title: Proof Type
          description: ProofType enum value
          default: revert
        agent_id:
          type: string
          title: Agent Id
          default: dna-001
        commission_rate:
          type: number
          maximum: 0.5
          minimum: 0.01
          title: Commission Rate
          default: 0.1
      type: object
      required:
      - tx_id
      - claimant_did
      - counterparty_did
      - victim_wallet
      - amount_usd
      title: FileClaimBody
    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
    ComplianceReviewBody:
      properties:
        claim_id:
          type: string
          title: Claim Id
        outcome:
          type: string
          title: Outcome
          description: '''cleared'' or ''confirmed_fraud'''
        reviewer:
          type: string
          title: Reviewer
          default: human-reviewer
      type: object
      required:
      - claim_id
      - outcome
      title: ComplianceReviewBody
    SelfTuneTickBody:
      properties:
        claims_resolved_last_hour:
          type: integer
          minimum: 0.0
          title: Claims Resolved Last Hour
          default: 0
        arb_queue_depth:
          type: integer
          minimum: 0.0
          title: Arb Queue Depth
          default: 0
        arb_queue_normal:
          type: integer
          minimum: 1.0
          title: Arb Queue Normal
          default: 2
        false_positive_count:
          type: integer
          minimum: 0.0
          title: False Positive Count
          default: 0
        total_signals:
          type: integer
          minimum: 0.0
          title: Total Signals
          default: 0
      type: object
      title: SelfTuneTickBody
    SignalBody:
      properties:
        tx_id:
          type: string
          title: Tx Id
          description: Transaction hash being observed
        source_id:
          type: string
          title: Source Id
          description: Unique identifier for this signal source
        source_type:
          type: string
          title: Source Type
          description: SignalSource enum value
        proof_type:
          type: string
          title: Proof Type
          description: ProofType enum value
        tx_status:
          anyOf:
          - type: integer
          - type: 'null'
          title: Tx Status
          description: 0=reverted, 1=confirmed/sent
        dest_confirmed:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Dest Confirmed
          description: 'Bridge: did tx arrive at destination?'
        raw_evidence:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Raw Evidence
          description: Any additional evidence payload
        observer_type:
          type: string
          title: Observer Type
          description: Observer type that generated this signal
          default: hiveclear_observer
      type: object
      required:
      - tx_id
      - source_id
      - source_type
      - proof_type
      title: SignalBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SlashBody:
      properties:
        agent_id:
          type: string
          title: Agent Id
        reason:
          type: string
          title: Reason
      type: object
      required:
      - agent_id
      - reason
      title: SlashBody
    AutoProcessBody:
      properties:
        n:
          type: integer
          maximum: 50.0
          minimum: 1.0
          title: N
          description: Max verified failures to process
          default: 5
        claimant_did:
          type: string
          title: Claimant Did
          default: did:hive:agent-alpha
        agent_id:
          type: string
          title: Agent Id
          default: dna-001
      type: object
      title: AutoProcessBody
    BridgeObserveBody:
      properties:
        tx_id:
          type: string
          title: Tx Id
        source_chain:
          type: string
          title: Source Chain
        dest_chain:
          type: string
          title: Dest Chain
        source_confirmed:
          type: boolean
          title: Source Confirmed
        dest_arrived:
          type: boolean
          title: Dest Arrived
      type: object
      required:
      - tx_id
      - source_chain
      - dest_chain
      - source_confirmed
      - dest_arrived
      title: BridgeObserveBody
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)