Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Receipt Relay API

5 actions 5 updates phrasing extends openapi/thehiveryiq-com-receipt-relay-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Hive Civilization's API. It is a proposal applied on top of the contract, not a document Hive Civilization publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/v1/receipt-relay/health'].get
$.paths['/v1/receipt-relay/event'].post
$.paths['/v1/receipt-relay/http'].post
$.paths['/v1/receipt-relay/chain'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Receipt Relay API
  version: 1.0.0
extends: openapi/thehiveryiq-com-receipt-relay-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v1/receipt-relay/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the receipt relay
      effect: read
      questions:
      - Which modes and evidence tiers does the receipt relay support?
      - What schema do relay receipts follow?
      instructions:
      - text: Show the receipt relay modes and schema.
      - text: Describe the receipt relay evidence tiers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt-relay/event'].post
  update:
    x-apievangelist-phrasing:
      intent: Sign a receipt for an external event
      effect: write
      questions:
      - How can I get a signed self-attested receipt for something that happened in another system?
      - Can the receipt include request and response bodies as evidence?
      instructions:
      - text: Sign a receipt for action {action}.
        slots:
          action: requestBody.action
      - text: Record {action} in {external_system} by {actor} as a signed receipt.
        slots:
          action: requestBody.action
          external_system: requestBody.external_system
          actor: requestBody.actor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt-relay/http'].post
  update:
    x-apievangelist-phrasing:
      intent: Make a relayed HTTP call with a receipt
      effect: write
      questions:
      - Can the relay make an outbound HTTP request for me and sign what it saw?
      - Is there a dry-run mode for relayed requests?
      instructions:
      - text: Relay a request to {url} and sign the result.
        slots:
          url: requestBody.url
      - text: Dry-run a {method} to {url} through the relay.
        slots:
          method: requestBody.method
          url: requestBody.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/receipt-relay/chain'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a receipt for a blockchain transaction
      effect: write
      questions:
      - How do I get a receipt for a Solana or EVM transaction?
      - Can the relay optionally check the transaction on chain?
      instructions:
      - text: Record transaction {tx} on {chain}.
        slots:
          tx: requestBody.tx
          chain: requestBody.chain
      - text: Record {chain} transaction {tx} on network {network} and verify it.
        slots:
          chain: requestBody.chain
          tx: requestBody.tx
          network: requestBody.network
      method: generated
      generated: '2026-09-26'