Chio/Docs
LOGIN · JOIN

PlatformInventory & Assumptions

Formal Assurance

Theorem Inventory

Lean 4 theorems reachable from the formal root, with their Lean names, files, claim classes, and property IDs.

Reading the claim class

bounded_model means the theorem is over a finite Lean model, not the running Rust binary. aeneas_equivalence means the theorem links the handwritten Lean model to a model extracted from Rust by Aeneas. symbolic_crypto means the theorem is over a symbolic Merkle/sign/verify model rather than a cryptographic implementation. The declared axiom has claim class symbolic_crypto and is listed in allowed_axioms.

The axiom

Two registries have to agree on what the Lean tree assumes. The manifest's allowed_axioms list is the approved set:

formal/proof-manifest.toml197-201toml
allowed_axioms = [
  # Symbolic collision resistance over the image of the mechanized canonical
  # UTF-8 renderer. This is the Lean idealization registered as ASSUME-SHA256.
  "Chio.Json.hash_collision_resistant",
]

The inventory carries the matching row in its assumptions array, which is separate from the theorems array the rest of this catalog draws on:

formal/theorem-inventory.json4-16json
"assumptions": [
  {
    "id": "assume.hash.collision_resistant",
    "leanName": "Chio.Json.hash_collision_resistant",
    "file": "formal/lean4/Chio/Chio/Json/Hash.lean",
    "kind": "axiom",
    "rootImported": true,
    "claimClass": "symbolic_crypto",
    "status": "assumed",
    "mapsTo": ["P4", "P7"],
    "notes": "Symbolic hash collision resistance over the image of the mechanized canonical UTF-8 renderer. This is the sole explicit root-imported Lean axiom and is registered one-to-one as ASSUME-SHA256; concrete SHA-256 remains outside Lean."
  }
],
IDLean nameFileKindClassMaps to
assume.hash.collision_resistantChio.Json.hash_collision_resistantformal/lean4/Chio/Chio/Json/Hash.leanaxiomsymbolic_cryptoP4, P7

The declaration is axiom hash_collision_resistant : SymbolicHash at formal/lean4/Chio/Chio/Json/Hash.lean. SymbolicHash is a structure bundling an output type, a digest function over canonical bytes, and a proof that the digest is injective, so assuming an inhabitant of it is assuming collision resistance over the image of the mechanized canonical renderer. Concrete SHA-256 stays outside Lean, and the inventory registers the axiom one-to-one against ASSUME-SHA256 in formal/assumptions.toml.

scripts/check-formal-proofs.sh holds the two lists together in both directions. It rejects the tree when the inventory's assumption Lean names differ from allowed_axioms, and it elaborates the root module and rejects the tree again when the set of axioms the Lean environment reports differs from the same list. An axiom added to the source without an entry in both registries stops the gate.


Capability algebra theorems

P1 (capability monotonicity) proves, over the bounded capability algebra model, that a child capability is a subset of its parent.

IDLean nameFileMaps to
core.scope.empty_isSubsetOfChio.Core.ChioScope.empty_isSubsetOfCore/Scope.leanP1
core.tool_grant.isSubsetOf_reflChio.Core.ToolGrant.isSubsetOf_reflCore/Scope.leanP1
spec.capability_monotonicityChio.Spec.capability_monotonicitySpec/Properties.leanP1
spec.empty_scope_monotonicityChio.Spec.empty_scope_monotonicitySpec/Properties.leanP1
spec.scope_budgets_nonnegativeChio.Spec.scope_budgets_nonnegativeSpec/Properties.leanP1
proof.list_isSubsetOf_transChio.Proofs.list_isSubsetOf_transProofs/Monotonicity.leanP1
proof.scope_subset_of_grants_subsetChio.Proofs.scope_subset_of_grants_subsetProofs/Monotonicity.leanP1
proof.wildcard_subsumesChio.Proofs.wildcard_subsumesProofs/Monotonicity.leanP1
proof.reduced_budget_is_subsetChio.Proofs.reduced_budget_is_subsetProofs/Monotonicity.leanP1
proof.added_constraint_is_subsetChio.Proofs.added_constraint_is_subsetProofs/Monotonicity.leanP1
theorem.attenuation.witness_soundnessChio.Proofs.AttenuationWitness.witness_soundnessProofs/AttenuationWitness.leanP1
theorem.budget.sibling_sum_soundnessChio.Proofs.SiblingSumBudget.sibling_sum_soundnessProofs/SiblingSumBudget.leanP1
proof.delegation_chain_integrityChio.Proofs.delegation_chain_integrityProofs/Monotonicity.leanP5

The headline theorem statement is short:

formal/lean4/Chio/Chio/Spec/Properties.lean18-30lean
/-- P1: Capability monotonicity -- if a child scope is a subset of a parent
    scope, then every grant in the child is covered by some grant in the
    parent.

    This is the core Chio safety property: delegation can only attenuate,
    never amplify. -/
theorem capability_monotonicity (parent child : ChioScope)
    (h : child.isSubsetOf parent = true) :
    ∀ g, g ∈ child.grants →
      ∃ pg, pg ∈ parent.grants ∧ g.isSubsetOf pg = true := by
  intro g h_mem
  unfold ChioScope.isSubsetOf at h
  exact List.any_eq_true.mp (List.all_eq_true.mp h g h_mem)

P1: capability_monotonicity in this catalog

P1 says a child capability's bounds are tighter than its parent's; delegation attenuates and never amplifies. This catalog records P1 in thirteen rows spread across six files. The headline row is spec.capability_monotonicity; every other P1 row either supports it (subset transitivity, wildcard subsumption, budget tightening, added constraints, the attenuation witness, the sibling-sum budget law) or pins a corner case (empty scope, reflexivity, non-negative budgets). Verbatim from formal/theorem-inventory.json:

formal/theorem-inventory.jsonjson
{
  "id": "spec.capability_monotonicity",
  "leanName": "Chio.Spec.capability_monotonicity",
  "file": "formal/lean4/Chio/Chio/Spec/Properties.lean",
  "kind": "theorem",
  "rootImported": true,
  "claimClass": "bounded_model",
  "mapsTo": ["P1"],
  "notes": "Primary attenuation theorem over ChioScope grants only; no Rust refinement proof yet."
}

Field by field:

  • id · stable inventory ID. The gate scripts/check-formal-proofs.sh fails if any ID is renamed without an accompanying entry change.
  • leanName · the fully qualified Lean identifier. The gate elaborates the root module and asserts this name resolves.
  • file · path relative to the repo root. P1 sits under Spec/ rather than Proofs/ because the theorem statement is the Chio spec, not a derived helper.
  • rootImported · true means the gate checks the import graph closure from Chio.lean reaches this file. A theorem that elaborates but is not root-imported fails the gate.
  • claimClass · bounded_model. The theorem reasons about the Lean ChioScope definition, not the Rust binary. The Aeneas equivalence theorem aeneas_optionalCapIsSubset_preserves_parent_cap (also tagged P1) is what ties the bounded model to the executable code.
  • mapsTo · the property IDs from the proof manifest this row helps discharge. P1 is the only one here.

Continue the tour at Lean 4 Proofs: P1 the canonical proof or jump back to the P1 Tour.


Revocation theorems

Revocation surfaces in two places: the bounded revocation-store model, and the projected snapshot used by the evaluator.

IDFileMaps to
proof.revoke_marks_capability_revokedProofs/Revocation.leanP2
proof.revoke_preserves_existing_revocationProofs/Revocation.leanP2
proof.checkRevocation_revoked_token_errorsProofs/Revocation.leanP2
proof.checkRevocation_revoked_ancestor_never_okProofs/Revocation.leanP2
proof.checkRevocation_ok_implies_not_revokedProofs/Revocation.leanP2
proof.revocationSnapshot_revoked_token_deniesProofs/Protocol.leanP2, P3
proof.revocationSnapshot_revoked_ancestor_deniesProofs/Protocol.leanP2, P3

Evaluation theorems

The bounded evaluator covers signature, time, scope, and revocation checks. P3 is the master fail-closed property.

IDFileMaps to
proof.evalToolCall_totalProofs/Evaluation.leanP3
proof.evalToolCall_invalid_signature_deniesProofs/Evaluation.leanP3
proof.evalToolCall_not_yet_valid_deniesProofs/Evaluation.leanP3
proof.evalToolCall_expired_deniesProofs/Evaluation.leanP3
proof.evalToolCall_revoked_token_never_allowsProofs/Evaluation.leanP2, P3
proof.evalToolCall_revoked_ancestor_never_allowsProofs/Evaluation.leanP2, P3
proof.evalToolCall_out_of_scope_deniesProofs/Evaluation.leanP3
proof.evalToolCall_all_checks_pass_allowProofs/Evaluation.leanP3

Receipt theorems

Every inventory row whose file is Proofs/Receipt.lean, plus the field-coupling row in Proofs/Protocol.lean. The two collision-resistance rows here are theorems, discharged over the symbolic hash the axiom above supplies.

IDFileClassMaps to
proof.receipt_id_input_collision_resistantProofs/Receipt.leansymbolic_cryptoP4, P7
proof.receipt_id_collision_resistantProofs/Receipt.leansymbolic_cryptoP4, P7
proof.applyProof_appendProofs/Receipt.leansymbolic_cryptoP4
proof.membership_proof_soundProofs/Receipt.leansymbolic_cryptoP4
proof.membership_proof_verifiesProofs/Receipt.leansymbolic_cryptoP4
proof.checkpoint_consistencyProofs/Receipt.leansymbolic_cryptoP4
proof.receipt_sign_then_verifyProofs/Receipt.leansymbolic_cryptoP4
proof.receipt_immutabilityProofs/Receipt.leansymbolic_cryptoP4
proof.receiptFieldsCoupled_preserves_all_fieldsProofs/Protocol.leanbounded_modelP4

Protocol-layer theorems

Theorems in Proofs/Protocol.lean and Proofs/FormalClosure.lean cover guard-pipeline composition, DPoP nonce admission, budget commits, governed approvals, session continuity, lineage soundness, registry behavior, path-prefix safety, and report truthfulness.

IDFileMaps to
proof.admitSession_invalid_dpop_rejectsProofs/Protocol.leanP3, P8
proof.admitSession_invalid_anchor_rejectsProofs/Protocol.leanP3, P8
proof.budgetPrecheck_commit_preserves_boundsProofs/Protocol.leanP3
proof.budgetCommit_none_when_precheck_failsProofs/Protocol.leanP3
proof.budgetTwoCommit_preserves_boundsProofs/Protocol.leanP3
proof.clusterOverrun_bound_is_explicitProofs/Protocol.leanP3
proof.governedApproval_required_without_token_failsProofs/Protocol.leanP3
proof.governedApproval_valid_token_passesProofs/Protocol.leanP3
proof.dpop_required_missing_proof_rejectsProofs/Protocol.leanP3, P8
proof.dpop_required_invalid_proof_rejectsProofs/Protocol.leanP3, P8
proof.dpop_reused_nonce_rejectsProofs/Protocol.leanP8
proof.guardPipeline_deny_dominatesProofs/Protocol.leanP3
proof.guardPipeline_error_dominatesProofs/Protocol.leanP3
proof.guardPipeline_allow_requires_core_authorizedProofs/Protocol.leanP3
proof.observed_parent_edge_soundProofs/Protocol.leanP6
proof.verified_receipt_lineage_soundProofs/Protocol.leanP7
proof.session_continuity_soundProofs/Protocol.leanP8
proof.capability_lineage_consistency_soundProofs/Protocol.leanP9
proof.report_truthfulness_asserted_not_verifiedProofs/Protocol.leanP10
proof.report_truthfulness_observed_not_verifiedProofs/Protocol.leanP10
proof.registry_publish_requires_valid_signatureProofs/Protocol.leanP10
proof.registry_resolve_published_valid_recordProofs/Protocol.leanP10
proof.registry_revoke_deactivates_published_recordProofs/Protocol.leanP10
proof.delegation_step_allow_requires_attenuationProofs/FormalClosure.leanP5
proof.delegation_step_allow_requires_subject_continuityProofs/FormalClosure.leanP5
proof.delegation_step_allow_requires_expiry_monotonicityProofs/FormalClosure.leanP5
proof.delegation_revoked_ancestor_deniesProofs/FormalClosure.leanP5
proof.delegation_max_depth_failure_deniesProofs/FormalClosure.leanP3, P5
proof.dpop_binding_allows_only_when_all_fields_matchProofs/FormalClosure.leanP8
proof.path_prefix_rejects_sibling_prefixProofs/FormalClosure.leanP3
proof.path_prefix_rejects_normalized_traversal_escapeProofs/FormalClosure.leanP3

Treaty and bilateral accept theorems

The Treaty lane covers cross-organization governance: bilateral treaty admission, constitutional amendment refinement, syntactic predicate-chain preservation, and the bilateral DSSE accept set. These theorems live in Treaty/Intersection.lean, Treaty/PredicateLang.lean, and Treaty/BilateralAccept.lean, all imported from Chio.lean. The explanation of the systems modeled by these theorems is in Papers; this table is the catalog entry, copied verbatim from formal/theorem-inventory.json.

IDLean nameFileClassMaps to
proof.treaty_admission_iff_predicate_intersectionChio.Treaty.treaty_admission_iff_predicate_intersectionTreaty/Intersection.leanbounded_modelP7
proof.treaty_admission_stable_under_ladder_floorChio.Treaty.treaty_admission_stable_under_ladder_floorTreaty/Intersection.leanbounded_modelP7
proof.amendment_admissible_iff_backward_refinementChio.Treaty.amendment_admissible_iff_backward_refinementTreaty/Intersection.leanbounded_modelP3
proof.amendment_without_refinement_rejectedChio.Treaty.amendment_without_refinement_rejectedTreaty/Intersection.leanbounded_modelP3
proof.freestanding_accept_set_theoremChio.Treaty.BilateralAccept.freestanding_accept_set_theoremTreaty/BilateralAccept.leanbounded_modelP7
proof.essential_preserved_chainChio.Treaty.PredicateLang.essential_preserved_chainTreaty/PredicateLang.leanbounded_modelP3
proof.containsPredicate_preserved_chainChio.Treaty.PredicateLang.containsPredicate_preserved_chainTreaty/PredicateLang.leanbounded_modelP3
proof.anchor_admission_iff_lane_quorum_satisfiedChio.Treaty.PredicateLang.anchor_admission_iff_lane_quorum_satisfiedTreaty/PredicateLang.leanbounded_modelP7
proof.anchor_admission_rejects_undeclared_laneChio.Treaty.PredicateLang.anchor_admission_rejects_undeclared_laneTreaty/PredicateLang.leanbounded_modelP7

All nine rows are rootImported: true with status proved, claim class bounded_model: each holds over the bounded Lean treaty and predicate-language models, and none of them holds over an Aeneas extraction, a Kani harness, or a Creusot contract. The manifest states the standing of this lane directly: the treaty PredicateLang is a bounded post-validation abstraction over production-shaped federation inputs, and its Lean abstraction anchors are drift tripwires rather than a Rust refinement proof.


Aeneas equivalence theorems

These theorems live in Proofs/AeneasEquivalence.lean. Each one says: the Aeneas-extracted Lean mirror of a function in crates/kernel/chio-kernel-core/src/formal_aeneas.rs is equivalent to the handwritten model the rest of the proofs depend on. The class is aeneas_equivalence.

IDMaps to
proof.aeneas_timeWindowValid_equiv_modelP3
proof.aeneas_optionalCapIsSubset_preserves_parent_capP1
proof.aeneas_budgetCommit_equiv_modelP3
proof.aeneas_dpopAdmits_equiv_modelP8
proof.aeneas_revocationSnapshot_equiv_modelP2
proof.aeneas_guardStep_equiv_modelP3
proof.aeneas_receiptCoupling_equiv_modelP4

Proof-to-Rust mapping

formal/MAPPING.md is the cross-reference from named TLA+ invariants and Kani harnesses to the Rust call sites they constrain. The script scripts/check-mapping.sh greps the source for each name and fails the build if any appear in source but not in the mapping.

TLA+ invariants

Six rows, one per named invariant in formal/tla/RevocationPropagation.tla. The five safety names are the leaves of the aggregate SafetyInv, which conjoins them with the domain invariant DomainsOK; RevocationEventuallySeen is the liveness property and is checked separately. The mapping file labels the third column Assumption discharge and defines it as which audited assumptions the property relies on, so nothing in it is a retirement.

InvariantRust path constrainedAssumptions relied on
NoAllowAfterRevokechio-kernel/src/kernel/validation.rs (revoke_capability, check_revocation), chio-kernel-core/src/revocation_view.rsASSUME-SQLITE-ATOMICITY for single-row commits; cross-row recovery is excluded. Runtime trace qualification rests on ASSUME-TRACE-OBSERVER.
MonotoneLogchio-kernel/src/kernel/responses/receipt_persistence.rs, chio-store-sqlite/src/receipt_store.rsASSUME-SQLITE-ATOMICITY and ASSUME-OS-CLOCK; the storage anchors do not enforce strict timestamps
AttenuationPreservingchio-core-types/src/capability/attenuation.rs, chio-core-types/src/capability/scope.rs (ChioScope::is_subset_of), chio-kernel-core/src/normalized.rsn/a (structural; bounded by DEPTH_MAX)
RevocationFreshnesschio-revocation-oracle/src/freshness.rs, chio-kernel-core/src/revocation_view.rsASSUME-OS-CLOCK
RevocationStateCoupledchio-kernel-core/src/revocation_view.rs, chio-kernel/src/kernel/validation.rs (check_revocation), chio-kernel/src/kernel/delegation.rsASSUME-NETWORK-TRANSPORT; the runtime snapshot has one global epoch and a revoked-subject set rather than a per-subject lifecycle state
RevocationEventuallySeenchio-federation/src/revocation_gossip.rsModel-only WF_vars(PropagateAny); ASSUME-NETWORK-TRANSPORT remains audited and does not guarantee delivery

No row in this table records a discharge. Every id in it sits in required_assumption_ids at formal/assumptions.toml, retired_assumption_ids and retired_assumptions there are both empty, and so is discharged_assumptions in formal/proof-manifest.toml. The registry states the bar an invariant would have to clear: retiring an assumption takes named model evidence and a concrete implementation-refinement gate over the affected production boundary, and abstract invariants and manual mirror hashes are not sufficient by themselves.

The scope of the SQLite entry is worth reading in the registry's own words, because it is narrower than the invariant above it suggests. ASSUME-SQLITE-ATOMICITY assumes atomic committed updates for revocation, budget, receipt and registry state per single-row write. Cross-row crash recovery, ordering and conservation are not assumed or discharged and remain outside the current formal claim boundary. The manifest says the same thing from the other side about the invariant that comes closest: ReceiptBeforeAllow proves the abstract persist-before-publish ordering and its production replay exercises the native happy path, and it does not discharge concrete cross-row crash recovery, which remains excluded until implementation trace validation and crash-reopen conservation gates establish refinement. See Assumptions and TCB for the registry in full.

Two more Apalache specs sit alongside RevocationPropagation.tla. formal/tla/DelegationDepthBound.tla carries three named safety invariants ( DepthBoundedByRoot, AttenuatedAtEachStep, and RevokedSubtreeNotObservable ) and the kernel-state-subset lane under formal/apalache/ adds MonotoneLogApalache, ReceiptBeforeAllow, RevocationCutCompleteness, KernelTransitionCancelSafe, and PostAdmissionDropGuard.

Public Kani harnesses

Source: crates/kernel/chio-kernel-core/src/kani_public_harnesses.rs. The mapping script extracts function names following a #[kani::proof] attribute and checks that each appears in the table below.

HarnessRust path constrained
public_verify_capability_rejects_untrusted_issuer_before_signaturecapability_verify::verify_capability
public_normalized_scope_subset_rejects_widened_childNormalizedScope::is_subset_of
public_normalized_scope_subset_rejects_value_widened_childNormalizedScope::is_subset_of
public_normalized_scope_subset_rejects_identity_mismatchNormalizedScope::is_subset_of
public_resolve_matching_grants_rejects_out_of_scope_requestscope::resolve_matching_grants
public_resolve_matching_grants_preserves_wildcard_matchingscope::resolve_matching_grants
public_evaluate_rejects_untrusted_issuer_before_dispatchevaluate::evaluate
public_sign_receipt_rejects_kernel_key_mismatch_before_signingreceipts::sign_receipt
public_sign_receipt_accepts_matching_kernel_keyreceipts::sign_receipt
public_sign_receipt_refuses_content_hash_mismatchreceipts::sign_receipt (WYSIWYS content-hash recompute)
public_sign_receipt_accepts_matching_content_hashreceipts::sign_receipt (WYSIWYS content-hash recompute)
verify_scope_intersection_associativeformal_core::optional_u32_cap_is_subset
verify_revocation_predicate_idempotentformal_core::revocation_snapshot_denies
verify_delegation_chain_stepformal_core::* (one delegation step composition)
verify_receipt_roundtripreceipts::sign_receipt, ChioReceipt::verify_signature
verify_budget_checked_add_no_overflowchio_kernel::budget_store::BudgetUsageRecord (additive cap update)
verify_delegate_no_widenchio_core_types::capability::delegate
verify_delegation_receipt_canonicalchio_core_types::delegation_receipt::DelegationReceipt::canonical_bytes
verify_revocation_view_freshnesschio_kernel_core::revocation_view::RevocationView::install_if_newer
verify_oracle_inclusion_soundnesschio_revocation_oracle::api::InclusionProof::verify

Status

Each theorem in the inventory above is rootImported: true. That means it is reachable from the root module formal/lean4/Chio/Chio.lean and the Lean kernel has type-checked it without sorry placeholders. The gate scripts/check-formal-proofs.sh rejects any theorem that drops out of the root import graph or that introduces a sorry.

Bounded models, not Rust

Except for the Aeneas equivalence theorems, these theorems are over Lean models, not the running Rust binary. Aeneas equivalence theorems, Kani harnesses, and Creusot contracts cover separate links to executable code; each has its own model and boundary.

Next

  • Aeneas Pipeline · how the equivalence theorems are produced and checked.
  • Lean 4 Proofs · per-file structure of the proofs in this inventory.
  • Kani Harnesses · full per-harness inventory with wall clocks.
  • TLA+ Specs · the revocation-propagation invariants in detail.