Chio/Docs
LOGIN · JOIN

Finding Artifacts

Find a finding record’s schema, signature carrier, and identifier rule before you compute its digest or verify its signature.

Reference chio@5f63e6e

On this page

A cognition-market finding leaves a trail of separate records: what was offered, who admitted it, what a buyer accepted, and how delivery or a challenge ended. Each record has its own signer and its own identifier rule, so a verifier selects the carrier first and only then computes a digest or checks a signature.

The family holds 37 schema files under spec/schemas/chio-finding/v1/, 37 of them with a registered ID, in schema bundle 1.0.0. Cognition Market follows one finding from offer to purchase.

Synopsis

Each file registers a schema ID of the form chio.finding.<name>.v1, except chio.registry.market-penalty.v1. Every record travels in one of three carriers, and the carrier decides what its signature covers.

CarrierSignature coversFiles
Signed inline
The canonical body, after its content-addressed identifier is populated; the artifact holds its own signature
1
Signed envelope
The whole body of { body, signerKey, signature }
25
Unsigned carrier
Nothing: a bare object with no signature member
11
Signed envelope shapejson
{
  "body": { "…": "strict snake_case members" },
  "signerKey": "<signer public key>",
  "signature": "<signature over the canonical body>"
}

Every envelope body is strict snake_case JSON that rejects unknown members. The open-market penalty is the one exception: its camelCase body tolerates them. A digest that one artifact holds for another envelope covers the complete canonical envelope, body and signer key and signature, never the body alone.

Reveal envelope and digests

Reveal commitmentsChoose a moment.
ecσφκKρreveal envelopemedia_type, payload_b64payload_sha256contextcontext_sha256sellersignsfinding bodycontent addressfinding_idresponseread_finding grantexpected_digestobserved_digestAllow, capture oncematchedDeny, hold releasedDeniedAfterDeliverymismatchedecσφκKρreveal envelopemedia_type, payload_b64payload_sha256contextsellerfinding bodyfinding_idresponsegrantexpected_digestobserved_digestAllowDenyDeniedAfterDelivery

The finding commits to its payload before anyone pays

payload_sha256 hashes the canonical JSON bytes of the reveal envelope, the two-member { media_type, payload_b64 } value that read_finding returns. The finding body holds that digest and descriptor.context_sha256, the digest of the full context object. finding_id is content addressed over the body, so the envelope carries no finding_id. Delivery contract.

The digests that bind one finding to its sealed payload, and the comparison the kernel runs when a read_finding call delivers it. Prices, fees, the settlement profile, and the hosted market are left out.Paid reveal

A finding commits to its payload while the payload stays sealed, and the kernel checks the same commitment when a buyer’s read_finding call delivers it. Four values carry the binding.

  • payload_sha256 (finding body). The SHA-256 of the canonical JSON bytes of the reveal envelope, the two-member { media_type, payload_b64 } value the read_finding call returns, and never of the decoded payload bytes. The envelope carries no finding_id, because finding_id is content addressed over a body that already holds payload_sha256.
  • descriptor.context_sha256 (finding body). The digest of the full context object: a committed test suite and commit, or an experiment protocol. A buyer who hits the same failing context computes this digest and searches on it.
  • delivery_contract (chio.delivery-contract.v1). The block a digest-constrained call carries: the expected_digest the grant fixed in advance, the observed_digest the kernel computed over the whole response value, and a result of matched or mismatched. When the remaining delivery checks allow completion, a matched result captures the realized cost from the hold and the kernel signs an Allow.
  • DeniedAfterDelivery (admission state). The durable admission state a mismatch takes, legal only from Finalizing. The kernel signs a Deny, releases the open hold, captures zero currency, and keeps the one invocation the pre-dispatch capture already consumed.

Artifacts

Entries run in file order. A protocol section that reads “Not defined in 6.4.7” marks an identifier member the schema file requires and section 6.4.7 gives no derivation.

Chio Finding Admission

admission.schema.json

PropertyDefinition
Registry ID
chio.finding.admission.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with admission_id set to "".
Protocol section
6.4.7.8

Chio Finding Audit Epoch (signed envelope)

audit-epoch.schema.json

PropertyDefinition
Registry ID
chio.finding.audit-epoch.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with audit_epoch_id set to "".
Protocol section
6.4.7.16

Chio Finding Audit Report (signed envelope)

audit-report.schema.json

PropertyDefinition
Registry ID
chio.finding.audit-report.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with audit_report_id set to "".
Protocol section
6.4.7.17

Chio Finding Audit Round Authorization (signed envelope)

audit-round-authorization.schema.json

PropertyDefinition
Registry ID
chio.finding.audit-round-authorization.v1
Signature carrier
Signed envelope
Identifier
None. The digest of its signed envelope names it.
Protocol section
6.4.7.21

Chio Finding Authority Status (signed envelope)

authority-status.schema.json

PropertyDefinition
Registry ID
chio.finding.authority-status.v1
Signature carrier
Signed envelope
Identifier
None. The digest of its signed envelope names it.
Protocol section
6.4.7.25

Chio Finding Bond Backing

bond-backing.schema.json

PropertyDefinition
Registry ID
chio.finding.bond-backing.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with allocation_id set to "".
Protocol section
6.4.7.6

Chio Finding Bond Observation Request V1

bond-observation-request.schema.json

PropertyDefinition
Registry ID
chio.finding.bond-observation-request.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Finding Bond Observation Response V1

bond-observation-response.schema.json

PropertyDefinition
Registry ID
chio.finding.bond-observation-response.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Finding Challenge Enforcement (signed envelope)

challenge-enforcement.schema.json

PropertyDefinition
Registry ID
chio.finding.challenge-enforcement.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with enforcement_id set to "".
Protocol section
6.4.7.14

Chio Finding Challenge Outcome (signed envelope)

challenge-outcome.schema.json

PropertyDefinition
Registry ID
chio.finding.challenge-outcome.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the preimage "chio.finding.challenge-outcome.v1\0" followed by the canonical body with outcome_id set to "".
Protocol section
6.4.7.13

Chio Finding Challenge-Verifier Profile

challenge-verifier-profile.schema.json

PropertyDefinition
Registry ID
chio.finding.challenge-verifier-profile.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with profile_id set to "".
Protocol section
6.4.7.2

Chio Finding Challenge (signed envelope)

challenge.schema.json

PropertyDefinition
Registry ID
chio.finding.challenge.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with challenge_id set to "".
Protocol section
6.4.7.12

Chio Finding Claim Allocation

claim-allocation.schema.json

PropertyDefinition
Registry ID
chio.finding.claim-allocation.v1
Signature carrier
Signed envelope
Identifier
allocation_id
Protocol section
Not defined in 6.4.7

Chio Finding Failed Delivery (signed envelope)

failed-delivery.schema.json

PropertyDefinition
Registry ID
chio.finding.failed-delivery.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with failed_delivery_id set to "".
Protocol section
6.4.7.11

Chio Finding Finalized Bond Snapshot (signed envelope)

finalized-bond-snapshot.schema.json

PropertyDefinition
Registry ID
chio.finding.finalized-bond-snapshot.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with snapshot_id set to "".
Protocol section
6.4.7.15

Chio Finding

finding.schema.json

PropertyDefinition
Registry ID
chio.finding.v1
Signature carrier
Signed inline
Identifier
SHA-256 of the canonical body with both finding_id and signature set to "", neither member omitted nor encoded as null.
Protocol section
6.4.7

Chio Hosted Authenticated Finding Delivery

hosted-authenticated-delivery.schema.json

PropertyDefinition
Registry ID
chio.finding.hosted-authenticated-delivery.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Hosted Finding Market Qualification

hosted-qualification.schema.json

PropertyDefinition
Registry ID
chio.finding.hosted-qualification.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Finding Impairment Publisher Request V1

impairment-publisher-request.schema.json

PropertyDefinition
Registry ID
chio.finding.impairment-publisher-request.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Finding Impairment Publisher Response V1

impairment-publisher-response.schema.json

PropertyDefinition
Registry ID
chio.finding.impairment-publisher-response.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
Not defined in 6.4.7

Chio Finding Key Revocation (signed envelope)

key-revocation.schema.json

PropertyDefinition
Registry ID
chio.finding.key-revocation.v1
Signature carrier
Signed envelope
Identifier
None. The digest of its signed envelope names it.
Protocol section
6.4.7.20

Chio Finding Liability

liability.schema.json

PropertyDefinition
Registry ID
chio.finding.liability.v1
Signature carrier
Signed envelope
Identifier
liability_key
Protocol section
Not defined in 6.4.7

Chio Open Market Penalty (signed envelope)

market-penalty.schema.json

PropertyDefinition
Registry ID
chio.registry.market-penalty.v1
Signature carrier
Signed envelope
Identifier
penaltyId
Protocol section
6.4.7.19

Chio Finding Market Terms

market-terms.schema.json

PropertyDefinition
Registry ID
chio.finding.market-terms.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with terms_id set to "".
Protocol section
6.4.7.4

Chio Finding Pool Allocation

pool-allocation.schema.json

PropertyDefinition
Registry ID
chio.finding.pool-allocation.v1
Signature carrier
Signed envelope
Identifier
allocation_id
Protocol section
Not defined in 6.4.7

Chio Finding Purchase Context (unsigned)

purchase-context.schema.json

PropertyDefinition
Registry ID
chio.finding.purchase-context.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
6.4.7.9

Chio Finding Purchase Record (signed envelope)

purchase-record.schema.json

PropertyDefinition
Registry ID
chio.finding.purchase-record.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the preimage "chio.finding.purchase.v1\0" followed by the accepted-bid envelope digest, a NUL byte, and the authoritative payment operation identifier.
Protocol section
6.4.7.10

Chio Finding Purchase Result

purchase-result.schema.json

PropertyDefinition
Registry ID
chio.finding.purchase-result.v1
Signature carrier
Signed envelope
Identifier
result_id
Protocol section
Not defined in 6.4.7

Chio Finding Recovery Context (unsigned)

recovery-context.schema.json

PropertyDefinition
Registry ID
chio.finding.recovery-context.v1
Signature carrier
Unsigned carrier
Identifier
recovery_id
Protocol section
6.4.7.24

Chio Finding Replay Observation (unsigned)

replay-observation.schema.json

PropertyDefinition
Registry ID
chio.finding.replay-observation.v1
Signature carrier
Unsigned carrier
Identifier
None. The mediated replay receipt's content_hash equals the canonical digest of these bytes.
Protocol section
6.4.7.18

Chio Finding Replay Recipe Input (unsigned)

replay-recipe-input.schema.json

PropertyDefinition
Registry ID
chio.finding.replay-recipe-input.v1
Signature carrier
Unsigned carrier
Identifier
None. The signed finding's replay_recipe_sha256 equals the canonical digest of the strict raw preimage.
Protocol section
6.4.7.3

Chio Finding Seller Authorization (signed envelope)

seller-authorization.schema.json

PropertyDefinition
Registry ID
chio.finding.seller-authorization.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with authorization_id set to "".
Protocol section
6.4.7.5

Chio Finding Status Epoch (signed envelope)

status-epoch.schema.json

PropertyDefinition
Registry ID
chio.finding.status-epoch.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the preimage "chio.finding.status-epoch.v1\0" followed by the canonical body with status_epoch_id set to "".
Protocol section
6.4.7.22

Chio Finding Portable Status Proof Input

status-proof-input.schema.json

PropertyDefinition
Registry ID
chio.finding.status-proof-input.v1
Signature carrier
Unsigned carrier
Identifier
None.
Protocol section
6.4.7.23

Chio Finding Verified Fix Submission

verified-fix-submission.schema.json

PropertyDefinition
Registry ID
chio.finding.verified-fix-submission.v1
Signature carrier
Signed envelope
Identifier
submission_id
Protocol section
Not defined in 6.4.7

Chio Finding Verifier Report

verifier-report.schema.json

PropertyDefinition
Registry ID
chio.finding.verifier-report.v1
Signature carrier
Signed envelope
Identifier
SHA-256 of the canonical body with report_id set to "".
Protocol section
6.4.7.7

Chio Finding Voluntary Retraction

voluntary-retraction.schema.json

PropertyDefinition
Registry ID
chio.finding.voluntary-retraction.v1
Signature carrier
Signed envelope
Identifier
intent_id
Protocol section
Not defined in 6.4.7

Schema file registry

The registry lists the bundle’s file names and registered IDs. The entries above supply each artifact’s carrier and identifier rule.

Browse the schema file registry
37 files in chio-finding · 37 registered · registry 1.0.0
FileTitleRegistry IDVersion
chio-finding/v1/admission.schema.jsonChio Finding Admissionchio.finding.admission.v1v1
chio-finding/v1/audit-epoch.schema.jsonChio Finding Audit Epoch (signed envelope)chio.finding.audit-epoch.v1v1
chio-finding/v1/audit-report.schema.jsonChio Finding Audit Report (signed envelope)chio.finding.audit-report.v1v1
chio-finding/v1/audit-round-authorization.schema.jsonChio Finding Audit Round Authorization (signed envelope)chio.finding.audit-round-authorization.v1v1
chio-finding/v1/authority-status.schema.jsonChio Finding Authority Status (signed envelope)chio.finding.authority-status.v1v1
chio-finding/v1/bond-backing.schema.jsonChio Finding Bond Backingchio.finding.bond-backing.v1v1
chio-finding/v1/bond-observation-request.schema.jsonChio Finding Bond Observation Request V1chio.finding.bond-observation-request.v1v1
chio-finding/v1/bond-observation-response.schema.jsonChio Finding Bond Observation Response V1chio.finding.bond-observation-response.v1v1
chio-finding/v1/challenge-enforcement.schema.jsonChio Finding Challenge Enforcement (signed envelope)chio.finding.challenge-enforcement.v1v1
chio-finding/v1/challenge-outcome.schema.jsonChio Finding Challenge Outcome (signed envelope)chio.finding.challenge-outcome.v1v1
chio-finding/v1/challenge-verifier-profile.schema.jsonChio Finding Challenge-Verifier Profilechio.finding.challenge-verifier-profile.v1v1
chio-finding/v1/challenge.schema.jsonChio Finding Challenge (signed envelope)chio.finding.challenge.v1v1
chio-finding/v1/claim-allocation.schema.jsonChio Finding Claim Allocationchio.finding.claim-allocation.v1v1
chio-finding/v1/failed-delivery.schema.jsonChio Finding Failed Delivery (signed envelope)chio.finding.failed-delivery.v1v1
chio-finding/v1/finalized-bond-snapshot.schema.jsonChio Finding Finalized Bond Snapshot (signed envelope)chio.finding.finalized-bond-snapshot.v1v1
chio-finding/v1/finding.schema.jsonChio Findingchio.finding.v1v1
chio-finding/v1/hosted-authenticated-delivery.schema.jsonChio Hosted Authenticated Finding Deliverychio.finding.hosted-authenticated-delivery.v1v1
chio-finding/v1/hosted-qualification.schema.jsonChio Hosted Finding Market Qualificationchio.finding.hosted-qualification.v1v1
chio-finding/v1/impairment-publisher-request.schema.jsonChio Finding Impairment Publisher Request V1chio.finding.impairment-publisher-request.v1v1
chio-finding/v1/impairment-publisher-response.schema.jsonChio Finding Impairment Publisher Response V1chio.finding.impairment-publisher-response.v1v1
chio-finding/v1/key-revocation.schema.jsonChio Finding Key Revocation (signed envelope)chio.finding.key-revocation.v1v1
chio-finding/v1/liability.schema.jsonChio Finding Liabilitychio.finding.liability.v1v1
chio-finding/v1/market-penalty.schema.jsonChio Open Market Penalty (signed envelope)chio.registry.market-penalty.v1v1
chio-finding/v1/market-terms.schema.jsonChio Finding Market Termschio.finding.market-terms.v1v1
chio-finding/v1/pool-allocation.schema.jsonChio Finding Pool Allocationchio.finding.pool-allocation.v1v1
chio-finding/v1/purchase-context.schema.jsonChio Finding Purchase Context (unsigned)chio.finding.purchase-context.v1v1
chio-finding/v1/purchase-record.schema.jsonChio Finding Purchase Record (signed envelope)chio.finding.purchase-record.v1v1
chio-finding/v1/purchase-result.schema.jsonChio Finding Purchase Resultchio.finding.purchase-result.v1v1
chio-finding/v1/recovery-context.schema.jsonChio Finding Recovery Context (unsigned)chio.finding.recovery-context.v1v1
chio-finding/v1/replay-observation.schema.jsonChio Finding Replay Observation (unsigned)chio.finding.replay-observation.v1v1
chio-finding/v1/replay-recipe-input.schema.jsonChio Finding Replay Recipe Input (unsigned)chio.finding.replay-recipe-input.v1v1
chio-finding/v1/seller-authorization.schema.jsonChio Finding Seller Authorization (signed envelope)chio.finding.seller-authorization.v1v1
chio-finding/v1/status-epoch.schema.jsonChio Finding Status Epoch (signed envelope)chio.finding.status-epoch.v1v1
chio-finding/v1/status-proof-input.schema.jsonChio Finding Portable Status Proof Inputchio.finding.status-proof-input.v1v1
chio-finding/v1/verified-fix-submission.schema.jsonChio Finding Verified Fix Submissionchio.finding.verified-fix-submission.v1v1
chio-finding/v1/verifier-report.schema.jsonChio Finding Verifier Reportchio.finding.verifier-report.v1v1
chio-finding/v1/voluntary-retraction.schema.jsonChio Finding Voluntary Retractionchio.finding.voluntary-retraction.v1v1
Specification and source files
  • Carriers and identifier rules: spec/PROTOCOL.md section 6.4.7, version 1.0, dated 2026-04-14. The keywords MUST, SHOULD, and MAY are normative.
  • Schema files: spec/schemas/chio-finding/v1/ in the Chio repository.
  • Reveal envelope and its digests: docs/market/ARCHITECTURE.md section 4.5.
  • The durable denial terminal: crates/kernel/chio-kernel/src/admission_operation.rs.

Next: follow a finding through the market