docs/dbis-rail/README.md

# 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.
-												chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

											
										
										
											2026-03-02 11:37:34 -08:00
+								# 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.
-												chore: update submodule references and documentation

- Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes.
- Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions.
- Enhanced the README and various index files to provide clearer navigation and task completion guidance.

Made-with: Cursor

											
										
										
											2026-03-04 02:03:08 -08:00
+								- **E2E White Paper (simple terms):** [E2E_WHITEPAPER_SIMPLE.md](E2E_WHITEPAPER_SIMPLE.md) — end-to-end flow, components, and controls in plain language.
-												chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

											
										
										
											2026-03-02 11:37:34 -08:00
+								- **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.
-												feat(omnl): HYBX-BATCH-001 package, rail scripts, regulatory docs, CI

- Add OMNL/CBK Indonesia submission and audit binder docs, manifests, attestations
- Add scripts/omnl transaction-package pipeline, LEI/PvP helpers, jq/lib fixtures
- Update entity master data, MASTER_INDEX, TODOS, dbis-rail docs and rulebook
- Add proof_package/regulatory skeleton and transaction package zip + snapshot JSON
- validate-omnl-rail workflow, forge-verification-proxy tweak, .gitignore hygiene
- Bump smom-dbis-138 (cronos verify docs/scripts) and explorer-monorepo (SPA + env report)

Made-with: Cursor

											
										
										
											2026-03-24 18:11:36 -07:00
+								- **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.
-												chore: sync all changes to Gitea

- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor

											
										
										
											2026-03-02 11:37:34 -08:00
+								- **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.