# DBIS Rail

This folder holds the **DBIS Rail** technical specification and operational rulebook for Chain 138 (DBIS Mainnet): bank-rail settlement and GRU mint orchestration using ISO-20022–anchored authorizations.

- **E2E White Paper (simple terms):** [E2E_WHITEPAPER_SIMPLE.md](E2E_WHITEPAPER_SIMPLE.md) — end-to-end flow, components, and controls in plain language.
- **Technical Spec:** [DBIS_RAIL_TECHNICAL_SPEC_V1.md](DBIS_RAIL_TECHNICAL_SPEC_V1.md) — contract set, MintAuth, signer quorum, replay protection, audit events.
- **Rulebook:** [DBIS_RAIL_RULEBOOK_V1.md](DBIS_RAIL_RULEBOOK_V1.md) — good funds matrix, finality rules, accounting sequence, reversal handling, signer governance, incident controls, audit standards.
- **Settlement rulebook (HYBX / OMNL evidence):** [DBIS_SETTLEMENT_RULEBOOK.md](DBIS_SETTLEMENT_RULEBOOK.md) — batch identity, netting narrative, **Annex B** Merkle leaf canonicalisation for regulator packages.
- **Security Threat Model:** [DBIS_RAIL_SECURITY_THREAT_MODEL_V1.md](DBIS_RAIL_SECURITY_THREAT_MODEL_V1.md) — trust boundaries, authorization/ledger/router/mint/validator/off-chain threats, severity classification, residual risk, review cycle.
- **Regulator-Facing Brief:** [DBIS_RAIL_REGULATOR_BRIEF_V1.md](DBIS_RAIL_REGULATOR_BRIEF_V1.md) — institutional narrative for counterparties, examiners, counsel, and risk committees: overview, governance, lifecycle, good funds, controls, risk posture, audit, residual risk, amendment.
- **Audit Readiness Checklist:** [DBIS_RAIL_AUDIT_READINESS_CHECKLIST_V1.md](DBIS_RAIL_AUDIT_READINESS_CHECKLIST_V1.md) — pre-audit control verification: mint path, authorization, signer governance, accounting/evidence, router controls, validator layer, emergency controls, documentation integrity.
- **Audit Readiness Results:** [DBIS_RAIL_AUDIT_READINESS_RESULTS_V1.md](DBIS_RAIL_AUDIT_READINESS_RESULTS_V1.md) — baseline checklist run: status per section, gaps (e.g. owner mint, rail contracts not deployed), and prioritized remediation.
- **Control Mapping:** [DBIS_RAIL_CONTROL_MAPPING_V1.md](DBIS_RAIL_CONTROL_MAPPING_V1.md) — control IDs mapped to checklist sections, Spec, Rulebook, and Threat Model for audit and SOC 2 / ISO 27001 alignment.
- **Completion Master:** [DBIS_RAIL_AND_PROJECT_COMPLETION_MASTER_V1.md](DBIS_RAIL_AND_PROJECT_COMPLETION_MASTER_V1.md) — current project and deployment status; full task list (required and optional) for DBIS Rail audit readiness and project completion.
- **Implementation coordination:** [IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md](IMPLEMENTATION_COORDINATION_WITH_TRANSCRIPT_540AE663.md) — coordinate all implementations with transcript 540ae663 (PMM/DEX, tokens, GRU, cW*, deployments); maps Completion Master tasks to done/partial/open.
- **v1.5 Ledger Attestation Add-On:** [DBIS_RAIL_LEDGER_ATTESTATION_ADDON_V1_5.md](DBIS_RAIL_LEDGER_ATTESTATION_ADDON_V1_5.md) — LPA state machine, reversal policy matrix, mandatory signer effectiveFromBlock/revokedAtBlock enforcement.
- **v1.5 Conversion Router Spec:** [DBIS_RAIL_CONVERSION_ROUTER_SPEC_V1_5.md](DBIS_RAIL_CONVERSION_ROUTER_SPEC_V1_5.md) — SwapAuth (EIP-712), best execution/MEV posture, quote provenance, venue allowlist, sanctions/AML for swaps.
- **v1.5 Stablecoin Policy:** [DBIS_RAIL_STABLECOIN_POLICY_V1_5.md](DBIS_RAIL_STABLECOIN_POLICY_V1_5.md) — Canonical USDC/USDT definition, Stablecoin Reference Registry, canonical stablecoin routing, monitoring.
- **v1.5 Hash Canonicalization and Test Vectors:** [DBIS_RAIL_HASH_CANONICALIZATION_AND_TEST_VECTORS_V1_5.md](DBIS_RAIL_HASH_CANONICALIZATION_AND_TEST_VECTORS_V1_5.md) — LEB/LPA/ISO schemas, canonicalization rules, test vectors for auditor reproducibility.
- **Add-Ons code completion:** [DBIS_RAIL_ADDONS_CODE_COMPLETION_TASK_LIST.md](DBIS_RAIL_ADDONS_CODE_COMPLETION_TASK_LIST.md) — full task list to implement Spec v1 + v1.5 and achieve an operational system.