fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
OMNL Central Bank Configuration — Fineract/Mifos (VMID 5800)
Idempotent scripts and data for Master Plan 2: Apache Fineract + Mifos X Central Bank configuration for OMNL (Organisation Mondiale du Numérique). Target: VMID 5800 (192.168.11.85), reachable at mifos.d-bis.org or http://192.168.11.85.
Required environment variables
Set in project root .env (do not commit). Used by the scripts when calling the Fineract API:
| Variable | Description | Example |
|---|---|---|
MIFOS_BASE_URL |
Base URL of Fineract API | https://mifos.d-bis.org or http://192.168.11.85 |
MIFOS_TENANT |
Fineract tenant identifier | default |
MIFOS_USER |
API user (admin) | mifos |
MIFOS_PASSWORD |
API password | (set after first login) |
Optional:
| Variable | Description |
|---|---|
MIFOS_INSECURE |
Set to 1 to allow self-signed or invalid TLS (e.g. local/dev) |
Scripts
| Script | Purpose |
|---|---|
setup-currencies.sh |
Create/update currencies and special units (ISO-4217 subset + GRU, SDR, XAU, XAG). Idempotent (GET before POST). |
setup-coa.sh |
Create OMNL Chart of Accounts (GL accounts: Assets, Liabilities, Equity, Income, Expenses; M00/M0/M1 tagging in codes/names). Idempotent. |
setup-fx-revaluation.sh |
Create exchange-rate definitions (XAU as reference where applicable) and GL accounts for unrealized/realized FX P&L. Idempotent. |
validate-config.sh |
Verify currencies, CoA structure, and key mappings exist (GET-based checks). |
Execution order
./scripts/mifos/central-bank-config/setup-currencies.sh./scripts/mifos/central-bank-config/setup-coa.sh./scripts/mifos/central-bank-config/setup-fx-revaluation.sh./scripts/mifos/central-bank-config/validate-config.sh
Run from project root so that config/ip-addresses.conf and .env are available. Scripts source config/ip-addresses.conf and optionally .env.
Documentation
- Configuration overview, CoA mapping, and validation checklist: docs/04-configuration/mifos-omnl-central-bank/.
- Deployment runbook for VMID 5800: docs/04-configuration/MIFOS_R630_02_DEPLOYMENT.md.
Governance
OMNL is system owner and ledger authority. Configurations are deterministic, auditable, and suitable for sovereign/regulatory review. See Master Plan 2 and OMNL/Shamrayan Detail Sheet.