Module regulatory_api 

Phase 19.3 – read-only regulatory API over the receipt store.

This module exposes a substrate-agnostic handler that accepts a filter description, pulls receipts from a pluggable store, and wraps the result in a signed envelope. Every response is a SignedExportEnvelope signed with the kernel’s receipt-signing keypair, so regulators can verify every export against the kernel’s public key.

chio-http-core does not embed an HTTP server; substrate adapters wire [handle_regulatory_receipts] into their framework-native routing layer and forward query-string fields through RegulatoryReceiptsQuery.

Structs

RegulatorIdentity

Authorization surface for the regulatory API.

RegulatoryReceiptExport

Body of a regulatory receipt export. Wrapped in a SignedExportEnvelope so the signature covers every field of the body.

RegulatoryReceiptQueryResult

Raw query result handed back to the handler.

RegulatoryReceiptsQuery

Query parameters for GET /regulatory/receipts.

Enums

RegulatoryApiError

Error surface returned by [handle_regulatory_receipts].

Constants

MAX_REGULATORY_EXPORT_LIMIT

Maximum number of receipts returned by one regulatory export.

REGULATORY_RECEIPT_EXPORT_SCHEMA

Stable schema identifier for regulatory receipt exports.

Traits

RegulatoryReceiptSource

Pluggable source for regulatory receipt queries.

Functions

handle_regulatory_receipts_signed

Build, sign, and return a regulatory receipt export envelope.

sign_regulatory_export

Sign a prebuilt export body with the kernel’s keypair. Exposed so callers that have already materialized the body elsewhere (e.g. a batch job) can produce a verifiable envelope without re-running the query pipeline.

verify_regulatory_export

Verify a regulatory export envelope against the kernel’s public key.

Type Aliases

SignedRegulatoryReceiptExport

Signed envelope alias for regulatory receipt exports.