ReferenceSpec
Finding Artifacts
The chio-finding/v1 family: every schema file at the pin, the carrier that signs it, and how its identifier is derived.
Source
This page normatively reflects spec/PROTOCOL.md section 6.4.7 and the schema files under spec/schemas/chio-finding/v1/ in the chio repository. Status: current bounded Chio release profile. Version 1.0, dated 2026-04-14. The keywords MUST, SHOULD, and MAY are normative.
The reveal envelope and its digests come from docs/market/ARCHITECTURE.md section 4.5, and the durable denial terminal from crates/kernel/chio-kernel/src/admission_operation.rs.
Synopsis
Each file registers a schema id of the form chio.finding.<name>.v1, except chio.registry.market-penalty.v1.
| Carrier | Top-level shape | Files |
|---|---|---|
| Signed inline | The artifact holds its own signature, which covers the canonical body after the content-addressed identifier is populated. | 1 |
| Signed envelope | { body, signerKey, signature }. The signature covers the whole body, and every body is strict snake_case JSON that rejects unknown members except the open-market penalty, whose camelCase body tolerates them. | 25 |
| Unsigned carrier | A bare object with no signature member of its own. | 11 |
A digest that one artifact holds for another envelope covers the complete canonical envelope, body and signer key and signature, never the body alone.
Artifacts
A row whose section reads Not defined in 6.4.7 names the identifier member its schema file requires; section 6.4.7 fixes no derivation for it.
| File | Title | Registry id | Carrier | Identifier | Section |
|---|---|---|---|---|---|
admission.schema.json | Chio Finding Admission | chio.finding.admission.v1 | Signed envelope | SHA-256 of the canonical body with admission_id set to "". | 6.4.7.8 |
audit-epoch.schema.json | Chio Finding Audit Epoch (signed envelope) | chio.finding.audit-epoch.v1 | Signed envelope | SHA-256 of the canonical body with audit_epoch_id set to "". | 6.4.7.16 |
audit-report.schema.json | Chio Finding Audit Report (signed envelope) | chio.finding.audit-report.v1 | Signed envelope | SHA-256 of the canonical body with audit_report_id set to "". | 6.4.7.17 |
audit-round-authorization.schema.json | Chio Finding Audit Round Authorization (signed envelope) | chio.finding.audit-round-authorization.v1 | Signed envelope | None. The digest of its signed envelope names it. | 6.4.7.21 |
authority-status.schema.json | Chio Finding Authority Status (signed envelope) | chio.finding.authority-status.v1 | Signed envelope | None. The digest of its signed envelope names it. | 6.4.7.25 |
bond-backing.schema.json | Chio Finding Bond Backing | chio.finding.bond-backing.v1 | Signed envelope | SHA-256 of the canonical body with allocation_id set to "". | 6.4.7.6 |
bond-observation-request.schema.json | Chio Finding Bond Observation Request V1 | chio.finding.bond-observation-request.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
bond-observation-response.schema.json | Chio Finding Bond Observation Response V1 | chio.finding.bond-observation-response.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
challenge-enforcement.schema.json | Chio Finding Challenge Enforcement (signed envelope) | chio.finding.challenge-enforcement.v1 | Signed envelope | SHA-256 of the canonical body with enforcement_id set to "". | 6.4.7.14 |
challenge-outcome.schema.json | Chio Finding Challenge Outcome (signed envelope) | chio.finding.challenge-outcome.v1 | Signed envelope | SHA-256 of the preimage "chio.finding.challenge-outcome.v1\0" followed by the canonical body with outcome_id set to "". | 6.4.7.13 |
challenge-verifier-profile.schema.json | Chio Finding Challenge-Verifier Profile | chio.finding.challenge-verifier-profile.v1 | Signed envelope | SHA-256 of the canonical body with profile_id set to "". | 6.4.7.2 |
challenge.schema.json | Chio Finding Challenge (signed envelope) | chio.finding.challenge.v1 | Signed envelope | SHA-256 of the canonical body with challenge_id set to "". | 6.4.7.12 |
claim-allocation.schema.json | Chio Finding Claim Allocation | chio.finding.claim-allocation.v1 | Signed envelope | allocation_id | Not defined in 6.4.7 |
failed-delivery.schema.json | Chio Finding Failed Delivery (signed envelope) | chio.finding.failed-delivery.v1 | Signed envelope | SHA-256 of the canonical body with failed_delivery_id set to "". | 6.4.7.11 |
finalized-bond-snapshot.schema.json | Chio Finding Finalized Bond Snapshot (signed envelope) | chio.finding.finalized-bond-snapshot.v1 | Signed envelope | SHA-256 of the canonical body with snapshot_id set to "". | 6.4.7.15 |
finding.schema.json | Chio Finding | chio.finding.v1 | Signed inline | SHA-256 of the canonical body with both finding_id and signature set to "", neither member omitted nor encoded as null. | 6.4.7 |
hosted-authenticated-delivery.schema.json | Chio Hosted Authenticated Finding Delivery | chio.finding.hosted-authenticated-delivery.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
hosted-qualification.schema.json | Chio Hosted Finding Market Qualification | chio.finding.hosted-qualification.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
impairment-publisher-request.schema.json | Chio Finding Impairment Publisher Request V1 | chio.finding.impairment-publisher-request.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
impairment-publisher-response.schema.json | Chio Finding Impairment Publisher Response V1 | chio.finding.impairment-publisher-response.v1 | Unsigned carrier | None. | Not defined in 6.4.7 |
key-revocation.schema.json | Chio Finding Key Revocation (signed envelope) | chio.finding.key-revocation.v1 | Signed envelope | None. The digest of its signed envelope names it. | 6.4.7.20 |
liability.schema.json | Chio Finding Liability | chio.finding.liability.v1 | Signed envelope | liability_key | Not defined in 6.4.7 |
market-penalty.schema.json | Chio Open Market Penalty (signed envelope) | chio.registry.market-penalty.v1 | Signed envelope | penaltyId | 6.4.7.19 |
market-terms.schema.json | Chio Finding Market Terms | chio.finding.market-terms.v1 | Signed envelope | SHA-256 of the canonical body with terms_id set to "". | 6.4.7.4 |
pool-allocation.schema.json | Chio Finding Pool Allocation | chio.finding.pool-allocation.v1 | Signed envelope | allocation_id | Not defined in 6.4.7 |
purchase-context.schema.json | Chio Finding Purchase Context (unsigned) | chio.finding.purchase-context.v1 | Unsigned carrier | None. | 6.4.7.9 |
purchase-record.schema.json | Chio Finding Purchase Record (signed envelope) | chio.finding.purchase-record.v1 | Signed envelope | 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. | 6.4.7.10 |
purchase-result.schema.json | Chio Finding Purchase Result | chio.finding.purchase-result.v1 | Signed envelope | result_id | Not defined in 6.4.7 |
recovery-context.schema.json | Chio Finding Recovery Context (unsigned) | chio.finding.recovery-context.v1 | Unsigned carrier | recovery_id | 6.4.7.24 |
replay-observation.schema.json | Chio Finding Replay Observation (unsigned) | chio.finding.replay-observation.v1 | Unsigned carrier | None. The mediated replay receipt's content_hash equals the canonical digest of these bytes. | 6.4.7.18 |
replay-recipe-input.schema.json | Chio Finding Replay Recipe Input (unsigned) | chio.finding.replay-recipe-input.v1 | Unsigned carrier | None. The signed finding's replay_recipe_sha256 equals the canonical digest of the strict raw preimage. | 6.4.7.3 |
seller-authorization.schema.json | Chio Finding Seller Authorization (signed envelope) | chio.finding.seller-authorization.v1 | Signed envelope | SHA-256 of the canonical body with authorization_id set to "". | 6.4.7.5 |
status-epoch.schema.json | Chio Finding Status Epoch (signed envelope) | chio.finding.status-epoch.v1 | Signed envelope | SHA-256 of the preimage "chio.finding.status-epoch.v1\0" followed by the canonical body with status_epoch_id set to "". | 6.4.7.22 |
status-proof-input.schema.json | Chio Finding Portable Status Proof Input | chio.finding.status-proof-input.v1 | Unsigned carrier | None. | 6.4.7.23 |
verified-fix-submission.schema.json | Chio Finding Verified Fix Submission | chio.finding.verified-fix-submission.v1 | Signed envelope | submission_id | Not defined in 6.4.7 |
verifier-report.schema.json | Chio Finding Verifier Report | chio.finding.verifier-report.v1 | Signed envelope | SHA-256 of the canonical body with report_id set to "". | 6.4.7.7 |
voluntary-retraction.schema.json | Chio Finding Voluntary Retraction | chio.finding.voluntary-retraction.v1 | Signed envelope | intent_id | Not defined in 6.4.7 |
Reveal envelope and digests
| Value | What it commits to |
|---|---|
payload_sha256 | 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 not 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 | 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 | The block a digest-constrained call carries under schema chio.delivery-contract.v1: 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. |
DeniedAfterDelivery | 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. |
| file | title | registry id | version |
|---|---|---|---|
chio-finding/v1/admission.schema.json | Chio Finding Admission | chio.finding.admission.v1 | v1 |
chio-finding/v1/audit-epoch.schema.json | Chio Finding Audit Epoch (signed envelope) | chio.finding.audit-epoch.v1 | v1 |
chio-finding/v1/audit-report.schema.json | Chio Finding Audit Report (signed envelope) | chio.finding.audit-report.v1 | v1 |
chio-finding/v1/audit-round-authorization.schema.json | Chio Finding Audit Round Authorization (signed envelope) | chio.finding.audit-round-authorization.v1 | v1 |
chio-finding/v1/authority-status.schema.json | Chio Finding Authority Status (signed envelope) | chio.finding.authority-status.v1 | v1 |
chio-finding/v1/bond-backing.schema.json | Chio Finding Bond Backing | chio.finding.bond-backing.v1 | v1 |
chio-finding/v1/bond-observation-request.schema.json | Chio Finding Bond Observation Request V1 | chio.finding.bond-observation-request.v1 | v1 |
chio-finding/v1/bond-observation-response.schema.json | Chio Finding Bond Observation Response V1 | chio.finding.bond-observation-response.v1 | v1 |
chio-finding/v1/challenge-enforcement.schema.json | Chio Finding Challenge Enforcement (signed envelope) | chio.finding.challenge-enforcement.v1 | v1 |
chio-finding/v1/challenge-outcome.schema.json | Chio Finding Challenge Outcome (signed envelope) | chio.finding.challenge-outcome.v1 | v1 |
chio-finding/v1/challenge-verifier-profile.schema.json | Chio Finding Challenge-Verifier Profile | chio.finding.challenge-verifier-profile.v1 | v1 |
chio-finding/v1/challenge.schema.json | Chio Finding Challenge (signed envelope) | chio.finding.challenge.v1 | v1 |
chio-finding/v1/claim-allocation.schema.json | Chio Finding Claim Allocation | chio.finding.claim-allocation.v1 | v1 |
chio-finding/v1/failed-delivery.schema.json | Chio Finding Failed Delivery (signed envelope) | chio.finding.failed-delivery.v1 | v1 |
chio-finding/v1/finalized-bond-snapshot.schema.json | Chio Finding Finalized Bond Snapshot (signed envelope) | chio.finding.finalized-bond-snapshot.v1 | v1 |
chio-finding/v1/finding.schema.json | Chio Finding | chio.finding.v1 | v1 |
chio-finding/v1/hosted-authenticated-delivery.schema.json | Chio Hosted Authenticated Finding Delivery | chio.finding.hosted-authenticated-delivery.v1 | v1 |
chio-finding/v1/hosted-qualification.schema.json | Chio Hosted Finding Market Qualification | chio.finding.hosted-qualification.v1 | v1 |
chio-finding/v1/impairment-publisher-request.schema.json | Chio Finding Impairment Publisher Request V1 | chio.finding.impairment-publisher-request.v1 | v1 |
chio-finding/v1/impairment-publisher-response.schema.json | Chio Finding Impairment Publisher Response V1 | chio.finding.impairment-publisher-response.v1 | v1 |
chio-finding/v1/key-revocation.schema.json | Chio Finding Key Revocation (signed envelope) | chio.finding.key-revocation.v1 | v1 |
chio-finding/v1/liability.schema.json | Chio Finding Liability | chio.finding.liability.v1 | v1 |
chio-finding/v1/market-penalty.schema.json | Chio Open Market Penalty (signed envelope) | chio.registry.market-penalty.v1 | v1 |
chio-finding/v1/market-terms.schema.json | Chio Finding Market Terms | chio.finding.market-terms.v1 | v1 |
chio-finding/v1/pool-allocation.schema.json | Chio Finding Pool Allocation | chio.finding.pool-allocation.v1 | v1 |
chio-finding/v1/purchase-context.schema.json | Chio Finding Purchase Context (unsigned) | chio.finding.purchase-context.v1 | v1 |
chio-finding/v1/purchase-record.schema.json | Chio Finding Purchase Record (signed envelope) | chio.finding.purchase-record.v1 | v1 |
chio-finding/v1/purchase-result.schema.json | Chio Finding Purchase Result | chio.finding.purchase-result.v1 | v1 |
chio-finding/v1/recovery-context.schema.json | Chio Finding Recovery Context (unsigned) | chio.finding.recovery-context.v1 | v1 |
chio-finding/v1/replay-observation.schema.json | Chio Finding Replay Observation (unsigned) | chio.finding.replay-observation.v1 | v1 |
chio-finding/v1/replay-recipe-input.schema.json | Chio Finding Replay Recipe Input (unsigned) | chio.finding.replay-recipe-input.v1 | v1 |
chio-finding/v1/seller-authorization.schema.json | Chio Finding Seller Authorization (signed envelope) | chio.finding.seller-authorization.v1 | v1 |
chio-finding/v1/status-epoch.schema.json | Chio Finding Status Epoch (signed envelope) | chio.finding.status-epoch.v1 | v1 |
chio-finding/v1/status-proof-input.schema.json | Chio Finding Portable Status Proof Input | chio.finding.status-proof-input.v1 | v1 |
chio-finding/v1/verified-fix-submission.schema.json | Chio Finding Verified Fix Submission | chio.finding.verified-fix-submission.v1 | v1 |
chio-finding/v1/verifier-report.schema.json | Chio Finding Verifier Report | chio.finding.verifier-report.v1 | v1 |
chio-finding/v1/voluntary-retraction.schema.json | Chio Finding Voluntary Retraction | chio.finding.voluntary-retraction.v1 | v1 |
source
spec/schemas/registry.jsonat fe56570Related
- Cognition Market: how a finding reaches a buyer.
- Delivery contract: the digest comparison the kernel runs.
- Cognition findings: the market mechanisms these artifacts settle.
- Protocol: section 6.4.7 in its place in the artifact catalog.
- Receipt format: the receipt blocks a reveal writes.