Schema Reference

This page is the implementation index for all machine-consumable Reciprium v1 artifacts.

JSON Schema (Draft 2020-12)

Base path: https://reciprium.github.io/spec/v1/schema/

• envelope.json
• timestamp.json
• intent.json
• subject.json
• scope.json
• payload.json
• execution.json
• verification.json
• artifacts.json
• signature.json
• hash-chain.json

Notes:

• All schema $id values are hosted under https://reciprium.github.io/spec/v1/schema/....
• Relative $ref links resolve through those hosted IDs.

CDDL and Protobuf

• CDDL: v1/cddl/receipt.cddl
• Protobuf: v1/protobuf/receipt.proto

Interoperability Vectors

• Signature vectors: v1/test-vectors/signatures.json

This vector file is normative evidence for cross-language signing and verification behavior in SDKs.

Reference Example Receipts

• v1/examples/terraform-basic.json
• v1/examples/terraform-full.json
• v1/examples/gitops-basic.json
• v1/examples/database-migration.json
• v1/examples/secret-rotation.json
• v1/examples/break-glass-access.json

Validation Commands

cddl compile-cddl --cddl v1/cddl/receipt.cddl
for f in v1/examples/*.json; do
  cddl validate --cddl v1/cddl/receipt.cddl --json "$f"
done