graph TB
subgraph "🏛️ GRU Monetary System"
M00["M00 - Sovereign Issuance<br/>🔐 Base Reserve Layer"]
M0["M0 - Institutional<br/>🏦 Reserve Circulation"]
M1["M1 - Commercial<br/>💰 eMoney Layer"]
M00 -->|1:5 ratio| M0
M00 -->|1:25 ratio| M1
end
subgraph "🎯 Core Pillars"
P1["📊 Parity & Stability<br/>XAU Gold Anchor"]
P2["💧 Liquidity Management<br/>Li99 Bond System"]
P3["⚖️ Multi-Chamber Governance<br/>SHTE Framework"]
P4["🔄 Programmable Expansion<br/>7:10 Triangulation"]
end
subgraph "🌐 Integration"
DBIS["Digital Bank for<br/>International Settlements"]
Smart["Diamond Standard<br/>Smart Contracts"]
Audit["Quarterly PoR<br/>& Transparency"]
end
M00 -.-> P1
M0 -.-> P2
M1 -.-> P3
P4 -.-> Smart
Smart -.-> DBIS
DBIS -.-> Audit
This repository contains the comprehensive institutional documentation for the Global Reserve Unit (GRU) monetary architecture and Digital Bank for International Settlements (DBIS) charter. It establishes the foundation for:
- 📋 Core Policy Framework - Structural ratios, reserve policies, governance layers
- ⚙️ Mechanical Issuance Logic - Atomic triangulation, 7:10 protocol, 40/40/20 allocation
- 🏛️ Governance Infrastructure - Multi-chamber SHTE oversight and compliance
- 📈 Bond System Management - Li99-series liquidity instruments and cycles
- 🚀 Expansion Roadmap - Phased rollout and future enhancements
The GRU documentation is available in multiple languages to ensure global accessibility:
- 🇬🇧 English - Primary documentation (this repository root:
docs/) - 🇮🇩 Bahasa Indonesia - Indonesian Translation
- 🇧🇷 Português - Portuguese Translation
- 🇸🇦 العربية - Arabic Translation
- 🇫🇷 Français - French Translation
All translations maintain the same structure and technical accuracy as the English version. Core monetary policy documents are prioritized for translation.
graph LR
subgraph "📚 Documentation Layer"
DOCS["`docs/
📄 Core Policy Documents
📊 Meta References
🎨 Visual Assets`"]
end
subgraph "⚙️ Smart Contract Layer"
CONTRACTS["`contracts/
💎 Diamond Standard
🔧 Faceted Architecture
🔍 Interface Definitions`"]
end
subgraph "🛠️ Infrastructure Layer"
SCRIPTS["`scripts/
🏗️ Build Automation
📋 Export Utilities
🔐 Signing Tools`"]
SUBGRAPH["`subgraph/
📈 Data Indexing
🔗 Graph Protocol
📊 Analytics Layer`"]
end
DOCS --> CONTRACTS
CONTRACTS --> SCRIPTS
SCRIPTS --> SUBGRAPH
📁 docs/
├── 📋 core/ # Primary white paper documents
│ ├── 📄 00_GRU_Executive_Summary.md
│ ├── 📊 01_GRU_Monetary_Policy_Framework.md
│ ├── 🔄 02_GRU_Triangulation_eMoney_Creation.md
│ ├── 💰 03_GRU_Bond_System_Liquidity_Management.md
│ ├── ⚖️ 04_GRU_Governance_Regulatory_Oversight.md
│ ├── 🌐 05_Digital_Bank_for_International_Settlements_Charter.md
│ ├── 🚀 06_GRU_Enhancement_Expansion_Roadmap.md
│ └── 🏛️ 07_OMNL_Central_Bank_DBIS_Operational_Manual.md
│
├── 🏛️ compliance/ # EU/ECB regulatory compliance
│ ├── 📋 sepa/ # SEPA payments compliance
│ │ ├── SEPA_Compliance_Matrix.md
│ │ └── IPR_Compliance_Memo.md
│ ├── ⚖️ mica/ # Markets in Crypto-Assets regulation
│ │ ├── Legal_Position_GRU_vs_MiCA.md
│ │ └── Issuer_Obligations_Readiness.md
│ ├── 🛡️ dora/ # Digital Operational Resilience Act
│ │ ├── ICT_Risk_Policy.md
│ │ ├── Incident_Response_Runbook.md
│ │ ├── Third_Party_Risk_Policy.md
│ │ ├── BCP_DR_Plan.md
│ │ └── Annual_Test_Plan.md
│ ├── 🔍 aml/ # Anti-Money Laundering & CFT
│ │ ├── Enterprise_Wide_Risk_Assessment.md
│ │ ├── KYC_SOP.md
│ │ ├── Sanctions_Screening_SOP.md
│ │ ├── TM_Scenarios.md
│ │ ├── SAR_Playbook.md
│ │ └── Training_Log.md
│ └── 🔐 gdpr/ # Data protection compliance
│ ├── DPIA_GRU.pdf
│ └── Record_of_Processing_Activities.md
│
├── 🔗 integration/ # Technical integration documentation
│ └── iso20022/ # ISO 20022 message standards
│ ├── pain.001.sample.xml
│ ├── pacs.008.sample.xml
│ └── Mapping_Table.md
│
├── 📊 disclosures/ # Transparency and public disclosures
│ └── PoR_Methodology.md # Proof-of-Reserves framework
│
├── 🔒 security/ # Security and risk management
│ └── Oracle_Governance_Standard.md
│
├── 💼 finance/ # Financial controls and accounting
│ ├── Accounting_Policy_IFRS.md
│ └── Monthly_Close_Checklist.md
│
├── ⚖️ legal/ # Legal and documentary controls
│ └── Documentary_Controls_ICC_Style.md
│
├── 📖 meta/ # Supporting references & annexes
│ ├── 🧮 GRU_Formulas.md
│ ├── 📚 Glossary.md
│ ├── ⚠️ Risk_Annex.md
│ └── 🎨 preamble.tex # LaTeX PDF styling
│
└── 🎨 media/ # Visual diagrams & assets
├── 🔄 issuance_cycle.svg
├── 📐 triangulation_flow.svg
├── 🏛️ governance_chambers.svg
├── 💎 bond_cycle.svg
└── 📊 velocity_metrics.svg
💎 contracts/ # Diamond Standard smart contracts
├── 🏗️ GrcDiamond.sol # Main diamond contract
├── 🔧 facets/ # Modular functionality facets
├── 🔗 interfaces/ # Interface definitions
└── 📚 libraries/ # Shared contract libraries
🛠️ scripts/ # Build & automation tools
📈 subgraph/ # Graph Protocol indexing
📦 dist/ # Generated artifacts (gitignored)
The GRU system implements the Diamond Standard (EIP-2535) for maximum flexibility and upgradeability:
graph TB
Diamond["💎 GRU Diamond<br/>Main Contract"]
subgraph "🔧 Core Facets"
Access["🔐 AccessFacet<br/>Role Management"]
Monetary["💰 MonetaryFacet<br/>Issuance Logic"]
Triangulation["📐 TriangulationFacet<br/>7:10 Protocol"]
Bond["💎 BondFacet<br/>Li99 System"]
end
subgraph "🛡️ Security Facets"
Audit["🔍 AuditFacet<br/>PoR Validation"]
Pause["⏸️ PauseFacet<br/>Emergency Controls"]
Governance["⚖️ GovernanceFacet<br/>Multi-Chamber"]
end
subgraph "📊 Analytics"
Index["📈 IndexFacet<br/>LiXAU Metrics"]
Subgraph["📊 Graph Protocol<br/>Data Indexing"]
end
Diamond --> Access
Diamond --> Monetary
Diamond --> Triangulation
Diamond --> Bond
Diamond --> Audit
Diamond --> Pause
Diamond --> Governance
Diamond --> Index
Index --> Subgraph
graph LR
subgraph "📥 Input Sources"
MD["📄 Markdown Docs"]
TEX["🎨 LaTeX Preamble"]
SVG["🖼️ SVG Diagrams"]
end
subgraph "🔄 Build Pipeline"
PANDOC["📖 Pandoc Engine"]
LATEX["🔤 LaTeX Processing"]
CHECKSUM["🔐 SHA256 Hashing"]
end
subgraph "📦 Output Artifacts"
PDF["📄 PDF Documents"]
DOCX["📝 DOCX Files"]
ZIP["📦 Master Archive"]
VERIFY["✅ Verification Log"]
end
MD --> PANDOC
TEX --> LATEX
SVG --> PANDOC
PANDOC --> PDF
PANDOC --> DOCX
LATEX --> PDF
PDF --> CHECKSUM
DOCX --> CHECKSUM
CHECKSUM --> VERIFY
PDF --> ZIP
DOCX --> ZIP
VERIFY --> ZIP
# Core dependencies
pandoc # Document conversion engine
texlive-xetex # LaTeX with Unicode support
librsvg2-bin # SVG to PDF conversion
zip # Archive creation
sha256sum # Integrity verification# Make build script executable and run
chmod +x scripts/build.sh && ./scripts/build.shdist/
├── 📄 markdown/ # Source copies + master collection
├── 📖 pdf/ # PDF conversions (multi-format)
├── 📝 docx/ # DOCX conversions (Office compatible)
├── 🔍 metadata/ # Checksum logs & build info
└── 📦 GRU_Master_Whitepaper_PRO.zip # Complete archive bundle
💡 Smart Fallback: If
pandocis unavailable, the build gracefully generates markdown + checksums only, with detailed warnings indist/metadata/pandoc_missing.txt
The build pipeline leverages docs/meta/preamble.tex for consistent, professional typography:
- 📏 Geometry: Optimal page layouts and margins
- 🎨 Color Scheme: GRU-branded visual identity
- 📊 Formula Boxes: Highlighted mathematical expressions
- 📑 Headers/Footers: Document navigation and branding
| 🎨 Diagram | 📋 Purpose | 🔗 Usage Context |
|---|---|---|
issuance_cycle.svg |
🔄 Reserve → Issuance → Circulation | Monetary policy flow visualization |
triangulation_flow.svg |
📐 7:10 Protocol & Controls | Atomic issuance mechanism |
governance_chambers.svg |
🏛️ Multi-Chamber SHTE | Governance structure & oversight |
bond_cycle.svg |
💎 Li99 Bond Mechanics | Coupon accrual → escrow → buy-back |
velocity_metrics.svg |
📊 Composite Velocity Index | v_raw, v_adj, v_cov metrics |
🔄 Dynamic Conversion: SVG diagrams are automatically converted to PDF during build for seamless LaTeX embedding
graph LR
EXEC["📄 00_Executive_Summary"]
POLICY["📊 01_Monetary_Policy"]
TRIANGULATION["🔄 02_Triangulation"]
BONDS["💰 03_Bond_System"]
GOVERNANCE["⚖️ 04_Governance"]
DBIS["🌐 05_DBIS_Charter"]
ROADMAP["🚀 06_Roadmap"]
EXEC --> POLICY
POLICY --> TRIANGULATION
TRIANGULATION --> BONDS
BONDS --> GOVERNANCE
GOVERNANCE --> DBIS
DBIS --> ROADMAP
ROADMAP --> MASTER["📖 Master Collection<br/>Single Unified Document"]
graph TB
subgraph "🔍 Verification Pipeline"
BUILD["🏗️ Build Process"]
HASH["🔐 SHA256 Hashing"]
LOG["📋 Verification Log"]
SIGN["✍️ GPG Signing"]
end
subgraph "✅ Verification Methods"
CHECKSUM["🔍 Checksum Verification"]
GPG["🛡️ Cryptographic Signature"]
CI["🔄 CI/CD Validation"]
end
BUILD --> HASH
HASH --> LOG
LOG --> SIGN
LOG --> CHECKSUM
SIGN --> GPG
BUILD --> CI
# Verify all document integrity
cd dist && sha256sum -c metadata/GRU_Checksum_Verification_Log.txt
# Expected output: All files report "OK"
# Any mismatch indicates potential tampering# Verify cryptographic signature (if available)
gpg --verify dist/metadata/GRU_Checksum_Verification_Log.txt.asc
# Import public key for verification
gpg --import gru-public-key.ascgitGraph
commit id: "v1.0.0 - Initial Framework"
commit id: "Documentation Core"
branch feature/diagrams
checkout feature/diagrams
commit id: "Add Visual Assets"
commit id: "LaTeX Styling"
checkout main
merge feature/diagrams
commit id: "v1.1.0 - Visual Enhancement"
branch feature/smart-contracts
checkout feature/smart-contracts
commit id: "Diamond Standard"
commit id: "Facet Implementation"
checkout main
merge feature/smart-contracts
commit id: "v1.2.0 - Smart Contracts"
# 1. Validate build integrity
./scripts/build.sh && echo "✅ Build successful"
# 2. Commit and tag release
git add . && git commit -m "docs: prepare v1.x.x release"
git tag -a v1.x.x -m "GRU Documentation Release v1.x.x"
# 3. Trigger automated CI/CD
git push origin main --tagsv1.0.x- Core documentation frameworkv1.1.x- Visual enhancements & diagramsv1.2.x- Smart contract integrationv2.0.x- Major architecture updates
This work is licensed under a Creative Commons Attribution 4.0 International License. You are free to:
- ✅ Share — copy and redistribute the material in any medium or format
- ✅ Adapt — remix, transform, and build upon the material
- ✅ Commercial Use — use the material for any purpose, even commercially
Attribution Required: Please credit "GRU Monetary Authority" when using or deriving from this work.
gantt
title GRU Project Development Timeline
dateFormat YYYY-MM-DD
section Phase 1: Foundation
Executive Summary :done, exec, 2025-01-01, 2025-02-15
Core Policy Framework :done, policy, 2025-01-15, 2025-03-01
Master Collection Build :done, build, 2025-02-01, 2025-02-28
section Phase 2: Visualization
Diagram Assets :done, diagrams, 2025-02-15, 2025-03-15
LaTeX Styling System :done, latex, 2025-03-01, 2025-03-30
Velocity Metrics Dashboard :done, metrics, 2025-03-15, 2025-04-01
section Phase 3: Smart Contracts
Diamond Standard Setup :active, diamond, 2025-04-01, 2025-05-15
Facet Implementation :active, facets, 2025-04-15, 2025-06-01
Graph Protocol Integration :graph, 2025-05-01, 2025-06-15
section Phase 4: Integration
CI/CD Automation :ci, 2025-06-01, 2025-06-30
Oracle Redundancy :oracle, 2025-06-15, 2025-07-30
DBIS Charter Finalization :dbis, 2025-07-01, 2025-08-15
- 📄 Executive Summary - High-level framework orientation
- 🏗️ Master Collection - Automated document aggregation
- 🎨 Visual Assets - Complete diagram library (issuance, triangulation, governance)
- 💎 Bond Cycle - Li99 system visualization + velocity metrics
- 📚 Extended Glossary - ESG alignment, oracle taxonomy, settlement definitions
- 💎 Diamond Standard - Modular smart contract architecture
- 📊 Graph Protocol - Blockchain data indexing and analytics
[x] 🔐 CI Signing - Automated GPG key management for releases [ ] 🌐 Oracle Network - Multi-source redundancy specification (single-feed foundation live in companion; redundancy + aggregation pending) [ ] 📋 Compliance Suite - Automated regulatory reporting tools (interfaces & stub facet added; enforcement/storage pending) [x] 🔍 Audit Framework - Quarterly PoR validation system
The separate repository GREM-GRU-eMoney-Companion supplies execution-layer components (multi-asset controller, oracle interfaces, compliance & reporting abstractions) that extend this policy framework.
| Item | This Repo Status | Companion Capabilities | Next Step |
|---|---|---|---|
| CI Signing | Implemented (GPG in CI) | N/A | Cross-sign PoR bundle |
| Oracle Network | Pending redundancy | Multiple mock feeds (USD/EUR/XAU) + deviation logic | Add OracleAggregatorFacet logic & median calc |
| Compliance Suite | Stub facet only | Interfaces for KYC/AML/jurisdiction & velocity | Implement storage + execution gates |
| Audit Framework | Implemented (PoR) | Structured reporting interface (IReporting) |
Bundle signed PoR + compliance snapshot |
New stub facets introduced:
ComplianceFacet.sol– role-gated placeholders for KYC/AML functions (currently revertErrNotReady).OracleAggregatorFacet.sol– median price query placeholder (returns zero; mutators revertErrNotReady).
See docs/meta/Companion_Integration.md for detailed integration roadmap (oracle redundancy phases, compliance gating plan, signing enhancements).
graph LR
subgraph "📝 Documentation Standards"
YAML["📋 YAML Front Matter<br/>Consistency"]
DATE["📅 Update Timestamps<br/>last_updated field"]
FORMULAS["🧮 Formula Registry<br/>GRU_Formulas.md"]
end
subgraph "🎨 Design Standards"
SVG["🖼️ Minimal SVG Diagrams<br/>Text-based, Clean"]
STYLE["🎨 LaTeX Styling<br/>preamble.tex updates"]
LAYOUT["📐 Consistent Layout<br/>Spacing & formatting"]
end
subgraph "🔄 Process Standards"
SEMANTIC["📋 Semantic Commits<br/>docs:, build:, ci:"]
BUILD["🏗️ Pre-Release Build<br/>./scripts/build.sh"]
REVIEW["👀 Peer Review<br/>Pull request process"]
end
- 📄 Front Matter: Maintain YAML consistency (title, version, status, last_updated, checksum)
- 📅 Timestamps: Update
last_updatedfield for substantial content changes - 🧮 Formula Registry: Add new equations to
GRU_Formulas.mdwith proper documentation - 🔗 Cross-References: Use consistent linking format across documents
- 🖼️ SVG Diagrams: Keep minimal, text-based design for readable git diffs
- 📐 Consistent Layout: Avoid unnecessary reformatting of unrelated sections
- 🎨 Style Guide: Follow established LaTeX preamble styling conventions
- 📋 Semantic Commits: Use conventional commit format (
docs:,build:,ci:,security:) - 🏗️ Pre-Release Validation: Run build script before tagging releases
- 👀 Code Review: Submit changes via pull request for collaborative review
# Pre-contribution validation
□ Front matter properly formatted
□ Timestamps updated where applicable
□ Build script runs successfully
□ Diagrams optimized for version control
□ Semantic commit message used
□ Documentation cross-references verifiedgraph TB
subgraph "🔍 Validation Layers"
DSL["🔗 Distributed Sovereign Ledger<br/>PoR Interface"]
AUDIT["🔍 Quarterly Audits<br/>External Validation"]
TELEMETRY["📊 Operational Telemetry<br/>Real-time Monitoring"]
end
subgraph "📋 Documentation Integrity"
BUILD["🏗️ Reproducible Builds<br/>Deterministic Output"]
HASH["🔐 SHA256 Verification<br/>Tamper Detection"]
VERSION["🏷️ Version Control<br/>Git History Tracking"]
end
subgraph "🛡️ Security Measures"
GPG["✍️ GPG Signing<br/>Cryptographic Proof"]
CI["🔄 Automated CI/CD<br/>Build Validation"]
ESCROW["🔒 Key Escrow<br/>Multi-party Control"]
end
DSL --> BUILD
AUDIT --> HASH
TELEMETRY --> VERSION
BUILD --> GPG
HASH --> CI
VERSION --> ESCROW
- 📊 Reserve Modeling: External validation via planned DSL Proof-of-Reserves interface
⚠️ Risk Assessment: Provisional thresholds calibrated by operational telemetry post-deployment- 🏗️ Build Stability: YAML front matter processing + pre-converted SVG→PDF for reliable LaTeX embedding
- 🔍 Transparency: All build processes are reproducible and publicly auditable
- 🏛️ BIS Compatibility: Designed for integration with Bank for International Settlements frameworks
- ⚖️ Regulatory Compliance: Multi-jurisdictional governance model supports diverse regulatory environments
- 🌐 Cross-Border Settlement: DBIS charter enables seamless international monetary coordination
- 📊 ESG Integration: Environmental, Social, and Governance factors embedded in LiXAU composite indices
🏛️ Primary Stewardship
GRU Monetary Authority — Policy & Systems Division
| 🏢 Division | 🎯 Responsibility | 📧 Contact |
|---|---|---|
| Policy & Systems | Core framework development & maintenance | policy@gru-authority.org |
| Technical Architecture | Smart contract & infrastructure oversight | technical@gru-authority.org |
| Compliance & Audit | Regulatory alignment & transparency | compliance@gru-authority.org |
| Community Relations | Documentation & developer engagement | community@gru-authority.org |
graph TB
subgraph "🚀 GitHub Actions Workflow"
PUSH["📤 Push/Tag Event"]
SETUP["⚙️ Environment Setup"]
DEPS["📦 Install Dependencies"]
BUILD["🏗️ Build Execution"]
SIGN["✍️ GPG Signing"]
UPLOAD["📤 Artifact Upload"]
RELEASE["🏷️ Release Creation"]
end
subgraph "🛠️ Build Dependencies"
PANDOC["📖 Pandoc"]
LATEX["🔤 LaTeX Engine"]
SVG["🖼️ SVG Tools"]
ZIP["📦 Archive Tools"]
end
subgraph "📦 Release Artifacts"
DOCS["📄 Documentation Bundle"]
CHECKSUMS["🔐 Verification Logs"]
SIGNATURE["✍️ GPG Signatures"]
ARCHIVE["📦 Complete ZIP"]
end
PUSH --> SETUP
SETUP --> DEPS
DEPS --> BUILD
BUILD --> SIGN
SIGN --> UPLOAD
UPLOAD --> RELEASE
PANDOC --> BUILD
LATEX --> BUILD
SVG --> BUILD
ZIP --> BUILD
BUILD --> DOCS
SIGN --> CHECKSUMS
SIGN --> SIGNATURE
ARCHIVE --> RELEASE
The CI/CD pipeline triggers on every push and tag, executing:
- 🏗️ Environment Setup - Ubuntu latest with caching optimization
- 📦 Dependency Installation -
pandoc,texlive-xetex,librsvg2-bin,zip - 🔨 Build Execution -
./scripts/build.shwith full artifact generation - ✍️ Optional GPG Signing - Cryptographic verification (requires secrets)
- 📤 Artifact Publishing - Upload to GitHub releases for tagged versions
# Import private signing key
gpg --import private.key
export GPG_KEY_ID="gru-authority@example.org"
# Execute signing script
chmod +x scripts/sign_checksums.sh && ./scripts/sign_checksums.sh
# Verify signature integrity
gpg --verify dist/metadata/GRU_Checksum_Verification_Log.txt.asc \
dist/metadata/GRU_Checksum_Verification_Log.txt📋 Release Protocol: Include
.ascsignature files in all public releases for third-party verification
| 📖 Core Documentation | 🏛️ Regulatory Compliance | 💎 Smart Contracts | 🛠️ Development |
|---|---|---|---|
| Executive Summary | SEPA Compliance Matrix | Diamond Architecture | Build System |
| Policy Framework | MiCA Legal Position | Monetary Facet | CI/CD Pipeline |
| Governance & Oversight | DORA ICT Risk Policy | Graph Protocol | Contribution Guide |
| Formula Reference | AML Risk Assessment | Oracle Governance | Compliance Artifacts |
| Regulation | Status | Key Documents | Next Review |
|---|---|---|---|
| SEPA/IPR | ✅ Compliant | Compliance Matrix • IPR Memo | Q2 2025 |
| MiCA | ✅ Ready | Legal Position • Issuer Readiness | Q1 2025 |
| DORA | ✅ Implemented | ICT Risk Policy • Incident Response | Q2 2025 |
| AML/CFT | ✅ Compliant | Enterprise Risk Assessment | Annual |
| ISO 20022 | ✅ Implemented | Message Mapping • Sample Messages | Q3 2025 |
Built with ❤️ by the Global Reserve Unit Community
© 2025 GRU Monetary Authority | Licensed under CC BY 4.0
Advancing transparent, programmable, and sustainable monetary policy for the digital age
