diff --git a/config/deployment-omnl.production.env.example b/config/deployment-omnl.production.env.example
index 72822e6..ece7ef2 100644
--- a/config/deployment-omnl.production.env.example
+++ b/config/deployment-omnl.production.env.example
@@ -50,6 +50,9 @@ CHAIN_138_RPC_URL=http://192.168.11.221:8545
 # === Mirror chain 651940 ===
 CHAIN_651940_RPC_URL=https://mainnet-rpc.alltra.global
 
+# === Z Chain — deploy via scripts/deployment/deploy-z-ecosystem-production.sh ===
+# Portal: https://zblockchainsystem.com — see config/z-ecosystem.local.env.example
+
 # === Major L1/L2 RPC (set per chain — CHAIN_<id>_RPC_URL) ===
 CHAIN_1_RPC_URL=https://eth.llamarpc.com
 CHAIN_56_RPC_URL=https://bsc-dataseed.binance.org
diff --git a/config/ecosystem-links.v1.json b/config/ecosystem-links.v1.json
new file mode 100644
index 0000000..d6b5072
--- /dev/null
+++ b/config/ecosystem-links.v1.json
@@ -0,0 +1,128 @@
+{
+  "$schema": "OMNL ecosystem link map — canonical URLs for portals, APIs, and local dev",
+  "version": "1.2.0",
+  "updated": "2026-07-03",
+  "notes": [
+    "Z Ecosystem lives on zblockchainsystem.com — see config/z-ecosystem-links.v1.json",
+    "Public nginx exposes /settlement/* and /exchange/* without /api/v1/... prefix",
+    "Tunnel save file logs/public-url-{operator}.txt stores primary portal URL (Z Online Bank)",
+    "/omnl/* operator UIs ship in frontend dist (public/omnl) — portal-serve proxies /api to explorer",
+    "POST /z-bank/settle-m0-m4 exists in settlement-middleware source; production may use POST /settlement/external-transfer until deployed",
+    "SPA anchors #z-full-settlement and #z-settlement-protocols exist on /central-bank"
+  ],
+  "tunnel": {
+    "ephemeral": true,
+    "saveFile": "logs/public-url-ali.txt",
+    "primaryPath": "/central-bank",
+    "apps": {
+      "bridge": "/bridge",
+      "hub": "/hub",
+      "zOnlineBank": "/central-bank",
+      "zFullSettlement": "/central-bank#z-full-settlement",
+      "wireProtocols": "/central-bank#z-settlement-protocols",
+      "office24": "/office-24",
+      "omnlCompliance": "/omnl/compliance",
+      "omnlDashboard": "/omnl/dashboard",
+      "omnlTerminal": "/omnl/terminal",
+      "trade": "/trade",
+      "swap": "/swap",
+      "reserve": "/reserve",
+      "history": "/history",
+      "wallets": "/wallets",
+      "admin": "/admin",
+      "docs": "/docs"
+    },
+    "nginxOn3002": {
+      "settlementHealth": "/settlement/health",
+      "exchangeHealth": "/exchange/health",
+      "apiCatalog": "/api/v1/omnl/catalog"
+    },
+    "brokenOnServeOnly": []
+  },
+  "subjects": [
+    { "id": "bridge", "label": "Bridge", "path": "/bridge", "group": "app" },
+    { "id": "hub", "label": "DBIS Hub", "path": "/hub", "group": "app" },
+    { "id": "zOnlineBank", "label": "Z Online Bank", "path": "/central-bank", "group": "app" },
+    { "id": "zFullSettlement", "label": "Z M0-M4 settlement", "path": "/central-bank#z-full-settlement", "group": "app" },
+    { "id": "wireProtocols", "label": "Wire protocols", "path": "/central-bank#z-settlement-protocols", "group": "app" },
+    { "id": "office24", "label": "Office 24 Central Bank", "path": "/office-24", "group": "app" },
+    { "id": "trade", "label": "DBIS Trade", "path": "/trade", "group": "app" },
+    { "id": "swap", "label": "Digital Swap", "path": "/swap", "group": "app" },
+    { "id": "reserve", "label": "Reserve", "path": "/reserve", "group": "app" },
+    { "id": "history", "label": "History", "path": "/history", "group": "app" },
+    { "id": "wallets", "label": "Wallets", "path": "/wallets", "group": "app" },
+    { "id": "admin", "label": "Admin", "path": "/admin", "group": "app" },
+    { "id": "docs", "label": "Developers", "path": "/docs", "group": "app" },
+    { "id": "omnlCompliance", "label": "OMNL Compliance", "path": "/omnl/compliance", "group": "console" },
+    { "id": "omnlDashboard", "label": "OMNL API snapshot", "path": "/omnl/dashboard", "group": "console" },
+    { "id": "omnlTerminal", "label": "Settlement terminal", "path": "/omnl/terminal", "group": "console" },
+    { "id": "apiCatalog", "label": "API catalog", "path": "/api/v1/omnl/catalog", "group": "api" },
+    { "id": "gazetteNotices", "label": "GUOSMM gazette registry", "path": "/api/v1/omnl/gazette/notices", "group": "api" },
+    { "id": "integrationStatus", "label": "Integration status", "path": "/api/v1/omnl/integration-status", "group": "api" },
+    { "id": "settlementHealth", "label": "Settlement health", "path": "/settlement/health", "group": "api" },
+    { "id": "exchangeHealth", "label": "Exchange health", "path": "/exchange/health", "group": "api" }
+  ],
+  "local": {
+    "frontend": {
+      "port": 3002,
+      "bridge": "http://localhost:3002/bridge",
+      "centralBank": "http://localhost:3002/central-bank",
+      "hub": "http://localhost:3002/hub",
+      "office24": "http://localhost:3002/office-24",
+      "trade": "http://localhost:3002/trade",
+      "swap": "http://localhost:3002/swap"
+    },
+    "backend": {
+      "omnlCatalog": "http://localhost:3000/api/v1/omnl/catalog",
+      "compliance": "http://localhost:3000/omnl/compliance",
+      "omnlDashboard": "http://localhost:3000/omnl/dashboard",
+      "settlementTerminal": "http://localhost:3000/omnl/terminal",
+      "settlementHealth": "http://localhost:3011/api/v1/settlement/health",
+      "settlementChains": "http://localhost:3011/api/v1/settlement/chains",
+      "moneySupplyPublic": "http://localhost:3011/api/v1/settlement/money-supply/public",
+      "exchangeHealth": "http://localhost:3012/api/v1/exchange/health"
+    },
+    "nginx3002": {
+      "settlementHealth": "http://localhost:3002/settlement/health",
+      "exchangeHealth": "http://localhost:3002/exchange/health",
+      "apiCatalog": "http://localhost:3002/api/v1/omnl/catalog"
+    }
+  },
+  "productionPortals": {
+    "zOnlineBank": "https://online.omdnl.org/central-bank",
+    "centralBankSecure": "https://secure.omdnl.org/central-bank",
+    "office24": "https://office24.omdnl.org/office-24",
+    "exchangeTrade": "https://exchange.omdnl.org/trade",
+    "forexTrade": "https://forex.omdnl.org/trade",
+    "omnlBankHybx": "https://bank.omnl.hybxfinance.io",
+    "exchangeDbisMirror": "https://exchange.d-bis.org/trade",
+    "centralBankDbisMirror": "https://secure.d-bis.org/central-bank",
+    "forexDbisMirror": "https://forex.d-bis.org/trade"
+  },
+  "productionApis": {
+    "explorerRoot": "https://explorer.d-bis.org/api/v1",
+    "catalog": "https://explorer.d-bis.org/api/v1/omnl/catalog",
+    "gazetteNotices": "https://explorer.d-bis.org/api/v1/omnl/gazette/notices",
+    "complianceUi": "https://explorer.d-bis.org/omnl/compliance",
+    "omnlDashboardUi": "https://explorer.d-bis.org/omnl/dashboard",
+    "settlementTerminalUi": "https://explorer.d-bis.org/omnl/terminal",
+    "settlementHealth": "https://secure.omdnl.org/settlement/health",
+    "settlementChains": "https://secure.omdnl.org/settlement/chains",
+    "moneySupplyPublic": "https://secure.omdnl.org/settlement/public/money-supply",
+    "externalTransfer": "https://secure.omdnl.org/settlement/external-transfer",
+    "exchangeHealth": "https://exchange.omdnl.org/exchange/health",
+    "exchangeTokens": "https://exchange.omdnl.org/exchange/tokens",
+    "chain138Rpc": "https://rpc-http-pub.d-bis.org",
+    "chain138Explorer": "https://explorer.d-bis.org",
+    "fineractSwagger": "https://omnl.hybxfinance.io/fineract-provider/swagger-ui/index.html",
+    "swiftListenerPublic": "https://swift-listener.d-bis.org"
+  },
+  "infra": {
+    "gitea": "https://gitea.d-bis.org",
+    "smomRepo": "https://gitea.d-bis.org/d-bis/smom-dbis-138.git",
+    "guosmmGazette": "https://gazette.shosjj.org/notices/2026",
+    "swiftListenerLan": "http://192.168.11.114:8788",
+    "fineractSidecarLan": "http://192.168.11.89:8080",
+    "chain138RpcLan": "http://192.168.11.211:8545"
+  }
+}
diff --git a/config/genesis-z-chain-900002.json b/config/genesis-z-chain-900002.json
new file mode 100644
index 0000000..57481b5
--- /dev/null
+++ b/config/genesis-z-chain-900002.json
@@ -0,0 +1,37 @@
+{
+  "config": {
+    "chainId": 900002,
+    "homesteadBlock": 0,
+    "eip150Block": 0,
+    "eip155Block": 0,
+    "eip158Block": 0,
+    "byzantiumBlock": 0,
+    "constantinopleBlock": 0,
+    "petersburgBlock": 0,
+    "istanbulBlock": 0,
+    "berlinBlock": 0,
+    "londonBlock": 0,
+    "arrowGlacierBlock": 0,
+    "grayGlacierBlock": 0,
+    "mergeNetSplitBlock": 0,
+    "shanghaiTime": 0,
+    "cancunTime": 0,
+    "ibft2": {
+      "blockperiodseconds": 2,
+      "epochlength": 30000,
+      "requesttimeoutseconds": 10
+    }
+  },
+  "nonce": "0x0",
+  "timestamp": "0x0",
+  "gasLimit": "0x1c9c380",
+  "difficulty": "0x1",
+  "mixHash": "0x63746963616c2062797a616e74696e65206661756c7420746f6c6572616e6365",
+  "coinbase": "0x0000000000000000000000000000000000000000",
+  "alloc": {
+    "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73": {
+      "balance": "0x33b2e3c9fd0803ce8000000",
+      "comment": "Besu dev key #1 — funded for local deploy"
+    }
+  }
+}
diff --git a/config/guosmm-notices.v1.json b/config/guosmm-notices.v1.json
new file mode 100644
index 0000000..0a77eab
--- /dev/null
+++ b/config/guosmm-notices.v1.json
@@ -0,0 +1,115 @@
+{
+  "$schema": "GUOSMM official gazette notices — OMNL / ISB member banks",
+  "version": "1.0.0",
+  "gazetteBase": "https://gazette.shosjj.org/notices/2026",
+  "updated": "2026-07-03",
+  "notices": [
+    {
+      "documentId": "GUOSMM-B-2026-001",
+      "series": "B",
+      "title": "Central Bank Charter — OMNL",
+      "documentType": "Central Bank Charter",
+      "url": "https://gazette.shosjj.org/notices/2026/GUOSMM-B-2026-001",
+      "publishedAt": "2026-06-12T12:00:00Z",
+      "effectiveAt": "2026-06-13T00:00:00Z",
+      "signedAt": "2026-07-02T00:45:01.965Z",
+      "signingAuthority": "Sovereign Military Order of Malta",
+      "contentSha256": "685ebdbfd6a9c1b2c0b7963b7771bf96e96d002e822107207df66f7f593b8032",
+      "republication": "v2",
+      "omnlLei": "98450070C57395F6B906",
+      "scope": ["omnl", "emcb", "central-bank", "office-24", "settlement"],
+      "enablingActs": ["GUOSMM-A-2026-001"],
+      "notes": "EMCB model — Treasury issues SCUDO; OMNL administers; not issuer"
+    },
+    {
+      "documentId": "GUOSMM-C-2026-003",
+      "series": "C",
+      "title": "zBank — ISB Membership Admission and Operations Charter",
+      "documentType": "ISB Membership Admission and Operations Charter",
+      "url": "https://gazette.shosjj.org/notices/2026/GUOSMM-C-2026-003",
+      "publishedAt": "2026-07-01T20:00:00Z",
+      "effectiveAt": "2026-05-02T00:00:00Z",
+      "operationsCommencement": "2026-05-02T00:00:00Z",
+      "signedAt": "2026-07-03T03:24:07.594Z",
+      "signingAuthority": "Sovereign Military Order of Malta",
+      "contentSha256": "c685fd513cbc1e5d20d8f91605f33a8e824680a58b85c67a1a8ef12cf42b71eb",
+      "licenseId": "LICENSE-ZBANK-SHOSJJ-2026-001",
+      "licenseClass": "entity.bank",
+      "entity": "zBank",
+      "fineractOfficeId": 29,
+      "fineractExternalId": "ZBANK-OMNL",
+      "issuingDelegate": "pack-dbis",
+      "prudentialSupervisor": "pack-omnl",
+      "parentActs": [
+        "GUOSMM-A-2026-001",
+        "GUOSMM-A-2026-002",
+        "GUOSMM-A-2026-003",
+        "GUOSMM-B-2026-001",
+        "GUOSMM-B-2026-002",
+        "GUOSMM-C-2026-001",
+        "GUOSMM-C-2026-002"
+      ],
+      "scope": ["z-bank", "onex-bank", "central-bank", "office-29"]
+    },
+    {
+      "documentId": "GUOSMM-C-2026-004",
+      "series": "C",
+      "title": "NovaBank — ISB Membership Admission and Operations Charter",
+      "documentType": "ISB Membership Admission and Operations Charter",
+      "url": "https://gazette.shosjj.org/notices/2026/GUOSMM-C-2026-004",
+      "publishedAt": "2026-07-01T20:00:00Z",
+      "effectiveAt": "2026-05-02T00:00:00Z",
+      "operationsCommencement": "2026-05-02T00:00:00Z",
+      "signedAt": "2026-07-03T03:24:08.276Z",
+      "signingAuthority": "Sovereign Military Order of Malta",
+      "contentSha256": "6c524ad5207ae9ca8d53cd4f847593f175740291ad2f519c554bbb823b304b50",
+      "licenseId": "LICENSE-NOVABANK-SHOSJJ-2026-001",
+      "licenseClass": "entity.bank",
+      "entity": "NovaBank",
+      "fineractOfficeId": 30,
+      "fineractExternalId": "NOVABANK-OMNL",
+      "issuingDelegate": "pack-dbis",
+      "prudentialSupervisor": "pack-omnl",
+      "parentActs": [
+        "GUOSMM-A-2026-001",
+        "GUOSMM-A-2026-002",
+        "GUOSMM-A-2026-003",
+        "GUOSMM-B-2026-001",
+        "GUOSMM-B-2026-002",
+        "GUOSMM-C-2026-001",
+        "GUOSMM-C-2026-002"
+      ],
+      "scope": ["nova-bank", "central-bank", "office-30"]
+    },
+    {
+      "documentId": "GUOSMM-C-2026-005",
+      "series": "C",
+      "title": "AnakaBank — ISB Membership Admission and Operations Charter",
+      "documentType": "ISB Membership Admission and Operations Charter",
+      "url": "https://gazette.shosjj.org/notices/2026/GUOSMM-C-2026-005",
+      "publishedAt": "2026-07-01T20:00:00Z",
+      "effectiveAt": "2026-05-02T00:00:00Z",
+      "operationsCommencement": "2026-05-02T00:00:00Z",
+      "signedAt": "2026-07-03T03:24:08.926Z",
+      "signingAuthority": "Sovereign Military Order of Malta",
+      "contentSha256": "b93879aeb6e1c4791084b1e327682ccbf9b482a2b9b4fbbaff193e6e7a8f5f3e",
+      "licenseId": "LICENSE-ANAKABANK-SHOSJJ-2026-001",
+      "licenseClass": "entity.bank",
+      "entity": "AnakaBank",
+      "fineractOfficeId": 31,
+      "fineractExternalId": "ANAKABANK-OMNL",
+      "issuingDelegate": "pack-dbis",
+      "prudentialSupervisor": "pack-omnl",
+      "parentActs": [
+        "GUOSMM-A-2026-001",
+        "GUOSMM-A-2026-002",
+        "GUOSMM-A-2026-003",
+        "GUOSMM-B-2026-001",
+        "GUOSMM-B-2026-002",
+        "GUOSMM-C-2026-001",
+        "GUOSMM-C-2026-002"
+      ],
+      "scope": ["anaka-bank", "central-bank", "office-31"]
+    }
+  ]
+}
diff --git a/config/hybx-omnl-cross-chain-lines.json b/config/hybx-omnl-cross-chain-lines.json
index 96ecaf6..12967aa 100644
--- a/config/hybx-omnl-cross-chain-lines.json
+++ b/config/hybx-omnl-cross-chain-lines.json
@@ -1,24 +1,24 @@
 {
   "version": "1.0.0",
   "updated": "2026-06-20",
-  "description": "OMNL office settlement lines \u2014 treasury EVM wallets + canonical M1 token anchors per chain.",
+  "description": "OMNL office settlement lines — treasury EVM wallets + canonical M1 token anchors per chain.",
   "lines": [
     {
       "lineId": "0xa16da49f1c038e9d798245a68f33c539b595df5ed39f4c566345c381ac5fd8ad",
       "officeId": 1,
       "externalId": "1",
-      "entityName": "OMNL Head Office (DBIS) \u2013 Central Bank",
+      "entityName": "OMNL Head Office (DBIS) – Central Bank",
       "walletId": "HYBX-OFFICE-001",
       "treasuryWalletMainnet": "0x9baa0efd06a496f401b2fb8508192fec675b6986",
       "treasuryWalletChain138": "0xe41a19d5e62d83c086efe71ccecae397d32d2336",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -33,13 +33,13 @@
       "treasuryWalletMainnet": "0x8a72f33cb9f1110dfa2b0a950b887b814614e7ce",
       "treasuryWalletChain138": "0xcda90617d6b86698ef54ff1e6bdccbe5df8a54f1",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -54,13 +54,13 @@
       "treasuryWalletMainnet": "0x31d23172792db7d38c19a0d9136b47e5b9cb61bb",
       "treasuryWalletChain138": "0x6fba59d90a891588d14bc2ecd63371ebc1974759",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -75,13 +75,13 @@
       "treasuryWalletMainnet": "0x476eac28c5a369556590026a33bf59f7798e2121",
       "treasuryWalletChain138": "0x42c4091ab2080a029b3371b473cc22d27ed7170a",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -96,13 +96,13 @@
       "treasuryWalletMainnet": "0x3908d64ec91ad908ed0740654905b85f40c96892",
       "treasuryWalletChain138": "0xc536e3a0bb2ada09077f6fef49710ca2c5c7f404",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -117,13 +117,13 @@
       "treasuryWalletMainnet": "0x75aa3ef512ff29a0475954c0a478b6b8a0e7485b",
       "treasuryWalletChain138": "0xd1f1d00a3706fc5d680ac8a5bd49dcce17408ea2",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -138,13 +138,13 @@
       "treasuryWalletMainnet": "0x2f0d8f2b449eddbb0e1d57df5b8bab7bc1853fe3",
       "treasuryWalletChain138": "0xd437cbf6bf13f2c3b43abd0e5468e66edfe01299",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -159,13 +159,13 @@
       "treasuryWalletMainnet": "0xf75948728a2379b485dc4695233c102f0a261089",
       "treasuryWalletChain138": "0x7287fe01c4ab5f70e3d24dd6bc24ae925552bd40",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -180,13 +180,13 @@
       "treasuryWalletMainnet": "0xeaffdc8cff3096712beb4cdc0b0e076d8f3f68c6",
       "treasuryWalletChain138": "0xa7ebf614c6e47db20266be996db135d048fa20f7",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -201,13 +201,13 @@
       "treasuryWalletMainnet": "0x73f9180c4d219e3cca43b1c02895c685c4153414",
       "treasuryWalletChain138": "0xe5736303f0b60f9dc14ef45b71547c228f261e6e",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -222,13 +222,13 @@
       "treasuryWalletMainnet": "0x16cecc9f7d048c2a8829eea46b3c30fb134523fc",
       "treasuryWalletChain138": "0xac894ac9727fae7ff1c82103d74c5eafe5429d1a",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -243,13 +243,13 @@
       "treasuryWalletMainnet": "0x7090a3acdda8514d6b07aff27f91ee8430d0a61c",
       "treasuryWalletChain138": "0xdd0a1f686b87349bdc5aa909078688bc065a19f2",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -264,13 +264,13 @@
       "treasuryWalletMainnet": "0x5921918623c5fa3b3798467972497c6809d95790",
       "treasuryWalletChain138": "0xcf0acb4afb1e07dc7fb6a6cbbf40d302641f9eaa",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -285,13 +285,13 @@
       "treasuryWalletMainnet": "0xa312cc28d812832d03c72cb822b2b460ade174d1",
       "treasuryWalletChain138": "0x8112c72ecfc0493b2cc7622218bc015df97d8ceb",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -306,13 +306,13 @@
       "treasuryWalletMainnet": "0x09c8bbb678649ef543b0ca6e2d0248ed374be70e",
       "treasuryWalletChain138": "0x291069ab31457997037ac59296f4fff2b55a033c",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -327,13 +327,13 @@
       "treasuryWalletMainnet": "0xaca2ab7b574d19cee64b004baa46994abf9bf0f2",
       "treasuryWalletChain138": "0x0ad3a2a39dbf0c7b1646c2c57902f5756b95e93f",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -348,13 +348,13 @@
       "treasuryWalletMainnet": "0x45a70949a11fc813c82d44f80aec9fc07ff819e4",
       "treasuryWalletChain138": "0x3a3ae3e4355ac2a7cbeb1b12d2900eb37763f0b9",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -369,13 +369,13 @@
       "treasuryWalletMainnet": "0x6c2e2c8b8b5ecb82246ceabbcbc862dc2b77634a",
       "treasuryWalletChain138": "0x3d3475d9e9bc261372b99dd4f2b0df5dc40623dd",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -390,13 +390,13 @@
       "treasuryWalletMainnet": "0xea6eab4953f7f54f7c1001375e57d573bec66161",
       "treasuryWalletChain138": "0x106e4a810aff37a1bc62d30d414ec575e83e7539",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -411,13 +411,13 @@
       "treasuryWalletMainnet": "0x834a95c1f4216e90677334339074fda872b97847",
       "treasuryWalletChain138": "0xfd371f2457a6a58f11c80cc1c4ca2305f4674db3",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -432,13 +432,13 @@
       "treasuryWalletMainnet": "0x2e4d9d09801dc09e90b3752db42c1a8e6d033520",
       "treasuryWalletChain138": "0xa08621a479bc263e563b2eadb7490d1c07039ba7",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -453,13 +453,13 @@
       "treasuryWalletMainnet": "0x7af34ec0e3d65f147ba6134471bff7bb25f785d0",
       "treasuryWalletChain138": "0xa31bf188d4235aa509f6ead064587ee99e6029c6",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -474,13 +474,13 @@
       "treasuryWalletMainnet": "0x8c219794fdb74cf8ded871fab6135e40c4168da9",
       "treasuryWalletChain138": "0x204fa6d8c72a21116de75b37abf0d1cd642ddcfa",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -495,13 +495,13 @@
       "treasuryWalletMainnet": "0x87dab11386841366682d6c5fd3cd90587552f8cd",
       "treasuryWalletChain138": "0xc93522ae4ab7482572cc29edd68fbb6d5ec6a585",
       "chains": {
-        "138": {
-          "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
-        },
         "1": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
@@ -516,13 +516,80 @@
       "treasuryWalletMainnet": "0xfc4D24Bda60240D6dfa1a702eE83c65002cf5218",
       "treasuryWalletChain138": "0x934adfFFbe4D079b7dbDcE183805dBcBeC7818cb",
       "chains": {
+        "1": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
+        }
+      },
+      "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "inboundSettlementType": "gnosis-safe"
+    },
+    {
+      "lineId": "0x9f3e2a1b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f",
+      "officeId": 29,
+      "externalId": "ZBANK-OMNL",
+      "entityName": "zBank (OneX Bank)",
+      "walletId": "HYBX-OFFICE-029",
+      "treasuryWalletMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "treasuryWalletChain138": "0xc93522ae4ab7482572cc29edd68fbb6d5ec6a585",
+      "treasuryWalletShivaOneX": "0x0000000000000000000000000000000000000000",
+      "chains": {
+        "1": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+        },
         "138": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
           "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         },
-        "1": {
+        "900001": {
           "tokenM0": "0x0000000000000000000000000000000000000000",
-          "tokenM1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+          "tokenM1": "0x0000000000000000000000000000000000000000"
+        },
+        "900002": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0x5FbDB2315678afecb367f032d93F642f64180aa3"
+        }
+      },
+      "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "inboundSettlementType": "gnosis-safe",
+      "integrationRef": "config/onex-shiva-integration.v1.json"
+    },
+    {
+      "lineId": "0xa1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef12345678",
+      "officeId": 30,
+      "externalId": "NOVABANK-OMNL",
+      "entityName": "NovaBank",
+      "walletId": "HYBX-OFFICE-030",
+      "guosmmNotice": "GUOSMM-C-2026-004",
+      "treasuryWalletMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "treasuryWalletChain138": "0xc93522ae4ab7482572cc29edd68fbb6d5ec6a585",
+      "chains": {
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
+        }
+      },
+      "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "inboundSettlementType": "gnosis-safe"
+    },
+    {
+      "lineId": "0xb2c3d4e5f6789012345678901234567890abcdef1234567890abcdef1234567890",
+      "officeId": 31,
+      "externalId": "ANAKABANK-OMNL",
+      "entityName": "AnakaBank",
+      "walletId": "HYBX-OFFICE-031",
+      "guosmmNotice": "GUOSMM-C-2026-005",
+      "treasuryWalletMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
+      "treasuryWalletChain138": "0xc93522ae4ab7482572cc29edd68fbb6d5ec6a585",
+      "chains": {
+        "138": {
+          "tokenM0": "0x0000000000000000000000000000000000000000",
+          "tokenM1": "0xf22258f57794CC8E06237084b353Ab30fFfa640b"
         }
       },
       "inboundSettlementMainnet": "0xB08502ceE2545eEF782e933CFb80D0663E564da8",
diff --git a/config/offices/office-24-settlement.v1.json b/config/offices/office-24-settlement.v1.json
index 770b3f1..02ff5e2 100644
--- a/config/offices/office-24-settlement.v1.json
+++ b/config/offices/office-24-settlement.v1.json
@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "officeId": 24,
   "externalId": "HOSPITALLERS-ZARDASHT-IRAQ-IRAN",
-  "name": "HOSPITALLERS — Zardasht (Iraq / Iran Operations)",
+  "name": "Office 24 Central Bank — HOSPITALLERS Zardasht (Iraq / Iran)",
   "fineractTenant": "omnl",
   "tenantUser": "ali_hospitallers_tenant",
   "adminUser": "ali_hospitallers_admin",
@@ -27,5 +27,7 @@
     "chain138": { "enabled": true, "rpcEnv": "RPC_URL_138", "defaultLineId": "USD-M2" }
   },
   "omnlLegalName": "ORGANISATION MONDIALE DU NUMERIQUE L.P.B.C.",
-  "omnlLei": "98450070C57395F6B906"
+  "omnlLei": "98450070C57395F6B906",
+  "guosmmEnablingAct": "GUOSMM-B-2026-001",
+  "guosmmNoticeUrl": "https://gazette.shosjj.org/notices/2026/GUOSMM-B-2026-001"
 }
diff --git a/config/offices/office-29-zbank.v1.json b/config/offices/office-29-zbank.v1.json
new file mode 100644
index 0000000..31fa8ec
--- /dev/null
+++ b/config/offices/office-29-zbank.v1.json
@@ -0,0 +1,22 @@
+{
+  "$schema": "OMNL Office 29 — zBank (OneX Bank) per GUOSMM-C-2026-003",
+  "version": "1.0.0",
+  "officeId": 29,
+  "externalId": "ZBANK-OMNL",
+  "name": "zBank — ISB member (OneX Bank)",
+  "guosmmNotice": "GUOSMM-C-2026-003",
+  "licenseId": "LICENSE-ZBANK-SHOSJJ-2026-001",
+  "fineractTenant": "omnl",
+  "settlement": {
+    "defaultCurrency": "USD",
+    "moneyLayers": ["M0", "M1", "M2", "M3", "M4"],
+    "glM1": "2100",
+    "glM2": "2200",
+    "glM4NearMoney": "1000"
+  },
+  "rails": {
+    "swift": { "enabled": true },
+    "hybx": { "enabled": true },
+    "chain138": { "enabled": true, "defaultLineId": "USD-M2" }
+  }
+}
diff --git a/config/offices/office-30-novabank.v1.json b/config/offices/office-30-novabank.v1.json
new file mode 100644
index 0000000..b57a130
--- /dev/null
+++ b/config/offices/office-30-novabank.v1.json
@@ -0,0 +1,22 @@
+{
+  "$schema": "OMNL Office 30 — NovaBank per GUOSMM-C-2026-004",
+  "version": "1.0.0",
+  "officeId": 30,
+  "externalId": "NOVABANK-OMNL",
+  "name": "NovaBank — ISB member",
+  "guosmmNotice": "GUOSMM-C-2026-004",
+  "licenseId": "LICENSE-NOVABANK-SHOSJJ-2026-001",
+  "fineractTenant": "omnl",
+  "settlement": {
+    "defaultCurrency": "USD",
+    "moneyLayers": ["M0", "M1", "M2", "M3", "M4"],
+    "glM1": "2100",
+    "glM2": "2200",
+    "glM4NearMoney": "1000"
+  },
+  "rails": {
+    "swift": { "enabled": true },
+    "hybx": { "enabled": true },
+    "chain138": { "enabled": true, "defaultLineId": "USD-M2" }
+  }
+}
diff --git a/config/offices/office-31-anakabank.v1.json b/config/offices/office-31-anakabank.v1.json
new file mode 100644
index 0000000..ba054dc
--- /dev/null
+++ b/config/offices/office-31-anakabank.v1.json
@@ -0,0 +1,22 @@
+{
+  "$schema": "OMNL Office 31 — AnakaBank per GUOSMM-C-2026-005",
+  "version": "1.0.0",
+  "officeId": 31,
+  "externalId": "ANAKABANK-OMNL",
+  "name": "AnakaBank — ISB member",
+  "guosmmNotice": "GUOSMM-C-2026-005",
+  "licenseId": "LICENSE-ANAKABANK-SHOSJJ-2026-001",
+  "fineractTenant": "omnl",
+  "settlement": {
+    "defaultCurrency": "USD",
+    "moneyLayers": ["M0", "M1", "M2", "M3", "M4"],
+    "glM1": "2100",
+    "glM2": "2200",
+    "glM4NearMoney": "1000"
+  },
+  "rails": {
+    "swift": { "enabled": true },
+    "hybx": { "enabled": true },
+    "chain138": { "enabled": true, "defaultLineId": "USD-M2" }
+  }
+}
diff --git a/config/omnl-customer-security.production.v1.json b/config/omnl-customer-security.production.v1.json
index c09a5a8..50d1f52 100644
--- a/config/omnl-customer-security.production.v1.json
+++ b/config/omnl-customer-security.production.v1.json
@@ -16,6 +16,8 @@
     "https://online.omdnl.org",
     "https://office24.omdnl.org",
     "https://digital.omdnl.org",
+    "https://zblockchainsystem.com",
+    "https://www.zblockchainsystem.com",
     "https://exchange.d-bis.org",
     "https://exchange.omdnl.org",
     "https://forex.omdnl.org"
diff --git a/config/omnl-production-domains.v1.json b/config/omnl-production-domains.v1.json
index 89bdf74..8c38d2b 100644
--- a/config/omnl-production-domains.v1.json
+++ b/config/omnl-production-domains.v1.json
@@ -41,8 +41,9 @@
     },
     {
       "host": "digital.omdnl.org",
-      "product": "digital-swap",
-      "defaultRoute": "/swap"
+      "product": "digital-swap-legacy",
+      "defaultRoute": "/swap",
+      "notes": "Legacy — prefer https://zblockchainsystem.com/swap"
     },
     {
       "host": "office24.omdnl.org",
diff --git a/config/omnl-supported-chains.v1.json b/config/omnl-supported-chains.v1.json
index 83e2cc2..4df619e 100644
--- a/config/omnl-supported-chains.v1.json
+++ b/config/omnl-supported-chains.v1.json
@@ -1224,37 +1224,23 @@
     },
     {
       "chainId": 900001,
-      "name": "OMNL Expansion Slot 1",
+      "name": "Shiva Blockchain (OneX)",
       "type": "evm",
-      "nativeSymbol": "ETH",
-      "tier": "reserved",
-      "omnlRole": "expansion",
-      "status": "reserved",
+      "nativeSymbol": "SHIVA",
+      "tier": "primary",
+      "omnlRole": "onex-shiva",
+      "status": "active",
       "rpcEnv": "CHAIN_900001_RPC_URL",
+      "explorerUrl": "https://explorer.shiva.onex.omdnl.org",
+      "rpcDefault": "https://rpc.shiva.onex.omdnl.org",
       "settlement": {
-        "m2LoadEnabled": false,
-        "swapEnabled": false,
-        "bridgeEnabled": false,
-        "officeId": 24
+        "m2LoadEnabled": true,
+        "swapEnabled": true,
+        "bridgeEnabled": true,
+        "officeId": 29
       },
-      "complianceEnv": "OMNL_COMPLIANCE_CORE_900001"
-    },
-    {
-      "chainId": 900002,
-      "name": "OMNL Expansion Slot 2",
-      "type": "evm",
-      "nativeSymbol": "ETH",
-      "tier": "reserved",
-      "omnlRole": "expansion",
-      "status": "reserved",
-      "rpcEnv": "CHAIN_900002_RPC_URL",
-      "settlement": {
-        "m2LoadEnabled": false,
-        "swapEnabled": false,
-        "bridgeEnabled": false,
-        "officeId": 24
-      },
-      "complianceEnv": "OMNL_COMPLIANCE_CORE_900002"
+      "complianceEnv": "OMNL_COMPLIANCE_CORE_900001",
+      "integrationRef": "config/onex-shiva-integration.v1.json"
     },
     {
       "chainId": 900003,
@@ -2312,8 +2298,8 @@
     }
   ],
   "stats": {
-    "total": 128,
-    "active": 61,
+    "total": 127,
+    "active": 60,
     "staged": 3,
     "reserved": 64
   }
diff --git a/config/onex-shiva-integration.v1.json b/config/onex-shiva-integration.v1.json
new file mode 100644
index 0000000..54d9b63
--- /dev/null
+++ b/config/onex-shiva-integration.v1.json
@@ -0,0 +1,46 @@
+{
+  "$schema": "OneX Wallet + OneX Bank on Shiva Blockchain — OMNL integration",
+  "version": "1.0.0",
+  "updated": "2026-07-02",
+  "brand": {
+    "wallet": "OneX Wallet",
+    "bank": "OneX Bank",
+    "blockchain": "Shiva Blockchain"
+  },
+  "chain": {
+    "chainId": 900001,
+    "name": "Shiva Blockchain (OneX)",
+    "network": "shiva-onex",
+    "type": "evm",
+    "nativeSymbol": "SHIVA",
+    "rpcEnv": "CHAIN_900001_RPC_URL",
+    "rpcDefault": "https://rpc.shiva.onex.omdnl.org",
+    "explorerUrl": "https://explorer.shiva.onex.omdnl.org",
+    "omnlRegistrySlot": 900001
+  },
+  "fineract": {
+    "officeId": 29,
+    "externalId": "ZBANK-OMNL",
+    "entityName": "zBank",
+    "hybxWalletId": "HYBX-OFFICE-029",
+    "m1SpendableGl": "2100"
+  },
+  "bankCorridor": {
+    "orderingName": "OneX Bank",
+    "creditorBic": "ONEXSHIV33",
+    "debtorIban": "SH98ONEX000000000000000029",
+    "swiftMessageKind": "MT103",
+    "remittanceTemplate": "OneX Bank → Z Online Bank · Shiva blockchain settlement"
+  },
+  "wallet": {
+    "thirdwebMetadataName": "OneX Wallet",
+    "supportedAuth": ["email", "google", "apple", "passkey"],
+    "defaultTokenLineId": "USD-M2",
+    "defaultTokenSymbol": "cUSDC"
+  },
+  "settlement": {
+    "zBridgeOfficeId": 24,
+    "targetChainId": 900001,
+    "rails": ["HYBX", "SWIFT", "CHAIN_MINT"]
+  }
+}
diff --git a/config/settlement-middleware.production.v1.json b/config/settlement-middleware.production.v1.json
index 9af6ed1..27d66c3 100644
--- a/config/settlement-middleware.production.v1.json
+++ b/config/settlement-middleware.production.v1.json
@@ -47,5 +47,10 @@
     "allowHybxProduction": true,
     "allowChainMintExecute": true,
     "onlineBankMode": true
+  },
+  "guosmm": {
+    "emcbCharter": "GUOSMM-B-2026-001",
+    "registryPath": "config/guosmm-notices.v1.json",
+    "gazetteBase": "https://gazette.shosjj.org/notices/2026"
   }
 }
diff --git a/config/swift-listener-chain138.v1.json b/config/swift-listener-chain138.v1.json
new file mode 100644
index 0000000..de19e20
--- /dev/null
+++ b/config/swift-listener-chain138.v1.json
@@ -0,0 +1,110 @@
+{
+  "$schema": "OMNL SWIFT FIN / ISO 20022 listener — Chain 138 + Office 24 production",
+  "schemaVersion": "1.0.0",
+  "chain138": {
+    "chainId": 138,
+    "names": ["chain138", "chain 138", "defi oracle meta", "dbis", "omnl"],
+    "rpcHint": "RPC_URL_138",
+    "configSources": [
+      "config/ei-matrix-138-assets-and-pools.v1.json",
+      "config/chain138-iso20022-attestation.v1.json"
+    ]
+  },
+  "supportedSwiftFinTypes": ["MT103", "MT102", "MT202", "MT910", "MT940", "MT942", "MT950"],
+  "supportedIso20022Types": [
+    "pain.001",
+    "pacs.008",
+    "pacs.009",
+    "pacs.002",
+    "camt.052",
+    "camt.053",
+    "camt.054"
+  ],
+  "cToCwSymbolMapping": {
+    "USD": "cWUSD",
+    "USDC": "cWUSDC",
+    "USDT": "cWUSDT",
+    "EUR": "cWEUR",
+    "GBP": "cWGBP"
+  },
+  "matchHints": {
+    "instructionIdPrefixes": ["HOSPITALLERS", "CHAIN138", "OMNL", "HYBX", "ZARDASHT", "Z-BANK", "O24"],
+    "remittanceKeywords": [
+      "chain138",
+      "cWUSDC",
+      "cWUSDT",
+      "cWUSD",
+      "omnl",
+      "hybx",
+      "office 24",
+      "zardasht",
+      "hospitallers"
+    ]
+  },
+  "storage": {
+    "eventsDir": "reports/swift-listener/events",
+    "latestStatus": "reports/swift-listener/status-latest.json",
+    "processedIndex": "reports/swift-listener/processed-index.json",
+    "inboxDir": "reports/swift-listener/inbox",
+    "archiveDir": "reports/swift-listener/archive",
+    "as4InboxDir": "reports/swift-listener/as4-inbox",
+    "mailInboxDir": "reports/swift-listener/mail-inbox",
+    "telexInboxDir": "reports/swift-listener/telex-inbox"
+  },
+  "adapters": {
+    "fileInbox": { "enabled": true, "pollIntervalSec": 30, "archiveOnProcess": true },
+    "webhook": {
+      "enabled": true,
+      "port": 8788,
+      "path": "/inbound",
+      "healthPath": "/health",
+      "authBearerEnv": "SWIFT_LISTENER_WEBHOOK_TOKEN",
+      "webhookSecretEnv": "HYBX_WEBHOOK_SECRET",
+      "webhookSignatureHeader": "x-hybx-signature"
+    },
+    "p2pRail": {
+      "enabled": false,
+      "baseUrlEnv": "P2P_BASE_URL",
+      "pollIntervalSec": 60,
+      "transactionsPath": "/api/v1/transactions"
+    },
+    "finGateway": {
+      "enabled": false,
+      "baseUrlEnv": "FIN_GATEWAY_URL",
+      "fallbackBaseUrlEnv": "ALLIANCE_ACCESS_URL",
+      "pollIntervalSec": 120,
+      "messagesPath": "/messages",
+      "authBearerEnv": "FIN_GATEWAY_TOKEN"
+    },
+    "swiftFinTcp": {
+      "enabled": true,
+      "host": "0.0.0.0",
+      "portEnv": "SWIFT_FIN_TCP_PORT",
+      "defaultPort": 5001
+    },
+    "as4Inbox": { "enabled": false, "pollIntervalSec": 60, "archiveOnProcess": true },
+    "mailAttachmentInbox": { "enabled": false, "pollIntervalSec": 120, "archiveOnProcess": true },
+    "telexInbox": { "enabled": false, "pollIntervalSec": 120, "archiveOnProcess": true }
+  },
+  "outbound": {
+    "omnlForward": {
+      "enabled": true,
+      "mode": "local_and_api",
+      "apiPath": "/api/v1/omnl/iso20022/messages",
+      "tokenAggregationUrlEnv": "TOKEN_AGGREGATION_URL",
+      "apiKeyEnv": "OMNL_API_KEY",
+      "localStoreDir": "config/iso20022-omnl/messages"
+    },
+    "intakeGateway": {
+      "enabled": true,
+      "gatewayAddressEnv": "ISO20022_INTAKE_GATEWAY_MAINNET",
+      "gatewayAddressFallback": "0x66C89F91A4e830d87fcE4E5F86aFA71A96FbDa3d",
+      "rpcUrlEnv": "RPC_URL_138",
+      "privateKeyEnv": "PRIVATE_KEY",
+      "executeEnv": "SWIFT_LISTENER_GATEWAY_EXECUTE",
+      "dryRunDefault": true,
+      "autoExecuteWhenKeyPresent": true,
+      "chainId": 138
+    }
+  }
+}
diff --git a/config/swift-mt-catalog.v1.json b/config/swift-mt-catalog.v1.json
new file mode 100644
index 0000000..4d60597
--- /dev/null
+++ b/config/swift-mt-catalog.v1.json
@@ -0,0 +1,72 @@
+{
+  "$schema": "OMNL SWIFT MT catalog — Central Bank, Office 24, Z Online Bank",
+  "version": "1.0.0",
+  "settlementOfficeId": 24,
+  "bic": "OMNLUS33",
+  "rails": {
+    "outbound": "POST /settlement/external-transfer (rail SWIFT)",
+    "inbound": "POST /settlement/swift/inbound",
+    "listener": "SWIFT listener webhook POST /inbound :8788"
+  },
+  "messageTypes": [
+    {
+      "mt": "MT103",
+      "name": "Single Customer Credit Transfer",
+      "use": "Z Bank wire, Office 24 outbound, correspondent payments",
+      "moneyLayers": ["M0", "M1", "M2", "M4"],
+      "portal": "/central-bank#z-settlement-protocols",
+      "settlementField": "swiftMessageKind: MT103"
+    },
+    {
+      "mt": "MT102",
+      "name": "Multiple Customer Credit Transfer",
+      "use": "Bulk payroll, DLC/LS batch legs",
+      "moneyLayers": ["M1", "M2", "M3", "M4"],
+      "portal": "/central-bank#z-settlement-protocols"
+    },
+    {
+      "mt": "MT202",
+      "name": "General Financial Institution Transfer",
+      "use": "SBLC cover payment, interbank settlement",
+      "moneyLayers": ["M4"],
+      "tradeFinance": ["SBLC"]
+    },
+    {
+      "mt": "MT910",
+      "name": "Confirmation of Credit",
+      "use": "Credit advice to beneficiary bank",
+      "moneyLayers": ["M4"]
+    },
+    {
+      "mt": "MT940",
+      "name": "Customer Statement",
+      "use": "End-of-day account statement (Fineract reconcile)",
+      "moneyLayers": ["M0", "M1", "M2"]
+    },
+    {
+      "mt": "MT942",
+      "name": "Interim Statement",
+      "use": "Intraday statement / liquidity monitoring",
+      "moneyLayers": ["M0", "M1"]
+    },
+    {
+      "mt": "MT950",
+      "name": "Statement Message",
+      "use": "Legacy statement (Fineract GL export)",
+      "moneyLayers": ["M0", "M1", "M2"]
+    }
+  ],
+  "iso20022": [
+    { "type": "pacs.008", "swiftFin": "MT103", "use": "FI-to-FI customer credit" },
+    { "type": "pacs.009", "swiftFin": "MT202", "use": "FI-to-FI institution transfer" },
+    { "type": "camt.054", "swiftFin": "MT910", "use": "Credit notification" },
+    { "type": "camt.053", "swiftFin": "MT940", "use": "Account statement" },
+    { "type": "camt.052", "swiftFin": "MT942", "use": "Account report" }
+  ],
+  "tradeFinance": {
+    "SBLC": { "swiftMessages": ["MT103", "MT202"], "endpoint": "POST /settlement/trade-finance/SBLC" },
+    "DLC": { "swiftMessages": ["MT103", "MT102"], "endpoint": "POST /settlement/trade-finance/DLC" },
+    "BG": { "swiftMessages": ["MT103"], "endpoint": "POST /settlement/trade-finance/BG" },
+    "LS": { "swiftMessages": ["MT102", "MT103"], "endpoint": "POST /settlement/trade-finance/LS" }
+  }
+}
diff --git a/config/z-chain-deployed.v1.json b/config/z-chain-deployed.v1.json
new file mode 100644
index 0000000..54be0c6
--- /dev/null
+++ b/config/z-chain-deployed.v1.json
@@ -0,0 +1,17 @@
+{
+  "$schema": "Z Chain on-chain deployment addresses (chainId 900002)",
+  "version": "1.0.0",
+  "updated": "2026-07-07",
+  "chainId": 900002,
+  "network": "z-chain",
+  "status": "active",
+  "contracts": {
+    "cUSDC": "0x5FbDB2315678afecb367f032d93F642f64180aa3",
+    "accountWalletRegistry": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512"
+  },
+  "deployScript": "script/z-chain/DeployZChainEmoney.s.sol",
+  "notes": [
+    "Run scripts/deployment/deploy-z-chain-contracts.sh after bootstrap-z-chain-local",
+    "Update addresses here and in hybx-omnl-cross-chain-lines.json chains.900002"
+  ]
+}
diff --git a/config/z-chain-integration.v1.json b/config/z-chain-integration.v1.json
new file mode 100644
index 0000000..5450e8d
--- /dev/null
+++ b/config/z-chain-integration.v1.json
@@ -0,0 +1,105 @@
+{
+  "$schema": "International Z Wallet + Z Chain — Z Ecosystem integration",
+  "version": "1.0.0",
+  "updated": "2026-07-05",
+  "brand": {
+    "wallet": "International Z Wallet",
+    "bank": "Z Online Bank",
+    "blockchain": "Z Chain",
+    "bot": "Z Bot"
+  },
+  "chain": {
+    "chainId": 900002,
+    "name": "Z Chain",
+    "network": "z-chain",
+    "type": "evm",
+    "nativeSymbol": "Z",
+    "rpcEnv": "CHAIN_900002_RPC_URL",
+    "rpcDefault": "http://127.0.0.1:8546",
+    "explorerUrl": "https://explorer.zblockchainsystem.com",
+    "omnlRegistrySlot": 900002
+  },
+  "fineract": {
+    "officeId": 29,
+    "externalId": "ZBANK-OMNL",
+    "entityName": "zBank",
+    "hybxWalletId": "HYBX-OFFICE-029",
+    "m1SpendableGl": "2100"
+  },
+  "bankCorridor": {
+    "orderingName": "International Z Wallet",
+    "creditorBic": "ZCHNOMNL33",
+    "debtorIban": "Z298ZCHN000000000000000029",
+    "swiftMessageKind": "MT103",
+    "remittanceTemplate": "International Z Wallet → Z Online Bank · Z Chain settlement"
+  },
+  "internationalCorridors": [
+    {
+      "id": "IQ-USD",
+      "label": "Iraq (USD)",
+      "country": "IQ",
+      "currency": "USD",
+      "rails": [
+        "SWIFT",
+        "HYBX",
+        "CHAIN_MINT"
+      ]
+    },
+    {
+      "id": "IR-USD",
+      "label": "Iran (USD)",
+      "country": "IR",
+      "currency": "USD",
+      "rails": [
+        "HYBX",
+        "CHAIN_MINT"
+      ]
+    },
+    {
+      "id": "EU-EUR",
+      "label": "Europe (EUR)",
+      "country": "EU",
+      "currency": "EUR",
+      "rails": [
+        "SWIFT",
+        "HYBX"
+      ]
+    },
+    {
+      "id": "GLOBAL-USD",
+      "label": "Global (USD)",
+      "country": "GLOBAL",
+      "currency": "USD",
+      "rails": [
+        "SWIFT",
+        "HYBX",
+        "CHAIN_MINT"
+      ]
+    }
+  ],
+  "wallet": {
+    "thirdwebMetadataName": "International Z Wallet",
+    "supportedAuth": [
+      "email",
+      "google",
+      "apple",
+      "passkey"
+    ],
+    "defaultTokenLineId": "USD-M2",
+    "defaultTokenSymbol": "cUSDC"
+  },
+  "settlement": {
+    "zBridgeOfficeId": 24,
+    "targetChainId": 900002,
+    "rails": [
+      "HYBX",
+      "SWIFT",
+      "CHAIN_MINT"
+    ]
+  },
+  "contracts": {
+    "cUSDC": "0x5FbDB2315678afecb367f032d93F642f64180aa3",
+    "accountWalletRegistry": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
+    "deployRef": "config/z-chain-deployed.v1.json"
+  }
+}
diff --git a/config/z-chain-network-config.json b/config/z-chain-network-config.json
new file mode 100644
index 0000000..3e909e1
--- /dev/null
+++ b/config/z-chain-network-config.json
@@ -0,0 +1,29 @@
+{
+  "genesis": {
+    "config": {
+      "chainId": 900002,
+      "ibft2": {
+        "blockperiodseconds": 2,
+        "epochlength": 30000,
+        "requesttimeoutseconds": 10
+      }
+    },
+    "nonce": "0x0",
+    "timestamp": "0x0",
+    "gasLimit": "0x1c9c380",
+    "difficulty": "0x1",
+    "mixHash": "0x63746963616c2062797a616e74696e65206661756c7420746f6c6572616e6365",
+    "coinbase": "0x0000000000000000000000000000000000000000",
+    "alloc": {
+      "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73": {
+        "balance": "0x33b2e3c9fd0803ce8000000"
+      }
+    }
+  },
+  "blockchain": {
+    "nodes": {
+      "generate": true,
+      "count": 1
+    }
+  }
+}
diff --git a/config/z-chain-production.v1.json b/config/z-chain-production.v1.json
new file mode 100644
index 0000000..3a74668
--- /dev/null
+++ b/config/z-chain-production.v1.json
@@ -0,0 +1,37 @@
+{
+  "$schema": "Z Chain production endpoints — Besu IBFT2 on LXC or Azure",
+  "version": "1.0.0",
+  "updated": "2026-07-06",
+  "chainId": 900002,
+  "network": "z-chain",
+  "genesis": "config/genesis-z-chain-900002.json",
+  "networkConfig": "config/z-chain-network-config.json",
+  "endpoints": {
+    "portal": "https://zblockchainsystem.com",
+    "rpcPublic": "https://rpc.zblockchainsystem.com",
+    "rpcLan": "http://192.168.11.212:8546",
+    "explorer": "https://explorer.zblockchainsystem.com",
+    "walletPortal": "https://zblockchainsystem.com/z-wallet",
+    "ecosystemHub": "https://zblockchainsystem.com/z",
+    "digitalSwap": "https://zblockchainsystem.com/swap",
+    "zBankUi": "https://zblockchainsystem.com/central-bank"
+  },
+  "env": {
+    "rpc": "CHAIN_900002_RPC_URL",
+    "compliance": "OMNL_COMPLIANCE_CORE_900002",
+    "viteRpc": "VITE_RPC_URL_900002",
+    "viteExplorer": "VITE_Z_CHAIN_EXPLORER_URL"
+  },
+  "besu": {
+    "containerName": "z-chain-besu-prod",
+    "rpcPort": 8546,
+    "dataPath": "/opt/besu-z-chain",
+    "genesisPath": "/opt/besu-z-chain/config/genesis.json"
+  },
+  "deployScripts": {
+    "bootstrapLocal": "scripts/deployment/bootstrap-z-chain-local.sh",
+    "bootstrapProduction": "scripts/deployment/bootstrap-z-chain-production.sh",
+    "deployContracts": "scripts/deployment/deploy-z-chain-contracts.sh",
+    "syncAddresses": "scripts/deployment/sync-z-chain-deployed-addresses.mjs"
+  }
+}
diff --git a/config/z-ecosystem-links.v1.json b/config/z-ecosystem-links.v1.json
new file mode 100644
index 0000000..87ba70e
--- /dev/null
+++ b/config/z-ecosystem-links.v1.json
@@ -0,0 +1,35 @@
+{
+  "$schema": "Z Ecosystem link map — zblockchainsystem.com only",
+  "version": "1.0.0",
+  "updated": "2026-07-07",
+  "brand": "Z Blockchain System",
+  "publicUrl": "https://zblockchainsystem.com",
+  "routes": {
+    "hub": "/z",
+    "wallet": "/z-wallet",
+    "swap": "/swap",
+    "onlineBank": "/central-bank",
+    "zBotHealth": "/api/v1/z-bot/health",
+    "zWalletCorridors": "/api/v1/z-wallet/corridors",
+    "settlementHealth": "/settlement/health",
+    "zBankSettle": "/settlement/z-bank/settle-m0-m4"
+  },
+  "productionPortals": {
+    "zEcosystem": "https://zblockchainsystem.com/z",
+    "zWallet": "https://zblockchainsystem.com/z-wallet",
+    "zSwap": "https://zblockchainsystem.com/swap",
+    "zOnlineBank": "https://zblockchainsystem.com/central-bank"
+  },
+  "subdomains": {
+    "rpc": "https://rpc.zblockchainsystem.com",
+    "explorer": "https://explorer.zblockchainsystem.com"
+  },
+  "local": {
+    "frontend": "http://localhost:3002",
+    "zHub": "http://localhost:3002/z",
+    "zWallet": "http://localhost:3002/z-wallet",
+    "zBotHealth": "http://localhost:3000/api/v1/z-bot/health",
+    "settlementHealth": "http://localhost:3011/api/v1/settlement/health",
+    "chainRpc": "http://127.0.0.1:8546"
+  }
+}
diff --git a/config/z-ecosystem-production-domains.v1.json b/config/z-ecosystem-production-domains.v1.json
new file mode 100644
index 0000000..fef5ca0
--- /dev/null
+++ b/config/z-ecosystem-production-domains.v1.json
@@ -0,0 +1,28 @@
+{
+  "version": "1.0.0",
+  "updated": "2026-07-06",
+  "brand": "Z Blockchain System",
+  "publicUrl": "https://zblockchainsystem.com",
+  "originHost": "dev-bis-zardasht",
+  "originIp": "76.53.10.34",
+  "frontendPort": 3002,
+  "domains": [
+    {
+      "host": "zblockchainsystem.com",
+      "hostAliases": ["www.zblockchainsystem.com"],
+      "product": "z-ecosystem",
+      "defaultRoute": "/z",
+      "routes": ["/z", "/z-wallet", "/swap", "/central-bank"]
+    }
+  ],
+  "subdomains": {
+    "rpc": "rpc.zblockchainsystem.com",
+    "explorer": "explorer.zblockchainsystem.com"
+  },
+  "apis": {
+    "zBotHealth": "https://zblockchainsystem.com/api/v1/z-bot/health",
+    "zWalletCorridors": "https://zblockchainsystem.com/api/v1/z-wallet/corridors",
+    "settlementHealth": "https://zblockchainsystem.com/settlement/health",
+    "zBankSettle": "https://zblockchainsystem.com/settlement/z-bank/settle-m0-m4"
+  }
+}
diff --git a/config/z-ecosystem.local.env.example b/config/z-ecosystem.local.env.example
new file mode 100644
index 0000000..631211c
--- /dev/null
+++ b/config/z-ecosystem.local.env.example
@@ -0,0 +1,23 @@
+# Z Ecosystem local overrides — copy to config/z-ecosystem.local.env
+# Production portal: https://zblockchainsystem.com (separate from OMNL)
+
+VITE_ECOSYSTEM=z
+Z_SUPPORTED_CHAINS_CONFIG=config/z-supported-chains.v1.json
+Z_ECOSYSTEM_PUBLIC_URL=https://zblockchainsystem.com
+VITE_Z_ECOSYSTEM_URL=https://zblockchainsystem.com
+
+# Z Chain (local Hardhat/Besu)
+CHAIN_900002_RPC_URL=http://127.0.0.1:8546
+VITE_RPC_URL_900002=http://127.0.0.1:8546
+VITE_Z_CHAIN_EXPLORER_URL=https://explorer.zblockchainsystem.com
+VITE_ENABLE_Z_WALLET=true
+
+# Z Bot — Azure OpenAI (optional)
+AZURE_OPENAI_ENDPOINT=https://<resource>.openai.azure.com
+AZURE_OPENAI_API_KEY=
+AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
+
+# Settlement (Z Bank API backend)
+SETTLEMENT_MIDDLEWARE_URL=http://127.0.0.1:3011
+SETTLEMENT_MIDDLEWARE_CONFIG=config/settlement-middleware.production.v1.json
diff --git a/config/z-ecosystem.production.env.example b/config/z-ecosystem.production.env.example
new file mode 100644
index 0000000..f743b52
--- /dev/null
+++ b/config/z-ecosystem.production.env.example
@@ -0,0 +1,25 @@
+# Z Ecosystem production — copy to config/z-ecosystem.production.env
+# Gitea binds :3000 on dev-bis-ali; Z API uses :3100
+
+VITE_ECOSYSTEM=z
+Z_SUPPORTED_CHAINS_CONFIG=config/z-supported-chains.v1.json
+Z_ECOSYSTEM_PUBLIC_URL=https://zblockchainsystem.com
+VITE_Z_ECOSYSTEM_URL=https://zblockchainsystem.com
+
+CHAIN_900002_RPC_URL=https://rpc.zblockchainsystem.com
+VITE_RPC_URL_900002=https://rpc.zblockchainsystem.com
+VITE_Z_CHAIN_EXPLORER_URL=https://explorer.zblockchainsystem.com
+VITE_ENABLE_Z_WALLET=true
+
+Z_TOKEN_AGGREGATION_PORT=3100
+PORT=3100
+TOKEN_AGGREGATION_URL=http://127.0.0.1:3100
+SETTLEMENT_MIDDLEWARE_URL=http://127.0.0.1:3011
+SETTLEMENT_URL=http://127.0.0.1:3011
+SETTLEMENT_MIDDLEWARE_CONFIG=config/settlement-middleware.production.v1.json
+
+# Z Bot — Azure OpenAI (optional)
+AZURE_OPENAI_ENDPOINT=
+AZURE_OPENAI_API_KEY=
+AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
diff --git a/config/z-ecosystem.v1.json b/config/z-ecosystem.v1.json
new file mode 100644
index 0000000..da262f0
--- /dev/null
+++ b/config/z-ecosystem.v1.json
@@ -0,0 +1,50 @@
+{
+  "$schema": "Z consumer ecosystem hub links",
+  "version": "1.1.0",
+  "updated": "2026-07-06",
+  "brand": "Z Blockchain System",
+  "publicUrl": "https://zblockchainsystem.com",
+  "routes": {
+    "hub": "/z",
+    "wallet": "/z-wallet",
+    "bot": "/z-wallet#z-bot",
+    "swap": "/swap",
+    "onlineBank": "/central-bank",
+    "settlement": "/central-bank#z-full-settlement"
+  },
+  "apps": [
+    {
+      "id": "zWallet",
+      "label": "International Z Wallet",
+      "path": "/z-wallet",
+      "description": "Thirdweb in-app wallet on Z Chain with international corridors"
+    },
+    {
+      "id": "zBot",
+      "label": "Z Bot",
+      "path": "/z-wallet#z-bot",
+      "description": "In-app assistant for balance, transfers, and corridors"
+    },
+    {
+      "id": "zChain",
+      "label": "Z Chain",
+      "path": "/z",
+      "chainId": 900002,
+      "description": "Consumer EVM chain (chainId 900002)"
+    },
+    {
+      "id": "zSwap",
+      "label": "Digital Swap",
+      "path": "/swap",
+      "description": "M2 load, token swap, settlement rails"
+    },
+    {
+      "id": "zOnlineBank",
+      "label": "Z Online Bank",
+      "path": "/central-bank",
+      "description": "M0–M4 banking and settlement rails"
+    }
+  ],
+  "integrationRef": "config/z-chain-integration.v1.json",
+  "productionDomainsRef": "config/z-ecosystem-production-domains.v1.json"
+}
diff --git a/config/z-supported-chains.v1.json b/config/z-supported-chains.v1.json
new file mode 100644
index 0000000..27d6186
--- /dev/null
+++ b/config/z-supported-chains.v1.json
@@ -0,0 +1,27 @@
+{
+  "$schema": "Z Chain supported chains — separate from OMNL 128-chain registry",
+  "version": "1.0.0",
+  "brand": "Z Blockchain System",
+  "primaryChainId": 900002,
+  "chains": [
+    {
+      "chainId": 900002,
+      "name": "Z Chain",
+      "type": "evm",
+      "nativeSymbol": "Z",
+      "tier": "primary",
+      "zRole": "settlement-hub",
+      "status": "active",
+      "rpcEnv": "CHAIN_900002_RPC_URL",
+      "explorerUrl": "https://explorer.zblockchainsystem.com",
+      "rpcDefault": "http://127.0.0.1:8546",
+      "settlement": {
+        "m2LoadEnabled": true,
+        "swapEnabled": true,
+        "bridgeEnabled": true
+      },
+      "complianceEnv": "Z_COMPLIANCE_CORE_900002",
+      "integrationRef": "config/z-chain-integration.v1.json"
+    }
+  ]
+}
diff --git a/contracts/z-chain/AccountWalletRegistryZ.sol b/contracts/z-chain/AccountWalletRegistryZ.sol
new file mode 100644
index 0000000..1ade916
--- /dev/null
+++ b/contracts/z-chain/AccountWalletRegistryZ.sol
@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.19;
+
+import "@openzeppelin/contracts/access/AccessControl.sol";
+
+interface IAccountWalletRegistryZ {
+    struct WalletLink {
+        bytes32 walletRefId;
+        string provider;
+        bool active;
+    }
+
+    function linkAccountToWallet(bytes32 accountRefId, bytes32 walletRefId, string calldata provider) external;
+    function getWalletsForAccount(bytes32 accountRefId) external view returns (WalletLink[] memory);
+}
+
+/**
+ * @title AccountWalletRegistryZ
+ * @notice Minimal registry for Z Chain deploy scope
+ */
+contract AccountWalletRegistryZ is IAccountWalletRegistryZ, AccessControl {
+    bytes32 public constant ACCOUNT_MANAGER_ROLE = keccak256("ACCOUNT_MANAGER_ROLE");
+
+    mapping(bytes32 => WalletLink[]) private _accountToWallets;
+
+    constructor(address admin) {
+        _grantRole(DEFAULT_ADMIN_ROLE, admin);
+        _grantRole(ACCOUNT_MANAGER_ROLE, admin);
+    }
+
+    function linkAccountToWallet(bytes32 accountRefId, bytes32 walletRefId, string calldata provider) external {
+        require(hasRole(ACCOUNT_MANAGER_ROLE, msg.sender), "not manager");
+        _accountToWallets[accountRefId].push(WalletLink(walletRefId, provider, true));
+    }
+
+    function getWalletsForAccount(bytes32 accountRefId) external view returns (WalletLink[] memory) {
+        return _accountToWallets[accountRefId];
+    }
+}
diff --git a/contracts/z-chain/ZChainUSDC.sol b/contracts/z-chain/ZChainUSDC.sol
new file mode 100644
index 0000000..039d695
--- /dev/null
+++ b/contracts/z-chain/ZChainUSDC.sol
@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+
+/**
+ * @title ZChainUSDC
+ * @notice Minimal M2 stand-in for Z Chain local/dev deploys (cUSDC)
+ */
+contract ZChainUSDC is ERC20 {
+    constructor(address admin) ERC20("Z Chain USD", "cUSDC") {
+        _mint(admin, 1_000_000_000 * 10 ** 6);
+    }
+
+    function decimals() public pure override returns (uint8) {
+        return 6;
+    }
+}
diff --git a/deploy/nginx/omnl-common-locations.conf b/deploy/nginx/omnl-common-locations.conf
index ec6f588..c14955b 100644
--- a/deploy/nginx/omnl-common-locations.conf
+++ b/deploy/nginx/omnl-common-locations.conf
@@ -1,5 +1,10 @@
 # Shared OMNL Bank proxy locations (include inside each server block)
 
+# Z Ecosystem routes live on zblockchainsystem.com only
+location ~ ^/(z|z-wallet)(/|$) {
+    return 302 https://zblockchainsystem.com$request_uri;
+}
+
 location /api/v1/ {
     include /etc/nginx/omnl-portal-auth-current.conf.inc;
     proxy_pass http://omnl_api/api/v1/;
diff --git a/deploy/nginx/z-ecosystem-common-locations.conf b/deploy/nginx/z-ecosystem-common-locations.conf
new file mode 100644
index 0000000..8de5a3d
--- /dev/null
+++ b/deploy/nginx/z-ecosystem-common-locations.conf
@@ -0,0 +1,56 @@
+# Z Ecosystem — Z-only nginx locations (no OMNL consoles)
+
+location /api/v1/ {
+    proxy_pass http://z_ecosystem_api/api/v1/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 120s;
+}
+
+location /settlement/ {
+    proxy_pass http://z_ecosystem_settlement/api/v1/settlement/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 120s;
+}
+
+location /exchange/ {
+    proxy_pass http://z_ecosystem_exchange/api/v1/exchange/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_read_timeout 120s;
+}
+
+# Block OMNL / DBIS-only SPA routes on Z domain
+location ~ ^/(hub|office-24|trade|bridge|reserve|history|admin|docs|wallets|omnl)(/|$) {
+    return 404;
+}
+
+location /health {
+    return 200 'Z Ecosystem online — chain 900002';
+    add_header Content-Type text/plain;
+}
+
+location /assets/ {
+    proxy_pass http://z_ecosystem_frontend;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+}
+
+location / {
+    proxy_pass http://z_ecosystem_frontend;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
+}
diff --git a/deploy/nginx/z-ecosystem-domains.conf b/deploy/nginx/z-ecosystem-domains.conf
new file mode 100644
index 0000000..a513877
--- /dev/null
+++ b/deploy/nginx/z-ecosystem-domains.conf
@@ -0,0 +1,49 @@
+# Z Ecosystem — zblockchainsystem.com (Z Chain, Wallet, Bot, Swap, Z Bank)
+# Deploy: scripts/deployment/deploy-z-domains.sh
+# Independent from OMNL / DBIS portals
+
+upstream z_ecosystem_frontend {
+    server 127.0.0.1:3002;
+}
+
+upstream z_ecosystem_api {
+    server 127.0.0.1:3100;
+}
+
+upstream z_ecosystem_settlement {
+    server 127.0.0.1:3011;
+}
+
+upstream z_ecosystem_exchange {
+    server 127.0.0.1:3012;
+}
+
+server {
+    listen 80;
+    listen [::]:80;
+    server_name zblockchainsystem.com www.zblockchainsystem.com;
+
+    add_header X-Z-Product "z-ecosystem" always;
+    add_header X-Z-Chain "900002" always;
+
+    location = / {
+        return 302 /z;
+    }
+
+    include /etc/nginx/snippets/z-ecosystem-common-locations.conf;
+}
+
+server {
+    listen 80;
+    listen [::]:80;
+    server_name rpc.zblockchainsystem.com;
+
+    add_header X-Z-Product "z-chain-rpc" always;
+
+    location / {
+        proxy_pass http://127.0.0.1:8546;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_read_timeout 120s;
+    }
+}
diff --git a/docs/04-configuration/Z_ECOSYSTEM.md b/docs/04-configuration/Z_ECOSYSTEM.md
new file mode 100644
index 0000000..56bb577
--- /dev/null
+++ b/docs/04-configuration/Z_ECOSYSTEM.md
@@ -0,0 +1,157 @@
+# Z Ecosystem — Z Chain, International Z Wallet, Z Bot
+
+Consumer-facing Z products on OMNL expansion slot **900002**.
+
+## Components
+
+| Product | Route | Config |
+|---------|-------|--------|
+| Z Ecosystem hub | `/z` | `config/z-ecosystem.v1.json` |
+| International Z Wallet | `/z-wallet` | `config/z-chain-integration.v1.json` |
+| Z Bot (in-app chat) | `/z-wallet#z-bot` | `POST /api/v1/z-bot/chat` |
+| Z Online Bank | `/central-bank` | existing z-bank settlement |
+
+## Local Z Chain bootstrap
+
+```bash
+# Start Besu (chainId 900002) on port 8546
+bash scripts/deployment/bootstrap-z-chain-local.sh
+
+# Env
+export CHAIN_900002_RPC_URL=http://127.0.0.1:8546
+export VITE_RPC_URL_900002=http://127.0.0.1:8546
+
+# Deploy contracts (optional)
+export PRIVATE_KEY=0x...
+bash scripts/deployment/deploy-z-chain-contracts.sh
+```
+
+Windows:
+
+```powershell
+.\scripts\deployment\bootstrap-z-chain-local.ps1
+```
+
+Verify: `cast chain-id --rpc-url http://127.0.0.1:8546` → `900002` (hex `0xdbba2`)
+
+### One-command complete setup (Windows)
+
+```powershell
+npm install --legacy-peer-deps
+.\scripts\deployment\complete-z-chain.ps1
+```
+
+Uses Hardhat node when Docker is unavailable. Keeps node running in background (`logs/z-chain-node.pid`).
+
+
+## Frontend env
+
+```env
+VITE_ENABLE_Z_WALLET=true
+VITE_RPC_URL_900002=http://127.0.0.1:8546
+VITE_Z_CHAIN_EXPLORER_URL=https://explorer.z.omdnl.org
+VITE_THIRDWEB_CLIENT_ID=...
+```
+
+## API
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/v1/z-wallet/corridors` | International corridor catalog |
+| GET | `/api/v1/z-wallet/status/:ref` | Settlement status proxy |
+| GET | `/api/v1/z-bot/health` | Z Bot + Azure OpenAI config status |
+| POST | `/api/v1/z-bot/chat` | Z Bot assistant |
+
+Z Bot body:
+
+```json
+{
+  "sessionId": "zbot-...",
+  "message": "What is my balance?",
+  "walletAddress": "0x...",
+  "chainId": 900002
+}
+```
+
+## Z Bot LLM (optional)
+
+Set Azure OpenAI for live replies; otherwise rule-based fallback:
+
+```env
+AZURE_OPENAI_ENDPOINT=https://<resource>.openai.azure.com
+AZURE_OPENAI_API_KEY=...
+AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
+```
+
+## International corridors
+
+Defined in `config/z-chain-integration.v1.json`:
+
+- Iraq (USD) — SWIFT, HYBX, CHAIN_MINT
+- Iran (USD) — HYBX, CHAIN_MINT
+- Europe (EUR) — SWIFT, HYBX
+- Global (USD) — SWIFT, HYBX, CHAIN_MINT
+
+Transfers submit to `POST /z-bank/settle-m0-m4` (or `/external-transfer` fallback) with `targetChainId: 900002`.
+
+## Registry
+
+`config/omnl-supported-chains.v1.json` slot **900002** — `name: Z Chain`, `status: active`, `omnlRole: z-chain`.
+
+## Production Besu (LXC / VM)
+
+On the Z Chain host (see `config/z-chain-production.v1.json`):
+
+```bash
+sudo bash scripts/deployment/bootstrap-z-chain-production.sh
+```
+
+Wire nginx/Cloudflare:
+
+- `https://zblockchainsystem.com` → portal (`/z`, `/z-wallet`, `/swap`, `/central-bank`)
+- `https://rpc.zblockchainsystem.com` → `127.0.0.1:8546`
+- `https://explorer.zblockchainsystem.com` → Blockscout (optional)
+
+Set on Z portal host:
+
+```env
+CHAIN_900002_RPC_URL=https://rpc.zblockchainsystem.com
+VITE_RPC_URL_900002=https://rpc.zblockchainsystem.com
+VITE_Z_CHAIN_EXPLORER_URL=https://explorer.zblockchainsystem.com
+VITE_Z_ECOSYSTEM_URL=https://zblockchainsystem.com
+```
+
+Deploy:
+
+```bash
+bash scripts/deployment/deploy-z-ecosystem-production.sh
+bash scripts/deployment/print-z-dns-records.sh
+```
+
+## Local dev without Docker
+
+If Docker Desktop is not running, use Anvil:
+
+```powershell
+.\scripts\deployment\bootstrap-z-chain-anvil.ps1
+```
+
+Default Anvil account #0 key: `0xac0974bec39a17e36ba4a590bcafb95bd05417ff81f81088a92f31fcfcf35588`
+
+```bash
+export PRIVATE_KEY=0xac0974bec39a17e36ba4a590bcafb95bd05417ff81f81088a92f31fcfcf35588
+bash scripts/deployment/deploy-z-chain-contracts.sh
+node scripts/deployment/sync-z-chain-deployed-addresses.mjs
+```
+
+## Contract addresses
+
+After deploy, sync all configs:
+
+```bash
+node scripts/deployment/sync-z-chain-deployed-addresses.mjs
+```
+
+Updates `z-chain-deployed.v1.json`, `z-chain-integration.v1.json`, and `hybx-omnl-cross-chain-lines.json`.
+
diff --git a/docs/deployment/DEPLOYMENT_ISSUES_AND_FIXES.md b/docs/deployment/DEPLOYMENT_ISSUES_AND_FIXES.md
index 42d98e3..e00ebeb 100644
--- a/docs/deployment/DEPLOYMENT_ISSUES_AND_FIXES.md
+++ b/docs/deployment/DEPLOYMENT_ISSUES_AND_FIXES.md
@@ -143,7 +143,6 @@ forge script script/DeployTransactionMirror.s.sol \
 3. **RPC Providers**:
    - Alchemy: https://www.alchemy.com/
    - Infura: https://www.infura.io/
-   - QuickNode: https://www.quicknode.com/
 4. **Verification**: Contracts will be automatically verified on Etherscan if `ETHERSCAN_API_KEY` is set
 
 ---
diff --git a/docs/deployment/INFURA_RPC_ISSUE.md b/docs/deployment/INFURA_RPC_ISSUE.md
index c3683a3..77cd7a2 100644
--- a/docs/deployment/INFURA_RPC_ISSUE.md
+++ b/docs/deployment/INFURA_RPC_ISSUE.md
@@ -46,9 +46,6 @@ Switch to Alchemy or another provider:
 # Alchemy
 ETHEREUM_MAINNET_RPC=https://eth-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
 
-# QuickNode
-ETHEREUM_MAINNET_RPC=https://your-endpoint.quiknode.pro/YOUR_API_KEY
-
 # Public RPC (not recommended for production)
 ETHEREUM_MAINNET_RPC=https://eth.llamarpc.com
 ```
diff --git a/docs/deployment/INFURA_SETTINGS_FIX.md b/docs/deployment/INFURA_SETTINGS_FIX.md
index 7a32473..bbfb32f 100644
--- a/docs/deployment/INFURA_SETTINGS_FIX.md
+++ b/docs/deployment/INFURA_SETTINGS_FIX.md
@@ -62,11 +62,6 @@ Update `.env` line 18 with alternative provider:
 ETHEREUM_MAINNET_RPC=https://eth-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
 ```
 
-**QuickNode**:
-```bash
-ETHEREUM_MAINNET_RPC=https://your-endpoint.quiknode.pro/YOUR_API_KEY
-```
-
 **Public RPC** (not recommended for production):
 ```bash
 ETHEREUM_MAINNET_RPC=https://eth.llamarpc.com
diff --git a/foundry.toml b/foundry.toml
index 82344e2..96c48c2 100644
--- a/foundry.toml
+++ b/foundry.toml
@@ -68,6 +68,12 @@ via_ir = true
 # Generic deploy profile for post-Dencun EVMs. Do not use for Chain 138.
 evm_version = "cancun"
 
+[profile.zchain]
+optimizer = true
+optimizer_runs = 100
+via_ir = true
+evm_version = "cancun"
+
 [profile.chain138]
 optimizer = true
 optimizer_runs = 100
@@ -169,6 +175,7 @@ cbor_metadata = false
 # Prevents default localhost:8545 when ETH_RPC_URL not set
 [rpc_endpoints]
 chain138 = "http://192.168.11.211:8545"
+zchain = "http://127.0.0.1:8546"
 avalanche = "https://avalanche-c-chain.publicnode.com"
 arbitrum = "https://arbitrum-one.publicnode.com"
 cronos = "https://evm.cronos.org"
diff --git a/frontend-dapp/.env.example b/frontend-dapp/.env.example
index 0e4cc28..82711c6 100644
--- a/frontend-dapp/.env.example
+++ b/frontend-dapp/.env.example
@@ -8,6 +8,12 @@ VITE_WALLETCONNECT_PROJECT_ID=your_reown_project_id_from_cloud_reown_com
 VITE_THIRDWEB_CLIENT_ID=your_thirdweb_client_id_here
 VITE_RPC_URL_138=https://rpc-http-pub.d-bis.org
 
+# Z Chain (chainId 900002) — International Z Wallet
+# VITE_ENABLE_Z_WALLET=true
+# VITE_RPC_URL_900002=http://127.0.0.1:8546
+# VITE_Z_CHAIN_EXPLORER_URL=https://explorer.z.omdnl.org
+# VITE_Z_CHAIN_ID=900002
+
 # Defi Oracle Meta Testnet (chain ID 2138) — off unless VITE_ENABLE_CHAIN2138 is true or 1
 # VITE_ENABLE_CHAIN2138=true
 # VITE_RPC_URL_2138=https://rpc.public-2138.defi-oracle.io
diff --git a/frontend-dapp/.env.local.example b/frontend-dapp/.env.local.example
new file mode 100644
index 0000000..b9cbd51
--- /dev/null
+++ b/frontend-dapp/.env.local.example
@@ -0,0 +1,6 @@
+# Z Ecosystem local dev
+VITE_ENABLE_Z_WALLET=true
+VITE_Z_ECOSYSTEM_URL=http://localhost:3002
+VITE_RPC_URL_900002=http://127.0.0.1:8546
+VITE_Z_CHAIN_EXPLORER_URL=https://explorer.zblockchainsystem.com
+CHAIN_900002_RPC_URL=http://127.0.0.1:8546
diff --git a/frontend-dapp/index.html b/frontend-dapp/index.html
index 73345a6..5227525 100644
--- a/frontend-dapp/index.html
+++ b/frontend-dapp/index.html
@@ -3,10 +3,13 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>OMNL Mission Control - Chain 138</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <meta name="theme-color" content="#141a16" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <title>DBIS — Chain 138</title>
     <style>
-      html, body { margin: 0; min-height: 100%; background: #0f2847; color: #e8f4ff; }
+      html, body { margin: 0; min-height: 100%; background: #141a16; color: #eaecef; }
       #root { min-height: 100vh; }
       .omnl-boot {
         min-height: 100vh;
@@ -14,26 +17,19 @@
         flex-direction: column;
         align-items: center;
         justify-content: center;
-        gap: 1rem;
+        gap: 0.75rem;
         font-family: Inter, system-ui, sans-serif;
-        background:
-          radial-gradient(ellipse at 20% 0%, rgba(45, 107, 184, 0.45) 0%, transparent 55%),
-          linear-gradient(180deg, #0f2847 0%, #0a1a30 100%);
+        background: #141a16;
       }
-      .omnl-boot__title {
-        font-size: 1.1rem;
-        letter-spacing: 0.12em;
-        text-transform: uppercase;
-        color: #00d4ff;
-      }
-      .omnl-boot__hint { color: #9bb8d4; font-size: 0.9rem; }
+      .omnl-boot__title { font-size: 1.125rem; font-weight: 600; color: #eaecef; }
+      .omnl-boot__hint { color: #848e9c; font-size: 0.875rem; }
     </style>
   </head>
   <body>
     <div id="root">
       <div class="omnl-boot" role="status" aria-live="polite">
-        <div class="omnl-boot__title">OMNL Mission Control</div>
-        <div class="omnl-boot__hint">Loading dashboard...</div>
+        <div class="omnl-boot__title">DBIS</div>
+        <div class="omnl-boot__hint">Loading…</div>
       </div>
     </div>
     <script type="module" src="/src/main.tsx"></script>
diff --git a/frontend-dapp/package.json b/frontend-dapp/package.json
index 4cb940f..593c8f6 100644
--- a/frontend-dapp/package.json
+++ b/frontend-dapp/package.json
@@ -3,8 +3,15 @@
   "version": "1.0.0",
   "type": "module",
   "scripts": {
+    "predev": "node scripts/sync-omnl-consoles.mjs",
     "dev": "vite",
+    "prebuild": "node scripts/sync-omnl-consoles.mjs",
     "build": "node --max-old-space-size=4096 ./node_modules/vite/bin/vite.js build",
+    "build:omnl": "node --max-old-space-size=4096 ./node_modules/vite/bin/vite.js build",
+    "build:z": "node scripts/build-z.mjs",
+    "prebuild:omnl": "node scripts/sync-omnl-consoles.mjs",
+    "prebuild:z": "node -e \"console.log('Z build - skipping OMNL console sync')\"",
+    "serve:portal": "node scripts/portal-serve.mjs",
     "build:check": "tsc && NODE_OPTIONS='--max-old-space-size=4096' vite build",
     "preview": "vite preview",
     "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
@@ -15,6 +22,7 @@
   "dependencies": {
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.1",
+    "@lit/reactive-element": "^2.1.2",
     "@safe-global/api-kit": "^4.0.1",
     "@safe-global/protocol-kit": "^1.3.0",
     "@tanstack/react-query": "^5.90.21",
@@ -52,6 +60,7 @@
     "eslint-plugin-react-refresh": "^0.4.26",
     "identity-obj-proxy": "^3.0.0",
     "jsdom": "^23.2.0",
+    "serve": "^14.2.6",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
     "vite": "^5.4.21",
diff --git a/frontend-dapp/public/omnl/compliance/index.html b/frontend-dapp/public/omnl/compliance/index.html
new file mode 100644
index 0000000..37c848d
--- /dev/null
+++ b/frontend-dapp/public/omnl/compliance/index.html
@@ -0,0 +1,84 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="omnl-api-base" content="auto" />
+  <title>OMNL Compliance Console</title>
+  <link rel="stylesheet" href="/omnl/static/omnl-compliance-console.css" />
+</head>
+<body>
+  <div class="wrap">
+    <header>
+      <div>
+        <h1>OMNL Compliance Console</h1>
+        <p class="sub">HYBX · IPSAS / IFRS / US GAAP · Web3 notary &amp; reserve attestation · Chain 138</p>
+      </div>
+      <div class="toolbar">
+        <button type="button" id="btn-refresh">Refresh</button>
+        <button type="button" class="primary" id="btn-download-safe">Download Safe tx</button>
+        <button type="button" id="btn-toggle-raw">Raw JSON</button>
+        <a class="btn" href="/omnl/dashboard">Legacy dashboard</a>
+        <a class="btn" href="/api/v1/omnl/openapi.json">OpenAPI</a>
+      </div>
+    </header>
+
+    <div id="load-status" class="status-bar loading">Initializing…</div>
+    <p id="refreshed-at" class="sub" style="margin-top:-0.5rem"></p>
+
+    <section class="section">
+      <h2>Posture</h2>
+      <div id="posture-grid" class="grid"></div>
+    </section>
+
+    <section class="section">
+      <h2>Pending actions</h2>
+      <div id="pending-actions"></div>
+    </section>
+
+    <div class="grid" style="grid-template-columns: repeat(auto-fit, minmax(18rem, 1fr));">
+      <section class="section card">
+        <h2>On-chain evidence</h2>
+        <div id="evidence-kv"></div>
+      </section>
+      <section class="section card">
+        <h2>Gnosis Safe</h2>
+        <div id="safe-kv"></div>
+      </section>
+      <section class="section card">
+        <h2>External visibility</h2>
+        <div id="external-kv"></div>
+      </section>
+    </div>
+
+    <section class="section card">
+      <h2>HO nostro &amp; reserve coverage</h2>
+      <div id="ho-liquidity-kv"></div>
+    </section>
+
+    <section class="section card">
+      <h2>Triple-state reconcile</h2>
+      <div id="triple-summary"></div>
+    </section>
+
+    <section class="section card">
+      <h2>Sign-offs</h2>
+      <div id="signoffs-summary"></div>
+    </section>
+
+    <section id="raw-section" class="section hidden">
+      <h2>Full snapshot</h2>
+      <pre id="raw-json" class="raw">{}</pre>
+    </section>
+
+    <footer>
+      <p>
+        Auth: pass <code>?access_token=</code> when <code>OMNL_API_KEY</code> or <code>OMNL_DASHBOARD_TOKEN</code> is set.
+        API: <a href="/api/v1/omnl/compliance/console">/api/v1/omnl/compliance/console</a>
+      </p>
+    </footer>
+  </div>
+  <script src="/omnl/static/omnl-api-base.js"></script>
+  <script src="/omnl/static/omnl-compliance-console.js"></script>
+</body>
+</html>
diff --git a/frontend-dapp/public/omnl/dashboard/index.html b/frontend-dapp/public/omnl/dashboard/index.html
new file mode 100644
index 0000000..0c475a7
--- /dev/null
+++ b/frontend-dapp/public/omnl/dashboard/index.html
@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+  <title>HYBX OMNL — status</title>
+  <style>
+    body { font-family: system-ui, sans-serif; margin: 1.5rem; max-width: 56rem; overflow-x: hidden; }
+    h1 { font-size: 1.25rem; }
+    pre { background: #111; color: #eee; padding: 1rem; overflow: auto; border-radius: 6px; font-size: 12px; -webkit-overflow-scrolling: touch; }
+    .err { color: #f66; }
+    a { color: #6cf; word-break: break-word; }
+    @media (max-width: 640px) {
+      body { margin: 1rem 0.75rem; }
+      h1 { font-size: 1.1rem; }
+      p { font-size: 0.9rem; }
+    }
+  </style>
+</head>
+<body>
+  <h1>OMNL API snapshot</h1>
+  <p><a href="/omnl/compliance"><strong>→ OMNL Compliance Console</strong></a> (posture, pending actions, Safe tx download)</p>
+  <p>Reads <code>/api/v1/omnl/ipsas/registry</code> and <code>/api/v1/omnl/ipsas/fineract-compare</code> (503 if Fineract env missing; 401 if <code>OMNL_API_KEY</code> is set and no <code>access_token</code> in this page URL).</p>
+  <p><a href="/api/v1/omnl/openapi.json">OpenAPI 3 JSON</a> · <a href="/api/v1/omnl/catalog">OMNL API catalog</a> · <a href="/api/v1/omnl/integration-status">integration status</a> · <a href="/api/v1/omnl/ipsas/registry">registry JSON</a> · <a href="/api/v1/omnl/ipsas/matrix">matrix JSON</a> · <a href="/api/v1/omnl/ipsas/fineract-health">Fineract health</a></p>
+  <h2>IPSAS registry</h2>
+  <pre id="reg">Loading…</pre>
+  <h2>Fineract compare</h2>
+  <pre id="fin">Loading…</pre>
+  <script src="/omnl/static/omnl-api-base.js"></script>
+  <script>
+    (function () {
+      const params = new URLSearchParams(window.location.search);
+      const accessToken = params.get('access_token') || '';
+      const apiBase = window.resolveOmnlApiBase ? window.resolveOmnlApiBase() : '/api/v1';
+      const apiHeaders = accessToken ? { Authorization: 'Bearer ' + accessToken } : {};
+      async function load() {
+        try {
+          const r = await fetch(apiBase + '/omnl/ipsas/registry');
+          document.getElementById('reg').textContent = JSON.stringify(await r.json(), null, 2);
+        } catch (e) {
+          document.getElementById('reg').innerHTML = '<span class="err">' + e + '</span>';
+        }
+        try {
+          const f = await fetch(apiBase + '/omnl/ipsas/fineract-compare', { headers: apiHeaders });
+          const t = await f.text();
+          document.getElementById('fin').textContent = t;
+        } catch (e) {
+          document.getElementById('fin').innerHTML = '<span class="err">' + e + '</span>';
+        }
+      }
+      load();
+    })();
+  </script>
+</body>
+</html>
diff --git a/frontend-dapp/public/omnl/static/omnl-api-base.js b/frontend-dapp/public/omnl/static/omnl-api-base.js
new file mode 100644
index 0000000..2f79ad0
--- /dev/null
+++ b/frontend-dapp/public/omnl/static/omnl-api-base.js
@@ -0,0 +1,8 @@
+(function () {
+  /** auto → same-origin /api/v1 (vite proxy, portal-serve, or token-aggregation). */
+  window.resolveOmnlApiBase = function () {
+    const meta = document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content')?.trim();
+    if (meta && meta !== 'auto') return meta.replace(/\/$/, '');
+    return '/api/v1';
+  };
+})();
diff --git a/frontend-dapp/public/omnl/static/omnl-compliance-console.css b/frontend-dapp/public/omnl/static/omnl-compliance-console.css
new file mode 100644
index 0000000..41ed3ec
--- /dev/null
+++ b/frontend-dapp/public/omnl/static/omnl-compliance-console.css
@@ -0,0 +1,219 @@
+:root {
+  --bg: #0c0f14;
+  --panel: #141a22;
+  --border: #243044;
+  --text: #e8edf4;
+  --muted: #8b9cb3;
+  --ok: #3dd68c;
+  --warn: #f5c542;
+  --bad: #f07178;
+  --accent: #4ade80;
+  --mono: ui-monospace, 'Cascadia Code', 'SF Mono', monospace;
+}
+
+* { box-sizing: border-box; }
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.45;
+}
+
+.wrap {
+  max-width: 72rem;
+  margin: 0 auto;
+  padding: 1.25rem 1rem 3rem;
+}
+
+header {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem 1.5rem;
+  align-items: baseline;
+  justify-content: space-between;
+  margin-bottom: 1.25rem;
+}
+
+h1 {
+  font-size: 1.35rem;
+  font-weight: 650;
+  margin: 0;
+}
+
+.sub {
+  color: var(--muted);
+  font-size: 0.9rem;
+  margin: 0.25rem 0 0;
+}
+
+.toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  align-items: center;
+}
+
+button, .btn {
+  appearance: none;
+  border: 1px solid var(--border);
+  background: var(--panel);
+  color: var(--text);
+  border-radius: 8px;
+  padding: 0.45rem 0.75rem;
+  font-size: 0.85rem;
+  cursor: pointer;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+}
+
+button:hover, .btn:hover { border-color: var(--accent); color: var(--accent); }
+button.primary { background: #14532d; border-color: #22c55e; }
+button.primary:hover { background: #166534; }
+
+.grid {
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr));
+  margin-bottom: 1rem;
+}
+
+.card {
+  background: var(--panel);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 1rem;
+}
+
+.card h2 {
+  font-size: 0.78rem;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: var(--muted);
+  margin: 0 0 0.75rem;
+}
+
+.section { margin-bottom: 1.25rem; }
+
+.section > h2 {
+  font-size: 1rem;
+  margin: 0 0 0.65rem;
+}
+
+.badge {
+  display: inline-block;
+  padding: 0.2rem 0.55rem;
+  border-radius: 999px;
+  font-size: 0.78rem;
+  font-weight: 600;
+  border: 1px solid transparent;
+}
+
+.badge.ok { background: #143528; color: var(--ok); border-color: #2a6b4a; }
+.badge.warn { background: #3a3014; color: var(--warn); border-color: #6b5620; }
+.badge.bad { background: #3a1c20; color: var(--bad); border-color: #6b3038; }
+.badge.neutral { background: #1c2430; color: var(--muted); border-color: var(--border); }
+
+.metric {
+  font-size: 1.1rem;
+  font-weight: 650;
+}
+
+.metric small {
+  display: block;
+  font-size: 0.78rem;
+  font-weight: 400;
+  color: var(--muted);
+  margin-top: 0.15rem;
+}
+
+.actions-list { list-style: none; padding: 0; margin: 0; }
+
+.actions-list li {
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 0.85rem 1rem;
+  margin-bottom: 0.65rem;
+  background: #10151c;
+}
+
+.actions-list h3 {
+  margin: 0 0 0.35rem;
+  font-size: 0.95rem;
+}
+
+.actions-list p {
+  margin: 0 0 0.5rem;
+  color: var(--muted);
+  font-size: 0.88rem;
+}
+
+.link-row { display: flex; flex-wrap: wrap; gap: 0.5rem; }
+
+.link-row a {
+  color: var(--accent);
+  font-size: 0.82rem;
+  text-decoration: none;
+}
+
+.link-row a:hover { text-decoration: underline; }
+
+.kv {
+  display: grid;
+  grid-template-columns: minmax(8rem, 11rem) 1fr;
+  gap: 0.35rem 0.75rem;
+  font-size: 0.86rem;
+}
+
+.kv dt { color: var(--muted); margin: 0; }
+.kv dd { margin: 0; font-family: var(--mono); font-size: 0.8rem; word-break: break-all; }
+
+pre.raw {
+  background: #090c10;
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 0.85rem;
+  overflow: auto;
+  font-size: 0.72rem;
+  line-height: 1.35;
+  max-height: 24rem;
+}
+
+.status-bar {
+  padding: 0.65rem 0.85rem;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  font-size: 0.88rem;
+}
+
+.status-bar.loading { background: #1a2430; color: var(--muted); }
+.status-bar.error { background: #3a1c20; color: var(--bad); }
+.status-bar.ok { background: #143528; color: var(--ok); }
+
+.hidden { display: none !important; }
+
+footer {
+  margin-top: 2rem;
+  color: var(--muted);
+  font-size: 0.8rem;
+}
+
+footer a { color: var(--accent); }
+
+@media (max-width: 640px) {
+  .kv { grid-template-columns: 1fr; }
+  .wrap { padding-left: 0.75rem; padding-right: 0.75rem; }
+  header { flex-direction: column; align-items: stretch; }
+  .toolbar { width: 100%; }
+  .toolbar button,
+  .toolbar .btn {
+    min-height: 44px;
+    flex: 1 1 calc(50% - 0.25rem);
+    justify-content: center;
+  }
+  h1 { font-size: 1.15rem; }
+  pre, table { font-size: 12px; }
+}
diff --git a/frontend-dapp/public/omnl/static/omnl-compliance-console.js b/frontend-dapp/public/omnl/static/omnl-compliance-console.js
new file mode 100644
index 0000000..e4b878c
--- /dev/null
+++ b/frontend-dapp/public/omnl/static/omnl-compliance-console.js
@@ -0,0 +1,255 @@
+(function () {
+  const params = new URLSearchParams(window.location.search);
+  const accessToken = params.get('access_token') || '';
+  const apiBase = window.resolveOmnlApiBase
+    ? window.resolveOmnlApiBase()
+    : document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content')?.trim() || '/api/v1';
+
+  const els = {
+    status: document.getElementById('load-status'),
+    grid: document.getElementById('posture-grid'),
+    actions: document.getElementById('pending-actions'),
+    evidence: document.getElementById('evidence-kv'),
+    safe: document.getElementById('safe-kv'),
+    external: document.getElementById('external-kv'),
+    triple: document.getElementById('triple-summary'),
+    hoLiquidity: document.getElementById('ho-liquidity-kv'),
+    signoffs: document.getElementById('signoffs-summary'),
+    raw: document.getElementById('raw-json'),
+    refreshed: document.getElementById('refreshed-at'),
+  };
+
+  function apiHeaders() {
+    const h = { Accept: 'application/json' };
+    if (accessToken) h.Authorization = 'Bearer ' + accessToken;
+    return h;
+  }
+
+  function apiUrl(path) {
+    const base = apiBase.replace(/\/$/, '');
+    const rel = path.startsWith('/') ? path : '/' + path;
+    const u = new URL(base + rel, window.location.origin);
+    if (accessToken) u.searchParams.set('access_token', accessToken);
+    return u.toString();
+  }
+
+  function badge(ok, okLabel, badLabel) {
+    if (ok === true) return '<span class="badge ok">' + okLabel + '</span>';
+    if (ok === false) return '<span class="badge bad">' + badLabel + '</span>';
+    return '<span class="badge neutral">Unknown</span>';
+  }
+
+  function sevBadge(sev) {
+    const map = { critical: 'bad', high: 'bad', medium: 'warn', low: 'neutral' };
+    return '<span class="badge ' + (map[sev] || 'neutral') + '">' + sev + '</span>';
+  }
+
+  function renderPosture(data) {
+    const p = data.posture || {};
+    els.grid.innerHTML = [
+      card('Reporting', badge(p.reportingCompliant, 'Compliant', 'Not compliant'), ''),
+      card('Attestation', badge(!p.attestationStale, 'Fresh', 'Stale'), ''),
+      card('Triple reconcile', badge(p.tripleAligned, 'Aligned', 'Breaks'), ''),
+      card('Notary gate', badge(p.requireNotarizedEvidence, 'Enforced', 'Not enforced'), 'requireNotarizedEvidence'),
+      card('Threshold', '<div class="metric">' + (p.complianceThreshold || '—') + '</div>', 'IPSAS / IFRS / US GAAP'),
+      card('Policy v', '<div class="metric">' + (p.jurisdictionPolicyVersion ?? '—') + '</div>', 'ID jurisdiction'),
+    ].join('');
+  }
+
+  function card(title, body, sub) {
+    return (
+      '<div class="card"><h2>' +
+      title +
+      '</h2>' +
+      body +
+      (sub ? '<small style="color:var(--muted);font-size:0.78rem">' + sub + '</small>' : '') +
+      '</div>'
+    );
+  }
+
+  function renderActions(actions) {
+    if (!actions || !actions.length) {
+      els.actions.innerHTML = '<p style="color:var(--muted)">No pending actions.</p>';
+      return;
+    }
+    els.actions.innerHTML =
+      '<ul class="actions-list">' +
+      actions
+        .map(function (a) {
+          const links = (a.links || [])
+            .map(function (l) {
+              const href = l.href.startsWith('http') ? l.href : apiUrl(l.href);
+              const dl = l.href.indexOf('safe-notary-gate-tx') >= 0 ? ' download="omnl-safe-notary-gate-tx.json"' : '';
+              return '<a href="' + href + '"' + dl + '>' + l.label + '</a>';
+            })
+            .join('');
+          return (
+            '<li><h3>' +
+            sevBadge(a.severity) +
+            ' ' +
+            esc(a.title) +
+            '</h3><p>' +
+            esc(a.detail) +
+            '</p><div class="link-row">' +
+            links +
+            '</div></li>'
+          );
+        })
+        .join('') +
+      '</ul>';
+  }
+
+  function kv(rows) {
+    return (
+      '<dl class="kv">' +
+      rows
+        .map(function (r) {
+          return '<dt>' + esc(r[0]) + '</dt><dd>' + esc(String(r[1] ?? '—')) + '</dd>';
+        })
+        .join('') +
+      '</dl>'
+    );
+  }
+
+  function renderEvidence(data) {
+    const pr = data.proofReport;
+    const gate = data.onChainGate || {};
+    const triple = data.tripleReconcile;
+    els.evidence.innerHTML = kv([
+      ['Evidence hash', pr && pr.evidenceHash],
+      ['Merkle root', pr && pr.merkleRoot],
+      ['Package 3-of-3', pr && pr.packageNotarized3of3],
+      ['Reserve 3-of-3', pr && pr.reserveAttested3of3],
+      ['Reserve store', gate.reserveStore],
+      ['Notary registry', gate.notaryRegistry],
+      ['Attestation threshold', gate.attestationThreshold],
+      ['On-chain R', triple && triple.onChain && triple.onChain.r],
+    ]);
+  }
+
+  function renderSafe(data) {
+    const pr = data.proofReport;
+    const g = (pr && pr.gnosisSafe) || {};
+    const sw = data.safeWallet || {};
+    els.safe.innerHTML = kv([
+      ['Admin Safe', g.address || data.web3.deployed.GnosisSafeAdmin],
+      ['Threshold', g.threshold ? g.threshold + '-of-' + g.owners : '—'],
+      ['Safe Wallet registry', sw.npmRegistryHas138 ? 'chain 138 listed' : 'pending PR #1568'],
+      ['Registry status', sw.status],
+    ]);
+  }
+
+  function renderExternal(data) {
+    const ev = data.externalVisibility || {};
+    const guosmm = ev.guosmmGazette || {};
+    const noticeLinks = (guosmm.notices || [])
+      .map(function (n) {
+        return '<a href="' + esc(n.url) + '" target="_blank" rel="noopener">' + esc(n.documentId) + '</a>';
+      })
+      .join(' · ');
+    els.external.innerHTML =
+      kv([
+        ['GUOSMM gazette', guosmm.base || '—'],
+        ['API registry', guosmm.apiRegistry || '/api/v1/omnl/gazette/notices'],
+        ['Notices', noticeLinks || '—'],
+        ['DefiLlama chain', ev.defiLlama && ev.defiLlama.chainPage],
+        ['Pricing PR', ev.defiLlama && ev.defiLlama.pr12094],
+        ['Bridge TVL PR', ev.defiLlama && ev.defiLlama.pr19451],
+        ['Safe deployments PR', ev.safeDeployments && ev.safeDeployments.pr1568],
+      ]);
+  }
+
+  function renderHoLiquidity(snap) {
+    if (!els.hoLiquidity) return;
+    if (!snap) {
+      els.hoLiquidity.textContent = 'HO liquidity snapshot unavailable.';
+      return;
+    }
+    const cash = snap.cashInBank || {};
+    const cov = snap.reserveCoverage || {};
+    els.hoLiquidity.innerHTML = kv([
+      ['Generated', snap.generatedAt],
+      ['Nostro cash (GL 13010)', cash.cashInBankUsd != null ? '$' + Number(cash.cashInBankUsd).toLocaleString() : '—'],
+      ['Reserve coverage', cov.coverageRatio != null ? cov.coverageRatio.toFixed(2) + '×' : '—'],
+      ['Reserve assets', cov.reserveAssetsUsd != null ? '$' + Number(cov.reserveAssetsUsd).toLocaleString() : '—'],
+      ['Issued c* USD', cov.issuedCStarUsd != null ? '$' + Number(cov.issuedCStarUsd).toLocaleString() : '—'],
+      ['Public API', apiBase + '/omnl/ho-liquidity-snapshot'],
+    ]);
+  }
+
+  function renderTriple(data) {
+    const t = data.tripleReconcile;
+    if (!t) {
+      els.triple.textContent = 'Triple-state reconcile unavailable.';
+      return;
+    }
+    const breaks = (t.breaks || []).length;
+    els.triple.innerHTML =
+      badge(t.aligned, 'Aligned', breaks + ' break(s)') +
+      ' <span style="color:var(--muted);margin-left:0.5rem;font-size:0.88rem">line ' +
+      esc(t.lineId).slice(0, 18) +
+      '…</span>';
+  }
+
+  function renderSignoffs(data) {
+    const s = data.signoffs || {};
+    els.signoffs.innerHTML = '<pre class="raw" style="max-height:10rem">' + esc(JSON.stringify(s, null, 2)) + '</pre>';
+  }
+
+  function esc(s) {
+    return String(s)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;');
+  }
+
+  function setStatus(kind, msg) {
+    els.status.className = 'status-bar ' + kind;
+    els.status.textContent = msg;
+  }
+
+  async function load() {
+    setStatus('loading', 'Loading compliance console…');
+    try {
+      const res = await fetch(apiUrl('/omnl/compliance/console'), { headers: apiHeaders() });
+      const text = await res.text();
+      let data;
+      try {
+        data = JSON.parse(text);
+      } catch {
+        throw new Error(res.status + ' — non-JSON response');
+      }
+      if (!res.ok) throw new Error(data.error || res.statusText);
+
+      renderPosture(data);
+      renderActions(data.pendingActions);
+      renderEvidence(data);
+      renderSafe(data);
+      renderExternal(data);
+      renderTriple(data);
+      try {
+        const hoRes = await fetch(apiUrl('/omnl/ho-liquidity-snapshot'), { headers: apiHeaders() });
+        if (hoRes.ok) renderHoLiquidity(await hoRes.json());
+      } catch (_) {
+        renderHoLiquidity(null);
+      }
+      renderSignoffs(data);
+      els.raw.textContent = JSON.stringify(data, null, 2);
+      els.refreshed.textContent = 'Updated ' + new Date(data.generatedAt).toLocaleString();
+      setStatus('ok', 'Live — ' + data.pendingActions.length + ' pending action(s)');
+    } catch (e) {
+      setStatus('error', 'Failed to load: ' + (e && e.message ? e.message : e));
+    }
+  }
+
+  document.getElementById('btn-refresh').addEventListener('click', load);
+  document.getElementById('btn-download-safe').addEventListener('click', function () {
+    window.location.href = apiUrl('/omnl/compliance/safe-notary-gate-tx');
+  });
+  document.getElementById('btn-toggle-raw').addEventListener('click', function () {
+    document.getElementById('raw-section').classList.toggle('hidden');
+  });
+
+  load();
+})();
diff --git a/frontend-dapp/public/omnl/static/omnl-settlement-terminal.css b/frontend-dapp/public/omnl/static/omnl-settlement-terminal.css
new file mode 100644
index 0000000..74a8da0
--- /dev/null
+++ b/frontend-dapp/public/omnl/static/omnl-settlement-terminal.css
@@ -0,0 +1,190 @@
+:root {
+  --font-mono: "Consolas", "Lucida Console", "Courier New", monospace;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  font-family: system-ui, sans-serif;
+}
+
+body.theme-black {
+  background: #0a0a0a;
+  color: #33ff66;
+}
+
+body.theme-color {
+  background: #d8d8d8;
+  color: #111;
+}
+
+.layout {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 1rem 1.25rem 2rem;
+}
+
+.topbar {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  gap: 1rem;
+  align-items: flex-start;
+  margin-bottom: 1rem;
+}
+
+h1 {
+  font-size: 1.15rem;
+  margin: 0 0 0.25rem;
+}
+
+.sub {
+  margin: 0;
+  opacity: 0.85;
+  font-size: 0.85rem;
+}
+
+.toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+
+button,
+.btn {
+  font: inherit;
+  cursor: pointer;
+  border: 1px solid currentColor;
+  background: transparent;
+  color: inherit;
+  padding: 0.35rem 0.65rem;
+  border-radius: 4px;
+  text-decoration: none;
+  font-size: 0.85rem;
+}
+
+button.active {
+  font-weight: 700;
+}
+
+.card {
+  border: 1px solid currentColor;
+  border-radius: 6px;
+  padding: 0.75rem;
+  margin-bottom: 1rem;
+}
+
+.params {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(10rem, 1fr));
+  gap: 0.75rem;
+}
+
+.params label {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+.params input {
+  font: inherit;
+  padding: 0.35rem 0.5rem;
+  border: 1px solid currentColor;
+  background: transparent;
+  color: inherit;
+  border-radius: 4px;
+}
+
+.main {
+  display: grid;
+  grid-template-columns: 1fr min(22rem, 100%);
+  gap: 1rem;
+}
+
+@media (max-width: 900px) {
+  .main {
+    grid-template-columns: 1fr;
+  }
+}
+
+.terminal {
+  margin: 0;
+  min-height: 28rem;
+  max-height: 70vh;
+  overflow: auto;
+  font-family: var(--font-mono);
+  font-size: 0.78rem;
+  line-height: 1.35;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+body.theme-black .terminal {
+  background: #000;
+  color: #33ff66;
+  padding: 1rem;
+}
+
+body.theme-color .terminal {
+  background: #ececec;
+  color: #111;
+  padding: 1rem;
+}
+
+.side h2 {
+  font-size: 0.85rem;
+  margin: 0 0 0.5rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.cmd-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.35rem;
+  margin-bottom: 0.75rem;
+}
+
+.alchemy-row {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  font-size: 0.75rem;
+  margin-bottom: 0.75rem;
+}
+
+.alchemy-row input {
+  font: inherit;
+  padding: 0.35rem;
+  border: 1px solid currentColor;
+  background: transparent;
+  color: inherit;
+  border-radius: 4px;
+}
+
+.json-out {
+  margin: 0;
+  max-height: 16rem;
+  overflow: auto;
+  font-family: var(--font-mono);
+  font-size: 0.7rem;
+  white-space: pre-wrap;
+  word-break: break-word;
+  opacity: 0.9;
+}
+
+footer {
+  font-size: 0.75rem;
+  opacity: 0.8;
+}
+
+footer code {
+  font-family: var(--font-mono);
+}
diff --git a/frontend-dapp/public/omnl/static/omnl-settlement-terminal.js b/frontend-dapp/public/omnl/static/omnl-settlement-terminal.js
new file mode 100644
index 0000000..09e8174
--- /dev/null
+++ b/frontend-dapp/public/omnl/static/omnl-settlement-terminal.js
@@ -0,0 +1,219 @@
+(function () {
+  const API_BASE = window.resolveOmnlApiBase
+    ? window.resolveOmnlApiBase()
+    : document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content') || '/api/v1';
+  const screenEl = document.getElementById('terminal-screen');
+  const jsonEl = document.getElementById('json-out');
+  const inpRef = document.getElementById('inp-settlement-ref');
+  const inpOffice = document.getElementById('inp-office-id');
+  const inpDate = document.getElementById('inp-value-date');
+  const inpAmount = document.getElementById('inp-amount');
+  const inpToken = document.getElementById('inp-token');
+  const inpAlchemyAddr = document.getElementById('inp-alchemy-addr');
+
+  let screenMode = 'black';
+
+  const inpConnection = document.getElementById('inp-connection');
+  const DEFAULT_CONNECTION = 'mk-albert-gate-limited';
+  const DEFAULT_WALLET = '0xb3B416BdE671c256aAbFB56358baD91D46BB9c39';
+
+  (function initFromQuery() {
+    const p = new URLSearchParams(window.location.search);
+    const conn = p.get('connectionId') || DEFAULT_CONNECTION;
+    if (inpConnection) inpConnection.value = conn;
+    const ref = p.get('settlementRef');
+    if (ref) inpRef.value = ref;
+  })();
+
+  function qs() {
+    const p = new URLSearchParams(window.location.search);
+    const token = inpToken.value.trim() || p.get('access_token') || '';
+    const q = new URLSearchParams({
+      settlementRef: inpRef.value.trim(),
+      officeId: String(inpOffice.value || '1'),
+      valueDate: inpDate.value,
+      amountUsd: inpAmount.value.trim(),
+    });
+    const conn = inpConnection && inpConnection.value ? inpConnection.value.trim() : '';
+    if (conn) q.set('connectionId', conn);
+    if (token) q.set('access_token', token);
+    return q;
+  }
+
+  function authHeaders() {
+    const token = inpToken.value.trim() || new URLSearchParams(window.location.search).get('access_token') || '';
+    return token ? { Authorization: 'Bearer ' + token } : {};
+  }
+
+  async function apiGet(path, extra) {
+    const q = qs();
+    if (extra) {
+      Object.entries(extra).forEach(function (kv) {
+        q.set(kv[0], kv[1]);
+      });
+    }
+    const res = await fetch(API_BASE + path + '?' + q.toString(), { headers: authHeaders() });
+    const text = await res.text();
+    let data;
+    try {
+      data = JSON.parse(text);
+    } catch {
+      data = { raw: text, status: res.status };
+    }
+    if (!res.ok) throw new Error(data.error || data.raw || res.statusText);
+    return data;
+  }
+
+  async function apiPost(path, body) {
+    const q = qs();
+    const res = await fetch(API_BASE + path + '?' + q.toString(), {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', ...authHeaders() },
+      body: JSON.stringify(body),
+    });
+    const data = await res.json().catch(function () {
+      return {};
+    });
+    if (!res.ok) throw new Error(data.error || res.statusText);
+    return data;
+  }
+
+  function showJson(data) {
+    jsonEl.textContent = JSON.stringify(data, null, 2);
+  }
+
+  function showScreen(text) {
+    screenEl.textContent = text;
+  }
+
+  function setTheme(mode) {
+    screenMode = mode === 'color' ? 'color' : 'black';
+    document.body.classList.toggle('theme-black', screenMode === 'black');
+    document.body.classList.toggle('theme-color', screenMode === 'color');
+    document.getElementById('btn-mode-black').classList.toggle('active', screenMode === 'black');
+    document.getElementById('btn-mode-color').classList.toggle('active', screenMode === 'color');
+  }
+
+  async function loadScreen(artifact) {
+    const data = await apiGet('/omnl/terminal/screen', {
+      mode: screenMode,
+      artifact: artifact || 'package',
+      format: 'json',
+    });
+    showScreen(data.text || '');
+    showJson(data);
+  }
+
+  async function runCmd(cmd) {
+    try {
+      if (cmd === 'help') {
+        showScreen(
+          [
+            'OMNL / HYBX SETTLEMENT TERMINAL — COMMANDS',
+            '',
+            '  status          — integration status',
+            '  package         — full JSON package',
+            '  pof             — proof of funds',
+            '  debit-note      — debit note',
+            '  remittance      — remittance advice',
+            '  token-san       — tokenization sanitized copy',
+            '  swift-copy      — conversion SWIFT copy',
+            '  screen          — terminal screen (current theme)',
+            '  alchemy balance — eth_getBalance via Alchemy',
+            '',
+            'Toggle Black/Green vs Gray/Black with toolbar buttons.',
+          ].join('\n')
+        );
+        return;
+      }
+      if (cmd === 'status') {
+        const q = qs();
+        const token = q.get('access_token');
+        const url = API_BASE + '/omnl/terminal/status' + (token ? '?access_token=' + encodeURIComponent(token) : '');
+        const data = await fetch(url, { headers: authHeaders() }).then(function (r) {
+          return r.json();
+        });
+        showJson(data);
+        showScreen(JSON.stringify(data, null, 2));
+        return;
+      }
+      if (cmd === 'package') {
+        const data = await apiGet('/omnl/terminal/package');
+        showJson(data);
+        if (data.artifacts && data.artifacts.screens) {
+          showScreen(data.artifacts.screens[screenMode] || '');
+        }
+        return;
+      }
+      if (cmd === 'pof') {
+        const data = await apiGet('/omnl/terminal/proof-of-funds');
+        showJson(data);
+        await loadScreen('proof-of-funds');
+        return;
+      }
+      if (cmd === 'debit') {
+        const data = await apiGet('/omnl/terminal/debit-note');
+        showJson(data);
+        await loadScreen('debit-note');
+        return;
+      }
+      if (cmd === 'remittance') {
+        const data = await apiGet('/omnl/terminal/remittance-advice');
+        showJson(data);
+        await loadScreen('remittance-advice');
+        return;
+      }
+      if (cmd === 'token') {
+        const data = await apiGet('/omnl/terminal/tokenization-sanitized');
+        showJson(data);
+        await loadScreen('tokenization-sanitized');
+        return;
+      }
+      if (cmd === 'swift') {
+        const data = await apiGet('/omnl/terminal/conversion-swift-copy');
+        showJson(data);
+        await loadScreen('conversion-swift-copy');
+        return;
+      }
+      if (cmd === 'screen') {
+        await loadScreen('package');
+        return;
+      }
+      if (cmd === 'alchemy-balance') {
+        const addr = (inpAlchemyAddr.value || '').trim();
+        if (!addr) throw new Error('Set Alchemy address first');
+        const data = await apiPost('/omnl/terminal/alchemy/rpc', {
+          network: 'eth-mainnet',
+          method: 'eth_getBalance',
+          params: [addr, 'latest'],
+          connectionId: (inpConnection && inpConnection.value) || DEFAULT_CONNECTION,
+        });
+        showJson(data);
+        showScreen('ALCHEMY eth_getBalance\nADDRESS: ' + addr + '\nRESULT: ' + data.result);
+        return;
+      }
+    } catch (e) {
+      showScreen('ERROR: ' + (e && e.message ? e.message : String(e)));
+    }
+  }
+
+  document.getElementById('btn-mode-black').addEventListener('click', function () {
+    setTheme('black');
+    runCmd('screen');
+  });
+  document.getElementById('btn-mode-color').addEventListener('click', function () {
+    setTheme('color');
+    runCmd('screen');
+  });
+  document.getElementById('btn-refresh').addEventListener('click', function () {
+    runCmd('screen');
+  });
+  document.querySelectorAll('[data-cmd]').forEach(function (btn) {
+    btn.addEventListener('click', function () {
+      runCmd(btn.getAttribute('data-cmd'));
+    });
+  });
+
+  setTheme('black');
+  runCmd('screen');
+})();
diff --git a/frontend-dapp/public/omnl/terminal/index.html b/frontend-dapp/public/omnl/terminal/index.html
new file mode 100644
index 0000000..17803b4
--- /dev/null
+++ b/frontend-dapp/public/omnl/terminal/index.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="omnl-api-base" content="auto" />
+  <title>OMNL / HYBX Settlement Terminal</title>
+  <link rel="stylesheet" href="/omnl/static/omnl-settlement-terminal.css" />
+</head>
+<body class="theme-black">
+  <div class="layout">
+    <header class="topbar">
+      <div>
+        <h1>OMNL / HYBX Settlement Terminal</h1>
+        <p class="sub">Fineract SoR · Alchemy on-chain · institutional document API</p>
+      </div>
+      <div class="toolbar">
+        <button type="button" id="btn-mode-black" class="active">Black / Green</button>
+        <button type="button" id="btn-mode-color">Gray / Black</button>
+        <button type="button" id="btn-refresh">Refresh</button>
+        <a class="btn" href="/omnl/compliance">Compliance</a>
+        <a class="btn" href="/api/v1/omnl/terminal/status">Status JSON</a>
+      </div>
+    </header>
+
+    <section class="params card">
+      <label>Connection
+        <select id="inp-connection">
+          <option value="mk-albert-gate-limited" selected>MK Albert Gate Limited</option>
+          <option value="">(none — legacy defaults)</option>
+        </select>
+      </label>
+      <label>Settlement ref <input id="inp-settlement-ref" type="text" value="MK-ALBERT-GATE-20260529" /></label>
+      <label>Office ID <input id="inp-office-id" type="number" value="1" min="1" /></label>
+      <label>Value date <input id="inp-value-date" type="date" value="2026-03-17" /></label>
+      <label>Amount USD <input id="inp-amount" type="text" value="1000000000.00" /></label>
+      <label>API token <input id="inp-token" type="password" placeholder="OMNL_API_KEY (optional)" autocomplete="off" /></label>
+    </section>
+
+    <div class="main">
+      <section class="screen-wrap card">
+        <pre id="terminal-screen" class="terminal" aria-live="polite">Loading…</pre>
+      </section>
+      <aside class="side card">
+        <h2>Commands</h2>
+        <div class="cmd-grid">
+          <button type="button" data-cmd="help">help</button>
+          <button type="button" data-cmd="status">status</button>
+          <button type="button" data-cmd="package">package</button>
+          <button type="button" data-cmd="pof">pof</button>
+          <button type="button" data-cmd="debit">debit-note</button>
+          <button type="button" data-cmd="remittance">remittance</button>
+          <button type="button" data-cmd="token">token-san</button>
+          <button type="button" data-cmd="swift">swift-copy</button>
+          <button type="button" data-cmd="screen">screen</button>
+          <button type="button" data-cmd="alchemy-balance">alchemy balance</button>
+        </div>
+        <label>Alchemy address
+          <input id="inp-alchemy-addr" type="text" value="0xb3B416BdE671c256aAbFB56358baD91D46BB9c39" />
+        </label>
+        <h2>Output</h2>
+        <pre id="json-out" class="json-out">{}</pre>
+      </aside>
+    </div>
+
+    <footer>
+      <p>
+        API: <code>/api/v1/omnl/terminal/*</code> · Documents bound to Fineract — not SWIFT NET transmission.
+        Pass <code>?access_token=</code> or Bearer when <code>OMNL_API_KEY</code> is set.
+      </p>
+    </footer>
+  </div>
+  <script src="/omnl/static/omnl-api-base.js"></script>
+  <script src="/omnl/static/omnl-settlement-terminal.js"></script>
+</body>
+</html>
diff --git a/frontend-dapp/scripts/build-z.mjs b/frontend-dapp/scripts/build-z.mjs
new file mode 100644
index 0000000..c07bd6b
--- /dev/null
+++ b/frontend-dapp/scripts/build-z.mjs
@@ -0,0 +1,16 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
+const viteBin = path.join(root, 'node_modules', 'vite', 'bin', 'vite.js');
+
+process.env.VITE_ECOSYSTEM = 'z';
+
+const result = spawnSync(
+  process.execPath,
+  ['--max-old-space-size=4096', viteBin, 'build'],
+  { stdio: 'inherit', env: process.env, cwd: root },
+);
+
+process.exit(result.status ?? 1);
diff --git a/frontend-dapp/scripts/portal-serve.mjs b/frontend-dapp/scripts/portal-serve.mjs
new file mode 100644
index 0000000..dba18fd
--- /dev/null
+++ b/frontend-dapp/scripts/portal-serve.mjs
@@ -0,0 +1,142 @@
+/**
+ * Production-style portal server: static dist + API proxies (matches vite.config.ts).
+ */
+import http from 'http';
+import https from 'https';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DIST = path.join(__dirname, '..', 'dist');
+const PORT = Number(process.env.PORT || process.env.OMNL_BANK_FRONTEND_PORT || 3002);
+const API_TARGET = process.env.TOKEN_AGGREGATION_URL || 'http://127.0.0.1:3000';
+const SETTLEMENT_TARGET = process.env.SETTLEMENT_URL || process.env.SETTLEMENT_MIDDLEWARE_URL || 'http://127.0.0.1:3011';
+const EXCHANGE_TARGET = process.env.EXCHANGE_URL || '';
+const MIME = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.map': 'application/json',
+};
+
+function shouldServeOmnlStatic(url) {
+  return (
+    /^\/omnl\/(compliance|dashboard|terminal)\/?(\?.*)?$/.test(url) ||
+    url.startsWith('/omnl/static/')
+  );
+}
+
+function proxyRequest(req, res, targetBase, rewrite) {
+  const incoming = new URL(req.url, 'http://localhost');
+  const target = new URL(targetBase);
+  const pathname = rewrite ? rewrite(incoming.pathname) : incoming.pathname;
+  const options = {
+    protocol: target.protocol,
+    hostname: target.hostname,
+    port: target.port || (target.protocol === 'https:' ? 443 : 80),
+    path: `${pathname}${incoming.search}`,
+    method: req.method,
+    headers: { ...req.headers, host: target.host },
+  };
+
+  const lib = target.protocol === 'https:' ? https : http;
+  const proxyReq = lib.request(options, (proxyRes) => {
+    res.writeHead(proxyRes.statusCode ?? 502, proxyRes.headers);
+    proxyRes.pipe(res);
+  });
+  proxyReq.on('error', (err) => {
+    if (!res.headersSent) {
+      res.writeHead(502, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'proxy_error', message: err.message }));
+    }
+  });
+  req.pipe(proxyReq);
+}
+
+function sendFile(res, filePath, cacheControl) {
+  const ext = path.extname(filePath).toLowerCase();
+  const type = MIME[ext] || 'application/octet-stream';
+  const headers = { 'Content-Type': type };
+  if (cacheControl) headers['Cache-Control'] = cacheControl;
+  res.writeHead(200, headers);
+  fs.createReadStream(filePath).pipe(res);
+}
+
+function resolveStatic(urlPath) {
+  const decoded = decodeURIComponent(urlPath.split('?')[0]);
+  if (decoded.endsWith('/')) {
+    const indexPath = path.join(DIST, decoded, 'index.html');
+    if (fs.existsSync(indexPath)) return indexPath;
+  }
+  const direct = path.join(DIST, decoded);
+  if (fs.existsSync(direct) && fs.statSync(direct).isFile()) return direct;
+  const withIndex = path.join(DIST, decoded, 'index.html');
+  if (fs.existsSync(withIndex)) return withIndex;
+  return null;
+}
+
+const server = http.createServer((req, res) => {
+  const url = req.url || '/';
+
+  if (url.startsWith('/api')) {
+    return proxyRequest(req, res, API_TARGET);
+  }
+  if (url.startsWith('/reserve')) {
+    return proxyRequest(req, res, API_TARGET);
+  }
+  if (url.startsWith('/settlement')) {
+    return proxyRequest(req, res, SETTLEMENT_TARGET, (pathname) =>
+      pathname.replace(/^\/settlement/, '/api/v1/settlement'),
+    );
+  }
+  if (url.startsWith('/exchange')) {
+    if (!EXCHANGE_TARGET) {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      return res.end(JSON.stringify({ error: 'not_available', message: 'Z Ecosystem only' }));
+    }
+    return proxyRequest(req, res, EXCHANGE_TARGET);
+  }
+  if (url.startsWith('/omnl/')) {
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    return res.end(JSON.stringify({ error: 'not_available', message: 'Z Ecosystem only' }));
+  }
+
+  const file = resolveStatic(url === '/' ? '/index.html' : url);
+  if (file) {
+    const cache =
+      url.startsWith('/assets/') ? 'public, max-age=31536000, immutable' : 'no-cache, no-store, must-revalidate';
+    return sendFile(res, file, cache);
+  }
+
+  const indexHtml = path.join(DIST, 'index.html');
+  if (fs.existsSync(indexHtml)) {
+    return sendFile(res, indexHtml, 'no-cache, no-store, must-revalidate');
+  }
+
+  res.writeHead(404, { 'Content-Type': 'text/plain' });
+  res.end('Not found');
+});
+
+if (!fs.existsSync(DIST)) {
+  console.error(`Missing build output: ${DIST}\nRun: npm run build`);
+  process.exit(1);
+}
+
+server.listen(PORT, () => {
+  console.log(`portal-serve listening on http://localhost:${PORT}`);
+  console.log(`  dist: ${DIST}`);
+  console.log(`  api:  ${API_TARGET}`);
+  console.log(`  settlement: ${SETTLEMENT_TARGET}`);
+});
diff --git a/frontend-dapp/scripts/sync-omnl-consoles.mjs b/frontend-dapp/scripts/sync-omnl-consoles.mjs
new file mode 100644
index 0000000..1aeac8c
--- /dev/null
+++ b/frontend-dapp/scripts/sync-omnl-consoles.mjs
@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * Copy OMNL operator console static assets into frontend-dapp/public for Vite + portal-serve.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const frontendRoot = path.resolve(__dirname, '..');
+const srcPublic = path.resolve(frontendRoot, '../services/token-aggregation/public');
+const destRoot = path.join(frontendRoot, 'public', 'omnl');
+
+const staticFiles = [
+  'omnl-api-base.js',
+  'omnl-compliance-console.css',
+  'omnl-compliance-console.js',
+  'omnl-settlement-terminal.css',
+  'omnl-settlement-terminal.js',
+];
+
+const pageMap = [
+  { src: 'omnl-compliance-console.html', dest: 'compliance/index.html' },
+  { src: 'omnl-dashboard.html', dest: 'dashboard/index.html' },
+  { src: 'omnl-settlement-terminal.html', dest: 'terminal/index.html' },
+];
+
+function rmrf(dir) {
+  if (!fs.existsSync(dir)) return;
+  for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, ent.name);
+    if (ent.isDirectory()) rmrf(p);
+    else fs.unlinkSync(p);
+  }
+  fs.rmdirSync(dir);
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function copyFile(src, dest) {
+  ensureDir(path.dirname(dest));
+  fs.copyFileSync(src, dest);
+}
+
+if (!fs.existsSync(srcPublic)) {
+  console.warn('[sync-omnl-consoles] token-aggregation public missing — skip');
+  process.exit(0);
+}
+
+if (fs.existsSync(destRoot)) rmrf(destRoot);
+ensureDir(path.join(destRoot, 'static'));
+
+for (const name of staticFiles) {
+  const src = path.join(srcPublic, name);
+  if (!fs.existsSync(src)) {
+    console.warn(`[sync-omnl-consoles] missing ${name}`);
+    continue;
+  }
+  copyFile(src, path.join(destRoot, 'static', name));
+}
+
+for (const { src, dest } of pageMap) {
+  const from = path.join(srcPublic, src);
+  if (!fs.existsSync(from)) {
+    console.warn(`[sync-omnl-consoles] missing ${src}`);
+    continue;
+  }
+  copyFile(from, path.join(destRoot, dest));
+}
+
+console.log('[sync-omnl-consoles] synced operator consoles → public/omnl/');
diff --git a/frontend-dapp/src/App.tsx b/frontend-dapp/src/App.tsx
index e9e451e..41fbd8d 100644
--- a/frontend-dapp/src/App.tsx
+++ b/frontend-dapp/src/App.tsx
@@ -1,4 +1,5 @@
-import { BrowserRouter, Routes, Route } from 'react-router-dom'
+import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom'
+import { useEffect } from 'react'
 import { WagmiProvider } from 'wagmi'
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import { ThirdwebProvider } from '@thirdweb-dev/react'
@@ -14,11 +15,15 @@ import ReservePage from './pages/ReservePage'
 import HistoryPage from './pages/HistoryPage'
 import AdminPanel from './pages/AdminPanel'
 import DocsPage from './pages/DocsPage'
-import WalletsDemoPage from './pages/WalletsDemoPage'
 import HubPage from './pages/HubPage'
+import WalletsDemoPage from './pages/WalletsDemoPage'
+import ZEcosystemHubPage from './pages/ZEcosystemHubPage'
+import ZWalletPage from './pages/ZWalletPage'
 import Layout from './components/layout/Layout'
 import OmnlProductLayout from './components/layout/OmnlProductLayout'
+import ZProductLayout from './components/layout/ZProductLayout'
 import ToastProvider from './components/ui/ToastProvider'
+import { isZEcosystem, isOmnlEcosystem } from './config/ecosystemMode'
 
 const queryClient = new QueryClient({
   defaultOptions: {
@@ -35,6 +40,65 @@ const queryClient = new QueryClient({
 })
 const THIRDWEB_CLIENT_ID = import.meta.env.VITE_THIRDWEB_CLIENT_ID || '542981292d51ec610388ba8985f027d7'
 
+function ExternalRedirect({ to }: { to: string }) {
+  useEffect(() => {
+    window.location.replace(to)
+  }, [to])
+  return null
+}
+
+function ZRoutes() {
+  return (
+  <Routes>
+    <Route
+      element={
+        <ThirdwebProvider clientId={THIRDWEB_CLIENT_ID}>
+          <ZProductLayout />
+        </ThirdwebProvider>
+      }
+    >
+      <Route path="/z" element={<ZEcosystemHubPage />} />
+      <Route path="/z-wallet" element={<ZWalletPage />} />
+      <Route path="/swap" element={<SwapPage />} />
+      <Route path="/central-bank" element={<CentralBankPage />} />
+    </Route>
+    <Route path="/" element={<Navigate to="/z" replace />} />
+    <Route path="*" element={<Navigate to="/z" replace />} />
+  </Routes>
+  )
+}
+
+function OmnlRoutes() {
+  return (
+  <Routes>
+    <Route element={<OmnlProductLayout />}>
+      <Route path="/hub" element={<HubPage />} />
+      <Route path="/central-bank" element={<CentralBankPage />} />
+      <Route path="/office-24" element={<Office24Page />} />
+      <Route path="/trade" element={<TradePage />} />
+      <Route path="/swap" element={<SwapPage />} />
+    </Route>
+    <Route
+      element={
+        <ThirdwebProvider clientId={THIRDWEB_CLIENT_ID}>
+          <Layout />
+        </ThirdwebProvider>
+      }
+    >
+      <Route path="/bridge" element={<BridgePage />} />
+      <Route path="/reserve" element={<ReservePage />} />
+      <Route path="/history" element={<HistoryPage />} />
+      <Route path="/admin" element={<AdminPanel />} />
+      <Route path="/docs" element={<DocsPage />} />
+      <Route path="/wallets" element={<WalletsDemoPage />} />
+    </Route>
+    <Route path="/z" element={<ExternalRedirect to="https://zblockchainsystem.com/z" />} />
+    <Route path="/z-wallet" element={<ExternalRedirect to="https://zblockchainsystem.com/z-wallet" />} />
+    <Route path="/" element={<Navigate to="/hub" replace />} />
+  </Routes>
+  )
+}
+
 function App() {
   return (
     <ErrorBoundary>
@@ -48,30 +112,7 @@ function App() {
           >
             <ToastProvider />
             <AdminProvider>
-              <Routes>
-                <Route element={<OmnlProductLayout />}>
-                  <Route path="/hub" element={<HubPage />} />
-                  <Route path="/central-bank" element={<CentralBankPage />} />
-                  <Route path="/office-24" element={<Office24Page />} />
-                  <Route path="/trade" element={<TradePage />} />
-                  <Route path="/swap" element={<SwapPage />} />
-                </Route>
-                <Route
-                  element={
-                    <ThirdwebProvider clientId={THIRDWEB_CLIENT_ID}>
-                      <Layout />
-                    </ThirdwebProvider>
-                  }
-                >
-                  <Route path="/" element={<BridgePage />} />
-                  <Route path="/bridge" element={<BridgePage />} />
-                  <Route path="/reserve" element={<ReservePage />} />
-                  <Route path="/history" element={<HistoryPage />} />
-                  <Route path="/admin" element={<AdminPanel />} />
-                  <Route path="/docs" element={<DocsPage />} />
-                  <Route path="/wallets" element={<WalletsDemoPage />} />
-                </Route>
-              </Routes>
+              {isZEcosystem ? <ZRoutes /> : isOmnlEcosystem ? <OmnlRoutes /> : <OmnlRoutes />}
             </AdminProvider>
           </BrowserRouter>
         </QueryClientProvider>
diff --git a/frontend-dapp/src/components/admin/AdminDashboard.tsx b/frontend-dapp/src/components/admin/AdminDashboard.tsx
index de7936f..f159a5a 100644
--- a/frontend-dapp/src/components/admin/AdminDashboard.tsx
+++ b/frontend-dapp/src/components/admin/AdminDashboard.tsx
@@ -99,7 +99,7 @@ export default function AdminDashboard() {
   }, [publicClient, address])
 
   return (
-    <div className="space-y-6 nasa-mission-root">
+    <div className="space-y-6 app-shell">
       <div className="grid grid-cols-2 md:grid-cols-4 gap-4">
         <DashboardStatCard label="Total actions" value={String(stats.totalActions)} accent="blue" icon="admin" />
         <DashboardStatCard label="Pending" value={String(stats.pending)} accent="gold" icon="alert" />
diff --git a/frontend-dapp/src/components/admin/AuditLogViewer.tsx b/frontend-dapp/src/components/admin/AuditLogViewer.tsx
index 7e301a0..eda9694 100644
--- a/frontend-dapp/src/components/admin/AuditLogViewer.tsx
+++ b/frontend-dapp/src/components/admin/AuditLogViewer.tsx
@@ -73,7 +73,7 @@ export default function AuditLogViewer() {
           value={searchTerm}
           onChange={(e) => setSearchTerm(e.target.value)}
           placeholder="Search logs..."
-          className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+          className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
         />
         <div className="flex gap-2">
           {(['all', 'success', 'failure'] as const).map((f) => (
diff --git a/frontend-dapp/src/components/admin/FunctionPermissions.tsx b/frontend-dapp/src/components/admin/FunctionPermissions.tsx
index b33af3d..26e9f49 100644
--- a/frontend-dapp/src/components/admin/FunctionPermissions.tsx
+++ b/frontend-dapp/src/components/admin/FunctionPermissions.tsx
@@ -147,7 +147,7 @@ export default function FunctionPermissions() {
           <select
             value={selectedContract}
             onChange={(e) => setSelectedContract(e.target.value)}
-            className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+            className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
           >
             <option value={CONTRACT_ADDRESSES.mainnet.MAINNET_TETHER}>MainnetTether</option>
             <option value={CONTRACT_ADDRESSES.mainnet.TRANSACTION_MIRROR}>TransactionMirror</option>
@@ -227,7 +227,7 @@ export default function FunctionPermissions() {
               <select
                 value={selectedRole}
                 onChange={(e) => setSelectedRole(e.target.value)}
-                className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+                className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
               >
                 {roles.map((role) => (
                   <option key={role.id} value={role.id}>
@@ -239,7 +239,7 @@ export default function FunctionPermissions() {
             <div className="flex-1">
               <label className="block text-white/70 text-sm mb-2">Function</label>
               <select
-                className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+                className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
               >
                 {contractFunctions.map((func) => (
                   <option key={func} value={func}>
diff --git a/frontend-dapp/src/components/admin/GasOptimizer.tsx b/frontend-dapp/src/components/admin/GasOptimizer.tsx
index 9286e9a..3565c28 100644
--- a/frontend-dapp/src/components/admin/GasOptimizer.tsx
+++ b/frontend-dapp/src/components/admin/GasOptimizer.tsx
@@ -92,7 +92,7 @@ export default function GasOptimizer() {
             value={estimatedGas}
             onChange={(e) => setEstimatedGas(e.target.value)}
             placeholder="21000"
-            className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+            className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
           />
         </div>
 
diff --git a/frontend-dapp/src/components/admin/ImpersonationMode.tsx b/frontend-dapp/src/components/admin/ImpersonationMode.tsx
index 3089a92..99a7120 100644
--- a/frontend-dapp/src/components/admin/ImpersonationMode.tsx
+++ b/frontend-dapp/src/components/admin/ImpersonationMode.tsx
@@ -105,7 +105,7 @@ export default function ImpersonationMode() {
                 value={inputAddress}
                 onChange={(e) => setInputAddress(e.target.value)}
                 placeholder="0x... or name.eth"
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
                 onKeyPress={(e) => {
                   if (e.key === 'Enter') {
                     handleEnableImpersonation()
diff --git a/frontend-dapp/src/components/admin/MainnetTetherAdmin.tsx b/frontend-dapp/src/components/admin/MainnetTetherAdmin.tsx
index a777f82..7628351 100644
--- a/frontend-dapp/src/components/admin/MainnetTetherAdmin.tsx
+++ b/frontend-dapp/src/components/admin/MainnetTetherAdmin.tsx
@@ -177,7 +177,7 @@ export default function MainnetTetherAdmin() {
                 value={newAdmin}
                 onChange={(e) => setNewAdmin(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
               />
               <button
                 onClick={handleSetAdmin}
@@ -200,7 +200,7 @@ export default function MainnetTetherAdmin() {
             value={blockNumber}
             onChange={(e) => setBlockNumber(e.target.value)}
             placeholder="Block number"
-            className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+            className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
           />
           <button
             onClick={handleCheckBlock}
diff --git a/frontend-dapp/src/components/admin/MultiChainAdmin.tsx b/frontend-dapp/src/components/admin/MultiChainAdmin.tsx
index 119ab95..f0e67c3 100644
--- a/frontend-dapp/src/components/admin/MultiChainAdmin.tsx
+++ b/frontend-dapp/src/components/admin/MultiChainAdmin.tsx
@@ -72,7 +72,7 @@ export default function MultiChainAdmin() {
             <select
               value={selectedChain}
               onChange={(e) => setSelectedChain(parseInt(e.target.value))}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               {CHAIN_CONFIGS.map((chain) => (
                 <option key={chain.chainId} value={chain.chainId}>
diff --git a/frontend-dapp/src/components/admin/MultiSigAdmin.tsx b/frontend-dapp/src/components/admin/MultiSigAdmin.tsx
index 4519461..c6d3afb 100644
--- a/frontend-dapp/src/components/admin/MultiSigAdmin.tsx
+++ b/frontend-dapp/src/components/admin/MultiSigAdmin.tsx
@@ -182,7 +182,7 @@ export default function MultiSigAdmin() {
             <select
               value={selectedContract}
               onChange={(e) => setSelectedContract(e.target.value)}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value={contractAddress}>MainnetTether ({contractAddress.slice(0, 10)}...)</option>
               <option value={CONTRACT_ADDRESSES.mainnet.TRANSACTION_MIRROR}>
diff --git a/frontend-dapp/src/components/admin/OwnerManagement.tsx b/frontend-dapp/src/components/admin/OwnerManagement.tsx
index 30b4a97..0a2d765 100644
--- a/frontend-dapp/src/components/admin/OwnerManagement.tsx
+++ b/frontend-dapp/src/components/admin/OwnerManagement.tsx
@@ -145,7 +145,7 @@ export default function OwnerManagement() {
             <select
               value={selectedWallet}
               onChange={(e) => setSelectedWallet(e.target.value)}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value="">Select a wallet...</option>
               {wallets.map((wallet) => (
@@ -189,14 +189,14 @@ export default function OwnerManagement() {
                     value={newOwner}
                     onChange={(e) => setNewOwner(e.target.value)}
                     placeholder="0x..."
-                    className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                    className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
                   />
                   <input
                     type="text"
                     value={ownerLabel}
                     onChange={(e) => setOwnerLabel(e.target.value)}
                     placeholder="Owner label (optional)"
-                    className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                    className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
                   />
                   <button
                     onClick={addOwner}
diff --git a/frontend-dapp/src/components/admin/Pagination.tsx b/frontend-dapp/src/components/admin/Pagination.tsx
index fc69d47..52950b9 100644
--- a/frontend-dapp/src/components/admin/Pagination.tsx
+++ b/frontend-dapp/src/components/admin/Pagination.tsx
@@ -134,7 +134,7 @@ export default function Pagination({
           <select
             value={itemsPerPage}
             onChange={(e) => onItemsPerPageChange(Number(e.target.value))}
-            className="px-3 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+            className="px-3 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
           >
             <option value={10}>10</option>
             <option value={25}>25</option>
diff --git a/frontend-dapp/src/components/admin/RealtimeMonitor.tsx b/frontend-dapp/src/components/admin/RealtimeMonitor.tsx
index 5330a1b..c581159 100644
--- a/frontend-dapp/src/components/admin/RealtimeMonitor.tsx
+++ b/frontend-dapp/src/components/admin/RealtimeMonitor.tsx
@@ -151,7 +151,7 @@ export default function RealtimeMonitor() {
               onChange={(e) => setWsUrl(e.target.value)}
               placeholder="wss://your-monitoring-server.com/ws"
               disabled={monitoring}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm disabled:opacity-50"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm disabled:opacity-50"
             />
             <p className="text-white/60 text-xs mt-1">
               Leave empty to use polling fallback (checks every 10 seconds)
diff --git a/frontend-dapp/src/components/admin/RoleBasedAccess.tsx b/frontend-dapp/src/components/admin/RoleBasedAccess.tsx
index 0290292..a7e78c5 100644
--- a/frontend-dapp/src/components/admin/RoleBasedAccess.tsx
+++ b/frontend-dapp/src/components/admin/RoleBasedAccess.tsx
@@ -139,12 +139,12 @@ export default function RoleBasedAccess() {
                 value={selectedAddress}
                 onChange={(e) => setSelectedAddress(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
               />
               <select
                 value={selectedRole}
                 onChange={(e) => setSelectedRole(e.target.value as AdminRole)}
-                className="px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+                className="px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
               >
                 <option value={AdminRole.SUPER_ADMIN}>Super Admin</option>
                 <option value={AdminRole.OPERATOR}>Operator</option>
diff --git a/frontend-dapp/src/components/admin/ScheduledActions.tsx b/frontend-dapp/src/components/admin/ScheduledActions.tsx
index 2e6b379..ef89f77 100644
--- a/frontend-dapp/src/components/admin/ScheduledActions.tsx
+++ b/frontend-dapp/src/components/admin/ScheduledActions.tsx
@@ -153,7 +153,7 @@ export default function ScheduledActions() {
               value={newAction.name}
               onChange={(e) => setNewAction({ ...newAction, name: e.target.value })}
               placeholder="Daily State Check"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
 
@@ -162,7 +162,7 @@ export default function ScheduledActions() {
             <select
               value={newAction.contractAddress}
               onChange={(e) => setNewAction({ ...newAction, contractAddress: e.target.value as `0x${string}` })}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value={CONTRACT_ADDRESSES.mainnet.MAINNET_TETHER}>MainnetTether</option>
               <option value={CONTRACT_ADDRESSES.mainnet.TRANSACTION_MIRROR}>TransactionMirror</option>
@@ -176,7 +176,7 @@ export default function ScheduledActions() {
               value={newAction.functionName}
               onChange={(e) => setNewAction({ ...newAction, functionName: e.target.value })}
               placeholder="pause"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
 
@@ -185,7 +185,7 @@ export default function ScheduledActions() {
             <select
               value={newAction.schedule}
               onChange={(e) => setNewAction({ ...newAction, schedule: e.target.value })}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value="daily">Daily</option>
               <option value="weekly">Weekly</option>
diff --git a/frontend-dapp/src/components/admin/TimeLockedActions.tsx b/frontend-dapp/src/components/admin/TimeLockedActions.tsx
index dd9a298..710027c 100644
--- a/frontend-dapp/src/components/admin/TimeLockedActions.tsx
+++ b/frontend-dapp/src/components/admin/TimeLockedActions.tsx
@@ -107,7 +107,7 @@ export default function TimeLockedActions() {
               value={delayMinutes}
               onChange={(e) => setDelayMinutes(parseInt(e.target.value) || 0)}
               min="0"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             />
           </div>
 
diff --git a/frontend-dapp/src/components/admin/TransactionMirrorAdmin.tsx b/frontend-dapp/src/components/admin/TransactionMirrorAdmin.tsx
index 7c6efa4..d70ddf7 100644
--- a/frontend-dapp/src/components/admin/TransactionMirrorAdmin.tsx
+++ b/frontend-dapp/src/components/admin/TransactionMirrorAdmin.tsx
@@ -231,7 +231,7 @@ export default function TransactionMirrorAdmin() {
                 value={newAdmin}
                 onChange={(e) => setNewAdmin(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
               />
               <button
                 onClick={handleSetAdmin}
@@ -254,7 +254,7 @@ export default function TransactionMirrorAdmin() {
             value={txHash}
             onChange={(e) => setTxHash(e.target.value)}
             placeholder="Transaction hash (0x...)"
-            className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+            className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
           />
           <button
             onClick={handleCheckTransaction}
diff --git a/frontend-dapp/src/components/admin/TransactionPreview.tsx b/frontend-dapp/src/components/admin/TransactionPreview.tsx
index dcea701..e78e0fb 100644
--- a/frontend-dapp/src/components/admin/TransactionPreview.tsx
+++ b/frontend-dapp/src/components/admin/TransactionPreview.tsx
@@ -89,7 +89,7 @@ export default function TransactionPreview() {
             <select
               value={contractAddress}
               onChange={(e) => setContractAddress(e.target.value as `0x${string}`)}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value={CONTRACT_ADDRESSES.mainnet.MAINNET_TETHER}>MainnetTether</option>
               <option value={CONTRACT_ADDRESSES.mainnet.TRANSACTION_MIRROR}>TransactionMirror</option>
@@ -103,7 +103,7 @@ export default function TransactionPreview() {
               value={functionName}
               onChange={(e) => setFunctionName(e.target.value)}
               placeholder="pause"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
 
@@ -114,7 +114,7 @@ export default function TransactionPreview() {
               value={args}
               onChange={(e) => setArgs(e.target.value)}
               placeholder='[] or ["0x..."]'
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
             />
           </div>
 
diff --git a/frontend-dapp/src/components/admin/TransactionTemplates.tsx b/frontend-dapp/src/components/admin/TransactionTemplates.tsx
index 13a4abe..6db825b 100644
--- a/frontend-dapp/src/components/admin/TransactionTemplates.tsx
+++ b/frontend-dapp/src/components/admin/TransactionTemplates.tsx
@@ -183,7 +183,7 @@ export default function TransactionTemplates() {
               value={customTemplate.name}
               onChange={(e) => setCustomTemplate({ ...customTemplate, name: e.target.value })}
               placeholder="My Custom Template"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
           <div>
@@ -193,7 +193,7 @@ export default function TransactionTemplates() {
               value={customTemplate.description}
               onChange={(e) => setCustomTemplate({ ...customTemplate, description: e.target.value })}
               placeholder="What this template does"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
           <div>
@@ -203,7 +203,7 @@ export default function TransactionTemplates() {
               value={customTemplate.contractAddress}
               onChange={(e) => setCustomTemplate({ ...customTemplate, contractAddress: e.target.value })}
               placeholder="0x..."
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
             />
           </div>
           <div>
@@ -213,7 +213,7 @@ export default function TransactionTemplates() {
               value={customTemplate.functionName}
               onChange={(e) => setCustomTemplate({ ...customTemplate, functionName: e.target.value })}
               placeholder="pause"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
           <div>
@@ -223,7 +223,7 @@ export default function TransactionTemplates() {
               value={customTemplate.args}
               onChange={(e) => setCustomTemplate({ ...customTemplate, args: e.target.value })}
               placeholder='[] or ["0x..."]'
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
             />
           </div>
           <div>
@@ -231,7 +231,7 @@ export default function TransactionTemplates() {
             <select
               value={customTemplate.category}
               onChange={(e) => setCustomTemplate({ ...customTemplate, category: e.target.value as any })}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             >
               <option value="maintenance">Maintenance</option>
               <option value="emergency">Emergency</option>
diff --git a/frontend-dapp/src/components/admin/TwoWayBridgeAdmin.tsx b/frontend-dapp/src/components/admin/TwoWayBridgeAdmin.tsx
index b7e4ec3..80c1637 100644
--- a/frontend-dapp/src/components/admin/TwoWayBridgeAdmin.tsx
+++ b/frontend-dapp/src/components/admin/TwoWayBridgeAdmin.tsx
@@ -200,7 +200,7 @@ export default function TwoWayBridgeAdmin() {
                 value={newAdmin}
                 onChange={(e) => setNewAdmin(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
               />
               <button
                 onClick={handleSetAdmin}
@@ -220,14 +220,14 @@ export default function TwoWayBridgeAdmin() {
               value={chainSelector}
               onChange={(e) => setChainSelector(e.target.value)}
               placeholder="Chain Selector (e.g., 16015286601757825753)"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
             <input
               type="text"
               value={l2Bridge}
               onChange={(e) => setL2Bridge(e.target.value)}
               placeholder="L2 Bridge Address (0x...)"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
             <button
               onClick={handleAddDestination}
@@ -247,7 +247,7 @@ export default function TwoWayBridgeAdmin() {
                 value={feeToken}
                 onChange={(e) => setFeeToken(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
               />
               <button
                 onClick={handleUpdateFeeToken}
diff --git a/frontend-dapp/src/components/admin/WalletBackup.tsx b/frontend-dapp/src/components/admin/WalletBackup.tsx
index ccdc0c4..4970dc2 100644
--- a/frontend-dapp/src/components/admin/WalletBackup.tsx
+++ b/frontend-dapp/src/components/admin/WalletBackup.tsx
@@ -96,7 +96,7 @@ export default function WalletBackup() {
                   value={backupPassword}
                   onChange={(e) => setBackupPassword(e.target.value)}
                   placeholder="Enter password"
-                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
                 />
               </div>
               <button
@@ -119,7 +119,7 @@ export default function WalletBackup() {
                   onChange={(e) => setImportData(e.target.value)}
                   placeholder="Paste encrypted backup data..."
                   rows={6}
-                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
                 />
               </div>
               <div>
@@ -129,7 +129,7 @@ export default function WalletBackup() {
                   value={backupPassword}
                   onChange={(e) => setBackupPassword(e.target.value)}
                   placeholder="Enter password"
-                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+                  className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
                 />
               </div>
               <button
diff --git a/frontend-dapp/src/components/admin/WalletBalance.tsx b/frontend-dapp/src/components/admin/WalletBalance.tsx
index 7ca787b..4e26b0d 100644
--- a/frontend-dapp/src/components/admin/WalletBalance.tsx
+++ b/frontend-dapp/src/components/admin/WalletBalance.tsx
@@ -57,7 +57,7 @@ export default function WalletBalance() {
                 value={newWallet}
                 onChange={(e) => setNewWallet(e.target.value)}
                 placeholder="0x..."
-                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
               />
               <button
                 onClick={addWallet}
diff --git a/frontend-dapp/src/components/admin/WalletDeployment.tsx b/frontend-dapp/src/components/admin/WalletDeployment.tsx
index 3bdf5f0..af7fe1f 100644
--- a/frontend-dapp/src/components/admin/WalletDeployment.tsx
+++ b/frontend-dapp/src/components/admin/WalletDeployment.tsx
@@ -103,7 +103,7 @@ export default function WalletDeployment() {
               value={config.name}
               onChange={(e) => setConfig({ ...config, name: e.target.value })}
               placeholder="My Admin Wallet"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
 
@@ -132,7 +132,7 @@ export default function WalletDeployment() {
                   value={newOwner}
                   onChange={(e) => setNewOwner(e.target.value)}
                   placeholder="0x..."
-                  className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                  className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
                 />
                 <button
                   onClick={addOwner}
@@ -159,7 +159,7 @@ export default function WalletDeployment() {
               }
               min="1"
               max={config.owners.length}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             />
             <p className="text-white/60 text-xs mt-1">
               Requires {config.threshold} of {config.owners.length} owners to approve transactions
diff --git a/frontend-dapp/src/components/admin/WalletDeploymentEnhanced.tsx b/frontend-dapp/src/components/admin/WalletDeploymentEnhanced.tsx
index 2851b1c..e88c143 100644
--- a/frontend-dapp/src/components/admin/WalletDeploymentEnhanced.tsx
+++ b/frontend-dapp/src/components/admin/WalletDeploymentEnhanced.tsx
@@ -144,7 +144,7 @@ export default function WalletDeploymentEnhanced() {
               value={config.name}
               onChange={(e) => setConfig({ ...config, name: e.target.value })}
               placeholder="My Admin Wallet"
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500"
             />
           </div>
 
@@ -173,7 +173,7 @@ export default function WalletDeploymentEnhanced() {
                   value={newOwner}
                   onChange={(e) => setNewOwner(e.target.value)}
                   placeholder="0x..."
-                  className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-blue-500 font-mono text-sm"
+                  className="flex-1 px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white placeholder-white/40 focus:outline-none focus:border-green-500 font-mono text-sm"
                 />
                 <button
                   onClick={addOwner}
@@ -200,7 +200,7 @@ export default function WalletDeploymentEnhanced() {
               }
               min="1"
               max={config.owners.length}
-              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-blue-500"
+              className="w-full px-4 py-2 bg-white/10 border border-white/20 rounded-lg text-white focus:outline-none focus:border-green-500"
             />
             <p className="text-white/60 text-xs mt-1">
               Requires {config.threshold} of {config.owners.length} owners to approve transactions
diff --git a/frontend-dapp/src/components/admin/chain-management/ChainManagementDashboard.tsx b/frontend-dapp/src/components/admin/chain-management/ChainManagementDashboard.tsx
index cac73ad..c122f38 100644
--- a/frontend-dapp/src/components/admin/chain-management/ChainManagementDashboard.tsx
+++ b/frontend-dapp/src/components/admin/chain-management/ChainManagementDashboard.tsx
@@ -6,9 +6,9 @@
 import { useState, useEffect } from 'react';
 import toast from 'react-hot-toast';
 import { useAccount } from 'wagmi';
-import DashboardSection from '../../features/omnl-dashboard/DashboardSection';
-import NasaIcon, { StatusIcon } from '../icons/NasaIcon';
-import NasaPageHeader from '../../features/omnl-dashboard/NasaPageHeader';
+import DashboardSection from '../../../features/omnl-dashboard/DashboardSection';
+import NasaIcon, { StatusIcon } from '../../icons/NasaIcon';
+import NasaPageHeader from '../../../features/omnl-dashboard/NasaPageHeader';
 
 interface ChainMetadata {
     chainId: number;
@@ -80,8 +80,8 @@ export default function ChainManagementDashboard() {
 
     if (!isConnected) {
         return (
-            <div className="dash-card nasa-mission-root">
-                <p className="text-[#7a9bb8] flex items-center gap-2">
+            <div className="dash-card app-shell text-center">
+                <p className="text-[#848e9c] flex items-center justify-center gap-2">
                     <NasaIcon name="wallet" size={16} className="nasa-icon--telemetry" />
                     Please connect your wallet to manage chains.
                 </p>
@@ -90,10 +90,9 @@ export default function ChainManagementDashboard() {
     }
 
     return (
-        <div className="space-y-6 nasa-mission-root">
+        <div className="space-y-6 app-page-shell app-shell">
             <NasaPageHeader
                 icon="network"
-                missionId="NET-ADM"
                 title="Chain Management"
                 subtitle="Supported chains, adapters, and deployment registry"
             />
@@ -116,7 +115,7 @@ export default function ChainManagementDashboard() {
                                     <p className="text-[#7a9bb8] text-sm font-mono">Adapter: {chain.adapter.slice(0, 10)}…</p>
                                     <p className="text-[#7a9bb8] text-sm">
                                         Explorer:{' '}
-                                        <a href={chain.explorerUrl} target="_blank" rel="noopener noreferrer" className="text-[#00d4ff] hover:underline inline-flex items-center gap-1">
+                                        <a href={chain.explorerUrl} target="_blank" rel="noopener noreferrer" className="text-[#4ade80] hover:underline inline-flex items-center gap-1">
                                             <NasaIcon name="link" size={12} />
                                             {chain.explorerUrl}
                                         </a>
diff --git a/frontend-dapp/src/components/bridge/SwapBridgeSwapQuoteForm.tsx b/frontend-dapp/src/components/bridge/SwapBridgeSwapQuoteForm.tsx
index e638278..627bd91 100644
--- a/frontend-dapp/src/components/bridge/SwapBridgeSwapQuoteForm.tsx
+++ b/frontend-dapp/src/components/bridge/SwapBridgeSwapQuoteForm.tsx
@@ -77,7 +77,7 @@ export default function SwapBridgeSwapQuoteForm() {
           placeholder="Source token address"
           value={sourceToken}
           onChange={(e) => setSourceToken(e.target.value)}
-          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-teal-500/50 placeholder:text-[#A0A0A0]"
+          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-green-500/50 placeholder:text-[#A0A0A0]"
         />
         <label htmlFor="quote-destination-token" className="sr-only">Destination token address</label>
         <input
@@ -87,7 +87,7 @@ export default function SwapBridgeSwapQuoteForm() {
           placeholder="Destination token address"
           value={destinationToken}
           onChange={(e) => setDestinationToken(e.target.value)}
-          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-teal-500/50 placeholder:text-[#A0A0A0]"
+          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-green-500/50 placeholder:text-[#A0A0A0]"
         />
         <label htmlFor="quote-source-chain" className="sr-only">Source chain ID</label>
         <input
@@ -97,7 +97,7 @@ export default function SwapBridgeSwapQuoteForm() {
           placeholder="Source chain ID"
           value={sourceChainId}
           onChange={(e) => setSourceChainId(e.target.value)}
-          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-teal-500/50 placeholder:text-[#A0A0A0]"
+          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-green-500/50 placeholder:text-[#A0A0A0]"
         />
         <label htmlFor="quote-destination-chain" className="sr-only">Destination chain ID</label>
         <input
@@ -107,7 +107,7 @@ export default function SwapBridgeSwapQuoteForm() {
           placeholder="Destination chain ID"
           value={destinationChainId}
           onChange={(e) => setDestinationChainId(e.target.value)}
-          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-teal-500/50 placeholder:text-[#A0A0A0]"
+          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-green-500/50 placeholder:text-[#A0A0A0]"
         />
         <label htmlFor="quote-amount" className="sr-only">Amount (wei or decimal)</label>
         <input
@@ -117,14 +117,14 @@ export default function SwapBridgeSwapQuoteForm() {
           placeholder="Amount (wei or decimal)"
           value={amount}
           onChange={(e) => setAmount(e.target.value)}
-          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-teal-500/50 placeholder:text-[#A0A0A0] md:col-span-2"
+          className="px-3 py-2 rounded-lg bg-[#252830] text-white border border-white/20 focus:ring-2 focus:ring-green-500/50 placeholder:text-[#A0A0A0] md:col-span-2"
         />
       </div>
       <button
         type="button"
         onClick={handleGetQuote}
         disabled={loading}
-        className="px-4 py-2 rounded-lg bg-teal-600 text-white font-medium hover:bg-teal-500 disabled:opacity-50"
+        className="px-4 py-2 rounded-lg bg-green-600 text-white font-medium hover:bg-green-500 disabled:opacity-50"
       >
         {loading ? 'Getting quote...' : 'Get full path quote'}
       </button>
diff --git a/frontend-dapp/src/components/icons/NasaIcon.tsx b/frontend-dapp/src/components/icons/NasaIcon.tsx
index e587240..7f8a424 100644
--- a/frontend-dapp/src/components/icons/NasaIcon.tsx
+++ b/frontend-dapp/src/components/icons/NasaIcon.tsx
@@ -23,7 +23,12 @@ export type NasaIconName =
   | 'globe'
   | 'money'
   | 'rail'
-  | 'admin';
+  | 'admin'
+  | 'dashboard'
+  | 'code'
+  | 'shield'
+  | 'terminal'
+  | 'plus';
 
 type Props = SVGProps<SVGSVGElement> & {
   name: NasaIconName;
@@ -170,6 +175,39 @@ const paths: Record<NasaIconName, ReactNode> = {
       <path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 1 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 1 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 1 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 1 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1Z" />
     </>
   ),
+  dashboard: (
+    <>
+      <rect x="3" y="3" width="7" height="9" rx="1" />
+      <rect x="14" y="3" width="7" height="5" rx="1" />
+      <rect x="14" y="12" width="7" height="9" rx="1" />
+      <rect x="3" y="16" width="7" height="5" rx="1" />
+    </>
+  ),
+  code: (
+    <>
+      <path d="m16 18 6-6-6-6" />
+      <path d="m8 6-6 6 6 6" />
+    </>
+  ),
+  shield: (
+    <>
+      <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" />
+      <path d="m9 12 2 2 4-4" />
+    </>
+  ),
+  terminal: (
+    <>
+      <rect x="2" y="4" width="20" height="16" rx="2" />
+      <path d="m6 10 4 4-4 4" />
+      <path d="M12 18h6" />
+    </>
+  ),
+  plus: (
+    <>
+      <path d="M12 5v14" />
+      <path d="M5 12h14" />
+    </>
+  ),
 };
 
 export default function NasaIcon({ name, size = 18, className = '', ...props }: Props) {
diff --git a/frontend-dapp/src/components/layout/Layout.tsx b/frontend-dapp/src/components/layout/Layout.tsx
index e67b3bd..23a5857 100644
--- a/frontend-dapp/src/components/layout/Layout.tsx
+++ b/frontend-dapp/src/components/layout/Layout.tsx
@@ -1,86 +1,92 @@
 import { Link, Outlet, useLocation } from 'react-router-dom'
-import { useRef } from 'react'
+import { useRef, useState } from 'react'
 import WalletConnect from '../wallet/WalletConnect'
 import WalletDisconnectNotice from '../wallet/WalletDisconnectNotice'
 import { defaultFrontendExplorerUrl } from '../../config/networks'
+import MobileNavDrawer from './MobileNavDrawer'
+import MobileBottomNav from './MobileBottomNav'
 
 export default function Layout() {
   const location = useLocation()
   const userInitiatedDisconnectRef = useRef(false)
+  const [menuOpen, setMenuOpen] = useState(false)
 
   const isActive = (path: string) => location.pathname === path
 
+  const navItems = [
+    { to: '/hub', label: 'DBIS Dashboard', active: isActive('/hub') },
+    { to: '/bridge', label: 'Bridge', active: isActive('/bridge') },
+    { to: '/swap', label: 'Swap', active: isActive('/swap') },
+    { to: '/reserve', label: 'Reserve', active: isActive('/reserve') },
+    { to: '/history', label: 'History', active: isActive('/history') },
+    { to: '/wallets', label: 'Wallets', active: isActive('/wallets') },
+    { to: '/admin', label: 'Admin', active: isActive('/admin') },
+    { to: '/docs', label: 'Developers', active: isActive('/docs') },
+  ]
+
   return (
-    <div className="min-h-screen relative bg-[#1a1d24] flex flex-col">
+    <div className="min-h-screen relative bg-[#141a16] flex flex-col dbis-has-bottom-nav">
       <WalletDisconnectNotice userInitiatedDisconnectRef={userInitiatedDisconnectRef} />
-      <nav className="bg-[#252830] border-b border-white/10 sticky top-0 z-50">
-        <div className="container mx-auto px-4 max-w-7xl">
-          <div className="flex justify-between items-center h-14 gap-4">
-            <div className="flex items-center gap-6 min-w-0">
-              <Link to="/" className="text-xl font-semibold text-white whitespace-nowrap flex items-center gap-2">
-                <span className="text-teal-400 font-bold">DBIS</span>
+      <nav className="mobile-nav-bar bg-[#1a241c] border-b border-green-500/20 sticky top-0 z-50 safe-area-top">
+        <div className="container mx-auto px-3 sm:px-4 max-w-7xl">
+          <div className="flex justify-between items-center h-14 gap-2">
+            <div className="flex items-center gap-2 min-w-0 flex-1">
+              <button
+                type="button"
+                className="sm:hidden shrink-0 text-white p-2 min-h-[44px] min-w-[44px] rounded-lg hover:bg-white/10"
+                aria-label="Open menu"
+                aria-expanded={menuOpen}
+                onClick={() => setMenuOpen(true)}
+              >
+                ☰
+              </button>
+              <Link to="/hub" className="text-lg sm:text-xl font-semibold text-white whitespace-nowrap flex items-center gap-2">
+                <span className="text-green-400 font-bold">DBIS</span>
               </Link>
-              <div className="hidden sm:flex gap-1">
-                <Link
-                  to="/bridge"
-                  className={`px-4 py-2 rounded-lg text-sm font-medium transition-colors ${
-                    isActive('/bridge') || isActive('/') ? 'bg-teal-600 text-white' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
-                  }`}
-                >
-                  Bridge
-                </Link>
-                <Link
-                  to="/swap"
-                  className={`px-4 py-2 rounded-lg text-sm font-medium transition-colors ${
-                    isActive('/swap') ? 'bg-teal-600 text-white' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
-                  }`}
-                >
-                  Swap
-                </Link>
-                <Link
-                  to="/history"
-                  className={`px-4 py-2 rounded-lg text-sm font-medium transition-colors ${
-                    isActive('/history') ? 'bg-teal-600 text-white' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
-                  }`}
-                >
-                  History
-                </Link>
-                <Link
-                  to="/wallets"
-                  className={`px-4 py-2 rounded-lg text-sm font-medium transition-colors ${
-                    isActive('/wallets') ? 'bg-teal-600 text-white' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
-                  }`}
-                >
-                  Wallets
-                </Link>
+              <div className="hidden sm:flex gap-1 ml-2 overflow-x-auto">
+                {navItems.filter((i) => i.to && !['/central-bank', '/office-24', '/trade', '/docs', '/admin', '/hub'].includes(i.to)).map((item) => (
+                  <Link
+                    key={item.to}
+                    to={item.to!}
+                    className={`px-3 py-2 rounded-lg text-sm font-medium transition-colors whitespace-nowrap min-h-[44px] flex items-center ${
+                      item.active ? 'bg-green-600 text-white' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
+                    }`}
+                  >
+                    {item.label}
+                  </Link>
+                ))}
                 <a
                   href={defaultFrontendExplorerUrl}
                   target="_blank"
                   rel="noopener noreferrer"
-                  className="px-4 py-2 rounded-lg text-sm font-medium text-[#A0A0A0] hover:text-white hover:bg-white/5 transition-colors"
+                  className="px-3 py-2 rounded-lg text-sm font-medium text-[#A0A0A0] hover:text-white hover:bg-white/5 transition-colors whitespace-nowrap min-h-[44px] flex items-center"
                 >
                   Explorer
                 </a>
               </div>
             </div>
-            <div className="flex-shrink-0 w-full sm:w-auto max-w-[200px] sm:max-w-none">
+            <div className="flex-shrink-0 max-w-[50%] sm:max-w-none">
               <WalletConnect onBeforeDisconnect={() => { userInitiatedDisconnectRef.current = true }} />
             </div>
           </div>
         </div>
       </nav>
-      <main className="flex-1">
+
+      <MobileNavDrawer open={menuOpen} onClose={() => setMenuOpen(false)} title="DBIS Navigation" items={navItems} />
+      <MobileBottomNav onOpenMenu={() => setMenuOpen(true)} />
+
+      <main className="flex-1 w-full min-w-0 overflow-x-hidden">
         <Outlet />
       </main>
-      <footer className="border-t border-white/10 py-6 mt-auto">
+      <footer className="border-t border-white/10 py-6 mt-auto safe-area-bottom">
         <div className="container mx-auto px-4 max-w-7xl">
-          <div className="flex flex-wrap justify-center items-center gap-x-6 gap-y-2 text-sm text-[#A0A0A0]">
+          <div className="flex flex-wrap justify-center items-center gap-x-4 gap-y-2 text-xs sm:text-sm text-[#A0A0A0]">
             <span>✔ Contracts verified</span>
             <span>✔ Powered by CCIP</span>
-            <span>✔ Secure cross-chain messaging</span>
-            <span>✔ Trackable on Explorer</span>
-            <Link to="/wallets" className="hover:text-teal-400 transition-colors">Wallets</Link>
-            <Link to="/docs" className="hover:text-teal-400 transition-colors">Developers</Link>
+            <span className="hidden sm:inline">✔ Secure cross-chain messaging</span>
+            <Link to="/hub" className="hover:text-green-400 transition-colors min-h-[44px] flex items-center">DBIS Dashboard</Link>
+            <Link to="/wallets" className="hover:text-green-400 transition-colors min-h-[44px] flex items-center">Wallets</Link>
+            <Link to="/docs" className="hover:text-green-400 transition-colors min-h-[44px] flex items-center">Developers</Link>
           </div>
         </div>
       </footer>
diff --git a/frontend-dapp/src/components/layout/MobileBottomNav.tsx b/frontend-dapp/src/components/layout/MobileBottomNav.tsx
new file mode 100644
index 0000000..1c43fcd
--- /dev/null
+++ b/frontend-dapp/src/components/layout/MobileBottomNav.tsx
@@ -0,0 +1,43 @@
+import { Link, useLocation } from 'react-router-dom';
+import NasaIcon from '../icons/NasaIcon';
+
+type Props = {
+  onOpenMenu: () => void;
+};
+
+const TABS = [
+  { to: '/hub', label: 'Home', icon: 'dashboard' as const },
+  { to: '/bridge', label: 'Bridge', icon: 'bridge' as const },
+  { to: '/trade', label: 'Trade', icon: 'trade' as const },
+  { to: '/central-bank', label: 'Z Bank', icon: 'central-bank' as const },
+];
+
+export default function MobileBottomNav({ onOpenMenu }: Props) {
+  const location = useLocation();
+
+  const isActive = (path: string) => {
+    if (path === '/hub') return location.pathname === '/hub' || location.pathname === '/';
+    if (path === '/bridge') return location.pathname === '/bridge' || location.pathname.startsWith('/bridge');
+    if (path === '/') return location.pathname === '/';
+    return location.pathname.startsWith(path);
+  };
+
+  return (
+    <nav className="dbis-bottom-nav md:hidden" aria-label="Primary navigation">
+      {TABS.map(({ to, label, icon }) => (
+        <Link
+          key={to}
+          to={to}
+          className={`dbis-bottom-nav__item${isActive(to) ? ' dbis-bottom-nav__item--active' : ''}`}
+        >
+          <NasaIcon name={icon} size={20} />
+          <span>{label}</span>
+        </Link>
+      ))}
+      <button type="button" className="dbis-bottom-nav__item" onClick={onOpenMenu} aria-label="Open menu">
+        <span className="text-lg leading-none">☰</span>
+        <span>More</span>
+      </button>
+    </nav>
+  );
+}
diff --git a/frontend-dapp/src/components/layout/MobileNavDrawer.tsx b/frontend-dapp/src/components/layout/MobileNavDrawer.tsx
new file mode 100644
index 0000000..ce789ad
--- /dev/null
+++ b/frontend-dapp/src/components/layout/MobileNavDrawer.tsx
@@ -0,0 +1,80 @@
+import { useEffect } from 'react';
+import { Link } from 'react-router-dom';
+
+export type MobileNavItem = {
+  to?: string;
+  href?: string;
+  label: string;
+  active?: boolean;
+  onClick?: () => void;
+};
+
+type Props = {
+  open: boolean;
+  onClose: () => void;
+  title: string;
+  items: MobileNavItem[];
+};
+
+export default function MobileNavDrawer({ open, onClose, title, items }: Props) {
+  useEffect(() => {
+    if (!open) return;
+    const prev = document.body.style.overflow;
+    document.body.style.overflow = 'hidden';
+    return () => {
+      document.body.style.overflow = prev;
+    };
+  }, [open]);
+
+  if (!open) return null;
+
+  return (
+    <div className="fixed inset-0 z-[100] lg:hidden" role="dialog" aria-modal="true" aria-label={title}>
+      <button
+        type="button"
+        className="absolute inset-0 bg-black/75 backdrop-blur-sm"
+        aria-label="Close menu"
+        onClick={onClose}
+      />
+      <nav className="absolute top-0 left-0 bottom-0 w-[min(100vw,20rem)] bg-[#141a16] border-r border-green-500/20 flex flex-col shadow-2xl safe-area-pad">
+        <div className="flex items-center justify-between px-4 py-3 border-b border-white/10 min-h-[56px]">
+          <span className="text-white font-semibold text-sm">{title}</span>
+          <button
+            type="button"
+            onClick={onClose}
+            className="text-white/80 hover:text-white p-2 min-h-[44px] min-w-[44px] flex items-center justify-center rounded-lg"
+            aria-label="Close"
+          >
+            ✕
+          </button>
+        </div>
+        <ul className="flex-1 overflow-y-auto py-2">
+          {items.map((item) => {
+            const className = `block w-full text-left px-4 py-3 text-sm font-medium min-h-[44px] ${
+              item.active ? 'bg-green-600/20 text-green-300 border-l-2 border-green-400' : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
+            }`;
+            if (item.href) {
+              return (
+                <li key={item.href}>
+                  <a href={item.href} target="_blank" rel="noopener noreferrer" className={className} onClick={onClose}>
+                    {item.label}
+                  </a>
+                </li>
+              );
+            }
+            if (item.to) {
+              return (
+                <li key={item.to}>
+                  <Link to={item.to} className={className} onClick={() => { item.onClick?.(); onClose(); }}>
+                    {item.label}
+                  </Link>
+                </li>
+              );
+            }
+            return null;
+          })}
+        </ul>
+      </nav>
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/components/layout/OmnlProductLayout.tsx b/frontend-dapp/src/components/layout/OmnlProductLayout.tsx
index 52e401e..56ff748 100644
--- a/frontend-dapp/src/components/layout/OmnlProductLayout.tsx
+++ b/frontend-dapp/src/components/layout/OmnlProductLayout.tsx
@@ -1,122 +1,92 @@
 import { Link, Outlet, useLocation } from 'react-router-dom';
-
-import { useRef } from 'react';
-
+import { useRef, useState } from 'react';
 import WalletConnect from '../wallet/WalletConnect';
-
 import WalletDisconnectNotice from '../wallet/WalletDisconnectNotice';
-
 import NasaIcon, { type NasaIconName } from '../icons/NasaIcon';
-
-
+import MobileNavDrawer from './MobileNavDrawer';
+import MobileBottomNav from './MobileBottomNav';
 
 const PRODUCTS: { path: string; label: string; icon: NasaIconName }[] = [
-
-  { path: '/hub', label: 'Hub', icon: 'satellite' },
-
+  { path: '/hub', label: 'DBIS Dashboard', icon: 'dashboard' },
   { path: '/central-bank', label: 'Central Bank', icon: 'central-bank' },
-
-  { path: '/office-24', label: 'Office 24', icon: 'office' },
-
-  { path: '/trade', label: 'DBIS Trade', icon: 'trade' },
-
-  { path: '/swap', label: 'Digital Swap', icon: 'swap' },
-
+  { path: '/office-24', label: 'O24 Central Bank', icon: 'office' },
+  { path: '/trade', label: 'Trade', icon: 'trade' },
+  { path: '/swap', label: 'Swap', icon: 'swap' },
 ];
 
-
-
 export default function OmnlProductLayout() {
-
   const location = useLocation();
-
   const userInitiatedDisconnectRef = useRef(false);
+  const [menuOpen, setMenuOpen] = useState(false);
 
+  const isActive = (path: string) =>
+    path === '/hub' ? location.pathname === '/hub' : location.pathname.startsWith(path);
 
+  const drawerItems = [
+    ...PRODUCTS.map((p) => ({ to: p.path, label: p.label, active: isActive(p.path) })),
+    { to: '/bridge', label: 'Bridge', active: location.pathname === '/bridge' },
+    { to: '/admin', label: 'Admin', active: location.pathname === '/admin' },
+    { to: '/wallets', label: 'Wallets', active: location.pathname === '/wallets' },
+  ];
 
-  const isActive = (path: string) => location.pathname.startsWith(path);
-
-
+  const isBanking = location.pathname === '/central-bank';
 
   return (
-
-    <div className="omnl-app min-h-screen flex flex-col">
-
+    <div className={`omnl-app min-h-screen flex flex-col dbis-has-bottom-nav${isBanking ? ' omnl-banking-theme' : ''}`}>
       <WalletDisconnectNotice userInitiatedDisconnectRef={userInitiatedDisconnectRef} />
-
-      <header className="omnl-app-header sticky top-0 z-50 border-b">
-
-        <div className="max-w-[1600px] mx-auto px-4 h-14 flex items-center gap-4">
-
-          <Link to="/hub" className="flex items-center gap-2 shrink-0">
-
-            <span className="w-8 h-8 border border-[#2d6bb8] bg-[#163a6b] text-[#00d4ff] font-bold flex items-center justify-center text-sm">
-
-              <NasaIcon name="satellite" size={16} className="nasa-icon--telemetry" />
-
+      <header className="omnl-app-header mobile-nav-bar sticky top-0 z-50 border-b border-green-500/20 safe-area-top bg-[#1a241c]">
+        <div className="max-w-[1600px] mx-auto px-3 sm:px-4 h-14 flex items-center gap-2 sm:gap-4">
+          <button
+            type="button"
+            className="md:hidden shrink-0 text-white p-2 min-h-[44px] min-w-[44px] rounded-lg hover:bg-white/10"
+            aria-label="Open menu"
+            aria-expanded={menuOpen}
+            onClick={() => setMenuOpen(true)}
+          >
+            ☰
+          </button>
+          <Link to="/hub" className="flex items-center gap-2 shrink-0 min-w-0">
+            <span className="w-8 h-8 rounded-lg bg-green-600 text-white font-bold flex items-center justify-center text-sm shrink-0">
+              <NasaIcon name="central-bank" size={16} />
             </span>
-
-            <span className="nasa-nav-brand font-semibold hidden sm:inline text-sm">OMNL Mission Control</span>
-
+            <span className="font-semibold hidden sm:inline text-sm truncate text-white">DBIS OMNL</span>
           </Link>
 
-
-
-          <nav className="flex items-center gap-1 flex-1 overflow-x-auto" aria-label="OMNL products">
-
+          <nav className="hidden md:flex items-center gap-1 flex-1 overflow-x-auto min-w-0" aria-label="OMNL products">
             {PRODUCTS.map(({ path, label, icon }) => (
-
               <Link
-
                 key={path}
-
                 to={path}
-
-                className={`nasa-nav-link shrink-0 ${isActive(path) ? 'nasa-nav-link--active' : ''}`}
-
+                className={`px-3 py-2 rounded-lg text-sm font-medium transition-colors whitespace-nowrap min-h-[40px] flex items-center gap-1.5 ${
+                  isActive(path) ? 'bg-green-600 text-white' : 'text-[#848e9c] hover:text-white hover:bg-white/5'
+                }`}
               >
-
                 <NasaIcon name={icon} size={14} />
-
-                {label}
-
+                <span className="hidden lg:inline">{label}</span>
+                <span className="lg:hidden">{label.split(' ')[0]}</span>
               </Link>
-
             ))}
-
           </nav>
 
-
-
           <Link
-
             to="/bridge"
-
-            className="nasa-nav-link hidden md:inline shrink-0 !border-transparent"
-
+            className="hidden lg:inline-flex items-center gap-1.5 px-3 py-2 rounded-lg text-sm font-medium text-[#848e9c] hover:text-white hover:bg-white/5 min-h-[40px]"
           >
-
             <NasaIcon name="bridge" size={14} />
-
             Bridge
-
           </Link>
-
-          <WalletConnect onBeforeDisconnect={() => { userInitiatedDisconnectRef.current = true; }} />
-
+          <div className="shrink-0 max-w-[45%] sm:max-w-none ml-auto">
+            <WalletConnect onBeforeDisconnect={() => { userInitiatedDisconnectRef.current = true; }} />
+          </div>
         </div>
-
       </header>
 
-      <main className="flex-1">
+      <MobileNavDrawer open={menuOpen} onClose={() => setMenuOpen(false)} title="DBIS OMNL" items={drawerItems} />
+      <MobileBottomNav onOpenMenu={() => setMenuOpen(true)} />
 
+      <main className="flex-1 w-full min-w-0 overflow-x-hidden">
         <Outlet />
-
       </main>
-
     </div>
-
   );
-
 }
-
diff --git a/frontend-dapp/src/components/layout/ZMobileBottomNav.tsx b/frontend-dapp/src/components/layout/ZMobileBottomNav.tsx
new file mode 100644
index 0000000..e8e86cb
--- /dev/null
+++ b/frontend-dapp/src/components/layout/ZMobileBottomNav.tsx
@@ -0,0 +1,41 @@
+import { Link, useLocation } from 'react-router-dom';
+import NasaIcon from '../icons/NasaIcon';
+
+type Props = {
+  onOpenMenu: () => void;
+};
+
+const TABS = [
+  { to: '/z', label: 'Hub', icon: 'dashboard' as const },
+  { to: '/z-wallet', label: 'Wallet', icon: 'wallet' as const },
+  { to: '/swap', label: 'Swap', icon: 'swap' as const },
+  { to: '/central-bank', label: 'Z Bank', icon: 'central-bank' as const },
+];
+
+export default function ZMobileBottomNav({ onOpenMenu }: Props) {
+  const location = useLocation();
+
+  const isActive = (path: string) => {
+    if (path === '/z') return location.pathname === '/z' || location.pathname === '/';
+    return location.pathname.startsWith(path);
+  };
+
+  return (
+    <nav className="z-bottom-nav md:hidden" aria-label="Z Ecosystem navigation">
+      {TABS.map(({ to, label, icon }) => (
+        <Link
+          key={to}
+          to={to}
+          className={`z-bottom-nav__item${isActive(to) ? ' z-bottom-nav__item--active' : ''}`}
+        >
+          <NasaIcon name={icon} size={20} />
+          <span>{label}</span>
+        </Link>
+      ))}
+      <button type="button" className="z-bottom-nav__item" onClick={onOpenMenu} aria-label="Open menu">
+        <span className="text-lg leading-none">☰</span>
+        <span>More</span>
+      </button>
+    </nav>
+  );
+}
diff --git a/frontend-dapp/src/components/layout/ZProductLayout.tsx b/frontend-dapp/src/components/layout/ZProductLayout.tsx
new file mode 100644
index 0000000..f8d824c
--- /dev/null
+++ b/frontend-dapp/src/components/layout/ZProductLayout.tsx
@@ -0,0 +1,84 @@
+import { Link, Outlet, useLocation } from 'react-router-dom';
+import { useRef, useState } from 'react';
+import WalletConnect from '../wallet/WalletConnect';
+import WalletDisconnectNotice from '../wallet/WalletDisconnectNotice';
+import NasaIcon, { type NasaIconName } from '../icons/NasaIcon';
+import MobileNavDrawer from './MobileNavDrawer';
+import ZMobileBottomNav from './ZMobileBottomNav';
+import { Z_ECOSYSTEM_PUBLIC_URL } from '../../config/zEcosystemDomain';
+
+const PRODUCTS: { path: string; label: string; icon: NasaIconName }[] = [
+  { path: '/z', label: 'Z Hub', icon: 'dashboard' },
+  { path: '/z-wallet', label: 'Z Wallet', icon: 'wallet' },
+  { path: '/swap', label: 'Swap', icon: 'swap' },
+  { path: '/central-bank', label: 'Z Online Bank', icon: 'central-bank' },
+];
+
+export default function ZProductLayout() {
+  const location = useLocation();
+  const userInitiatedDisconnectRef = useRef(false);
+  const [menuOpen, setMenuOpen] = useState(false);
+
+  const isActive = (path: string) =>
+    path === '/z' ? location.pathname === '/z' : location.pathname.startsWith(path);
+
+  const drawerItems = PRODUCTS.map((p) => ({ to: p.path, label: p.label, active: isActive(p.path) }));
+  const isBanking = location.pathname === '/central-bank';
+
+  return (
+    <div
+      className={`omnl-app min-h-screen flex flex-col dbis-has-bottom-nav z-ecosystem-theme${isBanking ? ' omnl-banking-theme' : ''}`}
+    >
+      <WalletDisconnectNotice userInitiatedDisconnectRef={userInitiatedDisconnectRef} />
+      <header className="omnl-app-header mobile-nav-bar sticky top-0 z-50 border-b border-purple-500/30 safe-area-top bg-[#1a1624]">
+        <div className="max-w-[1600px] mx-auto px-3 sm:px-4 h-14 flex items-center gap-2 sm:gap-4">
+          <button
+            type="button"
+            className="md:hidden shrink-0 text-white p-2 min-h-[44px] min-w-[44px] rounded-lg hover:bg-white/10"
+            aria-label="Open menu"
+            aria-expanded={menuOpen}
+            onClick={() => setMenuOpen(true)}
+          >
+            ☰
+          </button>
+          <Link to="/z" className="flex items-center gap-2 shrink-0 min-w-0">
+            <span className="w-8 h-8 rounded-lg bg-purple-600 text-white font-bold flex items-center justify-center text-sm shrink-0">
+              Z
+            </span>
+            <span className="font-semibold hidden sm:inline text-sm truncate text-white">Z Blockchain System</span>
+          </Link>
+
+          <nav className="hidden md:flex items-center gap-1 flex-1 overflow-x-auto min-w-0" aria-label="Z Ecosystem">
+            {PRODUCTS.map(({ path, label, icon }) => (
+              <Link
+                key={path}
+                to={path}
+                className={`px-3 py-2 rounded-lg text-sm font-medium transition-colors whitespace-nowrap min-h-[40px] flex items-center gap-1.5 ${
+                  isActive(path) ? 'bg-purple-600 text-white' : 'text-[#848e9c] hover:text-white hover:bg-white/5'
+                }`}
+              >
+                <NasaIcon name={icon} size={14} />
+                {label}
+              </Link>
+            ))}
+          </nav>
+
+          <div className="shrink-0 max-w-[45%] sm:max-w-none ml-auto">
+            <WalletConnect onBeforeDisconnect={() => { userInitiatedDisconnectRef.current = true; }} />
+          </div>
+        </div>
+      </header>
+
+      <MobileNavDrawer open={menuOpen} onClose={() => setMenuOpen(false)} title="Z Ecosystem" items={drawerItems} />
+      <ZMobileBottomNav onOpenMenu={() => setMenuOpen(true)} />
+
+      <main className="flex-1">
+        <Outlet />
+      </main>
+
+      <footer className="text-center text-xs text-[#6b7280] py-3 border-t border-white/5">
+        {Z_ECOSYSTEM_PUBLIC_URL.replace(/^https?:\/\//, '')}
+      </footer>
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/components/ui/ToastProvider.tsx b/frontend-dapp/src/components/ui/ToastProvider.tsx
index b7a63dd..69d9d1d 100644
--- a/frontend-dapp/src/components/ui/ToastProvider.tsx
+++ b/frontend-dapp/src/components/ui/ToastProvider.tsx
@@ -34,7 +34,7 @@ export default function ToastProvider() {
         },
         loading: {
           iconTheme: {
-            primary: '#3b82f6',
+            primary: '#22c55e',
             secondary: '#fff',
           },
         },
diff --git a/frontend-dapp/src/components/wallet/WalletConnect.tsx b/frontend-dapp/src/components/wallet/WalletConnect.tsx
index 2e93262..7c58d64 100644
--- a/frontend-dapp/src/components/wallet/WalletConnect.tsx
+++ b/frontend-dapp/src/components/wallet/WalletConnect.tsx
@@ -128,7 +128,7 @@ export default function WalletConnect({ onBeforeDisconnect }: WalletConnectProps
     <>
       <button
         onClick={() => setShowConnectModal(true)}
-        className="px-6 py-3 bg-teal-600 text-white font-medium rounded-xl hover:bg-teal-500 transition-colors focus:outline-none focus:ring-2 focus:ring-teal-500 focus:ring-offset-2 focus:ring-offset-[#252830] min-h-[44px] w-full md:w-auto"
+        className="px-6 py-3 bg-green-600 text-white font-medium rounded-xl hover:bg-green-500 transition-colors focus:outline-none focus:ring-2 focus:ring-green-500 focus:ring-offset-2 focus:ring-offset-[#252830] min-h-[44px] w-full md:w-auto"
       >
         Connect Wallet
       </button>
@@ -152,7 +152,7 @@ export default function WalletConnect({ onBeforeDisconnect }: WalletConnectProps
                 >
                   <span>{connector.name}</span>
                   {isPending && (
-                    <svg className="animate-spin h-5 w-5 text-teal-400" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
+                    <svg className="animate-spin h-5 w-5 text-green-400" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
                       <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4"></circle>
                       <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"></path>
                     </svg>
diff --git a/frontend-dapp/src/config/chainIcons.ts b/frontend-dapp/src/config/chainIcons.ts
index 3177f79..676297a 100644
--- a/frontend-dapp/src/config/chainIcons.ts
+++ b/frontend-dapp/src/config/chainIcons.ts
@@ -13,6 +13,8 @@ export const CHAIN_ICON_URLS: Record<number, string> = {
   100: `${TW}/xdai/info/logo.png`,
   137: `${TW}/polygon/info/logo.png`,
   138: ETH_DIAMOND, // Chain 138 (DBIS) - from chain-138.json
+  900001: ETH_DIAMOND, // Shiva Blockchain (OneX)
+  900002: ETH_DIAMOND, // Z Chain
   42161: `${TW}/arbitrum/info/logo.png`,
   43114: `${TW}/avalanchec/info/logo.png`,
   8453: `${TW}/base/info/logo.png`,
diff --git a/frontend-dapp/src/config/dex.ts b/frontend-dapp/src/config/dex.ts
index ce0330c..3bb3369 100644
--- a/frontend-dapp/src/config/dex.ts
+++ b/frontend-dapp/src/config/dex.ts
@@ -9,28 +9,29 @@ function prodOrLocal(envValue: string | undefined, prodPath: string, localUrl: s
 
 export const TOKEN_AGGREGATION_URL = prodOrLocal(
   import.meta.env.VITE_TOKEN_AGGREGATION_URL,
-  '/api/v1',
+  'https://explorer.d-bis.org/api/v1',
   'http://localhost:3000',
 );
 export const DBIS_EXCHANGE_URL = prodOrLocal(
   import.meta.env.VITE_DBIS_EXCHANGE_URL,
-  '/exchange',
+  'https://exchange.omdnl.org/exchange',
   'http://localhost:3012',
 );
 export const SETTLEMENT_MIDDLEWARE_URL = prodOrLocal(
   import.meta.env.VITE_SETTLEMENT_MIDDLEWARE_URL,
-  '/settlement',
+  'https://secure.omdnl.org/settlement',
   'http://localhost:3011',
 );
 
-/** Production nginx maps /settlement/* → settlement-middleware /api/v1/settlement/* */
+/** Production nginx maps /settlement/* and /exchange/* to middleware; bare localhost needs /api/v1/... */
 function proxiedServiceUrl(base: string, servicePrefix: string, path: string): string {
   const root = base.replace(/\/$/, '');
   const suffix = path.startsWith('/') ? path : `/${path}`;
   if (root.startsWith('/')) {
     return `${root}${suffix}`;
   }
-  return `${root}${servicePrefix}${suffix}`;
+  const nginxPortal = /\/(settlement|exchange)$/.test(root);
+  return nginxPortal ? `${root}${suffix}` : `${root}${servicePrefix}${suffix}`;
 }
 
 export function settlementApi(path: string): string {
@@ -41,11 +42,18 @@ export function exchangeApi(path: string): string {
   return proxiedServiceUrl(DBIS_EXCHANGE_URL, '/api/v1/exchange', path);
 }
 
-/** Bearer auth for OMNL mutating APIs — production portals inject via nginx; never embed operator keys in browser. */
+/** Token aggregation OMNL routes (fiat LP positions, quotes). */
+export function tokenAggregationApi(path: string): string {
+  const root = TOKEN_AGGREGATION_URL.replace(/\/$/, '');
+  const suffix = path.startsWith('/') ? path : `/${path}`;
+  if (root.endsWith('/api/v1')) return `${root}${suffix}`;
+  return `${root}/api/v1${suffix}`;
+}
+
+/** Bearer auth for OMNL mutating APIs — set VITE_OMNL_API_KEY at build for tunnel deploy; nginx injects in prod portals. */
 export function omnlApiHeaders(json = true): Record<string, string> {
   const headers: Record<string, string> = {};
   if (json) headers['Content-Type'] = 'application/json';
-  if (import.meta.env.PROD) return headers;
   const key = import.meta.env.VITE_OMNL_API_KEY?.trim();
   if (key) headers.Authorization = `Bearer ${key}`;
   return headers;
diff --git a/frontend-dapp/src/config/ecosystemLinkRouting.ts b/frontend-dapp/src/config/ecosystemLinkRouting.ts
new file mode 100644
index 0000000..208a2c1
--- /dev/null
+++ b/frontend-dapp/src/config/ecosystemLinkRouting.ts
@@ -0,0 +1,16 @@
+import type { EcosystemLink } from './ecosystemLinks';
+
+/** Paths served outside the React SPA (static HTML or proxied APIs). */
+export function isStaticPortalPath(href: string): boolean {
+  return (
+    href.startsWith('/omnl') ||
+    href.startsWith('/api') ||
+    href.startsWith('/settlement') ||
+    href.startsWith('/exchange') ||
+    href.startsWith('/reserve/institutional')
+  );
+}
+
+export function ecosystemLinkUsesAnchor(link: EcosystemLink): boolean {
+  return Boolean(link.external) || link.href.startsWith('http') || isStaticPortalPath(link.href);
+}
diff --git a/frontend-dapp/src/config/ecosystemLinks.ts b/frontend-dapp/src/config/ecosystemLinks.ts
new file mode 100644
index 0000000..a80c9e3
--- /dev/null
+++ b/frontend-dapp/src/config/ecosystemLinks.ts
@@ -0,0 +1,77 @@
+import type { NasaIconName } from '../components/icons/NasaIcon';
+import { defaultFrontendExplorerUrl } from './networks';
+
+export type EcosystemLinkAccent = 'green' | 'teal' | 'blue' | 'gold' | 'purple' | 'slate';
+
+export type EcosystemLink = {
+  id: string;
+  label: string;
+  description: string;
+  icon: NasaIconName;
+  href: string;
+  external?: boolean;
+  accent?: EcosystemLinkAccent;
+};
+
+/** In-app React routes (OMNL / DBIS — no Z products) */
+export const IN_APP_LINKS: EcosystemLink[] = [
+  { id: 'bridge', label: 'Bridge', description: 'Cross-chain bridge, CCIP, XRPL, trustless', icon: 'bridge', href: '/bridge', accent: 'teal' },
+  { id: 'swap', label: 'Digital Swap', description: 'M2 load, token swap, settlement rails', icon: 'swap', href: '/swap', accent: 'blue' },
+  { id: 'trade', label: 'DBIS Trade', description: 'Markets, order book, spot trading', icon: 'trade', href: '/trade', accent: 'gold' },
+  { id: 'central-bank', label: 'Central Bank', description: 'OMNL balances & payments', icon: 'central-bank', href: '/central-bank', accent: 'green' },
+  { id: 'office-24', label: 'Office 24 Central Bank', description: '128-bank corridors · IPSAS settlement', icon: 'office', href: '/office-24', accent: 'purple' },
+  { id: 'reserve', label: 'Reserve', description: 'Coverage, attestation, peg status', icon: 'money', href: '/reserve', accent: 'green' },
+  { id: 'history', label: 'History', description: 'Bridge transfer lookup & tracking', icon: 'ledger', href: '/history', accent: 'slate' },
+  { id: 'wallets', label: 'Wallets', description: 'OneX Wallet · email, social, passkey on Shiva', icon: 'wallet', href: '/wallets', accent: 'blue' },
+  { id: 'admin', label: 'Admin', description: 'Multisig, channels, bridge operators', icon: 'admin', href: '/admin', accent: 'slate' },
+  { id: 'docs', label: 'Developers', description: 'API reference & integration', icon: 'code', href: '/docs', accent: 'teal' },
+  { id: 'hub', label: 'DBIS Dashboard', description: 'All apps, consoles & API links', icon: 'dashboard', href: '/hub', accent: 'green' },
+];
+
+/** Primary apps shown in dashboard quick-access strip (OMNL only) */
+export const FEATURED_APP_LINKS: EcosystemLink[] = [
+  IN_APP_LINKS.find((l) => l.id === 'central-bank')!,
+  IN_APP_LINKS.find((l) => l.id === 'bridge')!,
+  IN_APP_LINKS.find((l) => l.id === 'trade')!,
+  IN_APP_LINKS.find((l) => l.id === 'swap')!,
+  IN_APP_LINKS.find((l) => l.id === 'office-24')!,
+];
+
+/** Static operator consoles — served from /omnl/* (portal-serve or token-aggregation :3000) */
+export const OPERATOR_CONSOLE_LINKS: EcosystemLink[] = [
+  { id: 'compliance', label: 'OMNL Compliance Console', description: 'Posture, pending actions, Safe tx', icon: 'shield', href: '/omnl/compliance', accent: 'purple' },
+  { id: 'omnl-dash', label: 'OMNL API Snapshot', description: 'Registry and Fineract compare JSON', icon: 'chart', href: '/omnl/dashboard', accent: 'blue' },
+  { id: 'reserve-dash', label: 'Reserve Dashboard', description: 'Proof rows, coverage, institutional view', icon: 'money', href: '/reserve', accent: 'green' },
+  { id: 'settlement-term', label: 'Settlement Terminal', description: 'Operator settlement terminal UI', icon: 'terminal', href: '/omnl/terminal', accent: 'gold' },
+  { id: 'token-admin', label: 'Token Aggregation API', description: 'API catalog JSON', icon: 'ledger', href: '/api/v1/omnl/catalog', accent: 'teal' },
+];
+
+/** Public production portals (OMNL / DBIS) */
+export const PUBLIC_PORTAL_LINKS: EcosystemLink[] = [
+  { id: 'pub-cb', label: 'Central Bank', description: 'secure.omdnl.org', icon: 'central-bank', href: 'https://secure.omdnl.org/central-bank', external: true, accent: 'green' },
+  { id: 'pub-online', label: 'Online banking', description: 'online.omdnl.org', icon: 'globe', href: 'https://online.omdnl.org/central-bank', external: true, accent: 'green' },
+  { id: 'pub-o24', label: 'Office 24 Central Bank', description: 'office24.omdnl.org', icon: 'office', href: 'https://office24.omdnl.org/office-24', external: true, accent: 'purple' },
+  { id: 'pub-trade', label: 'Exchange', description: 'exchange.omdnl.org', icon: 'trade', href: 'https://exchange.omdnl.org/trade', external: true, accent: 'gold' },
+  { id: 'pub-forex', label: 'Forex', description: 'forex.omdnl.org', icon: 'trade', href: 'https://forex.omdnl.org/trade', external: true, accent: 'gold' },
+  { id: 'explorer', label: 'Chain 138 Explorer', description: 'Blocks, contracts, transactions', icon: 'globe', href: defaultFrontendExplorerUrl, external: true, accent: 'slate' },
+];
+
+/** Public Z Ecosystem portal — separate from OMNL (zblockchainsystem.com) */
+export const Z_ECOSYSTEM_PORTAL_LINKS: EcosystemLink[] = [
+  { id: 'z-hub', label: 'Z Ecosystem', description: 'zblockchainsystem.com', icon: 'globe', href: 'https://zblockchainsystem.com/z', external: true, accent: 'purple' },
+  { id: 'z-wallet', label: 'International Z Wallet', description: 'Z Chain wallet + corridors', icon: 'wallet', href: 'https://zblockchainsystem.com/z-wallet', external: true, accent: 'blue' },
+  { id: 'z-bot', label: 'Z Bot', description: 'In-app assistant', icon: 'terminal', href: 'https://zblockchainsystem.com/z-wallet#z-bot', external: true, accent: 'teal' },
+  { id: 'z-swap', label: 'Digital Swap', description: 'zblockchainsystem.com', icon: 'swap', href: 'https://zblockchainsystem.com/swap', external: true, accent: 'teal' },
+  { id: 'z-bank', label: 'Z Online Bank', description: 'M0–M4 settlement UI', icon: 'central-bank', href: 'https://zblockchainsystem.com/central-bank', external: true, accent: 'green' },
+];
+
+/** API & docs endpoints — same-origin via portal-serve proxy on tunnel/local */
+export const API_LINKS: EcosystemLink[] = [
+  { id: 'openapi', label: 'OpenAPI JSON', description: 'Machine-readable OMNL API spec', icon: 'code', href: '/api/v1/omnl/openapi.json', accent: 'teal' },
+  { id: 'catalog', label: 'API Catalog', description: 'All OMNL routes and auth notes', icon: 'ledger', href: '/api/v1/omnl/catalog', accent: 'blue' },
+  { id: 'integration', label: 'Integration Status', description: 'Configured env groups (no secrets)', icon: 'check', href: '/api/v1/omnl/integration-status', accent: 'green' },
+  { id: 'registry', label: 'IPSAS Registry', description: 'GL registry JSON', icon: 'money', href: '/api/v1/omnl/ipsas/registry', accent: 'gold' },
+  { id: 'settlement-health', label: 'Settlement health', description: '128-chain settlement middleware', icon: 'check', href: '/settlement/health', accent: 'green' },
+  { id: 'exchange-health', label: 'Exchange health', description: 'DBIS exchange service', icon: 'check', href: '/exchange/health', accent: 'green' },
+  { id: 'fineract-swagger', label: 'Fineract Swagger', description: 'omnl.hybxfinance.io', icon: 'chart', href: 'https://omnl.hybxfinance.io/fineract-provider/swagger-ui/index.html', external: true, accent: 'purple' },
+];
diff --git a/frontend-dapp/src/config/ecosystemMode.ts b/frontend-dapp/src/config/ecosystemMode.ts
new file mode 100644
index 0000000..47a12e2
--- /dev/null
+++ b/frontend-dapp/src/config/ecosystemMode.ts
@@ -0,0 +1,9 @@
+/** Build profile: `z` = Z Blockchain System only; `omnl` = DBIS / OMNL only */
+export type EcosystemMode = 'z' | 'omnl';
+
+const raw = (import.meta.env.VITE_ECOSYSTEM as string | undefined)?.trim().toLowerCase();
+
+export const ECOSYSTEM_MODE: EcosystemMode = raw === 'z' ? 'z' : 'omnl';
+
+export const isZEcosystem = ECOSYSTEM_MODE === 'z';
+export const isOmnlEcosystem = ECOSYSTEM_MODE === 'omnl';
diff --git a/frontend-dapp/src/config/guosmmNotices.ts b/frontend-dapp/src/config/guosmmNotices.ts
new file mode 100644
index 0000000..cddf1e5
--- /dev/null
+++ b/frontend-dapp/src/config/guosmmNotices.ts
@@ -0,0 +1,46 @@
+/** GUOSMM gazette notices — SSOT: config/guosmm-notices.v1.json */
+export type GuosmmNoticeLink = {
+  documentId: string;
+  title: string;
+  url: string;
+  series: string;
+  entity?: string;
+  fineractOfficeId?: number;
+};
+
+export const GUOSMM_GAZETTE_BASE = 'https://gazette.shosjj.org/notices/2026';
+
+export const GUOSMM_NOTICES: GuosmmNoticeLink[] = [
+  {
+    documentId: 'GUOSMM-B-2026-001',
+    series: 'B',
+    title: 'Central Bank Charter — OMNL',
+    url: `${GUOSMM_GAZETTE_BASE}/GUOSMM-B-2026-001`,
+  },
+  {
+    documentId: 'GUOSMM-C-2026-003',
+    series: 'C',
+    title: 'zBank — ISB Operations Charter',
+    url: `${GUOSMM_GAZETTE_BASE}/GUOSMM-C-2026-003`,
+    entity: 'zBank',
+    fineractOfficeId: 29,
+  },
+  {
+    documentId: 'GUOSMM-C-2026-004',
+    series: 'C',
+    title: 'NovaBank — ISB Operations Charter',
+    url: `${GUOSMM_GAZETTE_BASE}/GUOSMM-C-2026-004`,
+    entity: 'NovaBank',
+    fineractOfficeId: 30,
+  },
+  {
+    documentId: 'GUOSMM-C-2026-005',
+    series: 'C',
+    title: 'AnakaBank — ISB Operations Charter',
+    url: `${GUOSMM_GAZETTE_BASE}/GUOSMM-C-2026-005`,
+    entity: 'AnakaBank',
+    fineractOfficeId: 31,
+  },
+];
+
+export const GUOSMM_API_CATALOG = '/api/v1/omnl/gazette/notices';
diff --git a/frontend-dapp/src/config/networks.ts b/frontend-dapp/src/config/networks.ts
index aa1e91a..6627b64 100644
--- a/frontend-dapp/src/config/networks.ts
+++ b/frontend-dapp/src/config/networks.ts
@@ -13,6 +13,19 @@ import {
   optimism,
 } from 'wagmi/chains'
 
+import {
+  SHIVA_ONEX_CHAIN_ID,
+  shivaOnexExplorerUrl,
+  shivaOnexRpcUrl,
+} from './onexShiva'
+import {
+  Z_CHAIN_ID,
+  zChainExplorerUrl,
+  zChainRpcUrl,
+} from './zChain'
+
+const rpcUrlShivaOneX = shivaOnexRpcUrl
+const rpcUrlZChain = zChainRpcUrl
 const rpcUrl138 = import.meta.env.VITE_RPC_URL_138 || 'https://rpc-http-pub.d-bis.org'
 const rpcUrl651940 = import.meta.env.VITE_RPC_URL_651940 || 'https://mainnet-rpc.alltra.global'
 const rpcUrl42793 = import.meta.env.VITE_RPC_URL_42793 || 'https://node.mainnet.etherlink.com'
@@ -74,6 +87,54 @@ export const chain138 = defineChain({
   },
 })
 
+/** Chain 900001 - Shiva Blockchain (OneX Wallet / OneX Bank) */
+export const shivaOneXChain = defineChain({
+  id: SHIVA_ONEX_CHAIN_ID,
+  name: 'Shiva Blockchain (OneX)',
+  network: 'shiva-onex',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Shiva',
+    symbol: 'SHIVA',
+  },
+  rpcUrls: {
+    default: { http: [rpcUrlShivaOneX] },
+    public: { http: [rpcUrlShivaOneX] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Shiva OneX Explorer',
+      url: shivaOnexExplorerUrl,
+    },
+  },
+})
+
+export const shivaOneXChainId = shivaOneXChain.id
+
+/** Chain 900002 - Z Chain (International Z Wallet) */
+export const zChain = defineChain({
+  id: Z_CHAIN_ID,
+  name: 'Z Chain',
+  network: 'z-chain',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Z',
+    symbol: 'Z',
+  },
+  rpcUrls: {
+    default: { http: [rpcUrlZChain] },
+    public: { http: [rpcUrlZChain] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Z Chain Explorer',
+      url: zChainExplorerUrl,
+    },
+  },
+})
+
+export const zChainId = zChain.id
+
 /** Chain 651940 - ALL Mainnet */
 export const allMainnet = defineChain({
   id: 651940,
@@ -165,6 +226,8 @@ export const gnosis = defineChain({
 
 const customChainsWithout2138 = [
   chain138,
+  shivaOneXChain,
+  zChain,
   allMainnet,
   etherlink,
   bsc,
@@ -175,6 +238,8 @@ const customChainsWithout2138 = [
 
 const customChainsWith2138 = [
   chain138,
+  shivaOneXChain,
+  zChain,
   chain2138Testnet,
   allMainnet,
   etherlink,
@@ -191,8 +256,8 @@ export const customChains = chain2138TestnetEnabled
 
 /** Source chains the frontend can intentionally target for wallet UX. */
 export const frontendSourceChains = chain2138TestnetEnabled
-  ? [chain138, chain2138Testnet] as const
-  : [chain138] as const
+  ? ([chain138, shivaOneXChain, zChain, chain2138Testnet] as const)
+  : ([chain138, shivaOneXChain, zChain] as const)
 
 /** Shared source-chain IDs for connect/switch prompts. */
 export const frontendSourceChainIds: number[] = frontendSourceChains.map((chain) => chain.id)
@@ -217,6 +282,8 @@ export const allNetworks = [...customChains, ...standardChains] as const
 /** Chain IDs we support (for CowSwap, Jumper, UI filters) - all deployed contract networks */
 export const supportedChainIds = [
   chain138.id,
+  shivaOneXChain.id,
+  zChain.id,
   ...(chain2138TestnetEnabled ? [chain2138Testnet.id] : []),
   allMainnet.id,
   etherlink.id,
@@ -235,6 +302,8 @@ export const supportedChainIds = [
 export const chainRpcUrls: Record<number, string> = {
   [mainnet.id]: import.meta.env.VITE_MAINNET_RPC_URL || 'https://ethereum.publicnode.com',
   [chain138.id]: rpcUrl138,
+  [shivaOneXChain.id]: rpcUrlShivaOneX,
+  [zChain.id]: rpcUrlZChain,
   ...(chain2138TestnetEnabled ? { [chain2138Testnet.id]: rpcUrl2138 } : {}),
   [allMainnet.id]: rpcUrl651940,
   [etherlink.id]: rpcUrl42793,
diff --git a/frontend-dapp/src/config/omnlInternalPaths.ts b/frontend-dapp/src/config/omnlInternalPaths.ts
index 2302c1b..617b663 100644
--- a/frontend-dapp/src/config/omnlInternalPaths.ts
+++ b/frontend-dapp/src/config/omnlInternalPaths.ts
@@ -86,6 +86,8 @@ export const INTERNAL_PATH_GROUPS: InternalPathGroup[] = [
     label: 'OMNL API',
     entries: [
       { method: 'GET', path: '/api/v1/omnl/catalog', auth: 'none' },
+      { method: 'GET', path: '/api/v1/omnl/gazette/notices', auth: 'none', notes: 'GUOSMM official gazette registry' },
+      { method: 'GET', path: '/api/v1/omnl/gazette/notices/:documentId', auth: 'none' },
       { method: 'GET', path: '/api/v1/omnl/openapi.json', auth: 'none' },
       { method: 'GET', path: '/api/v1/omnl/health', auth: 'omnl-key-in-production' },
       { method: 'GET', path: '/api/v1/omnl/ipsas/fineract-health', auth: 'omnl-key-in-production' },
diff --git a/frontend-dapp/src/config/onexShiva.ts b/frontend-dapp/src/config/onexShiva.ts
new file mode 100644
index 0000000..12472af
--- /dev/null
+++ b/frontend-dapp/src/config/onexShiva.ts
@@ -0,0 +1,24 @@
+import onexShivaConfig from '../../../config/onex-shiva-integration.v1.json';
+
+export type OnexShivaConfig = typeof onexShivaConfig;
+
+export const onexShiva = onexShivaConfig;
+
+export const SHIVA_ONEX_CHAIN_ID = Number(
+  import.meta.env.VITE_SHIVA_ONEX_CHAIN_ID || onexShiva.chain.chainId,
+);
+
+export const shivaOnexRpcUrl =
+  import.meta.env.VITE_RPC_URL_900001 ||
+  import.meta.env.VITE_SHIVA_ONEX_RPC_URL ||
+  onexShiva.chain.rpcDefault;
+
+export const shivaOnexExplorerUrl =
+  import.meta.env.VITE_SHIVA_ONEX_EXPLORER_URL || onexShiva.chain.explorerUrl;
+
+export const onexWalletEnabled =
+  import.meta.env.VITE_ENABLE_ONEX_SHIVA_WALLET !== 'false' &&
+  import.meta.env.VITE_ENABLE_ONEX_SHIVA_WALLET !== '0';
+
+export const ONEX_BANK_OFFICE_ID = onexShiva.fineract.officeId;
+export const ONEX_HYBX_WALLET_ID = onexShiva.fineract.hybxWalletId;
diff --git a/frontend-dapp/src/config/zChain.ts b/frontend-dapp/src/config/zChain.ts
new file mode 100644
index 0000000..6bb7c69
--- /dev/null
+++ b/frontend-dapp/src/config/zChain.ts
@@ -0,0 +1,21 @@
+import zChainConfig from '../../../config/z-chain-integration.v1.json';
+
+export type ZChainConfig = typeof zChainConfig;
+
+export const zChain = zChainConfig;
+
+export const Z_CHAIN_ID = Number(import.meta.env.VITE_Z_CHAIN_ID || zChain.chain.chainId);
+
+export const zChainRpcUrl =
+  import.meta.env.VITE_RPC_URL_900002 ||
+  import.meta.env.VITE_Z_CHAIN_RPC_URL ||
+  zChain.chain.rpcDefault;
+
+export const zChainExplorerUrl =
+  import.meta.env.VITE_Z_CHAIN_EXPLORER_URL || zChain.chain.explorerUrl;
+
+export const zWalletEnabled =
+  import.meta.env.VITE_ENABLE_Z_WALLET !== 'false' && import.meta.env.VITE_ENABLE_Z_WALLET !== '0';
+
+export const Z_WALLET_OFFICE_ID = zChain.fineract.officeId;
+export const Z_HYBX_WALLET_ID = zChain.fineract.hybxWalletId;
diff --git a/frontend-dapp/src/config/zEcosystemDomain.ts b/frontend-dapp/src/config/zEcosystemDomain.ts
new file mode 100644
index 0000000..c2e841c
--- /dev/null
+++ b/frontend-dapp/src/config/zEcosystemDomain.ts
@@ -0,0 +1,11 @@
+import zProd from '../../../config/z-ecosystem-production-domains.v1.json';
+
+/** Canonical public origin for Z Ecosystem (not OMNL). */
+export const Z_ECOSYSTEM_PUBLIC_URL =
+  import.meta.env.VITE_Z_ECOSYSTEM_URL?.trim() || zProd.publicUrl;
+
+export function zEcosystemUrl(path: string): string {
+  const base = Z_ECOSYSTEM_PUBLIC_URL.replace(/\/$/, '');
+  const suffix = path.startsWith('/') ? path : `/${path}`;
+  return `${base}${suffix}`;
+}
diff --git a/frontend-dapp/src/features/central-bank/ChainMatrixPanel.tsx b/frontend-dapp/src/features/central-bank/ChainMatrixPanel.tsx
index 4fa9b2b..15db1cf 100644
--- a/frontend-dapp/src/features/central-bank/ChainMatrixPanel.tsx
+++ b/frontend-dapp/src/features/central-bank/ChainMatrixPanel.tsx
@@ -1,109 +1,214 @@
-import { useEffect, useState } from 'react';
-import { fetchOmnlChainRegistry, type ChainRegistryResponse, type OmnlChainSummary } from '../../config/supported-chains';
-import NasaIcon, { StatusIcon } from '../../components/icons/NasaIcon';
-
-type Filter = 'all' | 'active' | 'primary' | 'l2';
-
-export default function ChainMatrixPanel() {
-  const [registry, setRegistry] = useState<ChainRegistryResponse | null>(null);
-  const [filter, setFilter] = useState<Filter>('active');
-  const [search, setSearch] = useState('');
-
-  useEffect(() => {
-    fetchOmnlChainRegistry().then(setRegistry);
-  }, []);
-
-  const chains = (registry?.chains ?? []).filter((c) => {
-    if (filter === 'active' && c.status !== 'active') return false;
-    if (filter === 'primary' && c.omnlRole !== 'settlement-hub' && c.omnlRole !== 'mirror-target') return false;
-    if (filter === 'l2' && c.tier !== 'l2') return false;
-    if (search) {
-      const q = search.toLowerCase();
-      return c.name.toLowerCase().includes(q) || String(c.chainId).includes(q) || c.nativeSymbol.toLowerCase().includes(q);
-    }
-    return true;
-  });
-
-  return (
-    <section id="z-settlement-protocols-chains" className="dash-card cb-card lg:col-span-2 scroll-mt-20">
-      <div className="flex flex-wrap items-center justify-between gap-3 mb-4">
-        <div>
-          <h2 className="dash-section-title flex items-center gap-2">
-            <NasaIcon name="network" size={14} className="nasa-icon--telemetry" />
-            128-chain network matrix
-          </h2>
-          <p className="text-xs text-[#7a9bb8] font-mono mt-1">
-            {registry?.stats?.active ?? 0} active · {registry?.stats?.staged ?? 0} staged ·{' '}
-            {registry?.stats?.reserved ?? 0} reserved · primary {registry?.primaryChainId ?? 138}
-          </p>
-        </div>
-        <div className="flex items-center gap-2">
-          <NasaIcon name="search" size={14} className="nasa-icon--telemetry" />
-          <input
-            type="search"
-            placeholder="Search chain…"
-            value={search}
-            onChange={(e) => setSearch(e.target.value)}
-            className="nasa-input !min-h-[36px] !w-48 text-sm"
-          />
-        </div>
-      </div>
-
-      <div className="flex gap-2 mb-4 flex-wrap">
-        {(['all', 'active', 'primary', 'l2'] as Filter[]).map((f) => (
-          <button
-            key={f}
-            type="button"
-            onClick={() => setFilter(f)}
-            className={`px-3 py-1 text-xs capitalize font-mono border ${
-              filter === f
-                ? 'border-[#00d4ff] text-[#00d4ff] bg-[#00d4ff]/10'
-                : 'border-[#1e4a8a] text-[#7a9bb8]'
-            }`}
-          >
-            {f}
-          </button>
-        ))}
-      </div>
-
-      <div className="overflow-x-auto max-h-[360px] overflow-y-auto">
-        <table className="w-full text-sm nasa-table">
-          <thead className="sticky top-0">
-            <tr className="text-left">
-              <th className="py-2 pr-3">ID</th>
-              <th className="py-2 pr-3">Network</th>
-              <th className="py-2 pr-3">Role</th>
-              <th className="py-2 pr-3">Status</th>
-              <th className="py-2 pr-3">Swap</th>
-              <th className="py-2">Bridge</th>
-            </tr>
-          </thead>
-          <tbody>
-            {chains.map((c: OmnlChainSummary) => (
-              <tr key={c.chainId}>
-                <td className="py-1.5 pr-3 font-mono text-[#00d4ff]">{c.chainId}</td>
-                <td className="py-1.5 pr-3 text-[#e8f4ff]">{c.name}</td>
-                <td className="py-1.5 pr-3 text-xs text-[#7a9bb8]">{c.omnlRole}</td>
-                <td className="py-1.5 pr-3">
-                  <span
-                    className={`text-xs px-1.5 py-0.5 font-mono uppercase ${
-                      c.status === 'active'
-                        ? 'text-[#3dff8a] border border-[#3dff8a]/35'
-                        : c.status === 'staged'
-                          ? 'text-[#ffb347] border border-[#ffb347]/35'
-                          : 'text-[#7a9bb8] border border-[#7a9bb8]/35'
-                    }`}
-                  >
-                    {c.status}
-                  </span>
-                </td>
-                <td className="py-1.5 pr-3"><StatusIcon ok={!!c.settlement?.swapEnabled} /></td>
-                <td className="py-1.5"><StatusIcon ok={!!c.settlement?.bridgeEnabled} /></td>
-              </tr>
-            ))}
-          </tbody>
-        </table>
-      </div>
-    </section>
-  );
-}
+import { useEffect, useState } from 'react';
+
+import { fetchOmnlChainRegistry, type ChainRegistryResponse, type OmnlChainSummary } from '../../config/supported-chains';
+
+import NasaIcon, { StatusIcon } from '../../components/icons/NasaIcon';
+
+
+
+type Filter = 'all' | 'active' | 'primary' | 'l2';
+
+
+
+export default function ChainMatrixPanel() {
+
+  const [registry, setRegistry] = useState<ChainRegistryResponse | null>(null);
+
+  const [filter, setFilter] = useState<Filter>('active');
+
+  const [search, setSearch] = useState('');
+
+
+
+  useEffect(() => {
+
+    fetchOmnlChainRegistry().then(setRegistry);
+
+  }, []);
+
+
+
+  const chains = (registry?.chains ?? []).filter((c) => {
+
+    if (filter === 'active' && c.status !== 'active') return false;
+
+    if (filter === 'primary' && c.omnlRole !== 'settlement-hub' && c.omnlRole !== 'mirror-target') return false;
+
+    if (filter === 'l2' && c.tier !== 'l2') return false;
+
+    if (search) {
+
+      const q = search.toLowerCase();
+
+      return c.name.toLowerCase().includes(q) || String(c.chainId).includes(q) || c.nativeSymbol.toLowerCase().includes(q);
+
+    }
+
+    return true;
+
+  });
+
+
+
+  return (
+
+    <section className="dash-card cb-card lg:col-span-2">
+
+      <div className="flex flex-wrap items-center justify-between gap-3 mb-4">
+
+        <div>
+
+          <h2 className="dash-section-title flex items-center justify-center gap-2">
+
+            <NasaIcon name="network" size={14} className="nasa-icon--telemetry" />
+
+            128-chain network matrix
+
+          </h2>
+
+          <p className="text-xs text-[#7a9bb8] font-mono mt-1">
+
+            {registry?.stats?.active ?? 0} active · {registry?.stats?.staged ?? 0} staged ·{' '}
+
+            {registry?.stats?.reserved ?? 0} reserved · primary {registry?.primaryChainId ?? 138}
+
+          </p>
+
+        </div>
+
+        <div className="flex items-center gap-2">
+
+          <NasaIcon name="search" size={14} className="nasa-icon--telemetry" />
+
+          <input
+
+            type="search"
+
+            placeholder="Search chain…"
+
+            value={search}
+
+            onChange={(e) => setSearch(e.target.value)}
+
+            className="nasa-input !min-h-[36px] !w-48 text-sm"
+
+          />
+
+        </div>
+
+      </div>
+
+
+
+      <div className="flex gap-2 mb-4 flex-wrap">
+
+        {(['all', 'active', 'primary', 'l2'] as Filter[]).map((f) => (
+
+          <button
+
+            key={f}
+
+            type="button"
+
+            onClick={() => setFilter(f)}
+
+            className={`px-3 py-1 text-xs capitalize rounded border ${
+              filter === f
+                ? 'border-green-500 text-green-400 bg-green-500/10'
+                : 'border-white/10 text-[#848e9c]'
+            }`}
+
+          >
+
+            {f}
+
+          </button>
+
+        ))}
+
+      </div>
+
+
+
+      <div className="overflow-x-auto max-h-[360px] overflow-y-auto">
+
+        <table className="w-full text-sm nasa-table">
+
+          <thead className="sticky top-0">
+
+            <tr className="text-left">
+
+              <th className="py-2 pr-3">ID</th>
+
+              <th className="py-2 pr-3">Network</th>
+
+              <th className="py-2 pr-3">Role</th>
+
+              <th className="py-2 pr-3">Status</th>
+
+              <th className="py-2 pr-3">Swap</th>
+
+              <th className="py-2">Bridge</th>
+
+            </tr>
+
+          </thead>
+
+          <tbody>
+
+            {chains.map((c: OmnlChainSummary) => (
+
+              <tr key={c.chainId}>
+
+                <td className="py-1.5 pr-3 font-mono text-[#4ade80]">{c.chainId}</td>
+
+                <td className="py-1.5 pr-3 text-[#e8f4ff]">{c.name}</td>
+
+                <td className="py-1.5 pr-3 text-xs text-[#7a9bb8]">{c.omnlRole}</td>
+
+                <td className="py-1.5 pr-3">
+
+                  <span
+
+                    className={`text-xs px-1.5 py-0.5 font-mono uppercase ${
+
+                      c.status === 'active'
+
+                        ? 'text-[#3dff8a] border border-[#3dff8a]/35'
+
+                        : c.status === 'staged'
+
+                          ? 'text-[#ffb347] border border-[#ffb347]/35'
+
+                          : 'text-[#7a9bb8] border border-[#7a9bb8]/35'
+
+                    }`}
+
+                  >
+
+                    {c.status}
+
+                  </span>
+
+                </td>
+
+                <td className="py-1.5 pr-3"><StatusIcon ok={!!c.settlement?.swapEnabled} /></td>
+
+                <td className="py-1.5"><StatusIcon ok={!!c.settlement?.bridgeEnabled} /></td>
+
+              </tr>
+
+            ))}
+
+          </tbody>
+
+        </table>
+
+      </div>
+
+    </section>
+
+  );
+
+}
+
diff --git a/frontend-dapp/src/features/central-bank/useCentralBank.ts b/frontend-dapp/src/features/central-bank/useCentralBank.ts
index a034c91..407a3e1 100644
--- a/frontend-dapp/src/features/central-bank/useCentralBank.ts
+++ b/frontend-dapp/src/features/central-bank/useCentralBank.ts
@@ -67,14 +67,9 @@ export function useCentralBank() {
       setOffice(o);
       setTokenCount(Array.isArray(m2?.tokens) ? m2.tokens.length : 0);
       setMonitor(mon);
-      setMoneySupply(
-        ms ??
-          (h?.status === 'ok'
-            ? { fineractConnected: true, fineractLive: false, officeId: 24 }
-            : null),
-      );
+      setMoneySupply(ms);
       if (!h && !o) {
-        setError('Settlement middleware unreachable');
+        setError('Settlement middleware unreachable — check production API at explorer.d-bis.org');
       }
     } catch (e) {
       setError(e instanceof Error ? e.message : 'Failed to load central bank data');
diff --git a/frontend-dapp/src/features/hub/DashboardSectionFold.tsx b/frontend-dapp/src/features/hub/DashboardSectionFold.tsx
new file mode 100644
index 0000000..13f82cb
--- /dev/null
+++ b/frontend-dapp/src/features/hub/DashboardSectionFold.tsx
@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+import type { NasaIconName } from '../../components/icons/NasaIcon';
+import NasaIcon from '../../components/icons/NasaIcon';
+
+type Props = {
+  title: string;
+  subtitle?: string;
+  icon: NasaIconName;
+  defaultOpen?: boolean;
+  children: ReactNode;
+};
+
+export default function DashboardSectionFold({ title, subtitle, icon, defaultOpen = true, children }: Props) {
+  return (
+    <details className="dbis-section-fold" open={defaultOpen}>
+      <summary className="dbis-section-fold__summary">
+        <span className="inline-flex items-center justify-center w-8 h-8 rounded-lg bg-green-500/10 border border-green-500/25 text-green-400 shrink-0">
+          <NasaIcon name={icon} size={16} />
+        </span>
+        <span>
+          {title}
+          {subtitle && <span className="block text-xs font-normal text-[var(--nasa-muted)] mt-0.5">{subtitle}</span>}
+        </span>
+        <NasaIcon name="arrow-right" size={14} className="dbis-section-fold__chevron ml-auto text-[var(--nasa-muted)]" />
+      </summary>
+      <div className="dbis-section-fold__body">{children}</div>
+    </details>
+  );
+}
diff --git a/frontend-dapp/src/features/hub/EcosystemLinkGrid.tsx b/frontend-dapp/src/features/hub/EcosystemLinkGrid.tsx
new file mode 100644
index 0000000..423fef4
--- /dev/null
+++ b/frontend-dapp/src/features/hub/EcosystemLinkGrid.tsx
@@ -0,0 +1,128 @@
+import { Link } from 'react-router-dom';
+import NasaIcon, { type NasaIconName } from '../../components/icons/NasaIcon';
+import type { EcosystemLink, EcosystemLinkAccent } from '../../config/ecosystemLinks';
+import { ecosystemLinkUsesAnchor } from '../../config/ecosystemLinkRouting';
+
+type Props = {
+  title: string;
+  subtitle?: string;
+  links: EcosystemLink[];
+  columns?: '2' | '3';
+  centered?: boolean;
+  sectionIcon?: NasaIconName;
+  variant?: 'grid' | 'list';
+  hideHeader?: boolean;
+};
+
+const ACCENT_STYLES: Record<EcosystemLinkAccent, { tile: string; icon: string }> = {
+  green: { tile: 'bg-green-500/15 border-green-500/30 shadow-[0_0_20px_rgba(34,197,94,0.1)]', icon: 'text-green-400' },
+  teal: { tile: 'bg-teal-500/15 border-teal-500/30 shadow-[0_0_20px_rgba(20,184,166,0.1)]', icon: 'text-teal-400' },
+  blue: { tile: 'bg-sky-500/15 border-sky-500/30 shadow-[0_0_20px_rgba(56,189,248,0.1)]', icon: 'text-sky-400' },
+  gold: { tile: 'bg-amber-500/15 border-amber-500/30 shadow-[0_0_20px_rgba(245,158,11,0.1)]', icon: 'text-amber-400' },
+  purple: { tile: 'bg-violet-500/15 border-violet-500/30 shadow-[0_0_20px_rgba(139,92,246,0.1)]', icon: 'text-violet-400' },
+  slate: { tile: 'bg-slate-500/15 border-slate-500/30', icon: 'text-slate-300' },
+};
+
+function LinkCard({ link, variant }: { link: EcosystemLink; variant: 'grid' | 'list' }) {
+  const accent = link.accent ?? 'green';
+  const styles = ACCENT_STYLES[accent];
+  const isExternal = link.external || link.href.startsWith('http');
+  const useAnchor = ecosystemLinkUsesAnchor(link);
+  const isList = variant === 'list';
+  const className = [
+    'hub-link-card group flex no-underline text-inherit rounded-xl border border-white/10 bg-[var(--nasa-panel)]',
+    'hover:border-green-500/40 hover:bg-[var(--nasa-panel-elevated)] active:scale-[0.98] transition-all duration-150 shadow-sm',
+    isList
+      ? 'hub-link-card--list flex-row items-center text-left gap-3 p-3 min-h-[60px]'
+      : 'flex-col items-center text-center gap-3 p-4 min-h-[148px] hover:-translate-y-0.5',
+  ].join(' ');
+
+  const inner = (
+    <>
+      <span
+        className={`hub-link-card__icon inline-flex items-center justify-center shrink-0 rounded-2xl border ${styles.tile} ${styles.icon} ${
+          isList ? 'w-10 h-10' : 'w-14 h-14'
+        }`}
+      >
+        <NasaIcon name={link.icon} size={isList ? 20 : 26} />
+      </span>
+      <div className={`hub-link-card__text ${isList ? 'flex-1 min-w-0' : 'flex-1 w-full'}`}>
+        <div className={`flex items-center gap-1.5 ${isList ? '' : 'justify-center'}`}>
+          <h3 className="text-sm font-semibold text-[var(--nasa-text)]">{link.label}</h3>
+          {isExternal && <NasaIcon name="globe" size={11} className="text-[var(--nasa-muted)] opacity-70 shrink-0" />}
+        </div>
+        <p className={`text-xs text-[var(--nasa-muted)] leading-relaxed ${isList ? 'mt-0.5 truncate' : 'mt-1.5 line-clamp-2'}`}>
+          {link.description}
+        </p>
+      </div>
+      {!isList && (
+        <span className="hub-link-card__open inline-flex items-center gap-1 text-xs font-medium text-green-500/80 group-hover:text-green-400">
+          Open
+          <NasaIcon name="arrow-right" size={12} />
+        </span>
+      )}
+      {isList && <NasaIcon name="arrow-right" size={14} className="text-[var(--nasa-muted)] shrink-0" />}
+    </>
+  );
+
+  if (isExternal) {
+    return (
+      <a href={link.href} target="_blank" rel="noopener noreferrer" className={className}>
+        {inner}
+      </a>
+    );
+  }
+
+  if (useAnchor) {
+    return (
+      <a href={link.href} className={className}>
+        {inner}
+      </a>
+    );
+  }
+
+  return (
+    <Link to={link.href} className={className}>
+      {inner}
+    </Link>
+  );
+}
+
+export default function EcosystemLinkGrid({
+  title,
+  subtitle,
+  links,
+  columns = '3',
+  centered = true,
+  sectionIcon = 'link',
+  variant = 'grid',
+  hideHeader = false,
+}: Props) {
+  const gridClass =
+    variant === 'list'
+      ? 'grid grid-cols-1 gap-2'
+      : columns === '2'
+        ? 'grid grid-cols-1 sm:grid-cols-2 gap-3 sm:gap-4'
+        : 'grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 gap-3 sm:gap-4';
+
+  return (
+    <section className="mb-6 md:mb-10">
+      {!hideHeader && (
+        <div className={`mb-4 md:mb-5 hidden md:block${centered ? ' text-center' : ''}`}>
+          <h2 className="dash-section-title flex items-center justify-center gap-2 text-base">
+            <span className="inline-flex items-center justify-center w-8 h-8 rounded-lg bg-green-500/10 border border-green-500/25 text-green-400">
+              <NasaIcon name={sectionIcon} size={16} />
+            </span>
+            {title}
+          </h2>
+          {subtitle && <p className="dash-section-subtitle mt-1">{subtitle}</p>}
+        </div>
+      )}
+      <div className={gridClass}>
+        {links.map((link) => (
+          <LinkCard key={link.id} link={link} variant={variant} />
+        ))}
+      </div>
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/hub/FeaturedAppsStrip.tsx b/frontend-dapp/src/features/hub/FeaturedAppsStrip.tsx
new file mode 100644
index 0000000..b0d47ec
--- /dev/null
+++ b/frontend-dapp/src/features/hub/FeaturedAppsStrip.tsx
@@ -0,0 +1,56 @@
+import { Link } from 'react-router-dom';
+import NasaIcon from '../../components/icons/NasaIcon';
+import { FEATURED_APP_LINKS, type EcosystemLink, type EcosystemLinkAccent } from '../../config/ecosystemLinks';
+import { ecosystemLinkUsesAnchor } from '../../config/ecosystemLinkRouting';
+
+const ACCENT_TILE: Record<EcosystemLinkAccent, string> = {
+  green: 'bg-green-500/15 border-green-500/30 text-green-400',
+  teal: 'bg-teal-500/15 border-teal-500/30 text-teal-400',
+  blue: 'bg-sky-500/15 border-sky-500/30 text-sky-400',
+  gold: 'bg-amber-500/15 border-amber-500/30 text-amber-400',
+  purple: 'bg-violet-500/15 border-violet-500/30 text-violet-400',
+  slate: 'bg-slate-500/15 border-slate-500/30 text-slate-300',
+};
+
+function FeaturedItem({ link }: { link: EcosystemLink }) {
+  const accent = link.accent ?? 'green';
+  const tile = ACCENT_TILE[accent];
+  const short = link.label.replace('DBIS ', '').replace('Digital ', '');
+
+  const className = 'dbis-featured__item';
+  const inner = (
+    <>
+      <span className={`dbis-featured__icon border ${tile}`}>
+        <NasaIcon name={link.icon} size={22} />
+      </span>
+      <span className="dbis-featured__name">{short}</span>
+    </>
+  );
+
+  if (ecosystemLinkUsesAnchor(link)) {
+    return (
+      <a href={link.href} className={className}>
+        {inner}
+      </a>
+    );
+  }
+
+  return (
+    <Link to={link.href} className={className}>
+      {inner}
+    </Link>
+  );
+}
+
+export default function FeaturedAppsStrip() {
+  return (
+    <section className="dbis-featured" aria-label="Quick access">
+      <p className="dbis-featured__label">Quick access</p>
+      <div className="dbis-featured__scroll">
+        {FEATURED_APP_LINKS.map((link) => (
+          <FeaturedItem key={link.id} link={link} />
+        ))}
+      </div>
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/office24/Office24BankCorridors.tsx b/frontend-dapp/src/features/office24/Office24BankCorridors.tsx
new file mode 100644
index 0000000..9c87a16
--- /dev/null
+++ b/frontend-dapp/src/features/office24/Office24BankCorridors.tsx
@@ -0,0 +1,116 @@
+import { useEffect, useState } from 'react';
+import { fetchOmnlChainRegistry, type ChainRegistryResponse } from '../../config/supported-chains';
+import NasaIcon, { StatusIcon } from '../../components/icons/NasaIcon';
+import DashboardSection from '../omnl-dashboard/DashboardSection';
+
+/** Office 24 Central Bank — 128-bank corridor status (settlement + SWIFT + M2 rails). */
+export default function Office24BankCorridors() {
+  const [registry, setRegistry] = useState<ChainRegistryResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    fetchOmnlChainRegistry()
+      .then(setRegistry)
+      .finally(() => setLoading(false));
+  }, []);
+
+  const chains = registry?.chains ?? [];
+  const active = chains.filter((c) => c.status === 'active');
+  const openCorridors = active.length;
+
+  return (
+    <DashboardSection
+      title="128-bank corridor network"
+      subtitle="Open settlement lines · SWIFT · HYBX · M2 load · bridge · swap per chain"
+      icon="globe"
+      className="mb-8 lg:col-span-3"
+      action={
+        <span className="nasa-badge nasa-badge--nominal">
+          {loading ? 'Loading…' : `${openCorridors} / ${registry?.maxCapacity ?? 128} corridors open`}
+        </span>
+      }
+    >
+      <div className="grid grid-cols-2 sm:grid-cols-4 gap-3 mb-4">
+        <div className="rounded border border-green-500/30 bg-green-500/5 p-3 text-center">
+          <p className="text-2xl font-bold text-[#3dff8a]">{registry?.stats?.active ?? '—'}</p>
+          <p className="text-xs text-[#7a9bb8]">Active chains</p>
+        </div>
+        <div className="rounded border border-white/10 p-3 text-center">
+          <p className="text-2xl font-bold text-[#e8f4ff]">{registry?.primaryChainId ?? 138}</p>
+          <p className="text-xs text-[#7a9bb8]">Settlement hub</p>
+        </div>
+        <div className="rounded border border-white/10 p-3 text-center">
+          <p className="text-2xl font-bold text-[#e8f4ff]">{registry?.mirrorChainId ?? 651940}</p>
+          <p className="text-xs text-[#7a9bb8]">Mirror chain</p>
+        </div>
+        <div className="rounded border border-white/10 p-3 text-center">
+          <p className="text-2xl font-bold text-[#ffb347]">{registry?.stats?.staged ?? '—'}</p>
+          <p className="text-xs text-[#7a9bb8]">Staged</p>
+        </div>
+      </div>
+
+      <p className="text-xs text-[#7a9bb8] mb-3 flex items-center gap-2">
+        <NasaIcon name="rail" size={12} />
+        All active chains have full OMNL integration: Fineract posting, SWIFT MT102/MT103, trade finance (SBLC/BG/LC), M2
+        token load, and bridge/swap when enabled in registry.
+      </p>
+
+      <div className="overflow-x-auto max-h-[280px] overflow-y-auto rounded border border-white/10">
+        <table className="w-full text-sm nasa-table">
+          <thead className="sticky top-0">
+            <tr className="text-left">
+              <th className="py-2 px-2">Chain</th>
+              <th className="py-2 px-2">Network</th>
+              <th className="py-2 px-2">Corridor</th>
+              <th className="py-2 px-2">SWIFT</th>
+              <th className="py-2 px-2">Settlement</th>
+              <th className="py-2 px-2">M2</th>
+              <th className="py-2 px-2">Swap</th>
+              <th className="py-2 px-2">Bridge</th>
+            </tr>
+          </thead>
+          <tbody>
+            {chains.slice(0, 128).map((c) => {
+              const open = c.status === 'active';
+              return (
+                <tr key={c.chainId}>
+                  <td className="py-1.5 px-2 font-mono text-[#4ade80]">{c.chainId}</td>
+                  <td className="py-1.5 px-2 text-[#e8f4ff]">{c.name}</td>
+                  <td className="py-1.5 px-2">
+                    <span
+                      className={`text-xs font-mono uppercase ${open ? 'text-[#3dff8a]' : 'text-[#7a9bb8]'}`}
+                    >
+                      {open ? 'OPEN' : c.status}
+                    </span>
+                  </td>
+                  <td className="py-1.5 px-2">
+                    <StatusIcon ok={open} />
+                  </td>
+                  <td className="py-1.5 px-2">
+                    <StatusIcon ok={open} />
+                  </td>
+                  <td className="py-1.5 px-2">
+                    <StatusIcon ok={open && !!c.settlement?.m2LoadEnabled} />
+                  </td>
+                  <td className="py-1.5 px-2">
+                    <StatusIcon ok={!!c.settlement?.swapEnabled} />
+                  </td>
+                  <td className="py-1.5 px-2">
+                    <StatusIcon ok={!!c.settlement?.bridgeEnabled} />
+                  </td>
+                </tr>
+              );
+            })}
+            {!chains.length && !loading && (
+              <tr>
+                <td colSpan={8} className="py-6 text-center text-[#7a9bb8]">
+                  Chain registry unavailable — settlement API /chains
+                </td>
+              </tr>
+            )}
+          </tbody>
+        </table>
+      </div>
+    </DashboardSection>
+  );
+}
diff --git a/frontend-dapp/src/features/office24/Office24Dashboard.tsx b/frontend-dapp/src/features/office24/Office24Dashboard.tsx
index 64e2c62..a1afec0 100644
--- a/frontend-dapp/src/features/office24/Office24Dashboard.tsx
+++ b/frontend-dapp/src/features/office24/Office24Dashboard.tsx
@@ -16,6 +16,12 @@ import NasaIcon, { StatusIcon } from '../../components/icons/NasaIcon';
 
 import { formatUsd } from '../../utils/formatMoney';
 
+import ChainMatrixPanel from '../central-bank/ChainMatrixPanel';
+
+import Office24BankCorridors from './Office24BankCorridors';
+
+import Office24EcosystemSubjects from './Office24EcosystemSubjects';
+
 
 
 export default function Office24Dashboard() {
@@ -44,43 +50,38 @@ export default function Office24Dashboard() {
 
   return (
 
-    <div className="dash-page o24-page max-w-[1400px] mx-auto px-4 py-6">
+    <div className="dash-page o24-page app-page-shell px-4 py-6">
 
-      <div className="flex flex-wrap items-start justify-between gap-4 mb-2">
+      <div className="flex flex-col items-center gap-4 mb-2 text-center">
 
-        <div className="flex-1 min-w-0">
+        <NasaPageHeader
 
-          <NasaPageHeader
+          icon="central-bank"
+          title={profile?.name ?? 'Office 24 Central Bank — HOSPITALLERS Zardasht'}
 
-            icon="office"
+          subtitle={profile?.externalId ?? 'HOSPITALLERS-ZARDASHT-IRAQ-IRAN · IPSAS Office 24'}
 
-            missionId="O24-138"
+          badges={
 
-            title={profile?.name ?? 'HOSPITALLERS — Zardasht (Iraq / Iran Operations)'}
+            <>
 
-            subtitle={profile?.externalId ?? 'HOSPITALLERS-ZARDASHT-IRAQ-IRAN'}
+              <span className="nasa-badge nasa-badge--nominal">Office 24 Central Bank</span>
 
-            badges={
+              <span className="nasa-badge nasa-badge--caution">128-bank corridors</span>
 
-              <>
+              {profile?.locked && <span className="nasa-badge nasa-badge--caution">Single office · locked</span>}
 
-                <span className="nasa-badge nasa-badge--nominal">Office 24</span>
+            </>
 
-                {profile?.locked && <span className="nasa-badge nasa-badge--caution">Single office · locked</span>}
+          }
 
-              </>
+        />
 
-            }
-
-          />
-
-        </div>
-
-        <div className="flex flex-wrap gap-2 pt-2">
+        <div className="flex flex-wrap gap-2 justify-center">
 
           <Link to="/central-bank" className="nasa-btn inline-flex items-center gap-1">
 
-            <NasaIcon name="central-bank" size={12} /> Central Bank
+            <NasaIcon name="globe" size={12} /> Z Online Bank
 
           </Link>
 
@@ -104,7 +105,7 @@ export default function Office24Dashboard() {
 
 
 
-      <h2 className="dash-section-title mb-1 flex items-center gap-2">
+      <h2 className="dash-section-title mb-1 flex items-center justify-center gap-2">
 
         <NasaIcon name="ledger" size={14} className="nasa-icon--telemetry" />
 
@@ -146,7 +147,7 @@ export default function Office24Dashboard() {
 
           action={
 
-            <button type="button" onClick={() => refresh()} className="text-xs text-[#00d4ff] hover:underline inline-flex items-center gap-1">
+            <button type="button" onClick={() => refresh()} className="text-xs text-[#4ade80] hover:underline inline-flex items-center gap-1">
 
               <NasaIcon name="refresh" size={12} className={loading ? 'nasa-icon--spin' : ''} />
 
@@ -232,7 +233,7 @@ export default function Office24Dashboard() {
 
         <DashboardSection title="M2 token registry" subtitle="Tradable lines on Chain 138" icon="rocket" className="lg:col-span-2">
 
-          <div className="overflow-x-auto max-h-[420px] overflow-y-auto rounded border border-[#1e4a8a]">
+          <div className="overflow-x-auto max-h-[420px] overflow-y-auto rounded border border-white/10">
 
             <table className="w-full text-sm nasa-table">
 
@@ -298,6 +299,16 @@ export default function Office24Dashboard() {
 
       </div>
 
+      <div className="grid grid-cols-1 gap-6 mb-8">
+
+        <Office24BankCorridors />
+
+        <ChainMatrixPanel />
+
+      </div>
+
+      <Office24EcosystemSubjects />
+
     </div>
 
   );
diff --git a/frontend-dapp/src/features/office24/Office24EcosystemSubjects.tsx b/frontend-dapp/src/features/office24/Office24EcosystemSubjects.tsx
new file mode 100644
index 0000000..779d0b7
--- /dev/null
+++ b/frontend-dapp/src/features/office24/Office24EcosystemSubjects.tsx
@@ -0,0 +1,65 @@
+import { Link } from 'react-router-dom';
+import { FEATURED_APP_LINKS, IN_APP_LINKS, OPERATOR_CONSOLE_LINKS, PUBLIC_PORTAL_LINKS } from '../../config/ecosystemLinks';
+import { ecosystemLinkUsesAnchor } from '../../config/ecosystemLinkRouting';
+import NasaIcon, { StatusIcon } from '../../components/icons/NasaIcon';
+import DashboardSection from '../omnl-dashboard/DashboardSection';
+
+const SUBJECT_GROUPS = [
+  { title: 'Core banking apps', links: FEATURED_APP_LINKS },
+  { title: 'Ecosystem subjects', links: IN_APP_LINKS.filter((l) => !FEATURED_APP_LINKS.some((f) => f.id === l.id)) },
+  { title: 'Operator consoles', links: OPERATOR_CONSOLE_LINKS },
+  { title: 'Production portals', links: PUBLIC_PORTAL_LINKS },
+];
+
+export default function Office24EcosystemSubjects() {
+  return (
+    <DashboardSection
+      title="Ecosystem integration"
+      subtitle="All DBIS OMNL subjects · live corridors from Office 24 Central Bank"
+      icon="network"
+      className="mb-8"
+    >
+      <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+        {SUBJECT_GROUPS.map((group) => (
+          <div key={group.title}>
+            <h3 className="text-sm font-semibold text-[#e8f4ff] mb-3 flex items-center gap-2">
+              <NasaIcon name="check" size={12} className="nasa-icon--telemetry" />
+              {group.title}
+            </h3>
+            <ul className="space-y-2">
+              {group.links.map((link) => (
+                <li key={link.id}>
+                  {ecosystemLinkUsesAnchor(link) ? (
+                    <a
+                      href={link.href}
+                      target={link.external ? '_blank' : undefined}
+                      rel={link.external ? 'noreferrer' : undefined}
+                      className="flex items-center justify-between gap-2 rounded border border-white/10 px-3 py-2 hover:border-green-500/40 text-sm"
+                    >
+                      <span className="flex items-center gap-2 text-[#e8f4ff]">
+                        <NasaIcon name={link.icon} size={14} />
+                        {link.label}
+                      </span>
+                      <StatusIcon ok />
+                    </a>
+                  ) : (
+                    <Link
+                      to={link.href}
+                      className="flex items-center justify-between gap-2 rounded border border-white/10 px-3 py-2 hover:border-green-500/40 text-sm"
+                    >
+                      <span className="flex items-center gap-2 text-[#e8f4ff]">
+                        <NasaIcon name={link.icon} size={14} />
+                        {link.label}
+                      </span>
+                      <StatusIcon ok />
+                    </Link>
+                  )}
+                </li>
+              ))}
+            </ul>
+          </div>
+        ))}
+      </div>
+    </DashboardSection>
+  );
+}
diff --git a/frontend-dapp/src/features/office24/useOffice24.ts b/frontend-dapp/src/features/office24/useOffice24.ts
index e90ba17..0b9010c 100644
--- a/frontend-dapp/src/features/office24/useOffice24.ts
+++ b/frontend-dapp/src/features/office24/useOffice24.ts
@@ -49,12 +49,7 @@ export function useOffice24() {
       setOffice(o);
       setTokens(Array.isArray(t?.tokens) ? t.tokens : []);
       setHealth(h);
-      setMoneySupply(
-        ms ??
-          (o
-            ? { fineractConnected: true, fineractLive: false, officeId: 24 }
-            : null),
-      );
+      setMoneySupply(ms);
     } finally {
       setLoading(false);
     }
diff --git a/frontend-dapp/src/features/omnl-dashboard/DashboardSection.tsx b/frontend-dapp/src/features/omnl-dashboard/DashboardSection.tsx
index 5ae82f3..b52981e 100644
--- a/frontend-dapp/src/features/omnl-dashboard/DashboardSection.tsx
+++ b/frontend-dapp/src/features/omnl-dashboard/DashboardSection.tsx
@@ -1,35 +1,74 @@
-import type { ReactNode } from 'react';

-import type { NasaIconName } from '../../components/icons/NasaIcon';

-import NasaIcon from '../../components/icons/NasaIcon';

-

-export default function DashboardSection({

-  title,

-  subtitle,

-  action,

-  children,

-  className = '',

-  icon,

-}: {

-  title: string;

-  subtitle?: string;

-  action?: ReactNode;

-  children: ReactNode;

-  className?: string;

-  icon?: NasaIconName;

-}) {

-  return (

-    <section className={`dash-card ${className}`}>

-      <div className="flex flex-wrap items-start justify-between gap-3 mb-4">

-        <div>

-          <h2 className="dash-section-title flex items-center gap-2">

-            {icon && <NasaIcon name={icon} size={14} className="nasa-icon--telemetry" />}

-            {title}

-          </h2>

-          {subtitle && <p className="dash-section-subtitle">{subtitle}</p>}

-        </div>

-        {action}

-      </div>

-      {children}

-    </section>

-  );

-}

+import type { ReactNode } from 'react';
+
+import type { NasaIconName } from '../../components/icons/NasaIcon';
+
+import NasaIcon from '../../components/icons/NasaIcon';
+
+
+
+export default function DashboardSection({
+
+  title,
+
+  subtitle,
+
+  action,
+
+  children,
+
+  className = '',
+
+  icon,
+
+}: {
+
+  title: string;
+
+  subtitle?: string;
+
+  action?: ReactNode;
+
+  children: ReactNode;
+
+  className?: string;
+
+  icon?: NasaIconName;
+
+}) {
+
+  return (
+
+    <section className={`dash-card ${className}`}>
+
+      <div className="flex flex-col items-center text-center gap-3 mb-4">
+
+        <div>
+
+          <h2 className="dash-section-title flex items-center justify-center gap-2">
+
+            {icon && <NasaIcon name={icon} size={14} className="nasa-icon--telemetry" />}
+
+            {title}
+
+          </h2>
+
+          {subtitle && <p className="dash-section-subtitle">{subtitle}</p>}
+
+        </div>
+
+        {action}
+
+      </div>
+
+      <div className="dash-section-body text-left">
+
+        {children}
+
+      </div>
+
+    </section>
+
+  );
+
+}
+
diff --git a/frontend-dapp/src/features/omnl-dashboard/DashboardStatCard.tsx b/frontend-dapp/src/features/omnl-dashboard/DashboardStatCard.tsx
index a095bb7..b23de7b 100644
--- a/frontend-dapp/src/features/omnl-dashboard/DashboardStatCard.tsx
+++ b/frontend-dapp/src/features/omnl-dashboard/DashboardStatCard.tsx
@@ -1,36 +1,67 @@
-import type { NasaIconName } from '../../components/icons/NasaIcon';

-import NasaIcon from '../../components/icons/NasaIcon';

-

-type Accent = 'gold' | 'green' | 'blue' | 'neutral';

-

-const ACCENT: Record<Accent, string> = {

-  blue: 'border-l-[#00d4ff]',

-  green: 'border-l-[#3dff8a]',

-  gold: 'border-l-[#ffb347]',

-  neutral: 'border-l-[#7a9bb8]',

-};

-

-export default function DashboardStatCard({

-  label,

-  value,

-  hint,

-  accent = 'neutral',

-  icon,

-}: {

-  label: string;

-  value: string;

-  hint?: string;

-  accent?: Accent;

-  icon?: NasaIconName;

-}) {

-  return (

-    <div className={`dash-card border-l-4 ${ACCENT[accent]}`}>

-      <p className="dash-stat-label flex items-center gap-1.5">

-        {icon && <NasaIcon name={icon} size={14} className="nasa-icon--telemetry" />}

-        {label}

-      </p>

-      <p className="dash-stat-value">{value}</p>

-      {hint && <p className="dash-stat-hint">{hint}</p>}

-    </div>

-  );

-}

+import type { NasaIconName } from '../../components/icons/NasaIcon';
+
+import NasaIcon from '../../components/icons/NasaIcon';
+
+
+
+type Accent = 'gold' | 'green' | 'blue' | 'neutral';
+
+
+
+const ACCENT: Record<Accent, string> = {
+  blue: 'border-l-green-500',
+  green: 'border-l-green-500',
+  gold: 'border-l-amber-500',
+  neutral: 'border-l-gray-500',
+};
+
+
+
+export default function DashboardStatCard({
+
+  label,
+
+  value,
+
+  hint,
+
+  accent = 'neutral',
+
+  icon,
+
+}: {
+
+  label: string;
+
+  value: string;
+
+  hint?: string;
+
+  accent?: Accent;
+
+  icon?: NasaIconName;
+
+}) {
+
+  return (
+
+    <div className={`dash-card border-l-4 ${ACCENT[accent]} text-center`}>
+
+      {icon && (
+        <div className="flex justify-center mb-2">
+          <NasaIcon name={icon} size={18} className="nasa-icon--telemetry" />
+        </div>
+      )}
+
+      <p className="dash-stat-label justify-center">{label}</p>
+
+      <p className="dash-stat-value">{value}</p>
+
+      {hint && <p className="dash-stat-hint">{hint}</p>}
+
+    </div>
+
+  );
+
+}
+
diff --git a/frontend-dapp/src/features/omnl-dashboard/NasaPageHeader.tsx b/frontend-dapp/src/features/omnl-dashboard/NasaPageHeader.tsx
index 4c46818..5c18953 100644
--- a/frontend-dapp/src/features/omnl-dashboard/NasaPageHeader.tsx
+++ b/frontend-dapp/src/features/omnl-dashboard/NasaPageHeader.tsx
@@ -1,48 +1,33 @@
-import { useEffect, useState, type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { NasaIconName } from '../../components/icons/NasaIcon';
 import NasaIcon from '../../components/icons/NasaIcon';
 
 type Props = {
   icon: NasaIconName;
-  missionId: string;
   title: string;
   subtitle?: string;
   badges?: ReactNode;
+  centered?: boolean;
 };
 
-function missionClock() {
-  const now = new Date();
-  return now.toISOString().slice(11, 19) + ' UTC';
-}
-
-export default function NasaPageHeader({ icon, missionId, title, subtitle, badges }: Props) {
-  const [clock, setClock] = useState(missionClock);
-
-  useEffect(() => {
-    const id = setInterval(() => setClock(missionClock()), 1000);
-    return () => clearInterval(id);
-  }, []);
-
+export default function NasaPageHeader({ icon, title, subtitle, badges, centered = true }: Props) {
   return (
-    <header className="nasa-header mb-6">
-      <div className="nasa-header__meta">
-        <span className="nasa-mission-id">
-          <NasaIcon name="satellite" size={12} />
-          {missionId}
-        </span>
-        <span>MET {clock}</span>
-      </div>
+    <header className={`nasa-header mb-6${centered ? ' nasa-header--centered' : ''}`}>
       <div className="nasa-header__body">
         <div className="nasa-header__title-row">
           <div className="nasa-header__icon-wrap">
-            <NasaIcon name={icon} size={26} className="nasa-icon--telemetry" />
+            <NasaIcon name={icon} size={22} className="nasa-icon--telemetry" />
           </div>
           <div>
             <h1 className="nasa-title">{title}</h1>
             {subtitle && <p className="dash-page-subtitle !mt-1">{subtitle}</p>}
           </div>
         </div>
-        {badges && <div className="flex flex-wrap items-center gap-2">{badges}</div>}
+        {badges && (
+          <div className={`flex flex-wrap items-center gap-2${centered ? ' justify-center w-full' : ''}`}>
+            {badges}
+          </div>
+        )}
       </div>
     </header>
   );
diff --git a/frontend-dapp/src/features/omnl-dashboard/QuickPortalLinks.tsx b/frontend-dapp/src/features/omnl-dashboard/QuickPortalLinks.tsx
index e1d730c..ad0ee33 100644
--- a/frontend-dapp/src/features/omnl-dashboard/QuickPortalLinks.tsx
+++ b/frontend-dapp/src/features/omnl-dashboard/QuickPortalLinks.tsx
@@ -1,7 +1,7 @@
-import { Link } from 'react-router-dom';
+import { Link } from 'react-router-dom';
 import NasaIcon from '../../components/icons/NasaIcon';
 
-/** Same-origin portal surfaces — no FQDNs (see /docs). */
+/** Same-origin portal surfaces ÔÇö no FQDNs (see /docs). */
 const LINKS = [
   { label: 'Central Bank', to: '/central-bank', icon: 'central-bank' as const },
   { label: 'Office 24', to: '/office-24', icon: 'office' as const },
diff --git a/frontend-dapp/src/features/online-bank/GuosmmNoticesPanel.tsx b/frontend-dapp/src/features/online-bank/GuosmmNoticesPanel.tsx
new file mode 100644
index 0000000..b8b4a31
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/GuosmmNoticesPanel.tsx
@@ -0,0 +1,32 @@
+import { GUOSMM_NOTICES } from '../../config/guosmmNotices';
+
+export default function GuosmmNoticesPanel() {
+  return (
+    <section className="revolut-bank__gazette" aria-labelledby="guosmm-heading">
+      <h2 id="guosmm-heading" className="revolut-bank__section-title">
+        Official gazette (GUOSMM)
+      </h2>
+      <p className="text-xs text-[var(--nasa-muted)] mb-3 max-w-2xl">
+        Sovereign Military Order of Malta · SHOSJJ official notices governing OMNL EMCB and ISB member banks.
+      </p>
+      <ul className="grid grid-cols-1 sm:grid-cols-2 gap-2">
+        {GUOSMM_NOTICES.map((n) => (
+          <li key={n.documentId}>
+            <a
+              href={n.url}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="revolut-bank__service-card block !text-left"
+            >
+              <span className="revolut-bank__service-label">
+                {n.documentId}
+                {n.fineractOfficeId != null ? ` · Office ${n.fineractOfficeId}` : ''}
+              </span>
+              <span className="revolut-bank__service-desc">{n.title}</span>
+            </a>
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/online-bank/OnlineBankApp.tsx b/frontend-dapp/src/features/online-bank/OnlineBankApp.tsx
new file mode 100644
index 0000000..dc4eb9f
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/OnlineBankApp.tsx
@@ -0,0 +1,320 @@
+import { useState } from 'react';
+import { Link } from 'react-router-dom';
+import NasaIcon from '../../components/icons/NasaIcon';
+import { formatUsd } from '../../utils/formatMoney';
+import CentralBankDashboard from '../central-bank/CentralBankDashboard';
+import SettlementProtocolsPanel from './SettlementProtocolsPanel';
+import GuosmmNoticesPanel from './GuosmmNoticesPanel';
+import ZBankFullSettlementPanel from './ZBankFullSettlementPanel';
+import ZBankLiquidityPanel from './ZBankLiquidityPanel';
+import { useOnlineBank } from './useOnlineBank';
+import { useZBankSettlement } from './useZBankSettlement';
+import { isZEcosystem } from '../../config/ecosystemMode';
+
+const ACCOUNTS = [
+  { key: 'main', label: 'USD account', meta: 'Main · M1 eMoney', flag: 'USD', balanceKey: 'primaryBalance' as const, active: true },
+  { key: 'savings', label: 'Savings', meta: 'M2 tokenized', flag: 'M2', balanceKey: 'savingsBalance' as const },
+  { key: 'reserve', label: 'Reserve', meta: 'M0 base money', flag: 'M0', balanceKey: 'reserveBalance' as const },
+  { key: 'fiat', label: 'Fiat rails', meta: 'M4 SWIFT settlement', flag: 'M4', balanceKey: 'm4Balance' as const },
+  { key: 'chain', label: 'On-chain', meta: 'M3 digital', flag: 'M3', balanceKey: 'm3Balance' as const },
+];
+
+function BalanceSkeleton() {
+  return (
+    <section className="revolut-bank__balance-card" aria-hidden>
+      <div className="revolut-bank__skeleton h-4 w-28 mb-3" />
+      <div className="revolut-bank__skeleton h-12 w-56" />
+    </section>
+  );
+}
+
+export default function OnlineBankApp() {
+  const bank = useOnlineBank();
+  const settlement = useZBankSettlement();
+  const [mintWallet, setMintWallet] = useState('');
+
+  return (
+    <div className="revolut-bank omnl-app">
+      <div className="revolut-bank__inner">
+        <header className="revolut-bank__page-header">
+          <div className="revolut-bank__logo-row">
+            <div className="revolut-bank__logo-mark" aria-hidden>
+              Z
+            </div>
+            <div className="revolut-bank__brand-block">
+              <h1 className="revolut-bank__brand-title">Z Online Bank</h1>
+              <p className="revolut-bank__greeting-label">
+                Hello · Good {timeOfDay()}, <span className="revolut-bank__greeting-name">{bank.displayName}</span>
+              </p>
+            </div>
+          </div>
+          <span className={`revolut-bank__status${bank.connected ? '' : ' revolut-bank__status--offline'}`}>
+            <NasaIcon name={bank.connected ? 'check' : 'x'} size={10} />
+            {bank.connected ? 'Live' : 'Offline'}
+          </span>
+        </header>
+
+        {bank.loading && !bank.primaryBalance ? (
+          <BalanceSkeleton />
+        ) : (
+          <section className="revolut-bank__balance-card" aria-label="Total balance">
+            <p className="revolut-bank__balance-label">Total balance</p>
+            <p className="revolut-bank__balance-amount">{formatUsd(bank.primaryBalance)}</p>
+            <div className="revolut-bank__balance-sub">
+              <span>{bank.officeLabel}</span>
+              {bank.live && <span>Synced with Fineract</span>}
+            </div>
+          </section>
+        )}
+
+        <div className="revolut-bank__cta-row">
+          <a href="#z-full-settlement" className="revolut-bank__cta revolut-bank__cta--primary">
+            <NasaIcon name="money" size={18} />
+            Send
+          </a>
+          <a href="#z-full-settlement" className="revolut-bank__cta revolut-bank__cta--secondary">
+            <NasaIcon name="plus" size={18} />
+            Add money
+          </a>
+        </div>
+
+        <section className="revolut-bank__accounts-section" aria-label="Your accounts">
+          <h2 className="revolut-bank__accounts-heading">Your accounts</h2>
+          <div className="revolut-bank__accounts">
+            {ACCOUNTS.map((acct) => (
+              <div
+                key={acct.key}
+                className={`revolut-bank__account-pill${acct.active ? ' revolut-bank__account-pill--active' : ''}`}
+              >
+                <span className="revolut-bank__account-flag">{acct.flag}</span>
+                <div className="revolut-bank__account-pill-body">
+                  <p className="revolut-bank__account-pill-label">{acct.label}</p>
+                  <p className="revolut-bank__account-pill-meta">{acct.meta}</p>
+                </div>
+                <p className="revolut-bank__account-pill-value">{formatUsd(bank[acct.balanceKey])}</p>
+              </div>
+            ))}
+          </div>
+        </section>
+
+        <nav className="revolut-bank__actions" aria-label="Quick actions">
+          {isZEcosystem ? (
+            <>
+              <Link to="/swap" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="swap" size={20} />
+                </span>
+                Convert
+              </Link>
+              <Link to="/z-wallet" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="wallet" size={20} />
+                </span>
+                Z Wallet
+              </Link>
+              <a href="#z-settlement-protocols" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="globe" size={20} />
+                </span>
+                International
+              </a>
+              <Link to="/z" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="dashboard" size={20} />
+                </span>
+                Z Hub
+              </Link>
+            </>
+          ) : (
+            <>
+              <Link to="/swap" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="swap" size={20} />
+                </span>
+                Convert
+              </Link>
+              <Link to="/trade" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="trade" size={20} />
+                </span>
+                Invest
+              </Link>
+              <a href="#z-settlement-protocols" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="globe" size={20} />
+                </span>
+                International
+              </a>
+              <Link to="/office-24" className="revolut-bank__action">
+                <span className="revolut-bank__action-icon">
+                  <NasaIcon name="office" size={20} />
+                </span>
+                O24 Central Bank
+              </Link>
+            </>
+          )}
+        </nav>
+
+        <ZBankFullSettlementPanel
+          settlement={settlement}
+          onSuccess={() => bank.refresh()}
+          onMintComplete={(addr) => setMintWallet(addr)}
+          balances={{
+            m0: bank.reserveBalance,
+            m1: bank.primaryBalance,
+            m2: bank.savingsBalance,
+            m3: bank.m3Balance,
+            m4: bank.m4Balance,
+          }}
+        />
+
+        {isZEcosystem && (
+          <ZBankLiquidityPanel
+            settlement={settlement}
+            mintWalletHint={mintWallet}
+            onSuccess={() => bank.refresh()}
+          />
+        )}
+
+        <SettlementProtocolsPanel settlement={settlement} onSuccess={() => bank.refresh()} />
+
+        {bank.error && (
+          <div className="revolut-bank__activity revolut-bank__error mb-4 p-4 text-sm">
+            {bank.error}. Showing cached layout — retrying every 30s.
+          </div>
+        )}
+
+        <section aria-labelledby="activity-heading">
+          <div className="revolut-bank__section-title">
+            <h2 id="activity-heading">Transactions</h2>
+            <button
+              type="button"
+              className="revolut-bank__section-link border-0 bg-transparent cursor-pointer"
+              onClick={() => bank.refresh()}
+            >
+              See all
+            </button>
+          </div>
+          <div className="revolut-bank__activity">
+            {bank.activities.length === 0 ? (
+              <div className="revolut-bank__activity-item">
+                <span className="revolut-bank__activity-icon">
+                  <NasaIcon name="ledger" size={16} />
+                </span>
+                <div className="revolut-bank__activity-body">
+                  <p className="revolut-bank__activity-title">No transactions yet</p>
+                  <p className="revolut-bank__activity-meta">Swaps and settlements appear here</p>
+                </div>
+              </div>
+            ) : (
+              bank.activities.map((item) => (
+                <div key={item.id} className="revolut-bank__activity-item">
+                  <span
+                    className={`revolut-bank__activity-icon${item.kind === 'swap' ? ' revolut-bank__activity-icon--swap' : ''}`}
+                  >
+                    <NasaIcon name={item.kind === 'swap' ? 'swap' : 'check'} size={16} />
+                  </span>
+                  <div className="revolut-bank__activity-body">
+                    <p className="revolut-bank__activity-title">{item.title}</p>
+                    <p className="revolut-bank__activity-meta">{item.meta}</p>
+                  </div>
+                  <span
+                    className={`revolut-bank__activity-amount${item.positive ? ' revolut-bank__activity-amount--positive' : ''}`}
+                  >
+                    {item.amount}
+                  </span>
+                </div>
+              ))
+            )}
+          </div>
+        </section>
+
+        <section aria-labelledby="services-heading">
+          <h2 id="services-heading" className="revolut-bank__section-title">
+            Explore
+          </h2>
+          <div className="revolut-bank__services">
+            {isZEcosystem ? (
+              <>
+                <Link to="/swap" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Digital Swap</span>
+                  <span className="revolut-bank__service-desc">Convert & load M2 tokens</span>
+                </Link>
+                <Link to="/z-wallet" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Z Wallet</span>
+                  <span className="revolut-bank__service-desc">International corridors · Chain 900002</span>
+                </Link>
+                <Link to="/z" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Z Hub</span>
+                  <span className="revolut-bank__service-desc">Ecosystem dashboard & Z Bot</span>
+                </Link>
+                <a href="#z-settlement-protocols" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">OneX Bank</span>
+                  <span className="revolut-bank__service-desc">HYBX corridor · office 29</span>
+                </a>
+                <a href="#z-settlement-protocols" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Nova Bank Online</span>
+                  <span className="revolut-bank__service-desc">Import wires · M4</span>
+                </a>
+                <a href="#z-activate-liquidity" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Real liquidity</span>
+                  <span className="revolut-bank__service-desc">c* LP → USDT / USDC / WETH</span>
+                </a>
+              </>
+            ) : (
+              <>
+                <Link to="/swap" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Digital Swap</span>
+                  <span className="revolut-bank__service-desc">Convert & load M2 tokens</span>
+                </Link>
+                <Link to="/trade" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">DBIS Trade</span>
+                  <span className="revolut-bank__service-desc">Spot markets</span>
+                </Link>
+                <Link to="/office-24" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Office 24 Central Bank</span>
+                  <span className="revolut-bank__service-desc">128-bank corridors · IPSAS</span>
+                </Link>
+                <Link to="/wallets" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">OneX Wallet</span>
+                  <span className="revolut-bank__service-desc">Shiva blockchain · MPC wallet</span>
+                </Link>
+                <a href="#z-settlement-protocols" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">OneX Bank</span>
+                  <span className="revolut-bank__service-desc">HYBX corridor · office 29</span>
+                </a>
+                <a href="#z-settlement-protocols" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Nova Bank Online</span>
+                  <span className="revolut-bank__service-desc">Import wires · M4</span>
+                </a>
+                <Link to="/reserve" className="revolut-bank__service-card">
+                  <span className="revolut-bank__service-label">Reserve</span>
+                  <span className="revolut-bank__service-desc">Coverage & attestation</span>
+                </Link>
+              </>
+            )}
+          </div>
+        </section>
+
+        <GuosmmNoticesPanel />
+
+        <details className="revolut-bank__treasury">
+          <summary>
+            Treasury & operator console
+            <NasaIcon name="arrow-right" size={14} className="revolut-bank__chevron" />
+          </summary>
+          <div className="revolut-bank__treasury-body">
+            <CentralBankDashboard />
+          </div>
+        </details>
+      </div>
+    </div>
+  );
+}
+
+function timeOfDay(): string {
+  const h = new Date().getHours();
+  if (h < 12) return 'morning';
+  if (h < 17) return 'afternoon';
+  return 'evening';
+}
diff --git a/frontend-dapp/src/features/online-bank/SettlementProtocolsPanel.tsx b/frontend-dapp/src/features/online-bank/SettlementProtocolsPanel.tsx
new file mode 100644
index 0000000..e7b8a65
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/SettlementProtocolsPanel.tsx
@@ -0,0 +1,374 @@
+import { useEffect, useState } from 'react';
+import { useAccount } from 'wagmi';
+import { useZBankSettlement, type SettlementPhase, type ZBankSettlementApi } from './useZBankSettlement';
+import { isZEcosystem } from '../../config/ecosystemMode';
+import { formatUsd } from '../../utils/formatMoney';
+
+const PHASE_LABEL: Record<SettlementPhase, string> = {
+  RECEIVED: 'Received',
+  VALIDATED: 'Validated',
+  VERBIAGE_ROLLED: 'Verbiage rolled',
+  FINERACT_POSTED: 'Fineract posted',
+  HYBX_RAIL_DISPATCHED: 'HYBX dispatched',
+  ISO20022_ARCHIVED: 'ISO 20022 archived',
+  CHAIN_MINT_REQUESTED: 'Chain mint',
+  SETTLED: 'Settled',
+  FAILED: 'Failed',
+};
+
+const DEFAULT_IBAN = 'IQ98ZARD00000000000000000001';
+const DEFAULT_AMOUNT = '1000';
+
+type ProtocolGroup = 'classic' | 'digital' | 'trade' | 'corridor';
+
+type ProtocolId =
+  | 'mt103'
+  | 'mt102'
+  | 'mt103-lc'
+  | 'sblc'
+  | 'bg'
+  | 'nova-zbank'
+  | 'onex-zbank'
+  | 'onex-shiva-crypto'
+  | 'o24-zbank'
+  | 'internal'
+  | 'external'
+  | 'token-load'
+  | 'fiat-crypto'
+  | 'full-external';
+
+const GROUPS: { id: ProtocolGroup; label: string; desc: string }[] = [
+  { id: 'classic', label: 'Classic bank', desc: 'SWIFT wires · MT102/MT103 · correspondent banking' },
+  { id: 'trade', label: 'Trade finance', desc: 'SBLC · BG · Documentary LC (MT103_LC)' },
+  { id: 'digital', label: 'Digital bank', desc: 'M2/M3 · token load · fiat→crypto · on-chain' },
+  { id: 'corridor', label: 'Corridor import', desc: 'Nova · OneX Bank · Office 24 · Shiva blockchain' },
+];
+
+const PROTOCOLS: Record<ProtocolGroup, { id: ProtocolId; label: string }[]> = {
+  classic: [
+    { id: 'mt103', label: 'MT103 wire' },
+    { id: 'mt102', label: 'MT102 bulk' },
+  ],
+  trade: [
+    { id: 'mt103-lc', label: 'MT103_LC (DLC)' },
+    { id: 'sblc', label: 'SBLC' },
+    { id: 'bg', label: 'Bank guarantee' },
+  ],
+  digital: [
+    { id: 'internal', label: 'Internal M2/M3' },
+    { id: 'token-load', label: 'M2 token load' },
+    { id: 'fiat-crypto', label: 'Fiat → crypto (138)' },
+    { id: 'onex-shiva-crypto', label: 'Fiat → Shiva (OneX)' },
+    { id: 'external', label: 'M4 SWIFT out' },
+  ],
+  corridor: [
+    { id: 'nova-zbank', label: 'Nova Bank → Z' },
+    { id: 'onex-zbank', label: 'OneX Bank → Z' },
+    { id: 'o24-zbank', label: 'O24 CB → Z' },
+    { id: 'full-external', label: 'Full M0–M4' },
+  ],
+};
+
+export default function SettlementProtocolsPanel({
+  settlement: s,
+  onSuccess,
+}: {
+  settlement: ZBankSettlementApi;
+  onSuccess?: () => void;
+}) {
+  const { address, isConnected } = useAccount();
+  const [group, setGroup] = useState<ProtocolGroup>('classic');
+  const [active, setActive] = useState<ProtocolId>('mt103');
+  const [amount, setAmount] = useState(DEFAULT_AMOUNT);
+  const [iban, setIban] = useState(DEFAULT_IBAN);
+  const [recipient, setRecipient] = useState('');
+  const [tfReference, setTfReference] = useState('');
+  const [tokenSymbol, setTokenSymbol] = useState('cUSDC');
+  const [tokenAddress, setTokenAddress] = useState('0x71D6687F38b93CCad569Fa6352c876eea967201b');
+  const [lineId, setLineId] = useState('USD-M2');
+
+  useEffect(() => {
+    if (address) setRecipient(address);
+    s.refreshSettlements();
+  }, [address]);
+
+  useEffect(() => {
+    const first = PROTOCOLS[group][0]?.id;
+    if (first) setActive(first);
+  }, [group]);
+
+  async function submit() {
+    try {
+      switch (active) {
+        case 'mt103':
+          await s.swiftMessageTransfer({
+            amount: String(amount),
+            creditorIban: iban,
+            swiftMessageKind: 'MT103',
+          });
+          break;
+        case 'mt102':
+          await s.swiftMessageTransfer({
+            amount: String(amount),
+            creditorIban: iban,
+            swiftMessageKind: 'MT102',
+          });
+          break;
+        case 'mt103-lc':
+          await s.mt103LcTransfer(String(amount), iban, tfReference || undefined);
+          break;
+        case 'sblc':
+          await s.tradeFinanceTransfer({
+            instrument: 'SBLC',
+            amount: String(amount),
+            creditorIban: iban,
+            reference: tfReference || undefined,
+          });
+          break;
+        case 'bg':
+          await s.tradeFinanceTransfer({
+            instrument: 'BG',
+            amount: String(amount),
+            creditorIban: iban,
+            reference: tfReference || undefined,
+          });
+          break;
+        case 'nova-zbank':
+          await s.transferNovaBankToZBank(String(amount), iban);
+          break;
+        case 'onex-zbank':
+          await s.transferOneXBankToZBank(String(amount), iban);
+          break;
+        case 'o24-zbank':
+          await s.transferOffice24ToZBank(String(amount), iban);
+          break;
+        case 'internal':
+          if (!recipient) throw new Error('Connect wallet for recipient');
+          await s.internalTransfer({
+            tokenAddress,
+            tokenSymbol,
+            amount: String(amount),
+            recipientAddress: recipient,
+            senderAddress: address,
+          });
+          break;
+        case 'external':
+          if (!recipient) throw new Error('Recipient address required');
+          await s.externalTransfer({
+            tokenAddress,
+            tokenSymbol,
+            amount: String(amount),
+            recipientAddress: recipient,
+            creditorIban: iban,
+            beneficiaryName: 'Z Online Bank',
+          });
+          break;
+        case 'token-load':
+          if (!recipient) throw new Error('Connect wallet for mint recipient');
+          await s.tokenLoad({
+            lineId,
+            symbol: tokenSymbol,
+            tokenAddress,
+            amount: String(amount),
+            recipientAddress: recipient,
+          });
+          break;
+        case 'fiat-crypto':
+          if (!recipient) throw new Error('Wallet recipient required');
+          await s.fiatToCrypto({
+            amount: String(amount),
+            creditorIban: iban,
+            recipientAddress: recipient,
+            tokenLineId: lineId,
+          });
+          break;
+        case 'onex-shiva-crypto':
+          if (!recipient) throw new Error('OneX wallet recipient required');
+          await s.fiatToCryptoShiva({
+            amount: String(amount),
+            creditorIban: iban,
+            recipientAddress: recipient,
+            tokenLineId: lineId,
+          });
+          break;
+        case 'full-external':
+          await s.fullExternalTransfer({
+            amount: String(amount),
+            creditorIban: iban,
+            beneficiaryName: 'Z Online Bank',
+          });
+          break;
+      }
+      await s.refreshSettlements();
+      onSuccess?.();
+    } catch {
+      /* error in hook */
+    }
+  }
+
+  const needsWallet = ['internal', 'external', 'token-load', 'fiat-crypto', 'onex-shiva-crypto'].includes(active);
+  const needsTfRef = ['mt103-lc', 'sblc', 'bg'].includes(active);
+  const simpleWire = ['mt103', 'mt102', 'mt103-lc', 'sblc', 'bg', 'nova-zbank', 'onex-zbank', 'o24-zbank', 'full-external'].includes(
+    active,
+  );
+
+  return (
+    <section className="revolut-bank__protocols" id="z-settlement-protocols" aria-label="Banking protocols">
+      <h2 className="revolut-bank__section-title">Banking protocols</h2>
+      {!import.meta.env.VITE_OMNL_API_KEY && (
+        <p className="revolut-bank__protocols-hint">
+          {isZEcosystem
+            ? 'Settlement uses the Z portal API — ensure token-aggregation is running on the origin server.'
+            : 'Settlement auth: set OMNL_API_KEY in repo .env and rebuild, or use online.omdnl.org portal.'}
+        </p>
+      )}
+      <p className="revolut-bank__protocols-hint">
+        Classic · trade finance · digital · 128-bank corridors · OneX Bank · Shiva blockchain · HYBX · Chain 138
+      </p>
+
+      <div className="zbank-settle__protocol-groups" role="tablist" aria-label="Protocol groups">
+        {GROUPS.map((g) => (
+          <button
+            key={g.id}
+            type="button"
+            role="tab"
+            aria-selected={group === g.id}
+            className={`zbank-settle__protocol-group${group === g.id ? ' zbank-settle__protocol-group--active' : ''}`}
+            onClick={() => setGroup(g.id)}
+          >
+            <span className="zbank-settle__protocol-group-label">{g.label}</span>
+            <span className="zbank-settle__protocol-group-desc">{g.desc}</span>
+          </button>
+        ))}
+      </div>
+
+      <div className="revolut-bank__protocol-tabs" role="tablist">
+        {PROTOCOLS[group].map((t) => (
+          <button
+            key={t.id}
+            type="button"
+            role="tab"
+            aria-selected={active === t.id}
+            className={`revolut-bank__protocol-tab${active === t.id ? ' revolut-bank__protocol-tab--active' : ''}`}
+            onClick={() => setActive(t.id)}
+          >
+            {t.label}
+          </button>
+        ))}
+      </div>
+
+      <div className="revolut-bank__protocol-form">
+        <label className="revolut-bank__field">
+          <span>Amount (USD)</span>
+          <input
+            type="text"
+            inputMode="decimal"
+            value={amount}
+            onChange={(e) => setAmount(e.target.value)}
+            className="revolut-bank__input"
+          />
+        </label>
+        <label className="revolut-bank__field">
+          <span>Creditor IBAN</span>
+          <input type="text" value={iban} onChange={(e) => setIban(e.target.value)} className="revolut-bank__input" />
+        </label>
+        {needsTfRef && (
+          <label className="revolut-bank__field">
+            <span>Trade finance reference</span>
+            <input
+              type="text"
+              value={tfReference}
+              onChange={(e) => setTfReference(e.target.value)}
+              placeholder="LC / SBLC / BG reference"
+              className="revolut-bank__input"
+            />
+          </label>
+        )}
+        {!simpleWire && (
+          <>
+            {needsWallet && (
+              <label className="revolut-bank__field">
+                <span>Recipient wallet</span>
+                <input
+                  type="text"
+                  value={recipient}
+                  onChange={(e) => setRecipient(e.target.value)}
+                  placeholder={isConnected ? address : '0x…'}
+                  className="revolut-bank__input"
+                />
+              </label>
+            )}
+            {(active === 'internal' || active === 'external' || active === 'token-load') && (
+              <>
+                <label className="revolut-bank__field">
+                  <span>Token symbol</span>
+                  <input
+                    type="text"
+                    value={tokenSymbol}
+                    onChange={(e) => setTokenSymbol(e.target.value)}
+                    className="revolut-bank__input"
+                  />
+                </label>
+                <label className="revolut-bank__field">
+                  <span>Token address</span>
+                  <input
+                    type="text"
+                    value={tokenAddress}
+                    onChange={(e) => setTokenAddress(e.target.value)}
+                    className="revolut-bank__input"
+                  />
+                </label>
+              </>
+            )}
+            {(active === 'token-load' || active === 'fiat-crypto') && (
+              <label className="revolut-bank__field">
+                <span>OMNL line ID</span>
+                <input type="text" value={lineId} onChange={(e) => setLineId(e.target.value)} className="revolut-bank__input" />
+              </label>
+            )}
+          </>
+        )}
+      </div>
+
+      {s.error && (
+        <div className="revolut-bank__protocol-error" role="alert">
+          {s.error}
+        </div>
+      )}
+
+      {s.lastResult?.settlementId && (
+        <div className="revolut-bank__protocol-result">
+          <p>
+            <strong>Settlement:</strong> {s.lastResult.settlementId}
+          </p>
+          <p>
+            <strong>Phase:</strong> {s.lastResult.phase ? PHASE_LABEL[s.lastResult.phase] : '—'}
+          </p>
+          {s.lastResult.fineractJournalRef && (
+            <p>
+              <strong>Fineract:</strong> {s.lastResult.fineractJournalRef}
+            </p>
+          )}
+        </div>
+      )}
+
+      <button type="button" className="revolut-bank__submit" disabled={s.loading} onClick={() => submit()}>
+        {s.loading ? 'Processing settlement…' : `Execute · ${PROTOCOLS[group].find((p) => p.id === active)?.label ?? active}`}
+      </button>
+
+      {s.settlements.length > 0 && (
+        <div className="revolut-bank__settlements-list">
+          <h3 className="revolut-bank__section-title">Recent settlements</h3>
+          <ul>
+            {s.settlements.slice(0, 8).map((row) => (
+              <li key={row.settlementId}>
+                <span>{row.settlementId?.slice(0, 12)}…</span>
+                <span>{row.phase ? PHASE_LABEL[row.phase] : '—'}</span>
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/online-bank/ZBankFullSettlementPanel.tsx b/frontend-dapp/src/features/online-bank/ZBankFullSettlementPanel.tsx
new file mode 100644
index 0000000..1eaeb16
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/ZBankFullSettlementPanel.tsx
@@ -0,0 +1,218 @@
+import { useEffect, useState } from 'react';
+import { useAccount } from 'wagmi';
+import { type SettlementPhase, type ZBankSettlementApi } from './useZBankSettlement';
+import { formatUsd } from '../../utils/formatMoney';
+
+const PHASE_LABEL: Record<SettlementPhase, string> = {
+  RECEIVED: 'Received',
+  VALIDATED: 'Validated',
+  VERBIAGE_ROLLED: 'Verbiage rolled',
+  FINERACT_POSTED: 'Fineract posted',
+  HYBX_RAIL_DISPATCHED: 'HYBX dispatched',
+  ISO20022_ARCHIVED: 'ISO 20022 archived',
+  CHAIN_MINT_REQUESTED: 'Chain mint',
+  SETTLED: 'Settled',
+  FAILED: 'Failed',
+};
+
+const DEFAULT_IBAN = 'IQ98ZARD00000000000000000001';
+const LAYERS = [
+  { id: 'M0', label: 'M0 Reserve', gl: '1050', desc: 'Base money · IPSAS reserve' },
+  { id: 'M1', label: 'M1 eMoney', gl: '2100', desc: 'Circulating liabilities' },
+  { id: 'M2', label: 'M2 Broad', gl: '2200', desc: 'Meta-fiat broad money' },
+  { id: 'M3', label: 'M3 On-chain', gl: '2300', desc: 'Token liabilities · Chain 138' },
+  { id: 'M4', label: 'M4 Fiat rails', gl: '1000', desc: 'SWIFT · HYBX · settlement suspense' },
+] as const;
+
+type Props = {
+  settlement: ZBankSettlementApi;
+  onSuccess?: () => void;
+  onMintComplete?: (recipientAddress: string) => void;
+  balances?: {
+    m0?: string;
+    m1?: string;
+    m2?: string;
+    m3?: string;
+    m4?: string;
+  };
+};
+
+export default function ZBankFullSettlementPanel({ settlement: s, onSuccess, onMintComplete, balances }: Props) {
+  const { address, isConnected } = useAccount();
+  const [amount, setAmount] = useState('1000');
+  const [iban, setIban] = useState(DEFAULT_IBAN);
+  const [recipient, setRecipient] = useState('');
+  const [includeM3, setIncludeM3] = useState(true);
+
+  useEffect(() => {
+    if (address) setRecipient(address);
+    s.refreshSettlements();
+  }, [address]);
+
+  async function submit() {
+    try {
+      await s.zBankSettleM0ToM4({
+        amount: String(amount),
+        creditorIban: iban,
+        recipientAddress: includeM3 ? recipient : undefined,
+      });
+      await s.refreshSettlements();
+      onSuccess?.();
+      if (includeM3 && recipient.startsWith('0x')) {
+        onMintComplete?.(recipient);
+        requestAnimationFrame(() => {
+          document.getElementById('z-activate-liquidity')?.scrollIntoView({ behavior: 'smooth', block: 'start' });
+        });
+      }
+    } catch {
+      /* hook sets error */
+    }
+  }
+
+  const layerSteps = s.lastResult?.layerSteps ?? [];
+  const activeLayerIdx = layerSteps.filter((st) => st.status === 'posted').length;
+
+  return (
+    <section className="zbank-settle" id="z-full-settlement" aria-label="M0 to M4 settlement">
+      <h2 className="revolut-bank__section-title">Full settlement · M0 → M4</h2>
+      <p className="revolut-bank__protocols-hint">
+        Posts sequential Fineract journals through every Z money layer, dispatches HYBX + SWIFT MT103, and{' '}
+        <strong>automatically</strong> swaps minted c* LP tokens to real USDT/USDC/WETH when M3 mint is enabled.
+      </p>
+
+      <div className="zbank-settle__pipeline" role="list" aria-label="Money layer pipeline">
+        {LAYERS.map((layer, i) => {
+          const posted = layerSteps.find((st) => st.to === layer.id)?.status === 'posted';
+          const active = s.loading && i === activeLayerIdx;
+          const done = posted || (s.lastResult?.phase === 'SETTLED' && i <= LAYERS.length - 1);
+          return (
+            <div key={layer.id} className="zbank-settle__layer-wrap" role="listitem">
+              {i > 0 && <div className={`zbank-settle__connector${done ? ' zbank-settle__connector--done' : ''}`} />}
+              <div
+                className={`zbank-settle__layer${done ? ' zbank-settle__layer--done' : ''}${active ? ' zbank-settle__layer--active' : ''}`}
+              >
+                <span className="zbank-settle__layer-id">{layer.id}</span>
+                <span className="zbank-settle__layer-name">{layer.label}</span>
+                <span className="zbank-settle__layer-gl">GL {layer.gl}</span>
+                {balances && (
+                  <span className="zbank-settle__layer-bal">
+                    {formatUsd(
+                      layer.id === 'M0'
+                        ? balances.m0
+                        : layer.id === 'M1'
+                          ? balances.m1
+                          : layer.id === 'M2'
+                            ? balances.m2
+                            : layer.id === 'M3'
+                              ? balances.m3
+                              : balances.m4,
+                    )}
+                  </span>
+                )}
+                <span className="zbank-settle__layer-desc">{layer.desc}</span>
+              </div>
+            </div>
+          );
+        })}
+      </div>
+
+      <div className="revolut-bank__protocol-form">
+        <label className="revolut-bank__field">
+          <span>Settlement amount (USD)</span>
+          <input
+            type="text"
+            inputMode="decimal"
+            value={amount}
+            onChange={(e) => setAmount(e.target.value)}
+            className="revolut-bank__input"
+          />
+        </label>
+        <label className="revolut-bank__field">
+          <span>Z Online Bank IBAN (creditor)</span>
+          <input type="text" value={iban} onChange={(e) => setIban(e.target.value)} className="revolut-bank__input" />
+        </label>
+        <label className="revolut-bank__field zbank-settle__checkbox">
+          <input type="checkbox" checked={includeM3} onChange={(e) => setIncludeM3(e.target.checked)} />
+          <span>Include M3 on-chain mint (M2→M3→M4 path)</span>
+        </label>
+        {includeM3 && (
+          <label className="revolut-bank__field">
+            <span>M3 recipient wallet (Chain 138)</span>
+            <input
+              type="text"
+              value={recipient}
+              onChange={(e) => setRecipient(e.target.value)}
+              placeholder={isConnected ? address : '0x…'}
+              className="revolut-bank__input"
+            />
+          </label>
+        )}
+      </div>
+
+      {layerSteps.length > 0 && (
+        <div className="zbank-settle__steps">
+          <h3 className="zbank-settle__steps-title">Layer journals</h3>
+          <ul>
+            {layerSteps.map((step) => (
+              <li key={`${step.from}-${step.to}`}>
+                <span>
+                  {step.from}→{step.to}
+                </span>
+                <span>
+                  Dr {step.debitGl} / Cr {step.creditGl}
+                </span>
+                <span className={`zbank-settle__step-status zbank-settle__step-status--${step.status}`}>
+                  {step.status}
+                  {step.journalRef ? ` · JE ${step.journalRef}` : ''}
+                </span>
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+
+      {s.error && (
+        <div className="revolut-bank__protocol-error" role="alert">
+          {s.error}
+        </div>
+      )}
+
+      {s.lastResult?.settlementId && (
+        <div className="revolut-bank__protocol-result">
+          <p>
+            <strong>Settlement:</strong> {s.lastResult.settlementId}
+          </p>
+          <p>
+            <strong>Phase:</strong> {s.lastResult.phase ? PHASE_LABEL[s.lastResult.phase] : '—'}
+          </p>
+          {s.lastResult.fineractJournalRef && (
+            <p>
+              <strong>Last journal:</strong> {s.lastResult.fineractJournalRef}
+            </p>
+          )}
+          {s.lastResult.hybxPaymentId && (
+            <p>
+              <strong>HYBX:</strong> {s.lastResult.hybxPaymentId}
+            </p>
+          )}
+          {s.lastResult.chainTxHash && (
+            <p>
+              <strong>Chain mint:</strong> {s.lastResult.chainTxHash}
+            </p>
+          )}
+          {s.lastResult.liquiditySwaps && s.lastResult.liquiditySwaps.length > 0 && (
+            <p>
+              <strong>Liquidity swaps:</strong> {s.lastResult.liquiditySwaps.filter((x) => x.status === 'SETTLED' || x.status === 'DRY_RUN').length} activated
+            </p>
+          )}
+        </div>
+      )}
+
+      <button type="button" className="revolut-bank__submit" disabled={s.loading} onClick={() => submit()}>
+        {s.loading
+          ? s.statusLabel ?? 'Settling M0→M4…'
+          : `Settle ${formatUsd(amount)} through M0–M4`}
+      </button>
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/online-bank/ZBankLiquidityPanel.tsx b/frontend-dapp/src/features/online-bank/ZBankLiquidityPanel.tsx
new file mode 100644
index 0000000..7ff5d19
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/ZBankLiquidityPanel.tsx
@@ -0,0 +1,173 @@
+import { useCallback, useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { useAccount } from 'wagmi';
+import WalletConnect from '../../components/wallet/WalletConnect';
+import { type FiatLpPosition, type ZBankSettlementApi } from './useZBankSettlement';
+
+type Props = {
+  settlement: ZBankSettlementApi;
+  onSuccess?: () => void;
+  mintWalletHint?: string;
+};
+
+export default function ZBankLiquidityPanel({ settlement: s, onSuccess, mintWalletHint }: Props) {
+  const { address, isConnected } = useAccount();
+  const [positions, setPositions] = useState<FiatLpPosition[]>([]);
+  const [positionsLoading, setPositionsLoading] = useState(false);
+
+  const holder = (address ?? mintWalletHint ?? '').trim();
+
+  const refreshPositions = useCallback(async () => {
+    if (!holder.startsWith('0x')) {
+      setPositions([]);
+      return;
+    }
+    setPositionsLoading(true);
+    try {
+      const rows = await s.fetchFiatLpPositions(holder);
+      setPositions(rows.filter((p) => parseFloat(p.balanceFormatted) > 0 || p.swappable));
+    } catch {
+      setPositions([]);
+    } finally {
+      setPositionsLoading(false);
+    }
+  }, [holder, s]);
+
+  useEffect(() => {
+    void refreshPositions();
+  }, [refreshPositions, mintWalletHint, s.autoLiquidityRan]);
+
+  const swappable = positions.filter((p) => p.swappable && parseFloat(p.balanceFormatted) > 0);
+
+  async function retryManual() {
+    if (!holder.startsWith('0x')) return;
+    try {
+      await s.activateRealLiquidity({
+        holderAddress: holder,
+        recipientAddress: holder,
+        convertAll: true,
+        dryRun: false,
+      });
+      await refreshPositions();
+      onSuccess?.();
+    } catch {
+      /* hook sets error */
+    }
+  }
+
+  return (
+    <section className="zbank-liquidity" id="z-activate-liquidity" aria-label="Activate real liquidity">
+      <h2 className="revolut-bank__section-title">Real liquidity (automatic)</h2>
+      <p className="revolut-bank__protocols-hint">
+        Runs <strong>automatically</strong> after M0→M4 mint with M3 enabled: c* LP tokens → real{' '}
+        <strong>USDT</strong>, <strong>USDC</strong>, or <strong>WETH</strong> on Chain 138.
+      </p>
+
+      {s.autoLiquidityRan && (
+        <p className="zbank-liquidity__auto-badge" role="status">
+          Automatic activation completed — check swap results below.
+        </p>
+      )}
+
+      {s.statusLabel && s.loading && (
+        <p className="zbank-liquidity__loading" role="status">
+          {s.statusLabel}
+        </p>
+      )}
+
+      {!isConnected && !mintWalletHint?.startsWith('0x') ? (
+        <div className="zbank-liquidity__connect">
+          <p className="zbank-liquidity__connect-hint">Connect your Chain 138 wallet to view LP balances.</p>
+          <WalletConnect />
+        </div>
+      ) : (
+        <>
+          <p className="zbank-liquidity__holder">
+            Holder: <code>{holder}</code>
+          </p>
+
+          {positionsLoading ? (
+            <p className="zbank-liquidity__loading">Reading LP balances…</p>
+          ) : swappable.length === 0 ? (
+            <p className="zbank-liquidity__empty">
+              No swappable c* balance yet — complete <a href="#z-full-settlement">M0→M4 settlement</a> with on-chain
+              mint; liquidity activation runs automatically.
+            </p>
+          ) : (
+            <div className="zbank-liquidity__table-wrap">
+              <table className="zbank-liquidity__table">
+                <thead>
+                  <tr>
+                    <th>LP token</th>
+                    <th>Balance</th>
+                    <th>→ Real fund</th>
+                    <th>Quoted out</th>
+                  </tr>
+                </thead>
+                <tbody>
+                  {swappable.map((p) => (
+                    <tr key={p.symbol}>
+                      <td>{p.symbol}</td>
+                      <td>{p.balanceFormatted}</td>
+                      <td>{p.realSymbol}</td>
+                      <td>{p.amountOutQuoted ?? '—'}</td>
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+          )}
+
+          {s.error && (
+            <div className="revolut-bank__protocol-error" role="alert">
+              {s.error}
+            </div>
+          )}
+
+          {s.lastResult?.liquiditySwaps && s.lastResult.liquiditySwaps.length > 0 && (
+            <div className="zbank-liquidity__swaps">
+              <h3 className="zbank-settle__steps-title">Swap results</h3>
+              <ul>
+                {s.lastResult.liquiditySwaps.map((leg) => (
+                  <li key={`${leg.lpSymbol}-${leg.status}-${leg.amountIn}`}>
+                    <span>
+                      {leg.lpSymbol} → {leg.realSymbol}
+                    </span>
+                    <span
+                      className={`zbank-settle__step-status zbank-settle__step-status--${leg.status === 'SETTLED' || leg.status === 'DRY_RUN' ? 'posted' : 'failed'}`}
+                    >
+                      {leg.status}
+                      {leg.txHash ? ` · ${leg.txHash.slice(0, 10)}…` : ''}
+                    </span>
+                  </li>
+                ))}
+              </ul>
+            </div>
+          )}
+
+          <div className="zbank-liquidity__actions">
+            <button
+              type="button"
+              className="revolut-bank__submit zbank-liquidity__btn--ghost"
+              disabled={positionsLoading || !holder.startsWith('0x')}
+              onClick={() => void refreshPositions()}
+            >
+              Refresh balances
+            </button>
+            <button
+              type="button"
+              className="revolut-bank__submit zbank-liquidity__btn--primary"
+              disabled={s.loading || !holder.startsWith('0x') || swappable.length === 0}
+              onClick={() => void retryManual()}
+            >
+              Retry liquidity activation
+            </button>
+            <Link to="/swap" className="zbank-liquidity__swap-link">
+              Trade real USDT / USDC on Digital Swap →
+            </Link>
+          </div>
+        </>
+      )}
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/online-bank/useOnlineBank.ts b/frontend-dapp/src/features/online-bank/useOnlineBank.ts
new file mode 100644
index 0000000..00d2f58
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/useOnlineBank.ts
@@ -0,0 +1,77 @@
+import { useMemo } from 'react';
+import { useCentralBank } from '../central-bank/useCentralBank';
+import { formatUsd } from '../../utils/formatMoney';
+
+export type BankActivity = {
+  id: string;
+  title: string;
+  meta: string;
+  amount: string;
+  positive?: boolean;
+  kind: 'swap' | 'transfer' | 'system';
+};
+
+export function useOnlineBank() {
+  const cb = useCentralBank();
+
+  const office = cb.office as {
+    officeId?: number;
+    name?: string;
+    externalId?: string;
+  } | null;
+
+  const healthOk = (cb.health as { status?: string } | null)?.status === 'ok';
+  const live = Boolean(cb.moneySupply?.fineractLive);
+  const connected = Boolean(cb.moneySupply?.fineractConnected) || healthOk;
+
+  const primaryBalance = cb.moneySupply?.M1?.circulating ?? cb.moneySupply?.M2?.broadMoney;
+  const savingsBalance = cb.moneySupply?.M2?.broadMoney;
+  const reserveBalance = cb.moneySupply?.M0?.gl1050;
+  const m4Balance = cb.moneySupply?.M4?.nearMoney;
+  const m3Balance = cb.moneySupply?.M3?.tokenLiabilities;
+
+  const activities = useMemo<BankActivity[]>(() => {
+    const items: BankActivity[] = [];
+    const swaps = (cb.monitor as { swaps?: { status: string; tokenIn: string; tokenOut?: string; amountIn?: string; createdAt: string }[] } | null)?.swaps ?? [];
+
+    for (const [i, s] of swaps.slice(0, 12).entries()) {
+      items.push({
+        id: `swap-${i}`,
+        title: `Exchange · ${s.tokenIn?.slice(0, 8) ?? 'token'}`,
+        meta: `${s.status} · ${s.createdAt?.slice(0, 16) ?? 'recent'}`,
+        amount: s.amountIn ? formatUsd(s.amountIn) : '—',
+        positive: s.status?.toLowerCase() === 'completed',
+        kind: 'swap',
+      });
+    }
+
+    if (connected && items.length === 0) {
+      items.push({
+        id: 'system-live',
+        title: 'Z Online Bank connected',
+        meta: live ? 'Fineract ledger live' : 'Settlement middleware online',
+        amount: formatUsd(primaryBalance),
+        positive: true,
+        kind: 'system',
+      });
+    }
+
+    return items;
+  }, [cb.monitor, connected, live, primaryBalance]);
+
+  return {
+    ...cb,
+    office,
+    healthOk,
+    live,
+    connected,
+    primaryBalance,
+    savingsBalance,
+    reserveBalance,
+    m4Balance,
+    m3Balance,
+    activities,
+    displayName: office?.name?.split('—')[0]?.trim() ?? (import.meta.env.VITE_ECOSYSTEM === 'z' ? 'Z Account' : 'DBIS Account'),
+    officeLabel: office?.externalId ?? `Office ${office?.officeId ?? 24}`,
+  };
+}
diff --git a/frontend-dapp/src/features/online-bank/useZBankSettlement.ts b/frontend-dapp/src/features/online-bank/useZBankSettlement.ts
new file mode 100644
index 0000000..e3f5e45
--- /dev/null
+++ b/frontend-dapp/src/features/online-bank/useZBankSettlement.ts
@@ -0,0 +1,613 @@
+import { useCallback, useState } from 'react';
+import { exchangeApi, omnlApiHeaders, settlementApi, tokenAggregationApi } from '../../config/dex';
+import { onexShiva, SHIVA_ONEX_CHAIN_ID } from '../../config/onexShiva';
+
+export type SettlementPhase =
+  | 'RECEIVED'
+  | 'VALIDATED'
+  | 'VERBIAGE_ROLLED'
+  | 'FINERACT_POSTED'
+  | 'HYBX_RAIL_DISPATCHED'
+  | 'ISO20022_ARCHIVED'
+  | 'CHAIN_MINT_REQUESTED'
+  | 'SETTLED'
+  | 'FAILED';
+
+export type FiatLpSwapLeg = {
+  lpSymbol: string;
+  tokenIn: string;
+  tokenOut: string;
+  realSymbol: string;
+  amountIn: string;
+  amountOutQuoted?: string;
+  txHash?: string;
+  status: string;
+  error?: string;
+};
+
+export type FiatLpPosition = {
+  symbol: string;
+  tokenAddress: string;
+  balanceFormatted: string;
+  realSymbol: string;
+  amountOutQuoted?: string;
+  swappable: boolean;
+};
+
+export type SettlementResult = {
+  settlementId?: string;
+  phase?: SettlementPhase;
+  errors?: string[];
+  fineractJournalRef?: string;
+  hybxPaymentId?: string;
+  chainTxHash?: string;
+  liquiditySwaps?: FiatLpSwapLeg[];
+  error?: string;
+  layerSteps?: {
+    from: string;
+    to: string;
+    debitGl: string;
+    creditGl: string;
+    journalRef?: string;
+    status: 'pending' | 'posted' | 'skipped' | 'failed';
+  }[];
+};
+
+async function postJson<T>(url: string, body: unknown): Promise<{ ok: boolean; status: number; data: T }> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: omnlApiHeaders(),
+    body: JSON.stringify(body),
+  });
+  const data = (await res.json().catch(() => ({ error: res.statusText || `HTTP ${res.status}` }))) as T;
+  return { ok: res.ok, status: res.status, data };
+}
+
+async function getJson<T>(url: string): Promise<T | null> {
+  try {
+    const res = await fetch(url, { headers: omnlApiHeaders(false) });
+    return res.ok ? ((await res.json()) as T) : null;
+  } catch {
+    return null;
+  }
+}
+
+function idem(prefix: string) {
+  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+
+function sleep(ms: number) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+const FIAT_LP_AUTO_EXECUTE = import.meta.env.VITE_FIAT_LP_AUTO_EXECUTE !== '0';
+
+/** Nova Bank Online → Z Online Bank: inbound wire import to M4 fiat */
+export async function novaBankToZBankM4Fiat(params: {
+  amount: string;
+  creditorIban: string;
+  beneficiaryName?: string;
+  remittanceInfo?: string;
+}) {
+  const base = {
+    idempotencyKey: idem('NOVA-Z-M4'),
+    officeId: 24,
+    currency: 'USD',
+    amount: params.amount,
+    creditorIban: params.creditorIban,
+    beneficiaryName: params.beneficiaryName ?? 'Z Online Bank',
+    orderingName: 'Nova Bank Online',
+    creditorBic: 'NOVAGB2LXXX',
+    debtorIban: 'GB29NOVA60161331926819',
+    remittanceInfo: params.remittanceInfo ?? 'Nova Bank Online → Z Online Bank · M4 fiat import',
+    moneyLayers: ['M1', 'M2', 'M4'] as const,
+    rail: 'SWIFT' as const,
+    swiftMessageKind: 'MT103' as const,
+  };
+
+  return postJson<SettlementResult>(settlementApi('/external-transfer'), base);
+}
+
+/** OneX Bank (Shiva / zBank office 29) → Z Online Bank: inbound wire to M4 */
+export async function onexBankToZBankM4Fiat(params: {
+  amount: string;
+  creditorIban: string;
+  beneficiaryName?: string;
+  remittanceInfo?: string;
+}) {
+  const corridor = onexShiva.bankCorridor;
+  const base = {
+    idempotencyKey: idem('ONEX-Z-M4'),
+    officeId: onexShiva.settlement.zBridgeOfficeId,
+    currency: 'USD',
+    amount: params.amount,
+    creditorIban: params.creditorIban,
+    beneficiaryName: params.beneficiaryName ?? 'Z Online Bank',
+    orderingName: corridor.orderingName,
+    creditorBic: corridor.creditorBic,
+    debtorIban: corridor.debtorIban,
+    remittanceInfo: params.remittanceInfo ?? corridor.remittanceTemplate,
+    moneyLayers: ['M1', 'M2', 'M4'] as const,
+    rail: 'HYBX' as const,
+    swiftMessageKind: corridor.swiftMessageKind as 'MT103',
+    metadata: {
+      sourceOfficeId: onexShiva.fineract.officeId,
+      sourceHybxWallet: onexShiva.fineract.hybxWalletId,
+      targetChainId: SHIVA_ONEX_CHAIN_ID,
+      integration: 'onex-shiva',
+    },
+  };
+
+  return postJson<SettlementResult>(settlementApi('/external-transfer'), base);
+}
+
+/** Office 24 → Z Online Bank: credit M1 then settle to M4 fiat rails */
+export async function office24ToZBankM4Fiat(params: {
+  amount: string;
+  creditorIban: string;
+  beneficiaryName?: string;
+  remittanceInfo?: string;
+}) {
+  const base = {
+    idempotencyKey: idem('Z-O24-M4'),
+    officeId: 24,
+    currency: 'USD',
+    amount: params.amount,
+    creditorIban: params.creditorIban,
+    beneficiaryName: params.beneficiaryName ?? 'Z Online Bank',
+    orderingName: 'Office 24 Central Bank — HOSPITALLERS',
+    remittanceInfo: params.remittanceInfo ?? 'Office 24 → Z Online Bank · M4 fiat settlement',
+    moneyLayers: ['M1', 'M2', 'M4'] as const,
+    rail: 'SWIFT' as const,
+    swiftMessageKind: 'MT103' as const,
+  };
+
+  return postJson<SettlementResult>(settlementApi('/external-transfer'), base);
+}
+
+export function useZBankSettlement() {
+  const [loading, setLoading] = useState(false);
+  const [statusLabel, setStatusLabel] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [lastResult, setLastResult] = useState<SettlementResult | null>(null);
+  const [settlements, setSettlements] = useState<SettlementResult[]>([]);
+  const [autoLiquidityRan, setAutoLiquidityRan] = useState(false);
+
+  const run = useCallback(async (label: string, fn: () => Promise<{ ok: boolean; status: number; data: SettlementResult }>) => {
+    setLoading(true);
+    setStatusLabel(label);
+    setError(null);
+    try {
+      const { ok, data, status } = await fn();
+      setLastResult(data);
+      if (!ok || data.phase === 'FAILED') {
+        const errBody = data as SettlementResult & { message?: string };
+        throw new Error(
+          errBody.error || errBody.errors?.join(', ') || errBody.message || `${label} failed (HTTP ${status})`,
+        );
+      }
+      return data;
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : `${label} failed`;
+      setError(msg);
+      throw e;
+    } finally {
+      setLoading(false);
+      setStatusLabel(null);
+    }
+  }, []);
+
+  const transferNovaBankToZBank = useCallback(
+    (amount: string, creditorIban: string) =>
+      run('Nova Bank Online → Z Online Bank M4 import', async () => {
+        const r = await novaBankToZBankM4Fiat({ amount, creditorIban });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const transferOffice24ToZBank = useCallback(
+    (amount: string, creditorIban: string) =>
+      run('Office 24 → Z Online Bank M4 transfer', async () => {
+        const r = await office24ToZBankM4Fiat({ amount, creditorIban });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const transferOneXBankToZBank = useCallback(
+    (amount: string, creditorIban: string) =>
+      run('OneX Bank → Z Online Bank M4 import (Shiva)', async () => {
+        const r = await onexBankToZBankM4Fiat({ amount, creditorIban });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const internalTransfer = useCallback(
+    (body: {
+      tokenAddress: string;
+      tokenSymbol: string;
+      amount: string;
+      recipientAddress: string;
+      senderAddress?: string;
+    }) =>
+      run('Internal transfer', async () => {
+        const r = await postJson<SettlementResult>(exchangeApi('/transfer/internal'), {
+          idempotencyKey: idem('Z-INT'),
+          ...body,
+          moneyLayers: ['M2', 'M3'],
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const externalTransfer = useCallback(
+    (body: {
+      tokenAddress: string;
+      tokenSymbol: string;
+      amount: string;
+      recipientAddress: string;
+      creditorIban: string;
+      beneficiaryName?: string;
+    }) =>
+      run('External M4 transfer', async () => {
+        const r = await postJson<SettlementResult>(exchangeApi('/transfer/external'), {
+          idempotencyKey: idem('Z-EXT'),
+          ...body,
+          moneyLayers: ['M2', 'M4'],
+          rail: 'SWIFT',
+          remittanceInfo: 'Z Online Bank M4 fiat outbound',
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const tokenLoad = useCallback(
+    (body: {
+      lineId: string;
+      symbol: string;
+      tokenAddress: string;
+      amount: string;
+      recipientAddress: string;
+    }) =>
+      run('M2 token load', async () => {
+        const r = await postJson<SettlementResult>(exchangeApi('/token-load'), {
+          idempotencyKey: idem('Z-LOAD'),
+          currency: 'USD',
+          ...body,
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const fiatToCrypto = useCallback(
+    (body: {
+      amount: string;
+      creditorIban: string;
+      recipientAddress: string;
+      tokenLineId?: string;
+      targetChainId?: number;
+    }) =>
+      run('Fiat to crypto', async () => {
+        const chainId = body.targetChainId ?? 138;
+        const r = await postJson<SettlementResult>(settlementApi('/convert/fiat-to-crypto'), {
+          idempotencyKey: idem('Z-F2C'),
+          officeId: 24,
+          currency: 'USD',
+          amount: body.amount,
+          creditorIban: body.creditorIban,
+          beneficiaryName: 'Z Online Bank',
+          recipientAddress: body.recipientAddress,
+          convertToCrypto: {
+            enabled: true,
+            targetChainId: chainId,
+            tokenLineId: body.tokenLineId ?? 'USD-M2',
+            recipientAddress: body.recipientAddress,
+          },
+          moneyLayers: ['M2', 'M3'],
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const fiatToCryptoShiva = useCallback(
+    (body: { amount: string; creditorIban: string; recipientAddress: string; tokenLineId?: string }) =>
+      fiatToCrypto({ ...body, targetChainId: SHIVA_ONEX_CHAIN_ID }),
+    [fiatToCrypto],
+  );
+
+  const tradeFinanceTransfer = useCallback(
+    (body: {
+      instrument: 'SBLC' | 'DLC' | 'BG' | 'LS';
+      amount: string;
+      creditorIban: string;
+      reference?: string;
+      expiryDate?: string;
+      swiftMessageKind?: 'MT102' | 'MT103';
+    }) =>
+      run(`${body.instrument} trade finance`, async () => {
+        const r = await postJson<SettlementResult>(settlementApi(`/trade-finance/${body.instrument}`), {
+          idempotencyKey: idem(`Z-TF-${body.instrument}`),
+          officeId: 24,
+          currency: 'USD',
+          amount: body.amount,
+          creditorIban: body.creditorIban,
+          beneficiaryName: 'Z Online Bank',
+          orderingName: 'Z Online Bank — OMNL Office 24 Central Bank',
+          remittanceInfo: `Z Online Bank ${body.instrument} · ${body.swiftMessageKind ?? 'MT103'}`,
+          moneyLayers: ['M0', 'M1', 'M2', 'M3', 'M4'],
+          rail: 'SWIFT',
+          swiftMessageKind: body.swiftMessageKind ?? 'MT103',
+          tradeFinance: {
+            instrument: body.instrument,
+            reference: body.reference ?? idem('TF-REF'),
+            expiryDate: body.expiryDate,
+          },
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const swiftMessageTransfer = useCallback(
+    (body: {
+      amount: string;
+      creditorIban: string;
+      swiftMessageKind: 'MT102' | 'MT103';
+      moneyLayers?: string[];
+      remittanceInfo?: string;
+    }) =>
+      run(`SWIFT ${body.swiftMessageKind}`, async () => {
+        const layers =
+          body.moneyLayers ??
+          (body.swiftMessageKind === 'MT102' ? ['M1', 'M2', 'M3', 'M4'] : ['M0', 'M1', 'M2', 'M4']);
+        const r = await postJson<SettlementResult>(settlementApi('/external-transfer'), {
+          idempotencyKey: idem(`Z-${body.swiftMessageKind}`),
+          officeId: 24,
+          currency: 'USD',
+          amount: body.amount,
+          creditorIban: body.creditorIban,
+          beneficiaryName: 'Z Online Bank',
+          orderingName: 'Z Online Bank — OMNL Office 24 Central Bank',
+          remittanceInfo: body.remittanceInfo ?? `Z Online Bank SWIFT ${body.swiftMessageKind}`,
+          moneyLayers: layers,
+          rail: 'SWIFT',
+          swiftMessageKind: body.swiftMessageKind,
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const mt103LcTransfer = useCallback(
+    (amount: string, creditorIban: string, reference?: string) =>
+      tradeFinanceTransfer({
+        instrument: 'DLC',
+        amount,
+        creditorIban,
+        reference,
+        swiftMessageKind: 'MT103',
+      }),
+    [tradeFinanceTransfer],
+  );
+
+  const fullExternalTransfer = useCallback(
+    (body: {
+      amount: string;
+      creditorIban: string;
+      beneficiaryName?: string;
+      moneyLayers?: string[];
+    }) =>
+      run('Full external transfer', async () => {
+        const r = await postJson<SettlementResult>(settlementApi('/external-transfer'), {
+          idempotencyKey: idem('Z-EXT-FULL'),
+          officeId: 24,
+          currency: 'USD',
+          amount: body.amount,
+          creditorIban: body.creditorIban,
+          beneficiaryName: body.beneficiaryName ?? 'Beneficiary',
+          moneyLayers: body.moneyLayers ?? ['M0', 'M1', 'M2', 'M3', 'M4'],
+          rail: 'SWIFT',
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  const refreshSettlements = useCallback(async () => {
+    const list = await getJson<{ settlements?: SettlementResult[]; items?: SettlementResult[] }>(
+      `${settlementApi('/settlements')}?limit=20`,
+    );
+    const rows = list?.settlements ?? list?.items;
+    if (rows) setSettlements(rows);
+  }, []);
+
+  const fetchFiatLpPositions = useCallback(async (holderAddress: string) => {
+    const q = new URLSearchParams({ holder: holderAddress });
+    const data = await getJson<{ positions?: FiatLpPosition[] }>(
+      `${tokenAggregationApi('/omnl/settlement/fiat-lp-positions')}?${q}`,
+    );
+    return data?.positions ?? [];
+  }, []);
+
+  const requestLiquidityActivation = useCallback(
+    async (holderAddress: string, dryRun: boolean) => {
+      const r = await postJson<SettlementResult>(settlementApi('/convert/fiat-lp-to-liquidity'), {
+        idempotencyKey: idem('Z-LP-LIQ'),
+        officeId: 24,
+        holderAddress,
+        recipientAddress: holderAddress,
+        convertAll: true,
+        dryRun,
+        maxSlippageBps: 50,
+      });
+      return r;
+    },
+    [],
+  );
+
+  const autoActivateRealLiquidity = useCallback(
+    async (holderAddress: string): Promise<SettlementResult | null> => {
+      setStatusLabel('Waiting for LP tokens on Chain 138…');
+      for (let attempt = 0; attempt < 12; attempt += 1) {
+        const positions = await fetchFiatLpPositions(holderAddress);
+        const hasLp = positions.some(
+          (p) => p.swappable && parseFloat(p.balanceFormatted) > 0,
+        );
+        if (hasLp) break;
+        await sleep(2000);
+      }
+
+      setStatusLabel('Activating real liquidity (c* → USDT/USDC/WETH)…');
+      let live = FIAT_LP_AUTO_EXECUTE;
+      let r = await requestLiquidityActivation(holderAddress, !live);
+      if (!r.ok && live) {
+        r = await requestLiquidityActivation(holderAddress, true);
+        live = false;
+      }
+
+      setAutoLiquidityRan(true);
+      if (r.data.liquiditySwaps?.length) {
+        setLastResult((prev) => ({
+          ...(prev ?? {}),
+          ...r.data,
+          liquiditySwaps: r.data.liquiditySwaps,
+        }));
+      }
+
+      if (!r.ok || r.data.phase === 'FAILED') {
+        const errBody = r.data as SettlementResult & { message?: string };
+        setError(
+          errBody.error ||
+            errBody.errors?.join(', ') ||
+            errBody.message ||
+            'Automatic liquidity activation failed',
+        );
+        return null;
+      }
+
+      return r.data;
+    },
+    [fetchFiatLpPositions, requestLiquidityActivation],
+  );
+
+  const zBankSettleM0ToM4 = useCallback(
+    (body: {
+      amount: string;
+      creditorIban: string;
+      recipientAddress?: string;
+      tokenLineId?: string;
+      autoActivateLiquidity?: boolean;
+    }) =>
+      run('Z Online Bank M0→M4 settlement', async () => {
+        const payload = {
+          idempotencyKey: idem('Z-M0M4'),
+          officeId: 24,
+          currency: 'USD',
+          amount: body.amount,
+          creditorIban: body.creditorIban,
+          beneficiaryName: 'Z Online Bank',
+          remittanceInfo: 'Z Online Bank full-stack settlement M0→M1→M2→M3→M4',
+          recipientAddress: body.recipientAddress,
+          tokenLineId: body.tokenLineId ?? 'USD-M2',
+        };
+        let r = await postJson<SettlementResult>(settlementApi('/z-bank/settle-m0-m4'), payload);
+        if (r.status === 404 || r.status === 405) {
+          r = await postJson<SettlementResult>(settlementApi('/external-transfer'), {
+            ...payload,
+            moneyLayers: ['M0', 'M1', 'M2', 'M3', 'M4'],
+            rail: 'SWIFT',
+            swiftMessageKind: 'MT103',
+            convertToCrypto: body.recipientAddress
+              ? {
+                  enabled: true,
+                  targetChainId: 138,
+                  tokenLineId: body.tokenLineId ?? 'USD-M2',
+                  recipientAddress: body.recipientAddress,
+                }
+              : undefined,
+          });
+        }
+
+        let data = r.data;
+        const autoOn = body.autoActivateLiquidity !== false;
+        if (
+          autoOn &&
+          body.recipientAddress?.startsWith('0x') &&
+          r.ok &&
+          data.phase !== 'FAILED'
+        ) {
+          setLoading(true);
+          const liq = await autoActivateRealLiquidity(body.recipientAddress);
+          if (liq?.liquiditySwaps) {
+            data = { ...data, liquiditySwaps: liq.liquiditySwaps };
+          }
+          setLoading(false);
+          setStatusLabel(null);
+        }
+
+        return { ok: r.ok, status: r.status, data };
+      }),
+    [run, autoActivateRealLiquidity],
+  );
+
+  const activateRealLiquidity = useCallback(
+    (body: {
+      holderAddress: string;
+      recipientAddress?: string;
+      convertAll?: boolean;
+      symbol?: string;
+      amount?: string;
+      dryRun?: boolean;
+    }) =>
+      run('Activate real liquidity', async () => {
+        const r = await postJson<SettlementResult>(settlementApi('/convert/fiat-lp-to-liquidity'), {
+          idempotencyKey: idem('Z-LP-LIQ'),
+          officeId: 24,
+          holderAddress: body.holderAddress,
+          recipientAddress: body.recipientAddress ?? body.holderAddress,
+          convertAll: body.convertAll ?? true,
+          symbol: body.symbol,
+          amount: body.amount,
+          dryRun: body.dryRun ?? true,
+          maxSlippageBps: 50,
+        });
+        return { ok: r.ok, status: r.status, data: r.data };
+      }),
+    [run],
+  );
+
+  return {
+    loading,
+    statusLabel,
+    error,
+    lastResult,
+    settlements,
+    autoLiquidityRan,
+    transferNovaBankToZBank,
+    transferOffice24ToZBank,
+    transferOneXBankToZBank,
+    internalTransfer,
+    externalTransfer,
+    tokenLoad,
+    fiatToCrypto,
+    fiatToCryptoShiva,
+    swiftMessageTransfer,
+    tradeFinanceTransfer,
+    mt103LcTransfer,
+    zBankSettleM0ToM4,
+    fullExternalTransfer,
+    refreshSettlements,
+    fetchFiatLpPositions,
+    activateRealLiquidity,
+    autoActivateRealLiquidity,
+    clearError: () => setError(null),
+  };
+}
+
+export type ZBankSettlementApi = ReturnType<typeof useZBankSettlement>;
diff --git a/frontend-dapp/src/features/swap/DBISSwapPanel.tsx b/frontend-dapp/src/features/swap/DBISSwapPanel.tsx
index aa4a1fe..5cbdee9 100644
--- a/frontend-dapp/src/features/swap/DBISSwapPanel.tsx
+++ b/frontend-dapp/src/features/swap/DBISSwapPanel.tsx
@@ -42,12 +42,12 @@ function SidePanel({
   children,
 }: {
   title: string;
-  icon: 'ledger' | 'rocket' | 'rail' | 'chart' | 'satellite';
+  icon: 'ledger' | 'rocket' | 'rail' | 'chart';
   children: ReactNode;
 }) {
   return (
     <div className="dash-card">
-      <h3 className="dash-section-title mb-3 flex items-center gap-2">
+      <h3 className="dash-section-title mb-3 flex items-center justify-center gap-2">
         <NasaIcon name={icon} size={14} className="nasa-icon--telemetry" />
         {title}
       </h3>
@@ -75,13 +75,12 @@ export default function DBISSwapPanel() {
         : '—';
 
   return (
-    <div className="nasa-page px-4 py-6 max-w-6xl mx-auto">
+    <div className="app-page-shell nasa-page px-4 py-6 w-full">
       <NasaPageHeader
         icon="swap"
-        missionId="SWP-138"
         title="Digital Swap Console"
         subtitle={`M2 asset exchange · Office 24 · ${swap.tokens.length} registered tokens`}
-        badges={<span className="nasa-badge nasa-badge--telemetry">Chain 138</span>}
+        badges={<span className="dash-badge dash-badge--green">Chain 138</span>}
       />
 
       <div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
@@ -116,16 +115,16 @@ export default function DBISSwapPanel() {
               />
             </label>
 
-            <div className="flex items-center gap-3 text-sm font-mono">
-              <span className="text-[#7a9bb8] uppercase text-xs">Slippage</span>
+            <div className="flex items-center gap-3 text-sm">
+              <span className="text-[#848e9c] text-xs font-medium">Slippage</span>
               {[25, 50, 100].map((bps) => (
                 <button
                   key={bps}
                   type="button"
-                  className={`px-3 py-1 text-xs border font-mono ${
+                  className={`px-3 py-1 text-xs rounded border ${
                     swap.slippageBps === bps
-                      ? 'border-[#00d4ff] text-[#00d4ff] bg-[#00d4ff]/10'
-                      : 'border-[#1e4a8a] text-[#7a9bb8]'
+                      ? 'border-green-500 text-green-400 bg-green-500/10'
+                      : 'border-white/10 text-[#848e9c]'
                   }`}
                   onClick={() => swap.setSlippageBps(bps)}
                 >
@@ -137,10 +136,10 @@ export default function DBISSwapPanel() {
             <div className="nasa-inset-panel">
               <p className="dash-stat-label">Expected output</p>
               <p className="dash-stat-value !text-2xl">
-                {outDisplay} <span className="text-base text-[#00d4ff]">{swap.tokenOut.symbol}</span>
+                {outDisplay} <span className="text-base text-green-400">{swap.tokenOut.symbol}</span>
               </p>
               {swap.plan?.plannerResponse?.routePlan?.legs && (
-                <p className="text-xs text-[#7a9bb8] mt-2 font-mono">
+                <p className="text-xs text-[#848e9c] mt-2">
                   Route:{' '}
                   {swap.plan.plannerResponse.routePlan.legs
                     .map((l: { provider?: string }) => l.provider)
@@ -157,9 +156,9 @@ export default function DBISSwapPanel() {
               </p>
             )}
             {swap.txHash && (
-              <p className="text-xs text-[#7a9bb8] break-all font-mono">
+              <p className="text-xs text-[#848e9c] break-all">
                 Tx:{' '}
-                <a href={`https://explorer.d-bis.org/tx/${swap.txHash}`} target="_blank" rel="noreferrer" className="text-[#00d4ff] hover:underline">
+                <a href={`https://explorer.d-bis.org/tx/${swap.txHash}`} target="_blank" rel="noreferrer" className="text-green-400 hover:underline">
                   {swap.txHash}
                 </a>
               </p>
@@ -186,16 +185,16 @@ export default function DBISSwapPanel() {
         <div className="space-y-4">
           <SidePanel title="Office 24 ledger" icon="ledger">
             {!swap.isConnected ? (
-              <p className="text-sm text-[#7a9bb8]">Connect wallet for crypto balances</p>
+              <p className="text-sm text-[#848e9c]">Connect wallet for crypto balances</p>
             ) : swap.ledger ? (
-              <div className="text-xs space-y-2 font-mono">
+              <div className="text-xs space-y-2">
                 <p>M1: {(swap.ledger as { fundLedger?: { M1?: { circulating?: string } } }).fundLedger?.M1?.circulating ?? '—'}</p>
                 <p>M2: {(swap.ledger as { fundLedger?: { M2?: { broadMoney?: string } } }).fundLedger?.M2?.broadMoney ?? '—'}</p>
                 <p>M3: {(swap.ledger as { fundLedger?: { M3?: { tokenLiabilities?: string } } }).fundLedger?.M3?.tokenLiabilities ?? '—'}</p>
                 <p>M4: {(swap.ledger as { fundLedger?: { M4?: { nearMoney?: string } } }).fundLedger?.M4?.nearMoney ?? '—'}</p>
                 {(swap.ledger as { cryptoLedger?: { balances?: Record<string, string> } }).cryptoLedger?.balances && (
-                  <div className="mt-2 pt-2 border-t border-[#1e4a8a]">
-                    <p className="text-[#7a9bb8] mb-1">Wallet balances</p>
+                  <div className="mt-2 pt-2 border-t border-white/10">
+                    <p className="text-[#848e9c] mb-1">Wallet balances</p>
                     {Object.entries(
                       (swap.ledger as { cryptoLedger: { balances: Record<string, string> } }).cryptoLedger.balances,
                     ).map(([sym, bal]) => (
@@ -212,7 +211,7 @@ export default function DBISSwapPanel() {
           </SidePanel>
 
           <SidePanel title="M2→M3 token load" icon="rocket">
-            <p className="text-xs text-[#7a9bb8] mb-3">GL 2200 → GL 2300 · on-chain M3</p>
+            <p className="text-xs text-[#848e9c] mb-3">GL 2200 → GL 2300 · on-chain M3</p>
             <input type="text" inputMode="decimal" placeholder="Fiat amount" value={swap.loadAmount} onChange={(e) => swap.setLoadAmount(e.target.value)} className="nasa-input mb-2 text-sm" />
             <button type="button" className="nasa-btn nasa-btn--primary w-full text-xs" disabled={swap.loading || !swap.isConnected || !swap.loadAmount} onClick={() => swap.loadM2Token()}>
               Load {swap.tokenOut.symbol}
@@ -232,8 +231,8 @@ export default function DBISSwapPanel() {
           </SidePanel>
 
           {swap.lastSettlement && (
-            <SidePanel title="Last settlement" icon="satellite">
-              <p className="text-xs text-[#7a9bb8] font-mono break-all">
+            <SidePanel title="Last settlement" icon="chart">
+              <p className="text-xs text-[#848e9c] break-all">
                 {(swap.lastSettlement as { phase?: string }).phase ?? 'OK'} · {(swap.lastSettlement as { settlementId?: string }).settlementId ?? '—'}
               </p>
             </SidePanel>
@@ -241,16 +240,16 @@ export default function DBISSwapPanel() {
 
           <SidePanel title="Swap monitor" icon="chart">
             {swap.monitor ? (
-              <div className="text-xs space-y-2 font-mono">
+              <div className="text-xs space-y-2">
                 <p>Total: {(swap.monitor as { stats?: { total?: number } }).stats?.total ?? 0} · 24h: {(swap.monitor as { stats?: { last24h?: number } }).stats?.last24h ?? 0}</p>
-                <ul className="max-h-40 overflow-y-auto space-y-1 text-[#7a9bb8]">
+                <ul className="max-h-40 overflow-y-auto space-y-1 text-[#848e9c]">
                   {((swap.monitor as { swaps?: { tokenIn: string; status: string; createdAt: string }[] }).swaps ?? []).slice(0, 5).map((s, i) => (
                     <li key={i} className="truncate">{s.status} · {s.createdAt.slice(0, 16)}</li>
                   ))}
                 </ul>
               </div>
             ) : (
-              <p className="text-xs text-[#7a9bb8]">Loading telemetry…</p>
+              <p className="text-xs text-[#848e9c]">Loading…</p>
             )}
           </SidePanel>
         </div>
diff --git a/frontend-dapp/src/features/trade/BinanceTradePanel.tsx b/frontend-dapp/src/features/trade/BinanceTradePanel.tsx
index 090b5c1..432cb0d 100644
--- a/frontend-dapp/src/features/trade/BinanceTradePanel.tsx
+++ b/frontend-dapp/src/features/trade/BinanceTradePanel.tsx
@@ -25,12 +25,12 @@ function MarketRow({
         active ? 'trade-market-row--active' : ''
       }`}
     >
-      <span className="font-medium text-[#e8f4ff] flex items-center gap-1.5">
-        <NasaIcon name="money" size={12} className="nasa-icon--telemetry" />
+      <span className="font-medium text-[#eaecef] flex items-center gap-1.5">
+        <NasaIcon name="money" size={12} className="text-green-500" />
         {token.symbol}
-        <span className="text-[#7a9bb8]">/{quote}</span>
+        <span className="text-[#848e9c]">/{quote}</span>
       </span>
-      <span className="text-[#3dff8a] text-xs font-mono">M2</span>
+      <span className="text-green-500 text-xs">M2</span>
     </button>
   );
 }
@@ -44,7 +44,7 @@ function OrderBookMock({ price }: { price: string }) {
   });
   return (
     <div className="trade-orderbook text-xs font-mono">
-      <div className="flex justify-between text-[#7a9bb8] px-2 py-1 border-b border-[#1e4a8a]">
+      <div className="flex justify-between text-[#848e9c] px-2 py-1 border-b border-white/10">
         <span>Price</span>
         <span>Amount</span>
       </div>
@@ -115,11 +115,37 @@ export default function BinanceTradePanel() {
       : '—';
 
   return (
-    <div className="trade-layout nasa-mission-root">
-      {/* Markets sidebar */}
-      <aside className="trade-markets hidden lg:flex flex-col border-r border-[#1e4a8a]">
-        <div className="p-3 border-b border-[#1e4a8a] flex items-center gap-2">
-          <NasaIcon name="search" size={14} className="nasa-icon--telemetry shrink-0" />
+    <div className="trade-layout app-shell">
+      {/* Mobile market picker */}
+      <div className="lg:hidden col-span-full border-b border-white/10 p-3 bg-[var(--nasa-panel)] space-y-2">
+        <label className="block text-xs text-[#848e9c] font-medium">Market</label>
+        <input
+          type="search"
+          placeholder="Search token"
+          value={marketSearch}
+          onChange={(e) => setMarketSearch(e.target.value)}
+          className="nasa-input !min-h-[44px] !text-base w-full"
+        />
+        <select
+          className="w-full bg-[#2b3139] border border-[#474d57] rounded px-3 py-3 text-base min-h-[44px]"
+          value={swap.tokenOut.address}
+          onChange={(e) => {
+            const t = markets.find((x) => x.address === e.target.value) ?? swap.tokenOut;
+            selectMarket(t);
+          }}
+        >
+          {markets.map((t) => (
+            <option key={t.address} value={t.address}>
+              {t.symbol} / {quoteToken?.symbol ?? 'USDT'}
+            </option>
+          ))}
+        </select>
+      </div>
+
+      {/* Markets sidebar — desktop */}
+      <aside className="trade-markets hidden lg:flex flex-col border-r border-white/10">
+        <div className="p-3 border-b border-white/10 flex items-center gap-2">
+          <NasaIcon name="search" size={14} className="text-green-500 shrink-0" />
           <input
             type="search"
             placeholder="Search markets"
@@ -129,9 +155,9 @@ export default function BinanceTradePanel() {
           />
         </div>
         <div className="flex-1 overflow-y-auto">
-          <p className="px-3 py-2 text-xs text-[#7a9bb8] uppercase font-mono flex items-center gap-1.5">
-            <NasaIcon name="trade" size={12} className="nasa-icon--telemetry" />
-            M2 · {markets.length} pairs
+          <p className="px-3 py-2 text-xs text-[#848e9c] font-medium flex items-center gap-1.5">
+            <NasaIcon name="trade" size={12} className="text-green-500" />
+            {markets.length} markets
           </p>
           {markets.map((t) => (
             <MarketRow
@@ -147,29 +173,25 @@ export default function BinanceTradePanel() {
 
       {/* Chart + order book */}
       <section className="trade-center flex flex-col min-w-0">
-        <div className="trade-pair-header flex flex-wrap items-center gap-4 px-4 py-3 border-b border-[#1e4a8a]">
+        <div className="trade-pair-header flex flex-wrap items-center gap-4 px-4 py-3 border-b border-white/10">
           <div className="flex items-center gap-2">
             <TokenIcon symbol={swap.tokenOut.symbol} size={28} />
             <div>
-              <p className="text-[0.65rem] font-mono uppercase tracking-widest text-[#7a9bb8] flex items-center gap-1">
-                <NasaIcon name="trade" size={12} className="nasa-icon--telemetry" />
-                TRD-138 · Exchange terminal
-              </p>
-              <h1 className="text-xl font-bold text-[#e8f4ff] font-mono uppercase tracking-wide">
+              <p className="text-xs text-[#848e9c]">Spot</p>
+              <h1 className="text-xl font-bold text-[#eaecef]">
                 {swap.tokenOut.symbol}/{quoteToken?.symbol ?? 'USDT'}
               </h1>
             </div>
           </div>
-          <span className="text-2xl font-semibold text-[#3dff8a] font-mono">{displayPrice}</span>
-          <span className="nasa-badge nasa-badge--nominal text-xs">Office 24 · Chain 138</span>
-          <span className="text-xs text-[#7a9bb8] font-mono flex items-center gap-1">
-            <NasaIcon name="satellite" size={12} />
-            37 M2 tokens · tradable &amp; swappable
+          <span className="text-2xl font-semibold text-green-400 tabular-nums">{displayPrice}</span>
+          <span className="dash-badge dash-badge--green text-xs">Chain 138</span>
+          <span className="text-xs text-[#848e9c]">
+            {markets.length} tradable tokens
           </span>
         </div>
 
         <div className="flex-1 grid grid-cols-1 xl:grid-cols-[1fr_280px] min-h-[320px]">
-          <div className="trade-chart border-b xl:border-b-0 xl:border-r border-[#2d6bb8] p-4">
+          <div className="trade-chart border-b xl:border-b-0 xl:border-r border-white/10 p-4">
             <div className="trade-chart__canvas h-full flex items-end justify-around px-2 pb-2 gap-1">
               {Array.from({ length: 24 }, (_, i) => (
                 <div
@@ -184,15 +206,23 @@ export default function BinanceTradePanel() {
             </div>
             <p className="text-xs text-[#848e9c] mt-2 text-center">Live chart · connect WebSocket feed for production</p>
           </div>
+          <div className="trade-book xl:hidden p-2 border-t border-white/10">
+            <details className="text-xs">
+              <summary className="text-[#848e9c] px-2 py-2 cursor-pointer min-h-[44px] flex items-center font-medium">
+                Order book
+              </summary>
+              <OrderBookMock price={displayPrice} />
+            </details>
+          </div>
           <div className="trade-book hidden xl:block p-2">
-            <p className="text-xs text-[#848e9c] uppercase px-2 py-1">Order book</p>
+            <p className="text-xs text-[#848e9c] px-2 py-1 font-medium">Order book</p>
             <OrderBookMock price={displayPrice} />
           </div>
         </div>
 
-        <div className="trade-recent border-t border-[#2d6bb8] p-3 max-h-[140px] overflow-y-auto">
-          <p className="text-xs text-[#848e9c] uppercase mb-2">Recent trades</p>
-          <div className="grid grid-cols-3 gap-2 text-xs font-mono text-[#848e9c]">
+        <div className="trade-recent border-t border-white/10 p-3 max-h-[140px] overflow-y-auto">
+          <p className="text-xs text-[#848e9c] mb-2 font-medium">Recent trades</p>
+          <div className="grid grid-cols-3 gap-2 text-xs tabular-nums text-[#848e9c]">
             {((swap.monitor as { swaps?: { status: string; amountIn: string; createdAt: string }[] })?.swaps ?? [])
               .slice(0, 6)
               .map((s, i) => (
@@ -207,8 +237,8 @@ export default function BinanceTradePanel() {
       </section>
 
       {/* Trade panel */}
-      <aside className="trade-panel w-full lg:w-[320px] shrink-0 border-l border-[#2d6bb8] flex flex-col">
-        <div className="flex border-b border-[#2d6bb8]">
+      <aside className="trade-panel w-full lg:w-[320px] shrink-0 border-l border-white/10 flex flex-col">
+        <div className="flex border-b border-white/10">
           <button
             type="button"
             className={`flex-1 py-3 text-sm font-semibold ${side === 'buy' ? 'text-[#0ecb81] border-b-2 border-[#0ecb81]' : 'text-[#848e9c]'}`}
diff --git a/frontend-dapp/src/features/z-bot/ZBotPanel.tsx b/frontend-dapp/src/features/z-bot/ZBotPanel.tsx
new file mode 100644
index 0000000..7103af0
--- /dev/null
+++ b/frontend-dapp/src/features/z-bot/ZBotPanel.tsx
@@ -0,0 +1,75 @@
+import { useEffect, useRef, useState } from 'react';
+import { useZBotChat } from './useZBotChat';
+import { zChain } from '../../config/zChain';
+import './z-bot.css';
+
+type Props = {
+  walletAddress?: string;
+  chainId?: number;
+  defaultOpen?: boolean;
+};
+
+export default function ZBotPanel({ walletAddress, chainId, defaultOpen = false }: Props) {
+  const [open, setOpen] = useState(defaultOpen);
+  const [input, setInput] = useState('');
+  const { messages, sendMessage, loading } = useZBotChat(walletAddress, chainId);
+  const chatRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (chatRef.current) {
+      chatRef.current.scrollTop = chatRef.current.scrollHeight;
+    }
+  }, [messages, open]);
+
+  const handleSend = () => {
+    const text = input;
+    setInput('');
+    void sendMessage(text);
+  };
+
+  return (
+    <>
+      <button
+        type="button"
+        id="z-bot"
+        className="z-bot-fab"
+        onClick={() => setOpen((v) => !v)}
+        aria-label="Open Z Bot"
+      >
+        Z Bot
+      </button>
+
+      {open && (
+        <div className="z-bot-panel" role="dialog" aria-label="Z Bot chat">
+          <header className="z-bot-header">
+            <span>{zChain.brand.bot}</span>
+            <button type="button" className="z-bot-close" onClick={() => setOpen(false)} aria-label="Close">
+              ×
+            </button>
+          </header>
+          <div ref={chatRef} className="z-bot-chat">
+            {messages.map((m, i) => (
+              <div key={i} className={`z-bot-message z-bot-message--${m.role}`}>
+                <div className="z-bot-message__text">{m.content}</div>
+              </div>
+            ))}
+            {loading && <div className="z-bot-message z-bot-message--assistant">Thinking…</div>}
+          </div>
+          <div className="z-bot-input-row">
+            <input
+              type="text"
+              className="z-bot-input"
+              placeholder="Ask Z Bot…"
+              value={input}
+              onChange={(e) => setInput(e.target.value)}
+              onKeyDown={(e) => e.key === 'Enter' && handleSend()}
+            />
+            <button type="button" className="z-bot-send" onClick={handleSend} disabled={loading}>
+              Send
+            </button>
+          </div>
+        </div>
+      )}
+    </>
+  );
+}
diff --git a/frontend-dapp/src/features/z-bot/useZBotChat.ts b/frontend-dapp/src/features/z-bot/useZBotChat.ts
new file mode 100644
index 0000000..16405d5
--- /dev/null
+++ b/frontend-dapp/src/features/z-bot/useZBotChat.ts
@@ -0,0 +1,71 @@
+import { useCallback, useState } from 'react';
+import { TOKEN_AGGREGATION_URL } from '../../config/dex';
+import { omnlApiHeaders } from '../../config/dex';
+
+export type ZBotMessage = {
+  role: 'user' | 'assistant';
+  content: string;
+  timestamp: Date;
+};
+
+function sessionId(): string {
+  const key = 'z-bot-session';
+  let id = sessionStorage.getItem(key);
+  if (!id) {
+    id = `zbot-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    sessionStorage.setItem(key, id);
+  }
+  return id;
+}
+
+export function useZBotChat(walletAddress?: string, chainId?: number) {
+  const [messages, setMessages] = useState<ZBotMessage[]>([
+    {
+      role: 'assistant',
+      content: 'Hi — I am Z Bot. Ask about your balance, international corridors, or transfer status.',
+      timestamp: new Date(),
+    },
+  ]);
+  const [loading, setLoading] = useState(false);
+
+  const sendMessage = useCallback(
+    async (text: string) => {
+      if (!text.trim()) return;
+      const userMsg: ZBotMessage = { role: 'user', content: text.trim(), timestamp: new Date() };
+      setMessages((prev) => [...prev, userMsg]);
+      setLoading(true);
+      try {
+        const res = await fetch(`${TOKEN_AGGREGATION_URL}/z-bot/chat`, {
+          method: 'POST',
+          headers: omnlApiHeaders(),
+          body: JSON.stringify({
+            sessionId: sessionId(),
+            message: text.trim(),
+            walletAddress,
+            chainId,
+          }),
+        });
+        const data = (await res.json()) as { reply?: string; error?: string };
+        const reply = data.reply ?? data.error ?? 'Sorry, I could not process that request.';
+        setMessages((prev) => [
+          ...prev,
+          { role: 'assistant', content: reply, timestamp: new Date() },
+        ]);
+      } catch (e) {
+        setMessages((prev) => [
+          ...prev,
+          {
+            role: 'assistant',
+            content: e instanceof Error ? e.message : 'Network error',
+            timestamp: new Date(),
+          },
+        ]);
+      } finally {
+        setLoading(false);
+      }
+    },
+    [walletAddress, chainId],
+  );
+
+  return { messages, sendMessage, loading };
+}
diff --git a/frontend-dapp/src/features/z-bot/z-bot.css b/frontend-dapp/src/features/z-bot/z-bot.css
new file mode 100644
index 0000000..a7ec8ef
--- /dev/null
+++ b/frontend-dapp/src/features/z-bot/z-bot.css
@@ -0,0 +1,111 @@
+.z-bot-fab {
+  position: fixed;
+  right: 1.25rem;
+  bottom: 1.25rem;
+  z-index: 50;
+  padding: 0.65rem 1rem;
+  border-radius: 9999px;
+  background: linear-gradient(135deg, #7c3aed, #0d9488);
+  color: #fff;
+  font-weight: 600;
+  font-size: 0.875rem;
+  border: none;
+  cursor: pointer;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+}
+
+.z-bot-panel {
+  position: fixed;
+  right: 1.25rem;
+  bottom: 4.5rem;
+  z-index: 50;
+  width: min(360px, calc(100vw - 2rem));
+  height: 420px;
+  display: flex;
+  flex-direction: column;
+  background: #1a1d24;
+  border: 1px solid rgba(124, 58, 237, 0.35);
+  border-radius: 1rem;
+  overflow: hidden;
+  box-shadow: 0 12px 40px rgba(0, 0, 0, 0.45);
+}
+
+.z-bot-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 1rem;
+  background: #252830;
+  font-weight: 600;
+  color: #e8f4ff;
+}
+
+.z-bot-close {
+  background: none;
+  border: none;
+  color: #a0a0a0;
+  font-size: 1.25rem;
+  cursor: pointer;
+  line-height: 1;
+}
+
+.z-bot-chat {
+  flex: 1;
+  overflow-y: auto;
+  padding: 0.75rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.z-bot-message {
+  max-width: 90%;
+  padding: 0.5rem 0.75rem;
+  border-radius: 0.75rem;
+  font-size: 0.875rem;
+  line-height: 1.4;
+}
+
+.z-bot-message--user {
+  align-self: flex-end;
+  background: #0d9488;
+  color: #fff;
+}
+
+.z-bot-message--assistant {
+  align-self: flex-start;
+  background: #2d3140;
+  color: #e8f4ff;
+}
+
+.z-bot-input-row {
+  display: flex;
+  gap: 0.5rem;
+  padding: 0.75rem;
+  border-top: 1px solid rgba(255, 255, 255, 0.08);
+}
+
+.z-bot-input {
+  flex: 1;
+  border-radius: 0.5rem;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  background: #252830;
+  color: #fff;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.875rem;
+}
+
+.z-bot-send {
+  border-radius: 0.5rem;
+  border: none;
+  background: #7c3aed;
+  color: #fff;
+  padding: 0.5rem 0.85rem;
+  font-weight: 500;
+  cursor: pointer;
+}
+
+.z-bot-send:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
diff --git a/frontend-dapp/src/features/z-wallet/InternationalTransferPanel.tsx b/frontend-dapp/src/features/z-wallet/InternationalTransferPanel.tsx
new file mode 100644
index 0000000..4a2048c
--- /dev/null
+++ b/frontend-dapp/src/features/z-wallet/InternationalTransferPanel.tsx
@@ -0,0 +1,82 @@
+import TransferStatusCard from './TransferStatusCard';
+import { useZWalletInternationalTransfer } from './useZWalletInternationalTransfer';
+import { useState } from 'react';
+
+type Props = {
+  recipientAddress?: string;
+};
+
+export default function InternationalTransferPanel({ recipientAddress }: Props) {
+  const { submitTransfer, loading, lastResult, error, corridors } = useZWalletInternationalTransfer();
+  const [amount, setAmount] = useState('');
+  const [creditorIban, setCreditorIban] = useState('');
+  const [corridorId, setCorridorId] = useState(corridors[0]?.id ?? 'GLOBAL-USD');
+  const selected = corridors.find((c) => c.id === corridorId);
+
+  return (
+    <section className="p-6 bg-[#252830] rounded-xl border border-emerald-500/20 space-y-4 text-left">
+      <div>
+        <h2 className="text-lg font-semibold text-white">International transfer</h2>
+        <p className="text-sm text-[#A0A0A0]">Send abroad via Z Bank rails (SWIFT, HYBX, CHAIN_MINT).</p>
+      </div>
+
+      <label className="block text-sm">
+        <span className="text-[#A0A0A0]">Corridor</span>
+        <select
+          className="mt-1 w-full rounded-lg bg-[#1a1d24] border border-white/10 px-3 py-2 text-white"
+          value={corridorId}
+          onChange={(e) => setCorridorId(e.target.value)}
+        >
+          {corridors.map((c) => (
+            <option key={c.id} value={c.id}>
+              {c.label}
+            </option>
+          ))}
+        </select>
+      </label>
+
+      <label className="block text-sm">
+        <span className="text-[#A0A0A0]">Amount ({selected?.currency ?? 'USD'})</span>
+        <input
+          type="text"
+          inputMode="decimal"
+          className="mt-1 w-full rounded-lg bg-[#1a1d24] border border-white/10 px-3 py-2 text-white"
+          value={amount}
+          onChange={(e) => setAmount(e.target.value)}
+          placeholder="100.00"
+        />
+      </label>
+
+      <label className="block text-sm">
+        <span className="text-[#A0A0A0]">Creditor IBAN</span>
+        <input
+          type="text"
+          className="mt-1 w-full rounded-lg bg-[#1a1d24] border border-white/10 px-3 py-2 text-white font-mono text-xs"
+          value={creditorIban}
+          onChange={(e) => setCreditorIban(e.target.value)}
+          placeholder="GB82WEST12345698765432"
+        />
+      </label>
+
+      <button
+        type="button"
+        disabled={loading || !amount || !creditorIban}
+        onClick={() =>
+          void submitTransfer({
+            amount,
+            creditorIban,
+            corridorId,
+            currency: selected?.currency ?? 'USD',
+            recipientAddress,
+          })
+        }
+        className="w-full py-2.5 rounded-lg bg-emerald-600 hover:bg-emerald-500 disabled:opacity-50 text-white font-medium"
+      >
+        {loading ? 'Submitting…' : 'Send international transfer'}
+      </button>
+
+      {error && <p className="text-sm text-red-400">{error}</p>}
+      {lastResult?.settlementId && <TransferStatusCard settlementRef={lastResult.settlementId} />}
+    </section>
+  );
+}
diff --git a/frontend-dapp/src/features/z-wallet/TransferStatusCard.tsx b/frontend-dapp/src/features/z-wallet/TransferStatusCard.tsx
new file mode 100644
index 0000000..d1d378c
--- /dev/null
+++ b/frontend-dapp/src/features/z-wallet/TransferStatusCard.tsx
@@ -0,0 +1,31 @@
+import { useZWalletTransferStatus } from './useZWalletTransferStatus';
+
+type Props = {
+  settlementRef: string;
+};
+
+export default function TransferStatusCard({ settlementRef }: Props) {
+  const { status, loading } = useZWalletTransferStatus(settlementRef);
+
+  return (
+    <div className="rounded-lg border border-white/10 bg-[#1a1d24] p-4 text-sm space-y-2">
+      <p className="text-[#A0A0A0]">
+        Reference: <span className="font-mono text-white text-xs">{settlementRef}</span>
+      </p>
+      {loading && !status && <p className="text-[#A0A0A0]">Loading status…</p>}
+      {status && (
+        <>
+          <p className="text-[#A0A0A0]">
+            Phase: <span className="text-white">{status.phase ?? status.status ?? 'pending'}</span>
+          </p>
+          {status.chainTxHash && (
+            <p className="text-[#A0A0A0]">
+              Tx: <span className="font-mono text-emerald-400 text-xs">{status.chainTxHash}</span>
+            </p>
+          )}
+          {status.error && <p className="text-red-400">{status.error}</p>}
+        </>
+      )}
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/features/z-wallet/useZWalletInternationalTransfer.ts b/frontend-dapp/src/features/z-wallet/useZWalletInternationalTransfer.ts
new file mode 100644
index 0000000..ef13ddf
--- /dev/null
+++ b/frontend-dapp/src/features/z-wallet/useZWalletInternationalTransfer.ts
@@ -0,0 +1,90 @@
+import { useCallback, useState } from 'react';
+import { omnlApiHeaders, settlementApi } from '../../config/dex';
+import { zChain, Z_CHAIN_ID } from '../../config/zChain';
+import type { SettlementResult } from '../online-bank/useZBankSettlement';
+
+function idem(prefix: string) {
+  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+
+async function postJson<T>(url: string, body: unknown): Promise<{ ok: boolean; status: number; data: T }> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: omnlApiHeaders(),
+    body: JSON.stringify(body),
+  });
+  const data = (await res.json().catch(() => ({ error: res.statusText || `HTTP ${res.status}` }))) as T;
+  return { ok: res.ok, status: res.status, data };
+}
+
+export function useZWalletInternationalTransfer() {
+  const [loading, setLoading] = useState(false);
+  const [lastResult, setLastResult] = useState<SettlementResult | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const submitTransfer = useCallback(
+    async (params: {
+      amount: string;
+      creditorIban: string;
+      corridorId: string;
+      currency: string;
+      recipientAddress?: string;
+    }) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const corridor = zChain.internationalCorridors.find((c) => c.id === params.corridorId);
+        const rail = corridor?.rails.includes('HYBX') ? 'HYBX' : 'SWIFT';
+        const payload = {
+          idempotencyKey: idem('Z-WALLET-INTL'),
+          officeId: zChain.settlement.zBridgeOfficeId,
+          currency: params.currency,
+          amount: params.amount,
+          creditorIban: params.creditorIban,
+          beneficiaryName: zChain.brand.bank,
+          orderingName: zChain.bankCorridor.orderingName,
+          creditorBic: zChain.bankCorridor.creditorBic,
+          debtorIban: zChain.bankCorridor.debtorIban,
+          remittanceInfo: `${zChain.bankCorridor.remittanceTemplate} · ${params.corridorId}`,
+          moneyLayers: ['M1', 'M2', 'M4'] as const,
+          rail,
+          swiftMessageKind: zChain.bankCorridor.swiftMessageKind as 'MT103',
+          metadata: {
+            sourceOfficeId: zChain.fineract.officeId,
+            sourceHybxWallet: zChain.fineract.hybxWalletId,
+            targetChainId: Z_CHAIN_ID,
+            integration: 'z-chain',
+            corridorId: params.corridorId,
+          },
+          convertToCrypto: params.recipientAddress
+            ? {
+                enabled: true,
+                targetChainId: Z_CHAIN_ID,
+                tokenLineId: zChain.wallet.defaultTokenLineId,
+                recipientAddress: params.recipientAddress,
+              }
+            : undefined,
+        };
+
+        let r = await postJson<SettlementResult>(settlementApi('/z-bank/settle-m0-m4'), payload);
+        if (r.status === 404 || r.status === 405) {
+          r = await postJson<SettlementResult>(settlementApi('/external-transfer'), payload);
+        }
+        setLastResult(r.data);
+        if (!r.ok) {
+          setError((r.data as { error?: string }).error ?? `Transfer failed (${r.status})`);
+        }
+        return r;
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        setError(msg);
+        return { ok: false, status: 0, data: { error: msg } as SettlementResult };
+      } finally {
+        setLoading(false);
+      }
+    },
+    [],
+  );
+
+  return { submitTransfer, loading, lastResult, error, corridors: zChain.internationalCorridors };
+}
diff --git a/frontend-dapp/src/features/z-wallet/useZWalletTransferStatus.ts b/frontend-dapp/src/features/z-wallet/useZWalletTransferStatus.ts
new file mode 100644
index 0000000..a93b867
--- /dev/null
+++ b/frontend-dapp/src/features/z-wallet/useZWalletTransferStatus.ts
@@ -0,0 +1,42 @@
+import { useCallback, useEffect, useState } from 'react';
+import { TOKEN_AGGREGATION_URL } from '../../config/dex';
+import { omnlApiHeaders } from '../../config/dex';
+
+export type TransferStatus = {
+  settlementId?: string;
+  phase?: string;
+  status?: string;
+  error?: string;
+  chainTxHash?: string;
+};
+
+export function useZWalletTransferStatus(settlementRef: string | undefined) {
+  const [status, setStatus] = useState<TransferStatus | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  const refresh = useCallback(async () => {
+    if (!settlementRef) return;
+    setLoading(true);
+    try {
+      const res = await fetch(`${TOKEN_AGGREGATION_URL}/z-wallet/status/${encodeURIComponent(settlementRef)}`, {
+        headers: omnlApiHeaders(false),
+      });
+      if (res.ok) {
+        setStatus((await res.json()) as TransferStatus);
+      }
+    } catch {
+      /* ignore */
+    } finally {
+      setLoading(false);
+    }
+  }, [settlementRef]);
+
+  useEffect(() => {
+    if (!settlementRef) return;
+    void refresh();
+    const t = window.setInterval(() => void refresh(), 8000);
+    return () => window.clearInterval(t);
+  }, [settlementRef, refresh]);
+
+  return { status, loading, refresh };
+}
diff --git a/frontend-dapp/src/index.css b/frontend-dapp/src/index.css
index d55d8d1..8df5e1b 100644
--- a/frontend-dapp/src/index.css
+++ b/frontend-dapp/src/index.css
@@ -11,7 +11,7 @@ body {
     sans-serif;
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
-  background: #1a1d24;
+  background: #141a16;
   min-height: 100vh;
 }
 
@@ -50,10 +50,10 @@ body {
 
 @keyframes pulse-glow {
   0%, 100% {
-    box-shadow: 0 0 5px rgba(59, 130, 246, 0.5);
+    box-shadow: 0 0 5px rgba(34, 197, 94, 0.5);
   }
   50% {
-    box-shadow: 0 0 20px rgba(59, 130, 246, 0.8), 0 0 30px rgba(147, 51, 234, 0.6);
+    box-shadow: 0 0 20px rgba(34, 197, 94, 0.8), 0 0 30px rgba(74, 222, 128, 0.6);
   }
 }
 
@@ -89,12 +89,12 @@ body {
 }
 
 ::-webkit-scrollbar-thumb {
-  background: linear-gradient(to bottom, #3b82f6, #8b5cf6);
+  background: linear-gradient(to bottom, #22c55e, #16a34a);
   border-radius: 10px;
 }
 
 ::-webkit-scrollbar-thumb:hover {
-  background: linear-gradient(to bottom, #2563eb, #7c3aed);
+  background: linear-gradient(to bottom, #16a34a, #15803d);
 }
 
 /* Glass morphism effect */
@@ -107,7 +107,7 @@ body {
 
 /* Gradient text */
 .gradient-text {
-  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  background: linear-gradient(135deg, #22c55e 0%, #059669 100%);
   -webkit-background-clip: text;
   -webkit-text-fill-color: transparent;
   background-clip: text;
@@ -115,13 +115,13 @@ body {
 
 /* Button hover effects */
 .btn-gradient {
-  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  background: linear-gradient(135deg, #22c55e 0%, #059669 100%);
   transition: all 0.3s ease;
 }
 
 .btn-gradient:hover {
   transform: translateY(-2px);
-  box-shadow: 0 10px 25px rgba(102, 126, 234, 0.4);
+  box-shadow: 0 10px 25px rgba(34, 197, 94, 0.4);
 }
 
 /* Card hover effect */
@@ -193,7 +193,7 @@ body {
 
 /* Focus styles for accessibility */
 *:focus-visible {
-  outline: 2px solid #3b82f6;
+  outline: 2px solid #22c55e;
   outline-offset: 2px;
   border-radius: 4px;
 }
@@ -224,7 +224,7 @@ textarea:focus {
 /* Loading spinner */
 .spinner {
   border: 3px solid rgba(59, 130, 246, 0.1);
-  border-top-color: #3b82f6;
+  border-top-color: #22c55e;
   border-radius: 50%;
   animation: spin 0.8s linear infinite;
 }
@@ -253,181 +253,19 @@ textarea:focus {
 
 /* Gradient backgrounds */
 .bg-gradient-primary {
-  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  background: linear-gradient(135deg, #22c55e 0%, #059669 100%);
 }
 
 .bg-gradient-secondary {
-  background: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
+  background: linear-gradient(135deg, #4ade80 0%, #16a34a 100%);
 }
 
 .bg-gradient-success {
-  background: linear-gradient(135deg, #4facfe 0%, #00f2fe 100%);
+  background: linear-gradient(135deg, #34d399 0%, #22c55e 100%);
 }
 
 /* Text selection */
 ::selection {
-  background-color: rgba(59, 130, 246, 0.3);
+  background-color: rgba(34, 197, 94, 0.3);
   color: inherit;
 }
-
-/* Portal Styling Enhancements */
-
-/* Animated grid pattern for portal effect */
-@keyframes gridMove {
-  0% {
-    transform: translate(0, 0);
-  }
-  100% {
-    transform: translate(60px, 60px);
-  }
-}
-
-.portal-grid {
-  background-image: 
-    linear-gradient(rgba(34, 211, 238, 0.1) 1px, transparent 1px),
-    linear-gradient(90deg, rgba(34, 211, 238, 0.1) 1px, transparent 1px);
-  background-size: 60px 60px;
-  animation: gridMove 20s linear infinite;
-}
-
-/* Portal entrance animation */
-@keyframes portalOpen {
-  0% {
-    opacity: 0;
-    transform: scale(0.8) rotateY(90deg);
-    filter: blur(10px);
-  }
-  100% {
-    opacity: 1;
-    transform: scale(1) rotateY(0deg);
-    filter: blur(0px);
-  }
-}
-
-.portal-entrance {
-  animation: portalOpen 0.6s cubic-bezier(0.34, 1.56, 0.64, 1);
-}
-
-/* Holographic shimmer effect */
-@keyframes holographic {
-  0% {
-    background-position: 0% 50%;
-  }
-  50% {
-    background-position: 100% 50%;
-  }
-  100% {
-    background-position: 0% 50%;
-  }
-}
-
-.holographic-text {
-  background: linear-gradient(
-    90deg,
-    #06b6d4 0%,
-    #8b5cf6 25%,
-    #ec4899 50%,
-    #8b5cf6 75%,
-    #06b6d4 100%
-  );
-  background-size: 200% auto;
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-  animation: holographic 3s linear infinite;
-}
-
-/* Energy flow animation */
-@keyframes energyFlow {
-  0% {
-    transform: translateX(-200%) translateY(-50%);
-  }
-  100% {
-    transform: translateX(200%) translateY(-50%);
-  }
-}
-
-.energy-flow::before {
-  content: '';
-  position: absolute;
-  top: 50%;
-  left: 0;
-  width: 100%;
-  height: 2px;
-  background: linear-gradient(
-    90deg,
-    transparent,
-    rgba(34, 211, 238, 0.8),
-    rgba(168, 85, 247, 0.8),
-    rgba(236, 72, 153, 0.8),
-    transparent
-  );
-  animation: energyFlow 2s ease-in-out infinite;
-}
-
-/* Portal glow pulse */
-@keyframes portalGlow {
-  0%, 100% {
-    box-shadow: 
-      0 0 20px rgba(34, 211, 238, 0.4),
-      0 0 40px rgba(168, 85, 247, 0.3),
-      inset 0 0 20px rgba(34, 211, 238, 0.1);
-  }
-  50% {
-    box-shadow: 
-      0 0 40px rgba(34, 211, 238, 0.6),
-      0 0 80px rgba(168, 85, 247, 0.5),
-      inset 0 0 30px rgba(34, 211, 238, 0.2);
-  }
-}
-
-.portal-glow {
-  animation: portalGlow 3s ease-in-out infinite;
-}
-
-/* Floating particles */
-@keyframes float {
-  0%, 100% {
-    transform: translateY(0) translateX(0);
-    opacity: 0.3;
-  }
-  50% {
-    transform: translateY(-20px) translateX(10px);
-    opacity: 0.8;
-  }
-}
-
-.floating-particle {
-  animation: float 4s ease-in-out infinite;
-}
-
-/* Neon border effect */
-.neon-border {
-  border: 2px solid;
-  border-image: linear-gradient(
-    45deg,
-    rgba(34, 211, 238, 0.5),
-    rgba(168, 85, 247, 0.5),
-    rgba(236, 72, 153, 0.5),
-    rgba(34, 211, 238, 0.5)
-  ) 1;
-  box-shadow: 
-    0 0 10px rgba(34, 211, 238, 0.3),
-    inset 0 0 10px rgba(34, 211, 238, 0.1);
-}
-
-/* Portal ring effect */
-@keyframes portalRing {
-  0%, 100% {
-    opacity: 0.3;
-    transform: scale(1);
-  }
-  50% {
-    opacity: 0.6;
-    transform: scale(1.05);
-  }
-}
-
-.portal-ring {
-  animation: portalRing 2s ease-in-out infinite;
-}
diff --git a/frontend-dapp/src/main.tsx b/frontend-dapp/src/main.tsx
index 2d8ee78..f3c6666 100644
--- a/frontend-dapp/src/main.tsx
+++ b/frontend-dapp/src/main.tsx
@@ -5,7 +5,11 @@ import { EventEmitter } from 'events'
 import App from './App.tsx'
 import './index.css'
 import './styles/mobile.css'
-import './styles/nasa-dashboard.css'
+import './styles/app-dashboard.css'
+import './styles/dbis-green-ui.css'
+import './styles/dbis-dashboard.css'
+import './styles/online-bank.css'
+import './styles/z-ecosystem.css'
 
 // Polyfill Buffer / EventEmitter for browser (ethers, wallet libs)
 type GlobalPolyfills = typeof globalThis & {
diff --git a/frontend-dapp/src/pages/AdminPanel.tsx b/frontend-dapp/src/pages/AdminPanel.tsx
index 8c62430..25db688 100644
--- a/frontend-dapp/src/pages/AdminPanel.tsx
+++ b/frontend-dapp/src/pages/AdminPanel.tsx
@@ -114,33 +114,48 @@ export default function AdminPanel() {
     <div className="container mx-auto px-4 py-8 max-w-7xl">
       <div className="bg-white/10 backdrop-blur-xl rounded-2xl shadow-2xl border border-white/20 overflow-hidden">
         {/* Header */}
-        <div className="border-b border-white/20 p-6 bg-gradient-to-r from-blue-600/20 via-purple-600/20 to-pink-600/20">
+        <div className="border-b border-white/20 p-6 bg-gradient-to-r from-blue-600/20 via-purple-600/20 to-pink-600/20 text-center">
           <h1 className="text-3xl font-bold text-white mb-2">Admin Panel</h1>
           <p className="text-white/70 text-sm">
             Connected as: <span className="font-mono text-white/90">{address}</span>
           </p>
         </div>
 
-        {/* Tabs */}
-        <div className="flex border-b border-white/20 bg-black/20">
+        {/* Tabs — mobile select + desktop scroll */}
+        <div className="sm:hidden p-3 border-b border-white/20 bg-black/30">
+          <label htmlFor="admin-tab-select" className="block text-xs text-white/60 mb-1">Section</label>
+          <select
+            id="admin-tab-select"
+            value={activeTab}
+            onChange={(e) => setActiveTab(e.target.value as TabType)}
+            className="w-full bg-[#1a1d24] text-white border border-white/20 rounded-lg px-3 py-3 text-sm min-h-[44px]"
+          >
+            {tabs.map((tab) => (
+              <option key={tab.id} value={tab.id}>
+                {tab.icon} {tab.label}
+              </option>
+            ))}
+          </select>
+        </div>
+        <div className="admin-tabs hidden sm:flex border-b border-white/20 bg-black/20 overflow-x-auto">
           {tabs.map((tab) => (
             <button
               key={tab.id}
               onClick={() => setActiveTab(tab.id)}
-              className={`flex-1 px-6 py-4 font-semibold transition-all duration-300 ${
+              className={`shrink-0 px-4 sm:px-6 py-3 sm:py-4 font-semibold transition-all duration-300 whitespace-nowrap min-h-[44px] ${
                 activeTab === tab.id
                   ? 'bg-gradient-to-r from-blue-500 via-purple-500 to-pink-500 text-white border-b-2 border-white'
                   : 'text-white/70 hover:text-white hover:bg-white/10'
               }`}
             >
-              <span className="mr-2">{tab.icon}</span>
-              {tab.label}
+              <span className="mr-1 sm:mr-2">{tab.icon}</span>
+              <span className="text-xs sm:text-sm">{tab.label}</span>
             </button>
           ))}
         </div>
 
         {/* Content */}
-        <div className="p-6">
+        <div className="p-4 sm:p-6">
           {activeTab === 'dashboard' && <AdminDashboard />}
           {activeTab === 'mainnet-tether' && <MainnetTetherAdmin />}
           {activeTab === 'transaction-mirror' && <TransactionMirrorAdmin />}
diff --git a/frontend-dapp/src/pages/BridgePage.tsx b/frontend-dapp/src/pages/BridgePage.tsx
index 936ba20..be8aba0 100644
--- a/frontend-dapp/src/pages/BridgePage.tsx
+++ b/frontend-dapp/src/pages/BridgePage.tsx
@@ -49,17 +49,17 @@ export default function BridgePage() {
                 </div>
 
                 {/* Tabs — text only, no icons */}
-                <div className="mb-6">
-                    <nav className="flex flex-wrap gap-1 bg-[#252830] rounded-xl p-1.5 border border-white/10" role="tablist">
+                <div className="mb-6 -mx-1 px-1 overflow-x-auto">
+                    <nav className="flex flex-nowrap sm:flex-wrap gap-1 bg-[#252830] rounded-xl p-1.5 border border-white/10 min-w-min sm:min-w-0" role="tablist">
                         <button
                             onClick={() => setActiveTab('custom')}
                             role="tab"
                             aria-selected={activeTab === 'custom'}
                             aria-controls="custom-tabpanel"
                             id="custom-tab"
-                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-teal-500/50 ${
+                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-green-500/50 shrink-0 whitespace-nowrap min-h-[44px] ${
                                 activeTab === 'custom'
-                                    ? 'bg-teal-600 text-white'
+                                    ? 'bg-green-600 text-white'
                                     : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
                             }`}
                         >
@@ -71,9 +71,9 @@ export default function BridgePage() {
                             aria-selected={activeTab === 'trustless'}
                             aria-controls="trustless-tabpanel"
                             id="trustless-tab"
-                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-teal-500/50 ${
+                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-green-500/50 shrink-0 whitespace-nowrap min-h-[44px] ${
                                 activeTab === 'trustless'
-                                    ? 'bg-teal-600 text-white'
+                                    ? 'bg-green-600 text-white'
                                     : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
                             }`}
                         >
@@ -85,9 +85,9 @@ export default function BridgePage() {
                             aria-selected={activeTab === 'evm'}
                             aria-controls="evm-tabpanel"
                             id="evm-tab"
-                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-teal-500/50 ${
+                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-green-500/50 shrink-0 whitespace-nowrap min-h-[44px] ${
                                 activeTab === 'evm'
-                                    ? 'bg-teal-600 text-white'
+                                    ? 'bg-green-600 text-white'
                                     : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
                             }`}
                         >
@@ -99,9 +99,9 @@ export default function BridgePage() {
                             aria-selected={activeTab === 'xrpl'}
                             aria-controls="xrpl-tabpanel"
                             id="xrpl-tab"
-                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-teal-500/50 ${
+                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-green-500/50 shrink-0 whitespace-nowrap min-h-[44px] ${
                                 activeTab === 'xrpl'
-                                    ? 'bg-teal-600 text-white'
+                                    ? 'bg-green-600 text-white'
                                     : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
                             }`}
                         >
@@ -113,9 +113,9 @@ export default function BridgePage() {
                             aria-selected={activeTab === 'track'}
                             aria-controls="track-tabpanel"
                             id="track-tab"
-                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-teal-500/50 ${
+                            className={`px-4 py-3 text-sm font-medium rounded-lg transition-all focus:outline-none focus:ring-2 focus:ring-green-500/50 shrink-0 whitespace-nowrap min-h-[44px] ${
                                 activeTab === 'track'
-                                    ? 'bg-teal-600 text-white'
+                                    ? 'bg-green-600 text-white'
                                     : 'text-[#A0A0A0] hover:text-white hover:bg-white/5'
                             }`}
                         >
@@ -148,7 +148,7 @@ export default function BridgePage() {
                                         <select
                                             value={ccipDestinationSelector}
                                             onChange={(e) => setCcipDestinationSelector(e.target.value)}
-                                            className="px-3 py-2 rounded-lg bg-[#1a1d24] text-white border border-white/20 min-w-[200px] focus:ring-2 focus:ring-teal-500/50 focus:border-teal-500"
+                                            className="px-3 py-2 rounded-lg bg-[#1a1d24] text-white border border-white/20 min-w-[200px] focus:ring-2 focus:ring-green-500/50 focus:border-green-500"
                                         >
                                             {CCIP_DESTINATIONS.map((d) => (
                                                 <option key={d.chainId} value={d.selector}>{d.name}</option>
diff --git a/frontend-dapp/src/pages/CentralBankPage.tsx b/frontend-dapp/src/pages/CentralBankPage.tsx
index c6772a0..22eb0a9 100644
--- a/frontend-dapp/src/pages/CentralBankPage.tsx
+++ b/frontend-dapp/src/pages/CentralBankPage.tsx
@@ -1,6 +1,6 @@
 import { useEffect } from 'react';
 import { useLocation } from 'react-router-dom';
-import CentralBankDashboard from '../features/central-bank/CentralBankDashboard';
+import OnlineBankApp from '../features/online-bank/OnlineBankApp';
 
 export default function CentralBankPage() {
   const { hash } = useLocation();
@@ -12,5 +12,5 @@ export default function CentralBankPage() {
     el?.scrollIntoView({ behavior: 'smooth', block: 'start' });
   }, [hash]);
 
-  return <CentralBankDashboard />;
+  return <OnlineBankApp />;
 }
diff --git a/frontend-dapp/src/pages/DocsPage.tsx b/frontend-dapp/src/pages/DocsPage.tsx
index 0a25988..6ea95ad 100644
--- a/frontend-dapp/src/pages/DocsPage.tsx
+++ b/frontend-dapp/src/pages/DocsPage.tsx
@@ -1,5 +1,5 @@
-/**
- * Developer / API documentation — same-origin internal path map.
+/**
+ * Developer / API documentation ÔÇö same-origin internal path map.
  */
 import { Link } from 'react-router-dom';
 import {
@@ -27,7 +27,7 @@ export default function DocsPage() {
     <div className="container mx-auto px-4 py-12 max-w-4xl">
       <h1 className="text-2xl font-bold text-white mb-2">Developer reference</h1>
       <p className="text-[#A0A0A0] text-sm mb-8">
-        Internal links use <strong className="text-white font-medium">same-origin paths only</strong> — no FQDNs,
+        Internal links use <strong className="text-white font-medium">same-origin paths only</strong> ÔÇö no FQDNs,
         localhost, or 127.0.0.1. Institutional share URLs live in operator manifests.
       </p>
 
@@ -99,13 +99,13 @@ export default function DocsPage() {
                       <td className="py-2 pr-4">{entry.label}</td>
                     )}
                     {group.id !== 'spa' && group.id !== 'omnl-html' && (
-                      <td className="py-2 pr-4 font-mono text-xs">{entry.method ?? '—'}</td>
+                      <td className="py-2 pr-4 font-mono text-xs">{entry.method ?? 'ÔÇö'}</td>
                     )}
                     <td className="py-2 pr-4">
                       <PathCode path={entry.path} />
                     </td>
                     {group.id !== 'spa' && group.id !== 'omnl-html' && (
-                      <td className="py-2 pr-4 text-xs">{entry.auth ?? '—'}</td>
+                      <td className="py-2 pr-4 text-xs">{entry.auth ?? 'ÔÇö'}</td>
                     )}
                     {group.id !== 'spa' && group.id !== 'omnl-html' && (
                       <td className="py-2 text-xs text-[#888]">{entry.notes ?? ''}</td>
@@ -150,7 +150,7 @@ export default function DocsPage() {
       </section>
 
       <p className="text-xs text-[#666]">
-        SSOT: <code>config/omnl-internal-paths.v1.json</code> · Operator map:{' '}
+        SSOT: <code>config/omnl-internal-paths.v1.json</code> ┬À Operator map:{' '}
         <code>docs/04-configuration/ZARDASHT_ENDPOINT_MAP.md</code>
       </p>
     </div>
diff --git a/frontend-dapp/src/pages/HistoryPage.tsx b/frontend-dapp/src/pages/HistoryPage.tsx
index 5918efd..d546087 100644
--- a/frontend-dapp/src/pages/HistoryPage.tsx
+++ b/frontend-dapp/src/pages/HistoryPage.tsx
@@ -1,9 +1,50 @@
-export default function HistoryPage() {
-  return (
-    <div className="container mx-auto px-4 py-8">
-      <h1 className="text-3xl font-bold mb-6">Transaction History</h1>
-      <p className="text-gray-600">Transaction history coming soon...</p>
-    </div>
-  )
+import { useSearchParams } from 'react-router-dom';
+import TransferTracking from '../components/bridge/TransferTracking';
+import NasaPageHeader from '../features/omnl-dashboard/NasaPageHeader';
+import DashboardSection from '../features/omnl-dashboard/DashboardSection';
+
+const RECENT_KEY = 'dbis-recent-transfer-ids';
+
+function loadRecentIds(): string[] {
+  try {
+    const raw = localStorage.getItem(RECENT_KEY);
+    const parsed = raw ? JSON.parse(raw) : [];
+    return Array.isArray(parsed) ? parsed.filter((x) => typeof x === 'string').slice(0, 8) : [];
+  } catch {
+    return [];
+  }
 }
 
+export default function HistoryPage() {
+  const [searchParams] = useSearchParams();
+  const transferIdFromUrl = searchParams.get('transferId') ?? undefined;
+  const recent = loadRecentIds();
+
+  return (
+    <div className="app-page-shell nasa-page history-page px-3 sm:px-4 py-6 sm:py-8 w-full min-w-0">
+      <NasaPageHeader
+        icon="ledger"
+        title="Transaction History"
+        subtitle="Look up bridge transfer status by ID. Recent IDs are stored in this browser."
+      />
+
+      <DashboardSection title="Track transfer" subtitle="Polls /api/bridge/status/:id">
+        <TransferTracking transferId={transferIdFromUrl} />
+      </DashboardSection>
+
+      {recent.length > 0 && (
+        <DashboardSection title="Recent in this browser" className="mt-6">
+          <ul className="space-y-2">
+            {recent.map((id) => (
+              <li key={id}>
+                <a href={`/history?transferId=${encodeURIComponent(id)}`} className="text-[var(--nasa-telemetry)] hover:underline font-mono text-sm break-all">
+                  {id}
+                </a>
+              </li>
+            ))}
+          </ul>
+        </DashboardSection>
+      )}
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/pages/HubPage.tsx b/frontend-dapp/src/pages/HubPage.tsx
index d0d694e..a5048c3 100644
--- a/frontend-dapp/src/pages/HubPage.tsx
+++ b/frontend-dapp/src/pages/HubPage.tsx
@@ -1,11 +1,10 @@
 import { Link } from 'react-router-dom';
 import NasaIcon, { type NasaIconName } from '../components/icons/NasaIcon';
+import { GUOSMM_NOTICES } from '../config/guosmmNotices';
+import { Z_ECOSYSTEM_PORTAL_LINKS } from '../config/ecosystemLinks';
 
 const BANKING: { path: string; label: string; icon: NasaIconName }[] = [
-  { path: '/central-bank', label: 'Z Online Bank / Central Bank', icon: 'central-bank' },
-  { path: '/central-bank#z-full-settlement', label: 'M0→M4 settlement', icon: 'money' },
-  { path: '/central-bank#z-settlement-protocols', label: 'Wire & chain protocols', icon: 'network' },
-  { path: '/central-bank#z-settlement-protocols-chains', label: '128-chain matrix', icon: 'network' },
+  { path: '/central-bank', label: 'Central Bank', icon: 'central-bank' },
   { path: '/office-24', label: 'Office 24', icon: 'office' },
   { path: '/trade', label: 'DBIS Trade', icon: 'trade' },
   { path: '/swap', label: 'Digital Swap', icon: 'swap' },
@@ -26,6 +25,41 @@ const OMNL_OPS: { path: string; label: string; icon: NasaIconName }[] = [
   { path: '/omnl/terminal', label: 'Settlement terminal', icon: 'rail' },
 ];
 
+const Z_ECOSYSTEM = Z_ECOSYSTEM_PORTAL_LINKS.map((l) => ({
+  href: l.href,
+  label: l.label,
+  icon: l.icon,
+}));
+
+function ExternalGrid({
+  title,
+  items,
+}: {
+  title: string;
+  items: { href: string; label: string; icon: NasaIconName }[];
+}) {
+  return (
+    <section className="dash-card cb-card p-4">
+      <h2 className="dash-section-title mb-3">{title}</h2>
+      <ul className="grid grid-cols-1 sm:grid-cols-2 gap-2">
+        {items.map(({ href, label, icon }) => (
+          <li key={href}>
+            <a
+              href={href}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="dash-quick-links__chip inline-flex w-full !justify-start gap-2 py-2.5 px-3"
+            >
+              <NasaIcon name={icon} size={14} />
+              {label}
+            </a>
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
+
 function LinkGrid({
   title,
   items,
@@ -70,7 +104,26 @@ export default function HubPage() {
         <LinkGrid title="Banking & settlement" items={BANKING} />
         <LinkGrid title="Chain 138 & operators" items={CHAIN138} />
       </div>
+      <ExternalGrid title="Z Blockchain System (external)" items={Z_ECOSYSTEM} />
       <LinkGrid title="OMNL operator consoles" items={OMNL_OPS} />
+      <section className="dash-card cb-card p-4 mt-4">
+        <h2 className="dash-section-title mb-3">GUOSMM official gazette</h2>
+        <ul className="grid grid-cols-1 sm:grid-cols-2 gap-2">
+          {GUOSMM_NOTICES.map((n) => (
+            <li key={n.documentId}>
+              <a
+                href={n.url}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="dash-quick-links__chip inline-flex w-full !justify-start gap-2 py-2.5 px-3"
+              >
+                <NasaIcon name="shield" size={14} />
+                {n.documentId} — {n.entity ?? 'OMNL EMCB'}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </section>
     </div>
   );
 }
diff --git a/frontend-dapp/src/pages/ReservePage.tsx b/frontend-dapp/src/pages/ReservePage.tsx
index 01dd3a2..107915e 100644
--- a/frontend-dapp/src/pages/ReservePage.tsx
+++ b/frontend-dapp/src/pages/ReservePage.tsx
@@ -1,9 +1,78 @@
-export default function ReservePage() {
-  return (
-    <div className="container mx-auto px-4 py-8">
-      <h1 className="text-3xl font-bold mb-6">Reserve Status</h1>
-      <p className="text-gray-600">Reserve backing and peg status coming soon...</p>
-    </div>
-  )
-}
+import { useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { OPERATOR_CONSOLE_LINKS } from '../config/ecosystemLinks';
+import { TOKEN_AGGREGATION_URL } from '../config/dex';
+import NasaPageHeader from '../features/omnl-dashboard/NasaPageHeader';
+import DashboardSection from '../features/omnl-dashboard/DashboardSection';
+import DashboardStatCard from '../features/omnl-dashboard/DashboardStatCard';
+import NasaIcon from '../components/icons/NasaIcon';
 
+type IntegrationStatus = Record<string, unknown> | null;
+
+export default function ReservePage() {
+  const [status, setStatus] = useState<IntegrationStatus>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        const base = TOKEN_AGGREGATION_URL.replace(/\/$/, '');
+        const res = await fetch(`${base}/omnl/integration-status`);
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        const data = await res.json();
+        if (!cancelled) setStatus(data);
+      } catch (e) {
+        if (!cancelled) setError(e instanceof Error ? e.message : 'API unavailable');
+      }
+    })();
+    return () => { cancelled = true; };
+  }, []);
+
+  const reserveLinks = OPERATOR_CONSOLE_LINKS.filter((l) =>
+    ['reserve-dash', 'compliance', 'omnl-dash'].includes(l.id),
+  );
+
+  return (
+    <div className="omnl-app min-h-screen">
+      <div className="app-page-shell dash-page px-3 sm:px-4 py-6">
+        <NasaPageHeader
+          icon="money"
+          title="Reserve & Attestation"
+          subtitle="Reserve coverage, HO nostro liquidity, and on-chain evidence consoles."
+        />
+
+        <div className="grid grid-cols-1 sm:grid-cols-3 gap-3 mb-8">
+          <DashboardStatCard label="Integration API" value={error ? 'Offline' : status ? 'Live' : '…'} accent={error ? 'gold' : 'green'} hint={error ?? 'token-aggregation'} />
+          <DashboardStatCard label="Fineract" value={status?.fineract === true ? 'Configured' : '—'} accent="blue" hint="HO ledger" />
+          <DashboardStatCard label="Reserve store" value={status?.reserveStore138 === true ? 'On-chain' : '—'} accent="green" hint="Chain 138" />
+        </div>
+
+        <DashboardSection title="Reserve consoles" subtitle="Open full operator UIs">
+          <div className="grid grid-cols-1 sm:grid-cols-3 gap-3">
+            {reserveLinks.map((link) => (
+              <a
+                key={link.id}
+                href={link.href}
+                className="dash-card flex flex-col items-center text-center gap-2 hover:border-[var(--nasa-telemetry)] transition-colors no-underline"
+              >
+                <NasaIcon name={link.icon} size={20} className="nasa-icon--telemetry shrink-0" />
+                <div>
+                  <div className="text-sm font-semibold text-[var(--nasa-text)]">{link.label}</div>
+                  <div className="text-xs text-[var(--nasa-muted)]">{link.description}</div>
+                </div>
+              </a>
+            ))}
+          </div>
+        </DashboardSection>
+
+        <p className="mt-6 text-sm text-[var(--nasa-muted)] text-center">
+          <Link to="/hub" className="text-[var(--nasa-telemetry)] hover:underline inline-flex items-center gap-1">
+            <NasaIcon name="network" size={14} />
+            DBIS Dashboard
+          </Link>
+        </p>
+      </div>
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/pages/SwapPage.tsx b/frontend-dapp/src/pages/SwapPage.tsx
index 7f531fa..17f2ca2 100644
--- a/frontend-dapp/src/pages/SwapPage.tsx
+++ b/frontend-dapp/src/pages/SwapPage.tsx
@@ -1,10 +1,18 @@
-import { Link } from 'react-router-dom';

-import DBISSwapPanel from '../features/swap/DBISSwapPanel';

-

-export default function SwapPage() {

-  return (

-    <div className="nasa-page">

-      <DBISSwapPanel />

-    </div>

-  );

-}

+import DBISSwapPanel from '../features/swap/DBISSwapPanel';
+
+
+
+export default function SwapPage() {
+
+  return (
+
+    <div className="nasa-page app-page-shell">
+
+      <DBISSwapPanel />
+
+    </div>
+
+  );
+
+}
+
diff --git a/frontend-dapp/src/pages/TradePage.tsx b/frontend-dapp/src/pages/TradePage.tsx
index fb4a658..e9875c6 100644
--- a/frontend-dapp/src/pages/TradePage.tsx
+++ b/frontend-dapp/src/pages/TradePage.tsx
@@ -1,5 +1,9 @@
 import BinanceTradePanel from '../features/trade/BinanceTradePanel';
 
 export default function TradePage() {
-  return <BinanceTradePanel />;
+  return (
+    <div className="nasa-page trade-page w-full">
+      <BinanceTradePanel />
+    </div>
+  );
 }
diff --git a/frontend-dapp/src/pages/WalletsDemoPage.tsx b/frontend-dapp/src/pages/WalletsDemoPage.tsx
index 3b47005..cb07f75 100644
--- a/frontend-dapp/src/pages/WalletsDemoPage.tsx
+++ b/frontend-dapp/src/pages/WalletsDemoPage.tsx
@@ -11,7 +11,10 @@ import {
   defaultFrontendChainId,
   defaultFrontendExplorerUrl,
   chainRpcUrls,
+  shivaOneXChain,
+  shivaOneXChainId,
 } from '../config/networks'
+import { onexShiva, onexWalletEnabled } from '../config/onexShiva'
 
 const clientId = import.meta.env.VITE_THIRDWEB_CLIENT_ID || '542981292d51ec610388ba8985f027d7'
 const client = createThirdwebClient({ clientId })
@@ -26,13 +29,24 @@ const defaultThirdwebChain = defineChain({
   },
 })
 
+const shivaThirdwebChain = defineChain({
+  id: shivaOneXChain.id,
+  name: shivaOneXChain.name,
+  rpc: chainRpcUrls[shivaOneXChainId] || shivaOneXChain.blockExplorers.default.url,
+  nativeCurrency: {
+    name: shivaOneXChain.nativeCurrency.name,
+    symbol: shivaOneXChain.nativeCurrency.symbol,
+    decimals: shivaOneXChain.nativeCurrency.decimals,
+  },
+})
+
 const wallets = [
   inAppWallet({
     auth: {
-      options: ['email', 'google', 'apple', 'passkey'],
+      options: onexShiva.wallet.supportedAuth as ('email' | 'google' | 'apple' | 'passkey')[],
     },
     metadata: {
-      name: 'DBIS Bridge',
+      name: onexWalletEnabled ? onexShiva.brand.wallet : 'DBIS Bridge',
       image: {
         src: `${defaultFrontendExplorerUrl}/favicon.ico`,
         width: 32,
@@ -49,17 +63,24 @@ function WalletsDemoContent() {
     chain: defaultThirdwebChain,
     address: account?.address,
   })
+  const { data: shivaBalance, isLoading: shivaBalanceLoading } = useWalletBalance({
+    client,
+    chain: shivaThirdwebChain,
+    address: account?.address,
+  })
 
   return (
-    <div className="max-w-2xl mx-auto p-6 space-y-8">
+    <div className="app-page-shell max-w-2xl mx-auto p-3 sm:p-6 space-y-6 sm:space-y-8 wallets-page w-full min-w-0 text-center">
       <div>
-        <h1 className="text-2xl font-bold text-white mb-2">Thirdweb Wallets</h1>
+        <h1 className="text-2xl font-bold text-white mb-2">{onexShiva.brand.wallet}</h1>
         <p className="text-[#A0A0A0] text-sm">
-          Connect with email, Google, Apple, passkey, or an external wallet (MetaMask, WalletConnect, etc.) on {defaultFrontendChain.name}.
+          {onexShiva.brand.bank} on {onexShiva.brand.blockchain} (chain {shivaOneXChainId}). Connect with email, Google,
+          Apple, passkey, or external wallet on Chain 138 or Shiva.
         </p>
       </div>
 
       <div className="flex flex-col items-center gap-6 p-6 bg-[#252830] rounded-xl border border-white/10">
+        <p className="text-xs uppercase tracking-wide text-teal-400/90">Chain 138 · DBIS</p>
         <ConnectButton
           client={client}
           chain={defaultThirdwebChain}
@@ -94,6 +115,44 @@ function WalletsDemoContent() {
         )}
       </div>
 
+      {onexWalletEnabled && (
+        <div className="flex flex-col items-center gap-6 p-6 bg-[#252830] rounded-xl border border-violet-500/20">
+          <p className="text-xs uppercase tracking-wide text-violet-400/90">Shiva · OneX</p>
+          <ConnectButton
+            client={client}
+            chain={shivaThirdwebChain}
+            wallets={wallets}
+            theme="dark"
+            connectButton={{
+              label: `Connect ${onexShiva.brand.wallet}`,
+              style: {
+                backgroundColor: '#7c3aed',
+                color: 'white',
+                borderRadius: '0.75rem',
+                padding: '0.75rem 1.5rem',
+              },
+            }}
+          />
+          {account && (
+            <div className="w-full space-y-2 text-sm">
+              {shivaBalanceLoading ? (
+                <p className="text-[#A0A0A0]">Loading Shiva balance…</p>
+              ) : shivaBalance ? (
+                <p className="text-[#A0A0A0]">
+                  Balance ({shivaOneXChain.name}):{' '}
+                  <span className="text-white">
+                    {shivaBalance.displayValue} {shivaBalance.symbol}
+                  </span>
+                </p>
+              ) : null}
+              <p className="text-[#A0A0A0] text-xs">
+                Fineract office {onexShiva.fineract.officeId} · {onexShiva.fineract.hybxWalletId}
+              </p>
+            </div>
+          )}
+        </div>
+      )}
+
       <div className="text-sm text-[#A0A0A0] space-y-2">
         <p>
           This page uses thirdweb SDK v5 and the{' '}
@@ -101,7 +160,7 @@ function WalletsDemoContent() {
             href="https://portal.thirdweb.com/wallets"
             target="_blank"
             rel="noopener noreferrer"
-            className="text-teal-400 hover:underline"
+            className="text-green-400 hover:underline"
           >
             thirdweb Wallets
           </a>{' '}
diff --git a/frontend-dapp/src/pages/ZEcosystemHubPage.tsx b/frontend-dapp/src/pages/ZEcosystemHubPage.tsx
new file mode 100644
index 0000000..7b3e5cd
--- /dev/null
+++ b/frontend-dapp/src/pages/ZEcosystemHubPage.tsx
@@ -0,0 +1,49 @@
+import { Link } from 'react-router-dom';
+import NasaIcon, { type NasaIconName } from '../components/icons/NasaIcon';
+import zEcosystem from '../../../config/z-ecosystem.v1.json';
+import { zChain } from '../config/zChain';
+
+const Z_APPS: { path: string; label: string; icon: NasaIconName; description: string }[] =
+  zEcosystem.apps.map((app) => ({
+    path: app.path,
+    label: app.label,
+    icon: (app.id === 'zWallet' ? 'globe' : app.id === 'zBot' ? 'rail' : app.id === 'zOnlineBank' ? 'central-bank' : 'network') as NasaIconName,
+    description: app.description,
+  }));
+
+export default function ZEcosystemHubPage() {
+  return (
+    <div className="dash-page cb-page max-w-[900px] mx-auto px-4 py-6">
+      <header className="mb-8">
+        <p className="text-xs font-mono text-violet-400/80 mb-1">Z Ecosystem · chain {zChain.chain.chainId}</p>
+        <h1 className="text-2xl font-semibold text-[#e8f4ff] flex items-center gap-2">
+          <NasaIcon name="globe" size={22} className="nasa-icon--telemetry" />
+          Z Ecosystem
+        </h1>
+        <p className="text-sm text-[#7a9bb8] mt-2 max-w-2xl">
+          {zChain.brand.blockchain} consumer entry — international wallet, Z Bot assistant, and Z Online Bank settlement.
+        </p>
+      </header>
+
+      <section className="dash-card cb-card p-4">
+        <h2 className="dash-section-title mb-3">Apps</h2>
+        <ul className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+          {Z_APPS.map(({ path, label, icon, description }) => (
+            <li key={path}>
+              <Link
+                to={path}
+                className="dash-quick-links__chip flex flex-col !items-start gap-1 py-3 px-3 h-full"
+              >
+                <span className="inline-flex items-center gap-2 font-medium">
+                  <NasaIcon name={icon} size={14} />
+                  {label}
+                </span>
+                <span className="text-xs text-[#7a9bb8] text-left">{description}</span>
+              </Link>
+            </li>
+          ))}
+        </ul>
+      </section>
+    </div>
+  );
+}
diff --git a/frontend-dapp/src/pages/ZWalletPage.tsx b/frontend-dapp/src/pages/ZWalletPage.tsx
new file mode 100644
index 0000000..135aee7
--- /dev/null
+++ b/frontend-dapp/src/pages/ZWalletPage.tsx
@@ -0,0 +1,126 @@
+/**
+ * International Z Wallet — Thirdweb v5 on Z Chain (900002)
+ */
+import { createThirdwebClient, defineChain } from 'thirdweb';
+import { ThirdwebProvider, ConnectButton, useActiveAccount, useWalletBalance } from 'thirdweb/react';
+import { inAppWallet } from 'thirdweb/wallets';
+import { chainRpcUrls, zChain as zChainDef, zChainId } from '../config/networks';
+import { zChain, zWalletEnabled } from '../config/zChain';
+import InternationalTransferPanel from '../features/z-wallet/InternationalTransferPanel';
+import ZBotPanel from '../features/z-bot/ZBotPanel';
+import { Link } from 'react-router-dom';
+
+const clientId = import.meta.env.VITE_THIRDWEB_CLIENT_ID || '542981292d51ec610388ba8985f027d7';
+const client = createThirdwebClient({ clientId });
+
+const zThirdwebChain = defineChain({
+  id: zChainDef.id,
+  name: zChainDef.name,
+  rpc: chainRpcUrls[zChainId] || zChain.chain.rpcDefault,
+  nativeCurrency: {
+    name: zChainDef.nativeCurrency.name,
+    symbol: zChainDef.nativeCurrency.symbol,
+    decimals: zChainDef.nativeCurrency.decimals,
+  },
+});
+
+const wallets = [
+  inAppWallet({
+    auth: {
+      options: zChain.wallet.supportedAuth as ('email' | 'google' | 'apple' | 'passkey')[],
+    },
+    metadata: {
+      name: zChain.wallet.thirdwebMetadataName,
+      image: {
+        src: '/favicon.ico',
+        width: 32,
+        height: 32,
+      },
+    },
+  }),
+];
+
+function ZWalletContent() {
+  const account = useActiveAccount();
+  const { data: balance, isLoading: balanceLoading } = useWalletBalance({
+    client,
+    chain: zThirdwebChain,
+    address: account?.address,
+  });
+
+  if (!zWalletEnabled) {
+    return (
+      <div className="app-page-shell max-w-2xl mx-auto p-6 text-center text-[#A0A0A0]">
+        International Z Wallet is disabled. Set VITE_ENABLE_Z_WALLET=true to enable.
+      </div>
+    );
+  }
+
+  return (
+    <div className="app-page-shell max-w-2xl mx-auto p-3 sm:p-6 space-y-6 w-full min-w-0">
+      <div className="text-center">
+        <p className="text-xs font-mono text-violet-400/90 mb-1">
+          <Link to="/z" className="hover:underline">
+            Z Ecosystem
+          </Link>{' '}
+          · chain {zChainId}
+        </p>
+        <h1 className="text-2xl font-bold text-white mb-2">{zChain.brand.wallet}</h1>
+        <p className="text-[#A0A0A0] text-sm">
+          {zChain.brand.blockchain} — email, Google, Apple, passkey, or external wallet. International corridors via{' '}
+          {zChain.brand.bank}.
+        </p>
+      </div>
+
+      <div className="flex flex-col items-center gap-6 p-6 bg-[#252830] rounded-xl border border-violet-500/25">
+        <ConnectButton
+          client={client}
+          chain={zThirdwebChain}
+          wallets={wallets}
+          theme="dark"
+          connectButton={{
+            label: `Connect ${zChain.brand.wallet}`,
+            style: {
+              backgroundColor: '#7c3aed',
+              color: 'white',
+              borderRadius: '0.75rem',
+              padding: '0.75rem 1.5rem',
+            },
+          }}
+        />
+        {account && (
+          <div className="w-full space-y-2 text-sm text-center">
+            <p className="text-[#A0A0A0]">
+              Address: <span className="font-mono text-white">{account.address}</span>
+            </p>
+            {balanceLoading ? (
+              <p className="text-[#A0A0A0]">Loading balance…</p>
+            ) : balance ? (
+              <p className="text-[#A0A0A0]">
+                Balance:{' '}
+                <span className="text-white">
+                  {balance.displayValue} {balance.symbol}
+                </span>
+              </p>
+            ) : null}
+            <p className="text-xs text-[#7a9bb8]">
+              Office {zChain.fineract.officeId} · {zChain.fineract.hybxWalletId}
+            </p>
+          </div>
+        )}
+      </div>
+
+      <InternationalTransferPanel recipientAddress={account?.address} />
+
+      <ZBotPanel walletAddress={account?.address} chainId={zChainId} />
+    </div>
+  );
+}
+
+export default function ZWalletPage() {
+  return (
+    <ThirdwebProvider>
+      <ZWalletContent />
+    </ThirdwebProvider>
+  );
+}
diff --git a/frontend-dapp/src/styles/app-dashboard.css b/frontend-dapp/src/styles/app-dashboard.css
new file mode 100644
index 0000000..24842f5
--- /dev/null
+++ b/frontend-dapp/src/styles/app-dashboard.css
@@ -0,0 +1,498 @@
+/**
+ * App dashboard — standard dark UI (replaces NASA mission-control styling).
+ * Class names kept for compatibility; visuals use normal Inter typography and rounded cards.
+ */
+
+.omnl-app,
+.app-shell,
+.nasa-mission-root {
+  --nasa-bg: #141a16;
+  --nasa-bg-deep: #0f1412;
+  --nasa-panel: #1e2329;
+  --nasa-panel-elevated: #252830;
+  --nasa-panel-border: rgba(255, 255, 255, 0.1);
+  --nasa-telemetry: #22c55e;
+  --nasa-nominal: #22c55e;
+  --nasa-caution: #f59e0b;
+  --nasa-critical: #ef4444;
+  --nasa-text: #eaecef;
+  --nasa-muted: #848e9c;
+  --nasa-mono: Inter, system-ui, sans-serif;
+}
+
+html:has(.omnl-app),
+html:has(.omnl-app) body {
+  background: var(--nasa-bg);
+  min-height: 100%;
+}
+
+.omnl-app {
+  background: var(--nasa-bg);
+  color: var(--nasa-text);
+}
+
+.nasa-icon--telemetry { color: var(--nasa-telemetry); }
+.nasa-icon--nominal { color: var(--nasa-nominal); }
+.nasa-icon--critical { color: var(--nasa-critical); }
+.nasa-icon--caution { color: var(--nasa-caution); }
+.nasa-icon--spin { animation: nasa-spin 1s linear infinite; }
+
+@keyframes nasa-spin {
+  to { transform: rotate(360deg); }
+}
+
+.dash-page, .o24-page, .nasa-page, .cb-page {
+  min-height: calc(100vh - 56px);
+  font-family: Inter, system-ui, sans-serif;
+}
+
+.nasa-panel, .dash-card, .o24-card, .cb-card {
+  background: var(--nasa-panel);
+  border: 1px solid var(--nasa-panel-border);
+  border-radius: 12px;
+  padding: 1.25rem;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
+}
+
+.nasa-header {
+  border: none;
+  background: transparent;
+  padding: 0 0 1.5rem;
+  margin-bottom: 0.5rem;
+  border-bottom: 1px solid var(--nasa-panel-border);
+}
+
+.nasa-header__meta {
+  display: none;
+}
+
+.nasa-header__body {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  gap: 1rem;
+  align-items: flex-start;
+}
+
+.nasa-header--centered .nasa-header__body {
+  justify-content: center;
+  align-items: center;
+  text-align: center;
+}
+
+.nasa-header--centered .nasa-header__title-row {
+  flex-direction: column;
+  align-items: center;
+}
+
+.nasa-header--centered .dash-page-subtitle {
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.app-page-shell .dash-section-subtitle,
+.hub-page .dash-section-subtitle {
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.app-page-shell {
+  width: 100%;
+  max-width: 1100px;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.app-page-shell .dash-card,
+.hub-page .dash-card {
+  width: 100%;
+}
+
+.nasa-header__title-row {
+  display: flex;
+  gap: 1rem;
+  align-items: flex-start;
+}
+
+.nasa-header__icon-wrap {
+  width: 44px;
+  height: 44px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 10px;
+  border: 1px solid var(--nasa-panel-border);
+  background: var(--nasa-panel-elevated);
+  color: var(--nasa-telemetry);
+  flex-shrink: 0;
+}
+
+.nasa-title, .dash-page-title {
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 1.75rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  text-transform: none;
+  color: var(--nasa-text);
+  line-height: 1.25;
+}
+
+.dash-page-subtitle {
+  margin-top: 0.35rem;
+  color: var(--nasa-muted);
+  font-size: 0.95rem;
+  max-width: 48rem;
+  line-height: 1.5;
+}
+
+.nasa-badge, .dash-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  padding: 0.25rem 0.65rem;
+  border-radius: 6px;
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.75rem;
+  font-weight: 500;
+  letter-spacing: normal;
+  text-transform: none;
+}
+
+.nasa-badge--telemetry, .dash-badge--blue {
+  background: rgba(34, 197, 94, 0.12);
+  color: #4ade80;
+  border: 1px solid rgba(34, 197, 94, 0.25);
+}
+
+.nasa-badge--nominal, .dash-badge--green {
+  background: rgba(34, 197, 94, 0.12);
+  color: #4ade80;
+  border: 1px solid rgba(34, 197, 94, 0.25);
+}
+
+.nasa-badge--caution, .dash-badge--gold {
+  background: rgba(245, 158, 11, 0.12);
+  color: #fbbf24;
+  border: 1px solid rgba(245, 158, 11, 0.25);
+}
+
+.dash-banner {
+  border-radius: 10px;
+  padding: 1rem 1.15rem;
+  border: 1px solid var(--nasa-panel-border);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  text-align: center;
+  gap: 0.75rem;
+}
+
+.dash-banner__title {
+  font-size: 0.95rem;
+  font-weight: 600;
+  font-family: Inter, system-ui, sans-serif;
+  letter-spacing: normal;
+  text-transform: none;
+  margin-bottom: 0.25rem;
+}
+
+.dash-banner__detail {
+  font-size: 0.875rem;
+  color: var(--nasa-muted);
+  line-height: 1.5;
+}
+
+.dash-banner--ok {
+  background: rgba(34, 197, 94, 0.08);
+  border-color: rgba(34, 197, 94, 0.25);
+}
+.dash-banner--ok .dash-banner__title { color: #4ade80; }
+
+.dash-banner--warn {
+  background: rgba(245, 158, 11, 0.08);
+  border-color: rgba(245, 158, 11, 0.25);
+}
+.dash-banner--warn .dash-banner__title { color: #fbbf24; }
+
+.dash-banner--error {
+  background: rgba(239, 68, 68, 0.08);
+  border-color: rgba(239, 68, 68, 0.25);
+}
+.dash-banner--error .dash-banner__title { color: #f87171; }
+
+.dash-banner--loading {
+  background: var(--nasa-panel);
+}
+
+.dash-stat-label {
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.75rem;
+  font-weight: 500;
+  color: var(--nasa-muted);
+  text-transform: none;
+  letter-spacing: normal;
+  margin-bottom: 0.35rem;
+  text-align: center;
+}
+
+.dash-stat-value {
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 1.5rem;
+  font-weight: 700;
+  color: var(--nasa-text);
+  font-variant-numeric: tabular-nums;
+  text-align: center;
+}
+
+.dash-stat-hint {
+  margin-top: 0.35rem;
+  font-size: 0.8rem;
+  color: var(--nasa-muted);
+  text-align: center;
+}
+
+.dash-section-title {
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 1rem;
+  font-weight: 600;
+  letter-spacing: normal;
+  text-transform: none;
+  color: var(--nasa-text);
+}
+
+.dash-section-subtitle {
+  margin-top: 0.25rem;
+  font-size: 0.875rem;
+  color: var(--nasa-muted);
+  text-align: center;
+}
+
+.dash-kv {
+  display: flex;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.5rem 0;
+  font-size: 0.875rem;
+  border-bottom: 1px solid var(--nasa-panel-border);
+}
+
+.dash-kv:last-child { border-bottom: none; }
+.dash-kv dt { color: var(--nasa-muted); flex-shrink: 0; }
+.dash-kv dd { color: var(--nasa-text); text-align: right; word-break: break-word; }
+.dash-kv .dash-kv-value--ok { color: #4ade80; font-weight: 500; }
+
+.dash-quick-links__label {
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: none;
+  letter-spacing: normal;
+  color: var(--nasa-muted);
+  margin-bottom: 0.5rem;
+}
+
+.dash-quick-links__chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  padding: 0.4rem 0.85rem;
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.8rem;
+  letter-spacing: normal;
+  color: var(--nasa-text);
+  background: var(--nasa-panel-elevated);
+  border: 1px solid var(--nasa-panel-border);
+  border-radius: 999px;
+  transition: background 0.15s, border-color 0.15s;
+}
+
+.dash-quick-links__chip:hover {
+  border-color: var(--nasa-telemetry);
+  color: var(--nasa-telemetry);
+  background: rgba(34, 197, 94, 0.08);
+}
+
+.dash-btn, .nasa-btn {
+  padding: 0.55rem 1rem;
+  border: 1px solid var(--nasa-panel-border);
+  border-radius: 8px;
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.875rem;
+  font-weight: 500;
+  letter-spacing: normal;
+  text-transform: none;
+  background: var(--nasa-panel-elevated);
+  color: var(--nasa-text);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  transition: background 0.15s, border-color 0.15s;
+}
+
+.dash-btn:hover, .nasa-btn:hover {
+  border-color: rgba(34, 197, 94, 0.4);
+  background: rgba(34, 197, 94, 0.08);
+}
+
+.nasa-btn--primary {
+  background: #16a34a;
+  border-color: #16a34a;
+  color: #fff;
+}
+
+.nasa-btn--primary:hover {
+  background: #22c55e;
+  border-color: #22c55e;
+  color: #fff;
+}
+
+.dash-btn:disabled, .nasa-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.nasa-input, .nasa-select {
+  width: 100%;
+  min-height: 44px;
+  padding: 0.5rem 0.75rem;
+  background: var(--nasa-panel-elevated);
+  border: 1px solid var(--nasa-panel-border);
+  border-radius: 8px;
+  color: var(--nasa-text);
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.9rem;
+}
+
+.nasa-input:focus, .nasa-select:focus {
+  outline: none;
+  border-color: var(--nasa-telemetry);
+  box-shadow: 0 0 0 2px rgba(34, 197, 94, 0.2);
+}
+
+.nasa-inset-panel {
+  background: var(--nasa-panel-elevated);
+  border: 1px solid var(--nasa-panel-border);
+  border-radius: 8px;
+  padding: 1rem;
+}
+
+.omnl-app-header {
+  background: #1a241c !important;
+  border-color: rgba(34, 197, 94, 0.2) !important;
+  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2);
+}
+
+.nasa-nav-brand {
+  font-family: Inter, system-ui, sans-serif;
+  letter-spacing: normal;
+  text-transform: none;
+  color: var(--nasa-text) !important;
+  font-weight: 600;
+}
+
+.nasa-nav-link {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.5rem 0.75rem;
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.875rem;
+  font-weight: 500;
+  letter-spacing: normal;
+  text-transform: none;
+  color: var(--nasa-muted);
+  border-radius: 8px;
+  border: 1px solid transparent;
+  transition: color 0.15s, background 0.15s;
+}
+
+.nasa-nav-link:hover {
+  color: var(--nasa-text);
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.nasa-nav-link--active {
+  color: #fff !important;
+  background: #16a34a !important;
+  border-color: transparent;
+}
+
+.nasa-table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+.nasa-table thead {
+  background: var(--nasa-panel-elevated);
+  font-family: Inter, system-ui, sans-serif;
+  font-size: 0.75rem;
+  font-weight: 500;
+  letter-spacing: normal;
+  text-transform: none;
+  color: var(--nasa-muted);
+}
+
+.nasa-table tbody tr { border-top: 1px solid var(--nasa-panel-border); }
+.nasa-table tbody tr:hover { background: rgba(255, 255, 255, 0.03); }
+
+.trade-layout {
+  display: grid;
+  grid-template-columns: 240px 1fr;
+  min-height: calc(100vh - 56px);
+  background: var(--nasa-bg);
+}
+
+.trade-markets, .trade-panel, .trade-pair-header, .trade-recent, .trade-book {
+  background: var(--nasa-panel) !important;
+  border-color: var(--nasa-panel-border) !important;
+}
+
+.trade-center {
+  min-height: 0;
+  background: var(--nasa-bg);
+}
+
+.trade-chart {
+  background: var(--nasa-panel) !important;
+  border-color: var(--nasa-panel-border) !important;
+}
+
+.trade-chart__canvas {
+  min-height: 240px;
+  border-radius: 8px;
+  border: 1px solid var(--nasa-panel-border);
+  background: var(--nasa-panel-elevated);
+}
+
+.trade-market-row:hover { background: rgba(255, 255, 255, 0.04); }
+.trade-market-row--active {
+  background: rgba(34, 197, 94, 0.1);
+  border-left: 2px solid var(--nasa-telemetry) !important;
+}
+
+.trade-orderbook { max-height: 360px; overflow-y: auto; font-family: ui-monospace, monospace; font-size: 0.8rem; }
+
+@media (max-width: 1023px) {
+  .trade-layout {
+    display: flex;
+    flex-direction: column;
+    min-height: calc(100dvh - 56px);
+  }
+
+  .trade-center { order: 2; }
+
+  .trade-panel {
+    order: 3;
+    width: 100% !important;
+    max-width: 100%;
+    border-left: none !important;
+    border-top: 1px solid var(--nasa-panel-border);
+  }
+
+  .trade-markets { display: none !important; }
+}
+
+@media (min-width: 1024px) {
+  .trade-layout { grid-template-columns: 240px 1fr 320px; }
+}
diff --git a/frontend-dapp/src/styles/dbis-dashboard.css b/frontend-dapp/src/styles/dbis-dashboard.css
new file mode 100644
index 0000000..644a414
--- /dev/null
+++ b/frontend-dapp/src/styles/dbis-dashboard.css
@@ -0,0 +1,369 @@
+/**
+ * DBIS Dashboard — mobile-first hub styling
+ */
+
+.dbis-dashboard {
+  background:
+    radial-gradient(ellipse 120% 80% at 50% -20%, rgba(34, 197, 94, 0.12), transparent 55%),
+    var(--nasa-bg, #141a16);
+}
+
+.dbis-dashboard__inner {
+  width: 100%;
+  max-width: 56rem;
+  margin: 0 auto;
+  padding: 1rem 0.75rem 5.5rem;
+}
+
+@media (min-width: 640px) {
+  .dbis-dashboard__inner {
+    padding: 1.5rem 1rem 2rem;
+  }
+}
+
+.dbis-dashboard__hero {
+  text-align: center;
+  margin-bottom: 1.5rem;
+}
+
+@media (min-width: 640px) {
+  .dbis-dashboard__hero {
+    margin-bottom: 2rem;
+  }
+}
+
+.dbis-dashboard__logo {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 4rem;
+  height: 4rem;
+  border-radius: 1rem;
+  background: linear-gradient(145deg, #16a34a, #065f46);
+  color: #fff;
+  border: 1px solid rgba(74, 222, 128, 0.35);
+  box-shadow: 0 8px 32px rgba(22, 163, 74, 0.35);
+  margin-bottom: 0.75rem;
+}
+
+@media (min-width: 640px) {
+  .dbis-dashboard__logo {
+    width: 4.5rem;
+    height: 4.5rem;
+    border-radius: 1.125rem;
+  }
+}
+
+.dbis-dashboard__eyebrow {
+  font-size: 0.65rem;
+  font-weight: 600;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: #22c55e;
+  margin-bottom: 0.35rem;
+}
+
+.dbis-dashboard__title {
+  font-size: 1.75rem;
+  font-weight: 700;
+  letter-spacing: -0.03em;
+  color: var(--nasa-text, #eaecef);
+  line-height: 1.15;
+}
+
+@media (min-width: 640px) {
+  .dbis-dashboard__title {
+    font-size: 2.25rem;
+  }
+}
+
+.dbis-dashboard__subtitle {
+  margin-top: 0.5rem;
+  font-size: 0.875rem;
+  color: var(--nasa-muted, #848e9c);
+  max-width: 28rem;
+  margin-left: auto;
+  margin-right: auto;
+  line-height: 1.5;
+}
+
+.dbis-status-pills {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 0.5rem;
+  margin-top: 1rem;
+}
+
+.dbis-status-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  padding: 0.35rem 0.65rem;
+  border-radius: 999px;
+  font-size: 0.7rem;
+  font-weight: 500;
+  border: 1px solid rgba(34, 197, 94, 0.25);
+  background: rgba(34, 197, 94, 0.08);
+  color: #4ade80;
+}
+
+/* Featured horizontal strip */
+.dbis-featured {
+  margin-bottom: 1.5rem;
+}
+
+.dbis-featured__label {
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--nasa-muted);
+  margin-bottom: 0.65rem;
+  padding-left: 0.15rem;
+}
+
+.dbis-featured__scroll {
+  display: flex;
+  gap: 0.65rem;
+  overflow-x: auto;
+  padding-bottom: 0.35rem;
+  -webkit-overflow-scrolling: touch;
+  scroll-snap-type: x mandatory;
+  scrollbar-width: none;
+}
+
+.dbis-featured__scroll::-webkit-scrollbar {
+  display: none;
+}
+
+.dbis-featured__item {
+  flex: 0 0 auto;
+  scroll-snap-align: start;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.5rem;
+  min-width: 5.25rem;
+  max-width: 5.5rem;
+  padding: 0.75rem 0.5rem;
+  border-radius: 1rem;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: var(--nasa-panel);
+  text-decoration: none;
+  color: inherit;
+  transition: border-color 0.2s, transform 0.2s, background 0.2s;
+  min-height: 5.5rem;
+}
+
+.dbis-featured__item:active {
+  transform: scale(0.97);
+}
+
+.dbis-featured__item:hover {
+  border-color: rgba(34, 197, 94, 0.4);
+  background: var(--nasa-panel-elevated);
+}
+
+.dbis-featured__icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.75rem;
+  height: 2.75rem;
+  border-radius: 0.875rem;
+  border: 1px solid transparent;
+}
+
+.dbis-featured__name {
+  font-size: 0.65rem;
+  font-weight: 600;
+  text-align: center;
+  line-height: 1.2;
+  color: var(--nasa-text);
+}
+
+@media (min-width: 768px) {
+  .dbis-featured__scroll {
+    display: grid;
+    grid-template-columns: repeat(5, 1fr);
+    overflow: visible;
+    gap: 0.75rem;
+  }
+
+  .dbis-featured__item {
+    min-width: 0;
+    max-width: none;
+  }
+}
+
+/* Collapsible sections on mobile */
+.dbis-section-fold {
+  margin-bottom: 0.75rem;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 0.875rem;
+  background: rgba(30, 35, 41, 0.5);
+  overflow: hidden;
+}
+
+.dbis-section-fold__summary {
+  display: flex;
+  align-items: center;
+  gap: 0.65rem;
+  padding: 0.875rem 1rem;
+  cursor: pointer;
+  list-style: none;
+  min-height: 3rem;
+  font-weight: 600;
+  font-size: 0.9rem;
+  color: var(--nasa-text);
+  user-select: none;
+}
+
+.dbis-section-fold__summary::-webkit-details-marker {
+  display: none;
+}
+
+.dbis-section-fold__chevron {
+  margin-left: auto;
+  color: var(--nasa-muted);
+  transition: transform 0.2s;
+}
+
+.dbis-section-fold[open] .dbis-section-fold__chevron {
+  transform: rotate(180deg);
+}
+
+.dbis-section-fold__body {
+  padding: 0 0.75rem 0.875rem;
+}
+
+@media (min-width: 768px) {
+  .dbis-section-fold {
+    border: none;
+    background: transparent;
+    border-radius: 0;
+    margin-bottom: 0;
+  }
+
+  .dbis-section-fold__summary {
+    display: none;
+  }
+
+  .dbis-section-fold__body {
+    padding: 0;
+  }
+}
+
+/* Link cards */
+.hub-link-card {
+  min-height: 8.5rem;
+  touch-action: manipulation;
+}
+
+@media (max-width: 639px) {
+  .hub-link-card {
+    min-height: 7.5rem;
+    padding: 0.875rem;
+  }
+
+  .hub-link-card__icon {
+    width: 3rem !important;
+    height: 3rem !important;
+    border-radius: 0.75rem !important;
+  }
+}
+
+.hub-link-card--list {
+  flex-direction: row !important;
+  align-items: center !important;
+  text-align: left !important;
+  min-height: 3.75rem !important;
+  padding: 0.75rem 1rem !important;
+  gap: 0.75rem !important;
+}
+
+.hub-link-card--list .hub-link-card__icon {
+  width: 2.5rem !important;
+  height: 2.5rem !important;
+  flex-shrink: 0;
+}
+
+.hub-link-card--list .hub-link-card__text {
+  flex: 1;
+  min-width: 0;
+}
+
+.hub-link-card--list .hub-link-card__open {
+  display: none;
+}
+
+.hub-link-card--list h3 {
+  text-align: left;
+}
+
+.hub-link-card--list p {
+  text-align: left;
+  margin-top: 0.15rem !important;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* Mobile bottom nav */
+.dbis-bottom-nav {
+  position: fixed;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 60;
+  display: flex;
+  justify-content: space-around;
+  align-items: stretch;
+  min-height: 3.5rem;
+  padding-bottom: env(safe-area-inset-bottom, 0);
+  background: rgba(26, 36, 28, 0.96);
+  border-top: 1px solid rgba(34, 197, 94, 0.2);
+  backdrop-filter: blur(12px);
+}
+
+@media (min-width: 768px) {
+  .dbis-bottom-nav {
+    display: none;
+  }
+}
+
+.dbis-bottom-nav__item {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 0.15rem;
+  padding: 0.4rem 0.25rem;
+  min-height: 3.5rem;
+  font-size: 0.6rem;
+  font-weight: 500;
+  color: #848e9c;
+  text-decoration: none;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  touch-action: manipulation;
+}
+
+.dbis-bottom-nav__item--active {
+  color: #4ade80;
+}
+
+.dbis-bottom-nav__item:active {
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.dbis-has-bottom-nav {
+  padding-bottom: calc(3.75rem + env(safe-area-inset-bottom, 0));
+}
+
+@media (min-width: 768px) {
+  .dbis-has-bottom-nav {
+    padding-bottom: 0;
+  }
+}
diff --git a/frontend-dapp/src/styles/dbis-green-ui.css b/frontend-dapp/src/styles/dbis-green-ui.css
new file mode 100644
index 0000000..3ec5137
--- /dev/null
+++ b/frontend-dapp/src/styles/dbis-green-ui.css
@@ -0,0 +1,13 @@
+@layer components {
+  .ui-btn-primary {
+    @apply bg-green-600 text-white font-medium rounded-xl hover:bg-green-500 transition-colors focus:outline-none focus:ring-2 focus:ring-green-500 focus:ring-offset-2 focus:ring-offset-[#141a16] min-h-[44px] px-4 py-2;
+  }
+
+  .ui-btn-secondary {
+    @apply bg-[#1a241c] text-white font-medium rounded-xl border border-green-500/30 hover:bg-green-900/30 transition-colors min-h-[44px] px-4 py-2;
+  }
+
+  .ui-btn-icon {
+    @apply p-2 rounded-lg text-green-400 hover:bg-green-500/10 min-h-[44px] min-w-[44px];
+  }
+}
diff --git a/frontend-dapp/src/styles/mobile.css b/frontend-dapp/src/styles/mobile.css
index e2392ef..6fc0f03 100644
--- a/frontend-dapp/src/styles/mobile.css
+++ b/frontend-dapp/src/styles/mobile.css
@@ -1,34 +1,56 @@
 /**
- * Mobile Responsive Styles - Additional mobile optimizations
+ * Mobile responsive styles — touch targets, safe areas, scrollable regions
  */
 
-/* Mobile-specific adjustments */
+.safe-area-top {
+  padding-top: env(safe-area-inset-top, 0);
+}
+
+.safe-area-bottom {
+  padding-bottom: env(safe-area-inset-bottom, 0);
+}
+
+.safe-area-pad {
+  padding-top: env(safe-area-inset-top, 0);
+  padding-bottom: env(safe-area-inset-bottom, 0);
+  padding-left: env(safe-area-inset-left, 0);
+}
+
+/* Prevent horizontal page scroll */
+html,
+body,
+#root {
+  overflow-x: hidden;
+  max-width: 100vw;
+}
+
 @media (max-width: 768px) {
-  /* Navigation */
-  nav {
-    padding: 0.5rem 1rem;
+  .dbis-dashboard__inner {
+    padding-bottom: calc(4.5rem + env(safe-area-inset-bottom, 0));
   }
 
-  nav .container {
-    flex-direction: column;
-    gap: 0.5rem;
+  .dbis-section-fold + .dbis-section-fold {
+    margin-top: 0.5rem;
   }
 
-  nav .flex {
-    flex-wrap: wrap;
-    gap: 0.25rem;
+  .dash-page,
+  .o24-page,
+  .cb-page {
+    padding-left: 0.75rem;
+    padding-right: 0.75rem;
   }
 
-  nav a, nav button {
-    padding: 0.5rem 0.75rem;
-    font-size: 0.875rem;
+  .mobile-nav-bar .container {
+    padding-left: 0.75rem;
+    padding-right: 0.75rem;
   }
 
-  /* Admin Panel Tabs */
+  /* Admin panel tabs */
   .admin-tabs {
-    flex-wrap: wrap;
+    flex-wrap: nowrap;
     overflow-x: auto;
     -webkit-overflow-scrolling: touch;
+    scrollbar-width: thin;
   }
 
   .admin-tabs button {
@@ -37,90 +59,91 @@
     font-size: 0.75rem;
   }
 
-  /* Tables - Stack on mobile */
+  /* Tables — horizontal scroll within container */
+  .nasa-table,
   table {
     display: block;
+    width: 100%;
     overflow-x: auto;
     -webkit-overflow-scrolling: touch;
   }
 
-  /* Cards */
-  .bg-black\/20 {
-    padding: 1rem;
+  .overflow-x-auto {
+    -webkit-overflow-scrolling: touch;
   }
 
-  /* Forms */
-  input, select, textarea {
-    font-size: 16px; /* Prevents zoom on iOS */
+  /* Forms — prevent iOS zoom */
+  input,
+  select,
+  textarea {
+    font-size: 16px;
   }
 
-  /* Buttons */
-  button {
-    min-height: 44px; /* Touch target size */
-    min-width: 44px;
+  /* Touch targets */
+  button,
+  a.nasa-btn,
+  .nasa-nav-link {
+    min-height: 44px;
   }
 
-  /* Modals/Dialogs */
+  /* Bridge tab bar */
+  [role='tablist'] {
+    overflow-x: auto;
+    flex-wrap: nowrap;
+    -webkit-overflow-scrolling: touch;
+  }
+
+  [role='tablist'] button {
+    flex-shrink: 0;
+    white-space: nowrap;
+  }
+
+  /* Trade terminal stacks cleanly */
+  .trade-pair-header {
+    gap: 0.5rem;
+  }
+
+  .trade-pair-header h1 {
+    font-size: 1rem;
+  }
+
+  .trade-panel input,
+  .trade-panel select {
+    font-size: 16px;
+    min-height: 44px;
+  }
+
+  /* Modals / toasts */
   .modal {
     padding: 1rem;
     margin: 0.5rem;
-    max-height: calc(100vh - 1rem);
+    max-height: calc(100dvh - 1rem);
     overflow-y: auto;
   }
 
-  /* Toast notifications */
-  .toast {
-    margin: 0.5rem;
-    max-width: calc(100vw - 1rem);
+  .nasa-page {
+    padding-left: 0.75rem;
+    padding-right: 0.75rem;
   }
 
-  /* Transaction lists */
-  .transaction-item {
+  .history-page,
+  .wallets-page {
     padding: 0.75rem;
-  }
-
-  /* Wallet connection */
-  .wallet-connect {
-    flex-direction: column;
-    width: 100%;
-  }
-
-  .wallet-connect button {
-    width: 100%;
-    margin-bottom: 0.5rem;
+    max-width: 100%;
+    overflow-x: hidden;
   }
 }
 
-/* Touch-friendly interactions */
 @media (hover: none) and (pointer: coarse) {
-  /* Larger touch targets */
-  a, button {
-    min-height: 44px;
-    min-width: 44px;
-  }
-
-  /* Remove hover effects on touch devices */
-  button:hover {
-    transform: none;
-  }
-
-  /* Better focus indicators */
   button:focus-visible,
+  a:focus-visible,
   input:focus-visible,
   select:focus-visible {
-    outline: 2px solid #3b82f6;
+    outline: 2px solid #22c55e;
     outline-offset: 2px;
   }
 }
 
-/* Landscape mobile */
-@media (max-width: 1024px) and (orientation: landscape) {
-  .admin-tabs {
-    flex-wrap: nowrap;
-  }
-}
-
-/* Very small screens */
 @media (max-width: 375px) {
   .text-3xl {
     font-size: 1.5rem;
@@ -130,12 +153,8 @@
     font-size: 1.25rem;
   }
 
-  .text-xl {
-    font-size: 1.125rem;
-  }
-
-  button, a {
-    padding: 0.5rem;
-    font-size: 0.875rem;
+  .dash-quick-links__chip {
+    font-size: 0.75rem;
+    padding: 0.35rem 0.6rem;
   }
 }
diff --git a/frontend-dapp/src/styles/nasa-dashboard.css b/frontend-dapp/src/styles/nasa-dashboard.css
deleted file mode 100644
index aba4138..0000000
--- a/frontend-dapp/src/styles/nasa-dashboard.css
+++ /dev/null
@@ -1,445 +0,0 @@
-@import url('https://fonts.googleapis.com/css2?family=Share+Tech+Mono&family=Inter:wght@400;500;600;700&display=swap');
-
-.omnl-app,
-.nasa-mission-root {
-  --nasa-bg: #0f2847;
-  --nasa-bg-deep: #0a1a30;
-  --nasa-panel: #163a6b;
-  --nasa-panel-elevated: #1c4680;
-  --nasa-panel-border: #2d6bb8;
-  --nasa-telemetry: #00d4ff;
-  --nasa-nominal: #3dff8a;
-  --nasa-caution: #ffb347;
-  --nasa-critical: #fc3d21;
-  --nasa-text: #e8f4ff;
-  --nasa-muted: #9bb8d4;
-  --nasa-mono: 'Share Tech Mono', ui-monospace, monospace;
-}
-
-html:has(.omnl-app),
-html:has(.omnl-app) body {
-  background: var(--nasa-bg);
-  min-height: 100%;
-}
-
-.omnl-app {
-  background:
-    radial-gradient(ellipse at 15% 0%, rgba(45, 107, 184, 0.45) 0%, transparent 50%),
-    radial-gradient(ellipse at 85% 100%, rgba(0, 212, 255, 0.12) 0%, transparent 45%),
-    linear-gradient(180deg, var(--nasa-bg) 0%, var(--nasa-bg-deep) 100%);
-  color: var(--nasa-text);
-}
-
-.nasa-icon--telemetry { color: var(--nasa-telemetry); }
-.nasa-icon--nominal { color: var(--nasa-nominal); }
-.nasa-icon--critical { color: var(--nasa-critical); }
-.nasa-icon--caution { color: var(--nasa-caution); }
-.nasa-icon--spin { animation: nasa-spin 1s linear infinite; }
-
-@keyframes nasa-spin {
-  to { transform: rotate(360deg); }
-}
-
-.dash-page, .o24-page, .nasa-page, .cb-page {
-  min-height: calc(100vh - 56px);
-  font-family: 'Inter', sans-serif;
-}
-
-.nasa-panel, .dash-card, .o24-card, .cb-card {
-  position: relative;
-  background: linear-gradient(180deg, rgba(28, 70, 128, 0.92) 0%, rgba(22, 58, 107, 0.96) 100%);
-  border: 1px solid var(--nasa-panel-border);
-  border-radius: 2px;
-  padding: 1.15rem 1.25rem;
-  box-shadow: inset 0 1px 0 rgba(0, 212, 255, 0.08), 0 4px 24px rgba(0, 0, 0, 0.45);
-}
-
-.dash-card::before {
-  content: '';
-  position: absolute;
-  top: 0; left: 0;
-  width: 10px; height: 10px;
-  border-top: 2px solid var(--nasa-telemetry);
-  border-left: 2px solid var(--nasa-telemetry);
-  opacity: 0.7;
-}
-
-.dash-card::after {
-  content: '';
-  position: absolute;
-  bottom: 0; right: 0;
-  width: 10px; height: 10px;
-  border-bottom: 2px solid var(--nasa-telemetry);
-  border-right: 2px solid var(--nasa-telemetry);
-  opacity: 0.7;
-}
-
-.nasa-header {
-  border: 1px solid var(--nasa-panel-border);
-  background: rgba(22, 58, 107, 0.55);
-  padding: 1rem 1.25rem;
-}
-
-.nasa-header__meta {
-  display: flex;
-  justify-content: space-between;
-  gap: 1rem;
-  margin-bottom: 0.75rem;
-  font-family: var(--nasa-mono);
-  font-size: 0.7rem;
-  letter-spacing: 0.12em;
-  text-transform: uppercase;
-  color: var(--nasa-muted);
-}
-
-.nasa-mission-id {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.4rem;
-  color: var(--nasa-telemetry);
-}
-
-.nasa-header__body {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: space-between;
-  gap: 1rem;
-}
-
-.nasa-header__title-row {
-  display: flex;
-  gap: 1rem;
-}
-
-.nasa-header__icon-wrap {
-  width: 52px; height: 52px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border: 1px solid var(--nasa-panel-border);
-  background: rgba(0, 212, 255, 0.06);
-}
-
-.nasa-title, .dash-page-title {
-  font-family: var(--nasa-mono);
-  font-size: 1.65rem;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-  color: var(--nasa-text);
-  line-height: 1.2;
-}
-
-.dash-page-subtitle {
-  margin-top: 0.35rem;
-  color: var(--nasa-muted);
-  font-size: 0.9rem;
-  max-width: 48rem;
-}
-
-.nasa-badge, .dash-badge {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.35rem;
-  padding: 0.25rem 0.6rem;
-  border: 1px solid var(--nasa-panel-border);
-  font-family: var(--nasa-mono);
-  font-size: 0.65rem;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
-}
-
-.nasa-badge--telemetry, .dash-badge--blue {
-  background: rgba(0, 212, 255, 0.1);
-  color: var(--nasa-telemetry);
-  border-color: rgba(0, 212, 255, 0.35);
-}
-
-.nasa-badge--nominal, .dash-badge--green {
-  background: rgba(61, 255, 138, 0.08);
-  color: var(--nasa-nominal);
-  border-color: rgba(61, 255, 138, 0.35);
-}
-
-.nasa-badge--caution, .dash-badge--gold {
-  background: rgba(255, 179, 71, 0.08);
-  color: var(--nasa-caution);
-  border-color: rgba(255, 179, 71, 0.35);
-}
-
-.dash-banner {
-  border-radius: 2px;
-  padding: 1rem 1.15rem;
-  border: 1px solid var(--nasa-panel-border);
-  display: flex;
-  gap: 0.75rem;
-  align-items: flex-start;
-}
-
-.dash-banner__title {
-  font-size: 0.9rem;
-  font-weight: 600;
-  font-family: var(--nasa-mono);
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-  margin-bottom: 0.25rem;
-}
-
-.dash-banner__detail {
-  font-size: 0.85rem;
-  color: var(--nasa-muted);
-  line-height: 1.45;
-}
-
-.dash-banner--ok {
-  background: rgba(61, 255, 138, 0.06);
-  border-color: rgba(61, 255, 138, 0.35);
-}
-.dash-banner--ok .dash-banner__title { color: var(--nasa-nominal); }
-
-.dash-banner--warn {
-  background: rgba(255, 179, 71, 0.06);
-  border-color: rgba(255, 179, 71, 0.35);
-}
-.dash-banner--warn .dash-banner__title { color: var(--nasa-caution); }
-
-.dash-banner--error {
-  background: rgba(252, 61, 33, 0.06);
-  border-color: rgba(252, 61, 33, 0.35);
-}
-.dash-banner--error .dash-banner__title { color: var(--nasa-critical); }
-
-.dash-banner--loading {
-  background: rgba(22, 58, 107, 0.85);
-}
-
-.dash-stat-label {
-  font-family: var(--nasa-mono);
-  font-size: 0.65rem;
-  color: var(--nasa-muted);
-  text-transform: uppercase;
-  letter-spacing: 0.1em;
-  margin-bottom: 0.35rem;
-}
-
-.dash-stat-value {
-  font-family: var(--nasa-mono);
-  font-size: 1.55rem;
-  font-weight: 700;
-  color: var(--nasa-text);
-  font-variant-numeric: tabular-nums;
-}
-
-.dash-stat-hint {
-  margin-top: 0.35rem;
-  font-size: 0.75rem;
-  color: var(--nasa-muted);
-}
-
-.dash-section-title {
-  font-family: var(--nasa-mono);
-  font-size: 0.95rem;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-  color: var(--nasa-telemetry);
-}
-
-.dash-section-subtitle {
-  margin-top: 0.2rem;
-  font-size: 0.8rem;
-  color: var(--nasa-muted);
-}
-
-.dash-kv {
-  display: flex;
-  justify-content: space-between;
-  gap: 1rem;
-  padding: 0.45rem 0;
-  font-size: 0.875rem;
-  border-bottom: 1px solid rgba(30, 74, 138, 0.35);
-}
-
-.dash-kv:last-child { border-bottom: none; }
-.dash-kv dt { color: var(--nasa-muted); flex-shrink: 0; }
-.dash-kv dd { color: var(--nasa-text); text-align: right; word-break: break-word; }
-.dash-kv .dash-kv-value--ok { color: var(--nasa-nominal); font-weight: 500; }
-
-.dash-quick-links__label {
-  font-family: var(--nasa-mono);
-  font-size: 0.65rem;
-  text-transform: uppercase;
-  letter-spacing: 0.12em;
-  color: var(--nasa-muted);
-  margin-bottom: 0.5rem;
-}
-
-.dash-quick-links__chip {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.35rem;
-  padding: 0.35rem 0.75rem;
-  font-family: var(--nasa-mono);
-  font-size: 0.7rem;
-  letter-spacing: 0.04em;
-  color: var(--nasa-text);
-  background: rgba(22, 58, 107, 0.75);
-  border: 1px solid var(--nasa-panel-border);
-  transition: border-color 0.15s, color 0.15s;
-}
-
-.dash-quick-links__chip:hover {
-  border-color: var(--nasa-telemetry);
-  color: var(--nasa-telemetry);
-}
-
-.dash-btn, .nasa-btn {
-  padding: 0.55rem 1rem;
-  border: 1px solid var(--nasa-panel-border);
-  font-family: var(--nasa-mono);
-  font-size: 0.8rem;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-  background: rgba(10, 18, 36, 0.9);
-  color: var(--nasa-text);
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  gap: 0.4rem;
-  transition: border-color 0.15s, background 0.15s;
-}
-
-.dash-btn:hover, .nasa-btn:hover {
-  border-color: var(--nasa-telemetry);
-  background: rgba(0, 212, 255, 0.08);
-}
-
-.nasa-btn--primary {
-  background: rgba(0, 212, 255, 0.15);
-  border-color: var(--nasa-telemetry);
-  color: var(--nasa-telemetry);
-}
-
-.nasa-btn--primary:hover {
-  background: rgba(0, 212, 255, 0.25);
-}
-
-.dash-btn:disabled, .nasa-btn:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
-
-.nasa-input, .nasa-select {
-  width: 100%;
-  min-height: 44px;
-  padding: 0.5rem 0.75rem;
-  background: var(--nasa-panel-elevated);
-  border: 1px solid var(--nasa-panel-border);
-  color: var(--nasa-text);
-  font-family: var(--nasa-mono);
-  font-size: 0.9rem;
-}
-
-.nasa-input:focus, .nasa-select:focus {
-  outline: none;
-  border-color: var(--nasa-telemetry);
-  box-shadow: 0 0 0 1px rgba(0, 212, 255, 0.25);
-}
-
-.nasa-inset-panel {
-  background: rgba(15, 40, 71, 0.55);
-  border: 1px solid rgba(45, 107, 184, 0.55);
-  padding: 1rem;
-}
-
-.omnl-app-header {
-  background: rgba(15, 40, 71, 0.92) !important;
-  border-color: var(--nasa-panel-border) !important;
-  box-shadow: 0 2px 16px rgba(0, 0, 0, 0.5);
-}
-
-.nasa-nav-brand {
-  font-family: var(--nasa-mono);
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  color: var(--nasa-telemetry) !important;
-}
-
-.nasa-nav-link {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.4rem;
-  padding: 0.45rem 0.85rem;
-  font-family: var(--nasa-mono);
-  font-size: 0.72rem;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-  color: var(--nasa-muted);
-  border: 1px solid transparent;
-  transition: color 0.15s, border-color 0.15s, background 0.15s;
-}
-
-.nasa-nav-link:hover {
-  color: var(--nasa-text);
-  background: rgba(0, 212, 255, 0.06);
-}
-
-.nasa-nav-link--active {
-  color: var(--nasa-telemetry) !important;
-  border-color: var(--nasa-panel-border);
-  background: rgba(0, 212, 255, 0.1);
-}
-
-.nasa-table thead {
-  background: rgba(11, 61, 145, 0.2);
-  font-family: var(--nasa-mono);
-  font-size: 0.65rem;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  color: var(--nasa-muted);
-}
-
-.nasa-table tbody tr { border-top: 1px solid rgba(30, 74, 138, 0.35); }
-.nasa-table tbody tr:hover { background: rgba(0, 212, 255, 0.04); }
-
-.trade-layout {
-  display: grid;
-  grid-template-columns: 240px 1fr;
-  min-height: calc(100vh - 56px);
-  background: transparent;
-}
-
-.trade-markets, .trade-panel, .trade-pair-header, .trade-recent, .trade-book {
-  background: var(--nasa-panel) !important;
-  border-color: var(--nasa-panel-border) !important;
-}
-
-.trade-center {
-  min-height: 0;
-  background: rgba(15, 40, 71, 0.35);
-}
-
-.trade-chart {
-  background: var(--nasa-panel) !important;
-  border-color: var(--nasa-panel-border) !important;
-}
-
-.trade-chart__canvas {
-  min-height: 240px;
-  border-radius: 2px;
-  border: 1px solid var(--nasa-panel-border);
-  background: linear-gradient(180deg, rgba(22, 58, 107, 0.95) 0%, rgba(15, 40, 71, 0.98) 100%);
-}
-.trade-market-row:hover { background: rgba(0, 212, 255, 0.08); }
-.trade-market-row--active {
-  background: rgba(0, 212, 255, 0.12);
-  border-left: 2px solid var(--nasa-telemetry) !important;
-}
-
-.trade-orderbook { max-height: 360px; overflow-y: auto; font-family: var(--nasa-mono); }
-
-@media (max-width: 1023px) {
-  .trade-layout { grid-template-columns: 1fr; grid-template-rows: auto 1fr auto; }
-}
-
-@media (min-width: 1024px) {
-  .trade-layout { grid-template-columns: 240px 1fr 320px; }
-}
diff --git a/frontend-dapp/src/styles/omnl-apps.css b/frontend-dapp/src/styles/omnl-apps.css
index c419871..7a1e223 100644
--- a/frontend-dapp/src/styles/omnl-apps.css
+++ b/frontend-dapp/src/styles/omnl-apps.css
@@ -36,13 +36,12 @@
   border-radius: 4px;
   font-size: 0.7rem;
   font-weight: 600;
-  letter-spacing: 0.02em;
-  text-transform: uppercase;
+  letter-spacing: 0.01em;
 }
 
 .dash-badge--blue {
-  background: rgba(56, 97, 251, 0.18);
-  color: #3861fb;
+  background: rgba(34, 197, 94, 0.18);
+  color: #22c55e;
 }
 
 .dash-badge--green {
@@ -106,10 +105,9 @@
 }
 
 .dash-stat-label {
-  font-size: 0.7rem;
+  font-size: 0.75rem;
   color: #848e9c;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
+  font-weight: 500;
   margin-bottom: 0.35rem;
 }
 
@@ -168,9 +166,8 @@
 }
 
 .dash-quick-links__label {
-  font-size: 0.7rem;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
+  font-size: 0.75rem;
+  font-weight: 500;
   color: #848e9c;
   margin-bottom: 0.5rem;
 }
@@ -189,8 +186,8 @@
 
 .dash-quick-links__chip:hover {
   background: #474d57;
-  border-color: #f0b90b;
-  color: #f0b90b;
+  border-color: #22c55e;
+  color: #4ade80;
 }
 
 .dash-btn {
@@ -245,7 +242,7 @@
 
 .trade-market-row--active {
   background: #2b3139;
-  border-left: 2px solid #f0b90b;
+  border-left: 2px solid #22c55e;
 }
 
 .trade-orderbook {
diff --git a/frontend-dapp/src/styles/online-bank.css b/frontend-dapp/src/styles/online-bank.css
new file mode 100644
index 0000000..5f2f42d
--- /dev/null
+++ b/frontend-dapp/src/styles/online-bank.css
@@ -0,0 +1,1098 @@
+/**
+ * Z Online Bank — Wise-inspired online banking UI
+ */
+
+.revolut-bank {
+  --rb-bg: #f2f2f2;
+  --rb-surface: #ffffff;
+  --rb-card: #ffffff;
+  --rb-text: #163300;
+  --rb-text-body: #454745;
+  --rb-muted: #6a6a6a;
+  --rb-subject: #454745;
+  --rb-accent: #9fe870;
+  --rb-accent-hover: #8fd960;
+  --rb-accent-text: #163300;
+  --rb-accent-deep: #0e2f0a;
+  --rb-accent-soft: #e8f8e0;
+  --rb-border: #e2e2e2;
+  --rb-border-strong: #d3d3d3;
+  --rb-shadow: 0 1px 3px rgba(22, 51, 0, 0.06);
+  --rb-shadow-md: 0 4px 12px rgba(22, 51, 0, 0.08);
+  --rb-radius: 16px;
+  --rb-radius-sm: 12px;
+  --rb-radius-pill: 9999px;
+  min-height: calc(100dvh - 3.5rem);
+  background: var(--rb-bg);
+  color: var(--rb-text-body);
+  font-family: Inter, 'Segoe UI', system-ui, -apple-system, sans-serif;
+  -webkit-font-smoothing: antialiased;
+}
+
+.omnl-banking-theme .omnl-app-header {
+  background: #ffffff !important;
+  border-bottom: 1px solid var(--rb-border) !important;
+  box-shadow: none !important;
+}
+
+.omnl-banking-theme .omnl-app-header a,
+.omnl-banking-theme .omnl-app-header .font-semibold,
+.omnl-banking-theme .omnl-app-header button {
+  color: var(--rb-text) !important;
+}
+
+.omnl-banking-theme .omnl-app-header nav a {
+  color: var(--rb-muted) !important;
+}
+
+.omnl-banking-theme .omnl-app-header nav a.bg-green-600 {
+  background: var(--rb-accent) !important;
+  color: var(--rb-accent-text) !important;
+}
+
+.omnl-banking-theme .omnl-app-header .bg-green-600 {
+  background: var(--rb-accent-deep) !important;
+}
+
+.omnl-banking-theme .omnl-app-header .text-white {
+  color: var(--rb-text) !important;
+}
+
+.omnl-banking-theme .omnl-app-header .hover\:bg-white\/10:hover {
+  background: var(--rb-bg) !important;
+}
+
+.revolut-bank__inner {
+  max-width: 42rem;
+  margin: 0 auto;
+  padding: 1.25rem 1rem 6rem;
+}
+
+@media (min-width: 768px) {
+  .revolut-bank__inner {
+    max-width: 52rem;
+    padding: 2rem 1.5rem 3rem;
+  }
+}
+
+/* Page header */
+.revolut-bank__page-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 1.75rem;
+}
+
+.revolut-bank__logo-row {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  min-width: 0;
+}
+
+.revolut-bank__logo-mark {
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: 50%;
+  background: var(--rb-accent);
+  color: var(--rb-accent-text);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-weight: 800;
+  font-size: 1rem;
+  flex-shrink: 0;
+}
+
+.revolut-bank__brand-block {
+  min-width: 0;
+}
+
+.revolut-bank__brand-title {
+  font-size: 1.125rem;
+  font-weight: 700;
+  color: var(--rb-text);
+  letter-spacing: -0.02em;
+  margin: 0;
+  line-height: 1.2;
+}
+
+.revolut-bank__greeting-label {
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+  margin: 0;
+}
+
+.revolut-bank__greeting-name {
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--rb-text);
+  margin: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.revolut-bank__status {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  padding: 0.35rem 0.65rem;
+  border-radius: var(--rb-radius-pill);
+  background: var(--rb-accent-soft);
+  color: var(--rb-accent-deep);
+  border: 1px solid rgba(159, 232, 112, 0.5);
+  flex-shrink: 0;
+}
+
+.revolut-bank__status--offline {
+  background: #f5f5f5;
+  color: var(--rb-muted);
+  border-color: var(--rb-border);
+}
+
+/* Balance hero */
+.revolut-bank__balance-card {
+  background: transparent;
+  padding: 0 0 1.5rem;
+  margin-bottom: 0.5rem;
+  border: none;
+  box-shadow: none;
+  position: relative;
+}
+
+.revolut-bank__balance-card::before {
+  display: none;
+}
+
+.revolut-bank__balance-label {
+  font-size: 0.875rem;
+  color: var(--rb-muted);
+  margin-bottom: 0.5rem;
+  font-weight: 400;
+}
+
+.revolut-bank__balance-amount {
+  font-size: 2.75rem;
+  font-weight: 700;
+  letter-spacing: -0.04em;
+  line-height: 1.05;
+  color: var(--rb-text);
+}
+
+@media (min-width: 768px) {
+  .revolut-bank__balance-amount {
+    font-size: 3.25rem;
+  }
+}
+
+.revolut-bank__balance-sub {
+  margin-top: 0.65rem;
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  border: none;
+  padding: 0;
+}
+
+.revolut-bank__balance-sub span:last-child {
+  color: var(--rb-accent-deep);
+  font-weight: 600;
+}
+
+/* Primary CTAs — Wise Send / Add money */
+.revolut-bank__cta-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.75rem;
+  margin-bottom: 2rem;
+}
+
+.revolut-bank__cta {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  padding: 0.875rem 1rem;
+  border-radius: var(--rb-radius-pill);
+  font-size: 0.9375rem;
+  font-weight: 600;
+  text-decoration: none;
+  cursor: pointer;
+  border: none;
+  transition: background 0.15s, transform 0.1s;
+  min-height: 48px;
+}
+
+.revolut-bank__cta--primary {
+  background: var(--rb-accent);
+  color: var(--rb-accent-text);
+}
+
+.revolut-bank__cta--primary:hover {
+  background: var(--rb-accent-hover);
+}
+
+.revolut-bank__cta--secondary {
+  background: var(--rb-surface);
+  color: var(--rb-text);
+  border: 1px solid var(--rb-border-strong);
+}
+
+.revolut-bank__cta--secondary:hover {
+  background: #fafafa;
+}
+
+/* Account list — Wise-style rows */
+.revolut-bank__accounts-section {
+  margin-bottom: 2rem;
+}
+
+.revolut-bank__accounts-heading {
+  font-size: 1.125rem;
+  font-weight: 700;
+  color: var(--rb-text);
+  margin: 0 0 0.75rem;
+  letter-spacing: -0.02em;
+}
+
+.revolut-bank__accounts {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  overflow: visible;
+  padding: 0;
+  margin: 0;
+}
+
+.revolut-bank__account-pill {
+  display: flex;
+  align-items: center;
+  gap: 0.875rem;
+  min-width: 0;
+  padding: 1rem 1.125rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  box-shadow: var(--rb-shadow);
+  cursor: default;
+}
+
+.revolut-bank__account-pill--active {
+  border-color: var(--rb-accent);
+  background: var(--rb-surface);
+  box-shadow: var(--rb-shadow-md);
+}
+
+.revolut-bank__account-flag {
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: 50%;
+  background: var(--rb-bg);
+  border: 1px solid var(--rb-border);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 0.6875rem;
+  font-weight: 800;
+  color: var(--rb-text);
+  flex-shrink: 0;
+  letter-spacing: -0.02em;
+}
+
+.revolut-bank__account-pill--active .revolut-bank__account-flag {
+  background: var(--rb-accent-soft);
+  border-color: rgba(159, 232, 112, 0.6);
+}
+
+.revolut-bank__account-pill-body {
+  flex: 1;
+  min-width: 0;
+}
+
+.revolut-bank__account-pill-label {
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: var(--rb-text);
+  margin-bottom: 0.1rem;
+  text-transform: none;
+  letter-spacing: 0;
+}
+
+.revolut-bank__account-pill-meta {
+  font-size: 0.75rem;
+  color: var(--rb-muted);
+}
+
+.revolut-bank__account-pill-value {
+  font-size: 1rem;
+  font-weight: 700;
+  color: var(--rb-text);
+  flex-shrink: 0;
+  text-align: right;
+}
+
+/* Quick links row */
+.revolut-bank__actions {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 0.5rem;
+  margin-bottom: 2rem;
+  padding: 0;
+  background: transparent;
+  border: none;
+  box-shadow: none;
+}
+
+.revolut-bank__action {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.5rem 0.25rem;
+  text-decoration: none;
+  color: var(--rb-subject);
+  border: none;
+  background: none;
+  cursor: pointer;
+  font-size: 0.6875rem;
+  font-weight: 600;
+}
+
+.revolut-bank__action-icon {
+  width: 3rem;
+  height: 3rem;
+  border-radius: 50%;
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--rb-text);
+  transition: background 0.15s, border-color 0.15s;
+  box-shadow: var(--rb-shadow);
+}
+
+.revolut-bank__action:hover .revolut-bank__action-icon {
+  background: var(--rb-accent-soft);
+  border-color: rgba(159, 232, 112, 0.5);
+  transform: none;
+}
+
+/* Sections */
+.revolut-bank__section-title {
+  font-size: 1.125rem;
+  font-weight: 700;
+  margin-bottom: 0.75rem;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  color: var(--rb-text);
+  letter-spacing: -0.02em;
+}
+
+.revolut-bank__section-title h2,
+.revolut-bank__section-title h3 {
+  color: inherit;
+  font-size: inherit;
+  font-weight: inherit;
+  margin: 0;
+}
+
+.revolut-bank__section-link {
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--rb-accent-deep);
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+/* Activity */
+.revolut-bank__activity {
+  background: var(--rb-surface);
+  border-radius: var(--rb-radius-sm);
+  border: 1px solid var(--rb-border);
+  box-shadow: var(--rb-shadow);
+  overflow: hidden;
+  margin-bottom: 2rem;
+}
+
+.revolut-bank__error {
+  color: #9a6700;
+  background: #fffbeb;
+  border-color: #fcd34d;
+}
+
+.revolut-bank__activity-item {
+  display: flex;
+  align-items: center;
+  gap: 0.875rem;
+  padding: 1rem 1.125rem;
+  border-bottom: 1px solid var(--rb-border);
+}
+
+.revolut-bank__activity-item:last-child {
+  border-bottom: none;
+}
+
+.revolut-bank__activity-icon {
+  width: 2.5rem;
+  height: 2.5rem;
+  border-radius: 50%;
+  background: var(--rb-bg);
+  border: 1px solid var(--rb-border);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  color: var(--rb-text);
+}
+
+.revolut-bank__activity-icon--swap {
+  background: #eef6ff;
+  border-color: #cce0ff;
+  color: #2563eb;
+}
+
+.revolut-bank__activity-body {
+  flex: 1;
+  min-width: 0;
+}
+
+.revolut-bank__activity-title {
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: var(--rb-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.revolut-bank__activity-meta {
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+  margin-top: 0.15rem;
+}
+
+.revolut-bank__activity-amount {
+  font-size: 0.9375rem;
+  font-weight: 700;
+  flex-shrink: 0;
+  color: var(--rb-text);
+}
+
+.revolut-bank__activity-amount--positive {
+  color: #0d7a4f;
+}
+
+/* Services grid */
+.revolut-bank__services {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 0.65rem;
+  margin-bottom: 2rem;
+}
+
+@media (min-width: 640px) {
+  .revolut-bank__services {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+.revolut-bank__service-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  padding: 1rem 1.125rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  box-shadow: var(--rb-shadow);
+  text-decoration: none;
+  color: var(--rb-text);
+  transition: border-color 0.15s, box-shadow 0.15s;
+  min-height: 5rem;
+}
+
+.revolut-bank__service-card:hover {
+  border-color: var(--rb-border-strong);
+  box-shadow: var(--rb-shadow-md);
+}
+
+.revolut-bank__service-label {
+  font-size: 0.875rem;
+  font-weight: 700;
+  color: var(--rb-text);
+}
+
+.revolut-bank__service-desc {
+  font-size: 0.75rem;
+  color: var(--rb-muted);
+  line-height: 1.4;
+}
+
+/* Treasury accordion */
+.revolut-bank__treasury {
+  margin-top: 0.5rem;
+}
+
+.revolut-bank__treasury summary {
+  list-style: none;
+  cursor: pointer;
+  padding: 1rem 1.125rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: var(--rb-text);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  box-shadow: var(--rb-shadow);
+}
+
+.revolut-bank__treasury summary::-webkit-details-marker {
+  display: none;
+}
+
+.revolut-bank__chevron {
+  color: var(--rb-muted);
+}
+
+.revolut-bank__treasury-body {
+  margin-top: 0.75rem;
+  border-radius: var(--rb-radius-sm);
+  overflow: hidden;
+}
+
+.revolut-bank__skeleton {
+  background: linear-gradient(90deg, #ececec 25%, #e0e0e0 50%, #ececec 75%);
+  background-size: 200% 100%;
+  animation: rb-shimmer 1.2s infinite;
+  border-radius: 8px;
+}
+
+@keyframes rb-shimmer {
+  0% { background-position: 200% 0; }
+  100% { background-position: -200% 0; }
+}
+
+/* Settlement panel */
+.revolut-bank__protocols {
+  margin-bottom: 2rem;
+  padding: 1.25rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  box-shadow: var(--rb-shadow);
+}
+
+.revolut-bank__protocols-hint {
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+  margin-bottom: 0.75rem;
+  line-height: 1.5;
+}
+
+.revolut-bank__protocol-tabs {
+  display: flex;
+  gap: 0.5rem;
+  overflow-x: auto;
+  margin-bottom: 1rem;
+  scrollbar-width: none;
+  padding-bottom: 0.25rem;
+}
+
+.revolut-bank__protocol-tabs::-webkit-scrollbar {
+  display: none;
+}
+
+.revolut-bank__protocol-tab {
+  flex: 0 0 auto;
+  padding: 0.5rem 0.875rem;
+  border-radius: var(--rb-radius-pill);
+  border: 1px solid var(--rb-border);
+  background: var(--rb-surface);
+  color: var(--rb-subject);
+  font-size: 0.75rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.revolut-bank__protocol-tab--active {
+  background: var(--rb-accent);
+  border-color: var(--rb-accent);
+  color: var(--rb-accent-text);
+}
+
+.revolut-bank__protocol-form {
+  display: grid;
+  gap: 0.875rem;
+  margin-bottom: 1rem;
+}
+
+.revolut-bank__field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+  font-size: 0.8125rem;
+  color: var(--rb-text);
+  font-weight: 600;
+}
+
+.revolut-bank__input {
+  width: 100%;
+  padding: 0.75rem 0.875rem;
+  border-radius: 10px;
+  border: 1px solid var(--rb-border-strong);
+  background: #fff;
+  color: var(--rb-text);
+  font-size: 1rem;
+  font-weight: 400;
+}
+
+.revolut-bank__input:focus {
+  outline: none;
+  border-color: var(--rb-accent-deep);
+  box-shadow: 0 0 0 3px rgba(159, 232, 112, 0.35);
+}
+
+.revolut-bank__protocol-error {
+  padding: 0.875rem;
+  border-radius: 10px;
+  background: #fef2f2;
+  border: 1px solid #fecaca;
+  color: #b91c1c;
+  font-size: 0.8125rem;
+  margin-bottom: 0.875rem;
+}
+
+.revolut-bank__protocol-result {
+  padding: 0.875rem;
+  border-radius: 10px;
+  background: var(--rb-accent-soft);
+  border: 1px solid rgba(159, 232, 112, 0.45);
+  font-size: 0.8125rem;
+  color: var(--rb-subject);
+  margin-bottom: 0.875rem;
+}
+
+.revolut-bank__protocol-result strong {
+  color: var(--rb-accent-deep);
+}
+
+.revolut-bank__submit {
+  width: 100%;
+  padding: 0.9375rem 1rem;
+  border-radius: var(--rb-radius-pill);
+  border: none;
+  background: var(--rb-accent);
+  color: var(--rb-accent-text);
+  font-weight: 700;
+  font-size: 1rem;
+  cursor: pointer;
+  min-height: 48px;
+  transition: background 0.15s;
+}
+
+.revolut-bank__submit:hover:not(:disabled) {
+  background: var(--rb-accent-hover);
+}
+
+.revolut-bank__submit:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.revolut-bank__settlements-list {
+  margin-top: 1.25rem;
+  padding-top: 1rem;
+  border-top: 1px solid var(--rb-border);
+}
+
+.revolut-bank__settlements-list ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.revolut-bank__settlements-list li {
+  display: flex;
+  justify-content: space-between;
+  gap: 0.5rem;
+  padding: 0.65rem 0;
+  border-bottom: 1px solid var(--rb-border);
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+}
+
+.revolut-bank__panel {
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  border-radius: var(--rb-radius-sm);
+  box-shadow: var(--rb-shadow);
+  padding: 1.25rem;
+  margin-bottom: 2rem;
+}
+
+/* M0→M4 full settlement pipeline */
+.zbank-settle {
+  margin-bottom: 2rem;
+  padding: 1.25rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+  box-shadow: var(--rb-shadow);
+}
+
+.zbank-settle__pipeline {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+  margin: 1.25rem 0 1.5rem;
+  overflow-x: auto;
+  padding-bottom: 0.25rem;
+}
+
+@media (min-width: 640px) {
+  .zbank-settle__pipeline {
+    flex-direction: row;
+    align-items: stretch;
+  }
+}
+
+.zbank-settle__layer-wrap {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-width: 7.5rem;
+}
+
+@media (min-width: 640px) {
+  .zbank-settle__layer-wrap {
+    flex-direction: row;
+    align-items: stretch;
+  }
+}
+
+.zbank-settle__connector {
+  width: 2px;
+  height: 1rem;
+  background: var(--rb-border-strong);
+  margin: 0 auto;
+}
+
+@media (min-width: 640px) {
+  .zbank-settle__connector {
+    width: 1rem;
+    height: 2px;
+    margin: auto 0;
+    flex-shrink: 0;
+  }
+}
+
+.zbank-settle__connector--done {
+  background: var(--rb-accent);
+}
+
+.zbank-settle__layer {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+  padding: 0.85rem 0.75rem;
+  border-radius: var(--rb-radius-sm);
+  border: 1px solid var(--rb-border);
+  background: var(--rb-bg);
+  min-height: 6.5rem;
+}
+
+.zbank-settle__layer--active {
+  border-color: var(--rb-accent);
+  box-shadow: 0 0 0 2px rgba(159, 232, 112, 0.35);
+}
+
+.zbank-settle__layer--done {
+  border-color: rgba(159, 232, 112, 0.6);
+  background: var(--rb-accent-soft);
+}
+
+.zbank-settle__layer-id {
+  font-size: 0.6875rem;
+  font-weight: 800;
+  letter-spacing: 0.06em;
+  color: var(--rb-accent-deep);
+}
+
+.zbank-settle__layer-name {
+  font-size: 0.8125rem;
+  font-weight: 700;
+  color: var(--rb-text);
+}
+
+.zbank-settle__layer-gl {
+  font-size: 0.6875rem;
+  color: var(--rb-muted);
+  font-family: ui-monospace, monospace;
+}
+
+.zbank-settle__layer-bal {
+  font-size: 0.75rem;
+  font-weight: 700;
+  color: var(--rb-text);
+  margin-top: 0.15rem;
+}
+
+.zbank-settle__layer-desc {
+  font-size: 0.625rem;
+  color: var(--rb-muted);
+  line-height: 1.35;
+  margin-top: auto;
+}
+
+.zbank-settle__checkbox {
+  flex-direction: row !important;
+  align-items: center;
+  gap: 0.5rem !important;
+  font-weight: 500 !important;
+}
+
+.zbank-settle__checkbox input {
+  width: 1rem;
+  height: 1rem;
+  accent-color: var(--rb-accent-deep);
+}
+
+.zbank-settle__steps {
+  margin-bottom: 1rem;
+  padding: 0.875rem;
+  border-radius: 10px;
+  background: var(--rb-bg);
+  border: 1px solid var(--rb-border);
+}
+
+.zbank-settle__steps-title {
+  font-size: 0.8125rem;
+  font-weight: 700;
+  color: var(--rb-text);
+  margin: 0 0 0.5rem;
+}
+
+.zbank-settle__steps ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.zbank-settle__steps li {
+  display: grid;
+  grid-template-columns: 3.5rem 1fr auto;
+  gap: 0.5rem;
+  padding: 0.4rem 0;
+  border-bottom: 1px solid var(--rb-border);
+  font-size: 0.75rem;
+  color: var(--rb-muted);
+}
+
+.zbank-settle__steps li:last-child {
+  border-bottom: none;
+}
+
+.zbank-settle__step-status--posted {
+  color: #0d7a4f;
+  font-weight: 600;
+}
+
+.zbank-settle__step-status--failed {
+  color: #b91c1c;
+  font-weight: 600;
+}
+
+.zbank-settle__protocol-groups {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 0.5rem;
+  margin-bottom: 1rem;
+}
+
+@media (min-width: 640px) {
+  .zbank-settle__protocol-groups {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+.zbank-settle__protocol-group {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0.2rem;
+  padding: 0.75rem 0.875rem;
+  border-radius: var(--rb-radius-sm);
+  border: 1px solid var(--rb-border);
+  background: var(--rb-surface);
+  cursor: pointer;
+  text-align: left;
+}
+
+.zbank-settle__protocol-group--active {
+  border-color: var(--rb-accent);
+  background: var(--rb-accent-soft);
+}
+
+.zbank-settle__protocol-group-label {
+  font-size: 0.8125rem;
+  font-weight: 700;
+  color: var(--rb-text);
+}
+
+.zbank-settle__protocol-group-desc {
+  font-size: 0.6875rem;
+  color: var(--rb-muted);
+  line-height: 1.35;
+}
+
+/* Fiat LP → real liquidity activation */
+.zbank-liquidity {
+  margin-top: 1.5rem;
+  padding: 1.25rem;
+  border-radius: var(--rb-radius-lg);
+  background: var(--rb-surface);
+  border: 1px solid var(--rb-border);
+}
+
+.zbank-liquidity__auto-badge {
+  margin: 0.5rem 0 0.75rem;
+  padding: 0.5rem 0.75rem;
+  border-radius: var(--rb-radius-sm);
+  background: rgba(38, 194, 129, 0.12);
+  color: #26c281;
+  font-size: 0.8125rem;
+}
+
+.zbank-liquidity__connect {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  margin-top: 0.75rem;
+}
+
+.zbank-liquidity__connect-hint {
+  margin: 0;
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+}
+
+.zbank-liquidity__holder {
+  margin: 0.75rem 0;
+  font-size: 0.75rem;
+  color: var(--rb-muted);
+}
+
+.zbank-liquidity__holder code {
+  color: var(--rb-text);
+  font-size: 0.6875rem;
+}
+
+.zbank-liquidity__loading,
+.zbank-liquidity__empty {
+  margin: 0.75rem 0;
+  font-size: 0.8125rem;
+  color: var(--rb-muted);
+}
+
+.zbank-liquidity__empty a {
+  color: var(--rb-accent);
+}
+
+.zbank-liquidity__table-wrap {
+  overflow-x: auto;
+  margin: 0.75rem 0 1rem;
+}
+
+.zbank-liquidity__table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.75rem;
+}
+
+.zbank-liquidity__table th,
+.zbank-liquidity__table td {
+  padding: 0.5rem 0.625rem;
+  text-align: left;
+  border-bottom: 1px solid var(--rb-border);
+}
+
+.zbank-liquidity__table th {
+  color: var(--rb-muted);
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  font-size: 0.625rem;
+}
+
+.zbank-liquidity__dryrun {
+  margin-bottom: 0.75rem;
+}
+
+.zbank-liquidity__swaps {
+  margin: 0.75rem 0;
+  padding: 0.75rem;
+  border-radius: var(--rb-radius-sm);
+  background: var(--rb-surface-soft);
+}
+
+.zbank-liquidity__swaps ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.zbank-liquidity__swaps li {
+  display: flex;
+  justify-content: space-between;
+  gap: 0.5rem;
+  padding: 0.375rem 0;
+  font-size: 0.75rem;
+  border-bottom: 1px solid var(--rb-border);
+}
+
+.zbank-liquidity__swaps li:last-child {
+  border-bottom: none;
+}
+
+.zbank-liquidity__actions {
+  display: flex;
+  flex-direction: column;
+  gap: 0.625rem;
+  margin-top: 0.5rem;
+}
+
+.zbank-liquidity__btn--primary {
+  background: linear-gradient(135deg, #26a17b, #1a6b52);
+}
+
+.zbank-liquidity__btn--ghost {
+  background: var(--rb-surface-elevated);
+  color: var(--rb-text);
+}
+
+.zbank-liquidity__swap-link {
+  font-size: 0.8125rem;
+  color: var(--rb-accent);
+  text-align: center;
+  text-decoration: none;
+}
+
+/* Legacy header elements — hidden when using Wise layout */
+.revolut-bank__header-bar,
+.revolut-bank__brand,
+.revolut-bank__topbar,
+.revolut-bank__avatar {
+  display: none;
+}
diff --git a/frontend-dapp/src/styles/z-ecosystem.css b/frontend-dapp/src/styles/z-ecosystem.css
new file mode 100644
index 0000000..48c7fc0
--- /dev/null
+++ b/frontend-dapp/src/styles/z-ecosystem.css
@@ -0,0 +1,65 @@
+/**
+ * Z Ecosystem chrome — purple theme overrides (scoped under .z-ecosystem-theme)
+ */
+
+.z-ecosystem-theme .z-bottom-nav {
+  position: fixed;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 60;
+  display: flex;
+  justify-content: space-around;
+  align-items: stretch;
+  min-height: 3.5rem;
+  padding-bottom: env(safe-area-inset-bottom, 0);
+  background: rgba(26, 22, 36, 0.96);
+  border-top: 1px solid rgba(147, 51, 234, 0.35);
+  backdrop-filter: blur(12px);
+}
+
+@media (min-width: 768px) {
+  .z-ecosystem-theme .z-bottom-nav {
+    display: none;
+  }
+}
+
+.z-ecosystem-theme .z-bottom-nav__item {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 0.15rem;
+  padding: 0.4rem 0.25rem;
+  min-height: 3.5rem;
+  font-size: 0.6rem;
+  font-weight: 500;
+  color: #9ca3af;
+  text-decoration: none;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  touch-action: manipulation;
+}
+
+.z-ecosystem-theme .z-bottom-nav__item--active {
+  color: #c084fc;
+}
+
+.z-ecosystem-theme .z-bottom-nav__item:active {
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.z-ecosystem-theme.omnl-banking-theme .omnl-app-header nav a.bg-purple-600 {
+  background: var(--rb-accent) !important;
+  color: var(--rb-accent-text) !important;
+}
+
+.z-ecosystem-theme.omnl-banking-theme .omnl-app-header .bg-purple-600 {
+  background: var(--rb-accent-deep) !important;
+}
+
+.z-ecosystem-theme.omnl-banking-theme .omnl-app-header .border-purple-500\/30 {
+  border-color: var(--rb-border) !important;
+}
diff --git a/frontend-dapp/tailwind.config.js b/frontend-dapp/tailwind.config.js
index d37737f..78570ae 100644
--- a/frontend-dapp/tailwind.config.js
+++ b/frontend-dapp/tailwind.config.js
@@ -1,12 +1,19 @@
+import colors from 'tailwindcss/colors'
+
 /** @type {import('tailwindcss').Config} */
 export default {
   content: [
-    "./index.html",
-    "./src/**/*.{js,ts,jsx,tsx}",
+    './index.html',
+    './src/**/*.{js,ts,jsx,tsx}',
   ],
   theme: {
-    extend: {},
+    extend: {
+      colors: {
+        primary: colors.green,
+        teal: colors.green,
+        cyan: colors.emerald,
+      },
+    },
   },
   plugins: [],
 }
-
diff --git a/frontend-dapp/vite.config.ts b/frontend-dapp/vite.config.ts
index e3a6e54..5493c0f 100644
--- a/frontend-dapp/vite.config.ts
+++ b/frontend-dapp/vite.config.ts
@@ -1,12 +1,32 @@
-import { defineConfig } from 'vite'
+import { defineConfig, loadEnv, type Plugin } from 'vite'
 import react from '@vitejs/plugin-react'
 import path from 'path'
 import { nodePolyfills } from 'vite-plugin-node-polyfills'
 
+function ecosystemHtmlPlugin(isZ: boolean): Plugin {
+  return {
+    name: 'ecosystem-html',
+    transformIndexHtml(html) {
+      if (!isZ) return html
+      return html
+        .replace('<title>DBIS — Chain 138</title>', '<title>Z Blockchain System</title>')
+        .replace('content="#141a16"', 'content="#1a1624"')
+        .replace(/background: #141a16/g, 'background: #1a1624')
+        .replace('class="omnl-boot__title">DBIS</div>', 'class="omnl-boot__title">Z</div>')
+        .replace('class="omnl-boot__hint">Loading…</div>', 'class="omnl-boot__hint">Loading Z Ecosystem…</div>')
+    },
+  }
+}
+
 // https://vitejs.dev/config/
-export default defineConfig({
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd(), '')
+  const isZ = env.VITE_ECOSYSTEM === 'z'
+
+  return {
   plugins: [
     react(),
+    ecosystemHtmlPlugin(isZ),
     nodePolyfills({
       // Enable polyfills for specific modules
       globals: {
@@ -37,6 +57,21 @@ export default defineConfig({
   },
   server: {
     port: 3002,
+    proxy: {
+      '/api': { target: 'http://localhost:3000', changeOrigin: true },
+      '/settlement': { target: 'https://secure.omdnl.org', changeOrigin: true },
+      '/exchange': { target: 'https://exchange.omdnl.org', changeOrigin: true },
+      '/omnl': {
+        target: 'http://localhost:3000',
+        changeOrigin: true,
+        bypass(req) {
+          const url = req.url ?? '';
+          if (/^\/omnl\/(compliance|dashboard|terminal)\/?(\?.*)?$/.test(url)) return url;
+          if (url.startsWith('/omnl/static/')) return url;
+        },
+      },
+      '/reserve': { target: 'http://localhost:3000', changeOrigin: true },
+    },
   },
   optimizeDeps: {
     // Exclude problematic packages from optimization
@@ -64,4 +99,5 @@ export default defineConfig({
     },
     chunkSizeWarningLimit: 1000,
   },
+  }
 })
diff --git a/hardhat.config.js b/hardhat.config.js
index 5d1c250..2247242 100644
--- a/hardhat.config.js
+++ b/hardhat.config.js
@@ -37,7 +37,7 @@ module.exports = {
   },
   networks: {
     hardhat: {
-      chainId: 31337,
+      chainId: process.env.Z_CHAIN_LOCAL === "1" ? 900002 : 31337,
     },
     mainnet: {
       url: process.env.ETHEREUM_MAINNET_RPC || "https://eth.llamarpc.com",
@@ -94,6 +94,13 @@ module.exports = {
       accounts: sharedAccounts,
       chainId: 43114,
     },
+    zchain: {
+      url: process.env.CHAIN_900002_RPC_URL || "http://127.0.0.1:8546",
+      accounts: sharedAccounts.length
+        ? sharedAccounts
+        : ["0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"],
+      chainId: 900002,
+    },
   },
   // Single Etherscan API key = V2 for all chains (see docs/deployment/ETHERSCAN_V2_VERIFY_OTHER_CHAINS.md)
   etherscan: {
diff --git a/hardhat.zchain.config.js b/hardhat.zchain.config.js
new file mode 100644
index 0000000..ab5ff41
--- /dev/null
+++ b/hardhat.zchain.config.js
@@ -0,0 +1,39 @@
+require("@nomicfoundation/hardhat-toolbox");
+require("dotenv").config();
+
+function resolveAccounts() {
+  const rawPrivateKey = (process.env.PRIVATE_KEY || "").trim();
+  if (!rawPrivateKey) return [];
+  const normalizedPrivateKey = rawPrivateKey.startsWith("0x") ? rawPrivateKey : `0x${rawPrivateKey}`;
+  if (/^0x[0-9a-fA-F]{64}$/.test(normalizedPrivateKey)) return [normalizedPrivateKey];
+  return [];
+}
+
+const sharedAccounts = resolveAccounts();
+const devAccount = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+
+/** Minimal Hardhat config — Z Chain deploy only (avoids full monorepo compile). */
+module.exports = {
+  solidity: {
+    compilers: [
+      { version: "0.8.20", settings: { optimizer: { enabled: true, runs: 200 } } },
+      { version: "0.8.19", settings: { optimizer: { enabled: true, runs: 200 } } },
+    ],
+  },
+  networks: {
+    hardhat: {
+      chainId: process.env.Z_CHAIN_LOCAL === "1" ? 900002 : 31337,
+    },
+    zchain: {
+      url: process.env.CHAIN_900002_RPC_URL || "http://127.0.0.1:8546",
+      accounts: sharedAccounts.length ? sharedAccounts : [devAccount],
+      chainId: 900002,
+    },
+  },
+  paths: {
+    sources: "./contracts/z-chain",
+    tests: "./test/z-chain",
+    cache: "./cache/zchain",
+    artifacts: "./artifacts/zchain",
+  },
+};
diff --git a/orchestration/portal/client/index.html b/orchestration/portal/client/index.html
index c1c8050..d749cec 100644
--- a/orchestration/portal/client/index.html
+++ b/orchestration/portal/client/index.html
@@ -2,11 +2,11 @@
 <html lang="en">
 <head>
   <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
   <meta name="description" content="Multi-Cloud Orchestration Portal - Manage and orchestrate deployments across multiple cloud providers and on-premises infrastructure">
   <meta name="keywords" content="multi-cloud, orchestration, kubernetes, cloud management, infrastructure">
   <meta name="author" content="Multi-Cloud Orchestration Portal">
-  <meta name="theme-color" content="#667eea">
+  <meta name="theme-color" content="#16a34a">
   
   <!-- Open Graph / Facebook -->
   <meta property="og:type" content="website">
diff --git a/orchestration/portal/client/src/react/components/layout/AppLayout.tsx b/orchestration/portal/client/src/react/components/layout/AppLayout.tsx
index 298ec96..09a4fa6 100644
--- a/orchestration/portal/client/src/react/components/layout/AppLayout.tsx
+++ b/orchestration/portal/client/src/react/components/layout/AppLayout.tsx
@@ -60,6 +60,12 @@ const AppLayout: React.FC<AppLayoutProps> = ({ children }) => {
     } catch (error) {
       console.warn('Failed to load panel states from localStorage:', error);
     }
+
+    if (typeof window !== 'undefined' && window.innerWidth < 768) {
+      setLeftPanelCollapsed(true);
+      setRightPanelCollapsed(true);
+      setBottomPanelCollapsed(true);
+    }
   }, []);
 
   // Save panel collapsed states
diff --git a/orchestration/portal/client/src/react/components/layout/Header.tsx b/orchestration/portal/client/src/react/components/layout/Header.tsx
index 0283484..aa73aa1 100644
--- a/orchestration/portal/client/src/react/components/layout/Header.tsx
+++ b/orchestration/portal/client/src/react/components/layout/Header.tsx
@@ -1,13 +1,34 @@
 import React, { useState } from 'react';
+import { Link, useLocation } from 'react-router-dom';
 
 const Header: React.FC = () => {
   const [searchQuery, setSearchQuery] = useState('');
   const [notificationCount] = useState(3);
+  const [mobileMenuOpen, setMobileMenuOpen] = useState(false);
+  const location = useLocation();
+
+  const menuItems = [
+    { path: '/', label: 'Dashboard', icon: 'fas fa-home' },
+    { path: '/health', label: 'Health', icon: 'fas fa-heartbeat' },
+    { path: '/costs', label: 'Costs', icon: 'fas fa-dollar-sign' },
+    { path: '/monitoring', label: 'Monitoring', icon: 'fas fa-chart-line' },
+    { path: '/admin', label: 'Admin', icon: 'fas fa-cog' },
+  ];
 
   return (
+    <>
     <header className="app-header" role="banner" aria-label="Main navigation">
       <div className="header-content">
         <div className="header-left">
+          <button
+            type="button"
+            className="header-btn header-menu-btn md:hidden"
+            title="Open navigation menu"
+            aria-label="Open navigation menu"
+            onClick={() => setMobileMenuOpen(true)}
+          >
+            <i className="fas fa-bars" aria-hidden="true" />
+          </button>
           <h1 className="header-title">
             <i className="fas fa-cloud mr-2" aria-hidden="true"></i>
             <span>Multi-Cloud Orchestration Portal</span>
@@ -81,6 +102,32 @@ const Header: React.FC = () => {
         </div>
       </div>
     </header>
+
+    {mobileMenuOpen && (
+      <div className="mobile-nav-overlay md:hidden" role="dialog" aria-modal="true" aria-label="Navigation menu">
+        <button type="button" className="mobile-nav-backdrop" aria-label="Close menu" onClick={() => setMobileMenuOpen(false)} />
+        <nav className="mobile-nav-drawer">
+          <div className="mobile-nav-drawer-header">
+            <span>Navigation</span>
+            <button type="button" className="header-btn" aria-label="Close menu" onClick={() => setMobileMenuOpen(false)}>
+              <i className="fas fa-times" aria-hidden="true" />
+            </button>
+          </div>
+          {menuItems.map((item) => (
+            <Link
+              key={item.path}
+              to={item.path}
+              className={`mobile-nav-drawer-link ${location.pathname === item.path ? 'active' : ''}`}
+              onClick={() => setMobileMenuOpen(false)}
+            >
+              <i className={`${item.icon}`} aria-hidden="true" />
+              <span>{item.label}</span>
+            </Link>
+          ))}
+        </nav>
+      </div>
+    )}
+    </>
   );
 };
 
diff --git a/orchestration/portal/client/src/react/components/layout/ResizablePanel.tsx b/orchestration/portal/client/src/react/components/layout/ResizablePanel.tsx
index 44c5e37..6040e46 100644
--- a/orchestration/portal/client/src/react/components/layout/ResizablePanel.tsx
+++ b/orchestration/portal/client/src/react/components/layout/ResizablePanel.tsx
@@ -56,6 +56,13 @@ const ResizablePanel: React.FC<Props> = ({
         setInternalCollapsed(true);
         onCollapsedChange?.(true);
       }
+
+      if (typeof window !== 'undefined' && window.innerWidth < 768) {
+        if (controlledCollapsed === undefined) {
+          setInternalCollapsed(true);
+        }
+        onCollapsedChange?.(true);
+      }
     } catch (error) {
       console.warn('Failed to load panel state from localStorage:', error);
     }
diff --git a/orchestration/portal/client/src/styles/panels.css b/orchestration/portal/client/src/styles/panels.css
index 5f88adf..ea53c3b 100644
--- a/orchestration/portal/client/src/styles/panels.css
+++ b/orchestration/portal/client/src/styles/panels.css
@@ -870,6 +870,94 @@
     width: var(--touch-target-comfortable);
     height: var(--touch-target-comfortable);
   }
+
+  /* Side panels become overlay drawers; collapse toggles stay on screen edge */
+  .resizable-panel.collapsed {
+    overflow: visible;
+  }
+
+  .resizable-panel-left:not(.collapsed) {
+    width: min(85vw, 280px) !important;
+    box-shadow: var(--shadow-xl);
+    z-index: calc(var(--z-panels) + 10);
+  }
+
+  .resizable-panel-right:not(.collapsed) {
+    width: min(85vw, 280px) !important;
+    box-shadow: var(--shadow-xl);
+    z-index: calc(var(--z-panels) + 10);
+  }
+
+  .resizable-panel-bottom:not(.collapsed) {
+    height: min(50vh, 320px) !important;
+    left: 0 !important;
+    right: 0 !important;
+    z-index: calc(var(--z-panels) + 10);
+  }
+
+  .resize-handle {
+    display: none;
+  }
+
+  .main-content {
+    margin-left: 0 !important;
+    margin-right: 0 !important;
+    padding: 1rem !important;
+  }
+
+  .mobile-nav-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: calc(var(--z-panels) + 50);
+    display: flex;
+  }
+
+  .mobile-nav-backdrop {
+    flex: 1;
+    background: rgba(0, 0, 0, 0.55);
+    border: none;
+    cursor: pointer;
+  }
+
+  .mobile-nav-drawer {
+    width: min(85vw, 280px);
+    background: white;
+    box-shadow: var(--shadow-xl);
+    display: flex;
+    flex-direction: column;
+    padding-top: env(safe-area-inset-top, 0);
+    padding-bottom: env(safe-area-inset-bottom, 0);
+  }
+
+  .mobile-nav-drawer-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.75rem 1rem;
+    border-bottom: 1px solid var(--border-color, #e5e7eb);
+    font-weight: 600;
+  }
+
+  .mobile-nav-drawer-link {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 0.875rem 1rem;
+    min-height: 44px;
+    color: var(--text-color, #1f2937);
+    text-decoration: none;
+    border-bottom: 1px solid rgba(0, 0, 0, 0.06);
+  }
+
+  .mobile-nav-drawer-link.active {
+    background: rgba(102, 126, 234, 0.12);
+    color: var(--color-primary-600, #16a34a);
+    font-weight: 600;
+  }
+
+  .header-menu-btn {
+    margin-right: 0.25rem;
+  }
 }
 
 @media (max-width: 640px) {
diff --git a/orchestration/portal/client/src/styles/variables.css b/orchestration/portal/client/src/styles/variables.css
index 26ada7c..a530158 100644
--- a/orchestration/portal/client/src/styles/variables.css
+++ b/orchestration/portal/client/src/styles/variables.css
@@ -1,17 +1,15 @@
 /**
- * CSS Variables for Theming and Consistency
- * Centralized design tokens for easy customization
+ * DBIS green UI — orchestration portal design tokens
  */
-
 :root {
-  /* Colors - Primary */
-  --color-primary-500: #3b82f6;
-  --color-primary-600: #2563eb;
-  --color-primary-700: #1d4ed8;
+  /* Colors - Primary (green) */
+  --color-primary-500: #22c55e;
+  --color-primary-600: #16a34a;
+  --color-primary-700: #15803d;
   
   /* Colors - Gradients */
-  --gradient-primary: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-  --gradient-ai: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
+  --gradient-primary: linear-gradient(135deg, #22c55e 0%, #059669 100%);
+  --gradient-ai: linear-gradient(135deg, #4ade80 0%, #16a34a 100%);
   
   /* Colors - Grays */
   --color-gray-50: #f9fafb;
@@ -29,7 +27,7 @@
   --color-success: #10b981;
   --color-warning: #f59e0b;
   --color-error: #ef4444;
-  --color-info: #3b82f6;
+  --color-info: #22c55e;
   
   /* Layout - Spacing */
   --spacing-xs: 0.25rem;
@@ -40,11 +38,11 @@
   --spacing-2xl: 3rem;
   
   /* Layout - Header & Footer */
-  --header-height: 64px; /* Standard header height, ensures consistent layout */
-  --header-height-mobile: 56px; /* Smaller on mobile for more screen space */
+  --header-height: 64px;
+  --header-height-mobile: 56px;
   --footer-height: 15px;
   
-  /* Touch Targets - WCAG 2.1 Level AAA requires 44x44px minimum */
+  /* Touch Targets */
   --touch-target-min: 44px;
   --touch-target-comfortable: 48px;
   
@@ -91,10 +89,8 @@
   --breakpoint-2xl: 1536px;
 }
 
-/* Dark mode support (future) */
 @media (prefers-color-scheme: dark) {
   :root {
     /* Dark mode variables can be added here */
   }
 }
-
diff --git a/orchestration/portal/client/src/vue/components/layout/AppLayout.vue b/orchestration/portal/client/src/vue/components/layout/AppLayout.vue
index 6180b2e..41d5c3f 100644
--- a/orchestration/portal/client/src/vue/components/layout/AppLayout.vue
+++ b/orchestration/portal/client/src/vue/components/layout/AppLayout.vue
@@ -128,6 +128,12 @@ onMounted(() => {
   } catch (error) {
     console.warn('Failed to load panel states from localStorage:', error);
   }
+
+  if (typeof window !== 'undefined' && window.innerWidth < 768) {
+    leftPanelCollapsed.value = true;
+    rightPanelCollapsed.value = true;
+    bottomPanelCollapsed.value = true;
+  }
 });
 
 // Save panel collapsed states
@@ -154,18 +160,32 @@ watch([leftPanelCollapsed, rightPanelCollapsed, bottomPanelCollapsed], () => {
   flex: 1;
   padding: 2rem;
   overflow-y: auto;
+  overflow-x: hidden;
   background: #f9fafb;
   min-height: calc(100vh - 79px);
   overscroll-behavior: contain;
 }
 
+@media (max-width: 768px) {
+  .main-content {
+    padding: 1rem;
+    margin-left: 0 !important;
+    margin-right: 0 !important;
+    margin-bottom: 1rem !important;
+  }
+
+  .app-footer .footer-links {
+    display: none;
+  }
+}
+
 .app-footer {
   position: fixed;
   bottom: 0;
   left: 0;
   right: 0;
   height: 15px;
-  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  background: linear-gradient(135deg, #22c55e 0%, #059669 100%);
   z-index: 1000;
   display: flex;
   align-items: center;
diff --git a/orchestration/portal/client/src/vue/components/layout/Header.vue b/orchestration/portal/client/src/vue/components/layout/Header.vue
index 45ed792..6b3687f 100644
--- a/orchestration/portal/client/src/vue/components/layout/Header.vue
+++ b/orchestration/portal/client/src/vue/components/layout/Header.vue
@@ -2,6 +2,15 @@
   <header class="app-header" role="banner" aria-label="Main navigation">
     <div class="header-content">
       <div class="header-left">
+        <button
+          type="button"
+          class="header-btn header-menu-btn md:hidden"
+          title="Open navigation menu"
+          aria-label="Open navigation menu"
+          @click="mobileMenuOpen = true"
+        >
+          <i class="fas fa-bars" aria-hidden="true"></i>
+        </button>
         <h1 class="header-title">
           <i class="fas fa-cloud mr-2" aria-hidden="true"></i>
           <span>Multi-Cloud Orchestration Portal</span>
@@ -73,6 +82,29 @@
       </div>
     </div>
   </header>
+
+  <div v-if="mobileMenuOpen" class="mobile-nav-overlay md:hidden" role="dialog" aria-modal="true" aria-label="Navigation menu">
+    <button type="button" class="mobile-nav-backdrop" aria-label="Close menu" @click="mobileMenuOpen = false" />
+    <nav class="mobile-nav-drawer">
+      <div class="mobile-nav-drawer-header">
+        <span>Navigation</span>
+        <button type="button" class="header-btn" aria-label="Close menu" @click="mobileMenuOpen = false">
+          <i class="fas fa-times" aria-hidden="true"></i>
+        </button>
+      </div>
+      <router-link
+        v-for="item in menuItems"
+        :key="item.path"
+        :to="item.path"
+        class="mobile-nav-drawer-link"
+        active-class="active"
+        @click="mobileMenuOpen = false"
+      >
+        <i :class="item.icon" aria-hidden="true"></i>
+        <span>{{ item.label }}</span>
+      </router-link>
+    </nav>
+  </div>
 </template>
 
 <script setup lang="ts">
@@ -80,6 +112,15 @@ import { ref } from 'vue';
 
 const searchQuery = ref('');
 const notificationCount = ref(3);
+const mobileMenuOpen = ref(false);
+
+const menuItems = [
+  { path: '/', label: 'Dashboard', icon: 'fas fa-home' },
+  { path: '/health', label: 'Health', icon: 'fas fa-heartbeat' },
+  { path: '/costs', label: 'Costs', icon: 'fas fa-dollar-sign' },
+  { path: '/monitoring', label: 'Monitoring', icon: 'fas fa-chart-line' },
+  { path: '/admin', label: 'Admin', icon: 'fas fa-cog' },
+];
 </script>
 
 <style scoped>
diff --git a/orchestration/portal/client/src/vue/components/layout/ResizablePanel.vue b/orchestration/portal/client/src/vue/components/layout/ResizablePanel.vue
index 1960c28..3e9847c 100644
--- a/orchestration/portal/client/src/vue/components/layout/ResizablePanel.vue
+++ b/orchestration/portal/client/src/vue/components/layout/ResizablePanel.vue
@@ -247,6 +247,11 @@ onMounted(() => {
     isCollapsed.value = true;
     emit('update:collapsed', true);
   }
+
+  if (typeof window !== 'undefined' && window.innerWidth < 768 && !isCollapsed.value) {
+    isCollapsed.value = true;
+    emit('update:collapsed', true);
+  }
 });
 
 onUnmounted(() => {
diff --git a/orchestration/portal/tailwind.config.js b/orchestration/portal/tailwind.config.js
index f631944..000a626 100644
--- a/orchestration/portal/tailwind.config.js
+++ b/orchestration/portal/tailwind.config.js
@@ -1,23 +1,23 @@
 /** @type {import('tailwindcss').Config} */
 export default {
   content: [
-    "./client/**/*.{vue,js,ts,jsx,tsx}",
-    "./templates/**/*.html",
+    './client/**/*.{vue,js,ts,jsx,tsx}',
+    './templates/**/*.html',
   ],
   theme: {
     extend: {
       colors: {
         primary: {
-          50: '#f0f4ff',
-          100: '#e0e9ff',
-          200: '#c7d7fe',
-          300: '#a5b8fc',
-          400: '#818cf8',
-          500: '#667eea',
-          600: '#5568d3',
-          700: '#4854b0',
-          800: '#3f4891',
-          900: '#3a4076',
+          50: '#f0fdf4',
+          100: '#dcfce7',
+          200: '#bbf7d0',
+          300: '#86efac',
+          400: '#4ade80',
+          500: '#22c55e',
+          600: '#16a34a',
+          700: '#15803d',
+          800: '#166534',
+          900: '#14532d',
         },
       },
       fontFamily: {
@@ -30,4 +30,3 @@ export default {
     require('@tailwindcss/typography'),
   ],
 };
-
diff --git a/orchestration/portal/templates/cost_dashboard.html b/orchestration/portal/templates/cost_dashboard.html
index 4588625..1fb38e0 100644
--- a/orchestration/portal/templates/cost_dashboard.html
+++ b/orchestration/portal/templates/cost_dashboard.html
@@ -14,7 +14,7 @@
         }
         
         :root {
-            --primary: #667eea;
+            --primary: #16a34a;
             --success: #10b981;
             --warning: #f59e0b;
             --error: #ef4444;
@@ -32,7 +32,7 @@
         }
         
         .navbar {
-            background: linear-gradient(135deg, var(--primary) 0%, #764ba2 100%);
+            background: linear-gradient(135deg, var(--primary) 0%, #059669 100%);
             color: white;
             padding: 1rem 2rem;
             box-shadow: 0 2px 10px rgba(0,0,0,0.1);
@@ -137,6 +137,14 @@
             font-weight: 600;
             color: var(--primary);
         }
+
+        @media (max-width: 768px) {
+            .navbar { flex-wrap: wrap; gap: 0.5rem; padding: 0.75rem 1rem; }
+            .container { padding: 1rem !important; }
+            .grid, .stats-grid { grid-template-columns: 1fr !important; }
+            table { display: block; overflow-x: auto; -webkit-overflow-scrolling: touch; }
+            .navbar a { min-height: 44px; display: inline-flex; align-items: center; }
+        }
     </style>
 </head>
 <body>
@@ -223,7 +231,7 @@
                 datasets: [{
                     label: 'Daily Cost (USD)',
                     data: values,
-                    borderColor: '#667eea',
+                    borderColor: '#16a34a',
                     backgroundColor: 'rgba(102, 126, 234, 0.1)',
                     tension: 0.4,
                     fill: true
diff --git a/orchestration/portal/templates/dashboard.html b/orchestration/portal/templates/dashboard.html
index fd51519..f73083b 100644
--- a/orchestration/portal/templates/dashboard.html
+++ b/orchestration/portal/templates/dashboard.html
@@ -14,8 +14,8 @@
         }
         
         :root {
-            --primary: #667eea;
-            --primary-dark: #5568d3;
+            --primary: #16a34a;
+            --primary-dark: #15803d;
             --success: #10b981;
             --warning: #f59e0b;
             --error: #ef4444;
@@ -35,7 +35,7 @@
         }
         
         .navbar {
-            background: linear-gradient(135deg, var(--primary) 0%, #764ba2 100%);
+            background: linear-gradient(135deg, var(--primary) 0%, #059669 100%);
             color: white;
             padding: 1rem 2rem;
             box-shadow: 0 2px 10px rgba(0,0,0,0.1);
@@ -364,6 +364,52 @@
             margin-bottom: 1rem;
             opacity: 0.5;
         }
+
+        @media (max-width: 768px) {
+            .navbar {
+                flex-direction: column;
+                align-items: flex-start;
+                gap: 0.75rem;
+                padding: 0.75rem 1rem;
+            }
+
+            .navbar h1 {
+                font-size: 1.1rem;
+            }
+
+            .navbar nav {
+                flex-wrap: wrap;
+                gap: 0.5rem 1rem;
+                width: 100%;
+            }
+
+            .navbar a {
+                min-height: 44px;
+                display: inline-flex;
+                align-items: center;
+            }
+
+            .container,
+            .dashboard-container {
+                padding: 1rem !important;
+            }
+
+            .stats-grid,
+            .grid {
+                grid-template-columns: 1fr !important;
+            }
+
+            .env-card,
+            .card {
+                padding: 1rem;
+            }
+
+            table {
+                display: block;
+                overflow-x: auto;
+                -webkit-overflow-scrolling: touch;
+            }
+        }
     </style>
 </head>
 <body>
diff --git a/orchestration/portal/templates/environment.html b/orchestration/portal/templates/environment.html
index 13e0e4b..a769d2f 100644
--- a/orchestration/portal/templates/environment.html
+++ b/orchestration/portal/templates/environment.html
@@ -18,7 +18,7 @@
         }
         
         .header {
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            background: linear-gradient(135deg, #16a34a 0%, #059669 100%);
             color: white;
             padding: 2rem;
         }
@@ -38,7 +38,7 @@
         }
         
         .card h2 {
-            color: #667eea;
+            color: #16a34a;
             margin-bottom: 1rem;
         }
         
@@ -69,7 +69,7 @@
         
         .btn {
             padding: 0.75rem 1.5rem;
-            background: #667eea;
+            background: #16a34a;
             color: white;
             border: none;
             border-radius: 4px;
@@ -79,7 +79,13 @@
         }
         
         .btn:hover {
-            background: #5568d3;
+            background: #15803d;
+        }
+
+        @media (max-width: 768px) {
+            .container { padding: 1rem !important; margin: 1rem auto !important; }
+            .header { padding: 1rem !important; }
+            .btn { width: 100%; min-height: 44px; }
         }
     </style>
 </head>
diff --git a/orchestration/portal/templates/environment_detail.html b/orchestration/portal/templates/environment_detail.html
index e14f524..0ddd180 100644
--- a/orchestration/portal/templates/environment_detail.html
+++ b/orchestration/portal/templates/environment_detail.html
@@ -14,7 +14,7 @@
         }
         
         :root {
-            --primary: #667eea;
+            --primary: #16a34a;
             --success: #10b981;
             --warning: #f59e0b;
             --error: #ef4444;
@@ -32,7 +32,7 @@
         }
         
         .navbar {
-            background: linear-gradient(135deg, var(--primary) 0%, #764ba2 100%);
+            background: linear-gradient(135deg, var(--primary) 0%, #059669 100%);
             color: white;
             padding: 1rem 2rem;
             box-shadow: 0 2px 10px rgba(0,0,0,0.1);
@@ -164,6 +164,14 @@
             background: #fee2e2;
             color: #991b1b;
         }
+
+        @media (max-width: 768px) {
+            .navbar { flex-wrap: wrap; gap: 0.5rem; padding: 0.75rem 1rem; }
+            .container { padding: 1rem !important; }
+            .grid, .meta { grid-template-columns: 1fr !important; }
+            table { display: block; overflow-x: auto; -webkit-overflow-scrolling: touch; }
+            .navbar a { min-height: 44px; display: inline-flex; align-items: center; }
+        }
     </style>
 </head>
 <body>
@@ -295,7 +303,7 @@
                 datasets: [{
                     label: 'CPU Usage %',
                     data: cpuData,
-                    borderColor: '#667eea',
+                    borderColor: '#16a34a',
                     backgroundColor: 'rgba(102, 126, 234, 0.1)',
                     tension: 0.4
                 }, {
diff --git a/orchestration/portal/templates/health_dashboard.html b/orchestration/portal/templates/health_dashboard.html
index e4cb92d..97b2b0c 100644
--- a/orchestration/portal/templates/health_dashboard.html
+++ b/orchestration/portal/templates/health_dashboard.html
@@ -14,7 +14,7 @@
         }
         
         :root {
-            --primary: #667eea;
+            --primary: #16a34a;
             --success: #10b981;
             --warning: #f59e0b;
             --error: #ef4444;
@@ -32,7 +32,7 @@
         }
         
         .navbar {
-            background: linear-gradient(135deg, var(--primary) 0%, #764ba2 100%);
+            background: linear-gradient(135deg, var(--primary) 0%, #059669 100%);
             color: white;
             padding: 1rem 2rem;
             box-shadow: 0 2px 10px rgba(0,0,0,0.1);
@@ -165,6 +165,14 @@
             background: #fee2e2;
             color: #991b1b;
         }
+
+        @media (max-width: 768px) {
+            .navbar { flex-wrap: wrap; gap: 0.5rem; padding: 0.75rem 1rem; }
+            .container { padding: 1rem !important; }
+            .grid, .stats-grid { grid-template-columns: 1fr !important; }
+            table { display: block; overflow-x: auto; -webkit-overflow-scrolling: touch; }
+            .navbar a { min-height: 44px; display: inline-flex; align-items: center; }
+        }
     </style>
 </head>
 <body>
diff --git a/orchestration/portal/templates/index.html b/orchestration/portal/templates/index.html
index 32cfa41..ada84c0 100644
--- a/orchestration/portal/templates/index.html
+++ b/orchestration/portal/templates/index.html
@@ -18,7 +18,7 @@
         }
         
         .header {
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            background: linear-gradient(135deg, #16a34a 0%, #059669 100%);
             color: white;
             padding: 2rem;
             box-shadow: 0 2px 10px rgba(0,0,0,0.1);
@@ -54,7 +54,7 @@
         }
         
         .stat-card h3 {
-            color: #667eea;
+            color: #16a34a;
             font-size: 0.9rem;
             text-transform: uppercase;
             margin-bottom: 0.5rem;
@@ -74,14 +74,14 @@
             background: white;
             padding: 1rem 1.5rem;
             border-radius: 8px 8px 0 0;
-            border-bottom: 2px solid #667eea;
+            border-bottom: 2px solid #16a34a;
             display: flex;
             justify-content: space-between;
             align-items: center;
         }
         
         .provider-header h2 {
-            color: #667eea;
+            color: #16a34a;
             font-size: 1.5rem;
         }
         
@@ -161,12 +161,12 @@
         }
         
         .btn-primary {
-            background: #667eea;
+            background: #16a34a;
             color: white;
         }
         
         .btn-primary:hover {
-            background: #5568d3;
+            background: #15803d;
         }
         
         .btn-secondary {
@@ -177,6 +177,14 @@
         .btn-secondary:hover {
             background: #e0e0e0;
         }
+
+        @media (max-width: 768px) {
+            .header { padding: 1.5rem 1rem !important; }
+            .container { padding: 1rem !important; }
+            .stats { grid-template-columns: 1fr !important; }
+            .environments { grid-template-columns: 1fr !important; }
+            .btn { min-height: 44px; }
+        }
     </style>
 </head>
 <body>
diff --git a/package.json b/package.json
index 2fdd4cc..a138111 100644
--- a/package.json
+++ b/package.json
@@ -42,6 +42,13 @@
     "deploy:logger:gnosis": "hardhat run scripts/ccip-deployment/deploy-ccip-logger-multichain.js --network gnosis",
     "deploy:logger:cronos": "hardhat run scripts/ccip-deployment/deploy-ccip-logger-multichain.js --network cronos",
     "deploy:reporter:chain138": "node scripts/ccip-deployment/deploy-ccip-reporter.js",
+    "zchain:complete": "powershell -ExecutionPolicy Bypass -File scripts/deployment/complete-z-chain.ps1",
+    "zchain:deploy-portal": "powershell -ExecutionPolicy Bypass -File scripts/deployment/deploy-z-ecosystem.ps1",
+    "zchain:go-live": "powershell -ExecutionPolicy Bypass -File scripts/deployment/go-live-z-ecosystem.ps1",
+    "zchain:deploy-production": "bash scripts/deployment/deploy-z-ecosystem-production.sh",
+    "zchain:deploy-domains": "bash scripts/deployment/deploy-z-domains.sh",
+    "zchain:compile": "hardhat compile --config hardhat.zchain.config.js",
+    "zchain:deploy": "hardhat run scripts/deployment/deploy-z-chain-contracts.js --network zchain --config hardhat.zchain.config.js",
     "verify:logger": "hardhat verify --network mainnet",
     "verify:reporter": "hardhat verify --network chain138",
     "keeper": "node scripts/reserve/keeper-service.js",
diff --git a/packages/settlement-core/dist/money-supply.d.ts b/packages/settlement-core/dist/money-supply.d.ts
index 05129d7..fa53b59 100644
--- a/packages/settlement-core/dist/money-supply.d.ts
+++ b/packages/settlement-core/dist/money-supply.d.ts
@@ -34,6 +34,24 @@ export declare function m3TokenLoadAmount(requested: string, m2Broad: string, m3
 };
 /** All settlement layers M0–M4 for production routing. */
 export declare const ALL_MONEY_LAYERS: MoneyLayer[];
+export type ZBankGlProfile = {
+    glM0: string;
+    glM1: string;
+    glM2: string;
+    glM3: string;
+    glM4NearMoney: string;
+};
+/** IPSAS journal pairs for Z Online Bank full-stack settlement (office 24 matrix). */
+export declare function resolveZBankLayerJournal(from: MoneyLayer, to: MoneyLayer, gl: ZBankGlProfile): {
+    debitGl: string;
+    creditGl: string;
+    narrative: string;
+} | null;
+/** Ordered layer hops for Z Online Bank M0→M4 settlement. */
+export declare function zBankM0ToM4Hops(includeM3: boolean): {
+    from: MoneyLayer;
+    to: MoneyLayer;
+}[];
 /** M4 outbound SWIFT/RTGS: move M1/M2 into GL 1000 settlement suspense while in flight. */
 export declare function resolveM4OutboundJournal(moneyLayers: MoneyLayer[], gl: {
     glM1: string;
diff --git a/packages/settlement-core/dist/money-supply.js b/packages/settlement-core/dist/money-supply.js
index eb4d31b..597c4e3 100644
--- a/packages/settlement-core/dist/money-supply.js
+++ b/packages/settlement-core/dist/money-supply.js
@@ -5,6 +5,8 @@ exports.aggregateMetaFiatLayers = aggregateMetaFiatLayers;
 exports.buildMoneySupplySnapshot = buildMoneySupplySnapshot;
 exports.m2FiatToTokenLoadAmount = m2FiatToTokenLoadAmount;
 exports.m3TokenLoadAmount = m3TokenLoadAmount;
+exports.resolveZBankLayerJournal = resolveZBankLayerJournal;
+exports.zBankM0ToM4Hops = zBankM0ToM4Hops;
 exports.resolveM4OutboundJournal = resolveM4OutboundJournal;
 /** IPSAS GL mapping for OMNL central-bank money aggregates M0–M4 */
 exports.GL_CODES = {
@@ -105,6 +107,51 @@ function m3TokenLoadAmount(requested, m2Broad, m3Outstanding) {
 }
 /** All settlement layers M0–M4 for production routing. */
 exports.ALL_MONEY_LAYERS = ['M0', 'M1', 'M2', 'M3', 'M4'];
+/** IPSAS journal pairs for Z Online Bank full-stack settlement (office 24 matrix). */
+function resolveZBankLayerJournal(from, to, gl) {
+    const pairs = {
+        'M0-M1': {
+            debitGl: gl.glM0 || exports.GL_CODES.M0_RESERVE,
+            creditGl: gl.glM1 || exports.GL_CODES.M1_CIRCULATING,
+            narrative: 'Z Online Bank · M0→M1 reserve to circulating',
+        },
+        'M1-M2': {
+            debitGl: gl.glM1 || exports.GL_CODES.M1_CIRCULATING,
+            creditGl: gl.glM2 || exports.GL_CODES.M2_BROAD,
+            narrative: 'Z Online Bank · M1→M2 broad-money conversion',
+        },
+        'M2-M3': {
+            debitGl: gl.glM2 || exports.GL_CODES.M2_BROAD,
+            creditGl: gl.glM3 || exports.GL_CODES.M3_TOKEN_LIABILITY,
+            narrative: 'Z Online Bank · M2→M3 on-chain token liability',
+        },
+        'M3-M4': {
+            debitGl: gl.glM3 || exports.GL_CODES.M3_TOKEN_LIABILITY,
+            creditGl: gl.glM4NearMoney || exports.GL_CODES.SETTLEMENT_SUSPENSE,
+            narrative: 'Z Online Bank · M3→M4 settlement suspense',
+        },
+        'M2-M4': {
+            debitGl: gl.glM2 || exports.GL_CODES.M2_BROAD,
+            creditGl: gl.glM4NearMoney || exports.GL_CODES.SETTLEMENT_SUSPENSE,
+            narrative: 'Z Online Bank · M2→M4 SWIFT/RTGS outbound suspense',
+        },
+    };
+    return pairs[`${from}-${to}`] ?? null;
+}
+/** Ordered layer hops for Z Online Bank M0→M4 settlement. */
+function zBankM0ToM4Hops(includeM3) {
+    const hops = [
+        { from: 'M0', to: 'M1' },
+        { from: 'M1', to: 'M2' },
+    ];
+    if (includeM3) {
+        hops.push({ from: 'M2', to: 'M3' }, { from: 'M3', to: 'M4' });
+    }
+    else {
+        hops.push({ from: 'M2', to: 'M4' });
+    }
+    return hops;
+}
 /** M4 outbound SWIFT/RTGS: move M1/M2 into GL 1000 settlement suspense while in flight. */
 function resolveM4OutboundJournal(moneyLayers, gl) {
     if (!moneyLayers.includes('M4'))
diff --git a/packages/settlement-core/dist/types.d.ts b/packages/settlement-core/dist/types.d.ts
index b7b7942..5612fd7 100644
--- a/packages/settlement-core/dist/types.d.ts
+++ b/packages/settlement-core/dist/types.d.ts
@@ -64,6 +64,28 @@ export type TransferRequest = {
     remittanceInfo?: string;
     currency?: string;
 };
+export type ZBankLayerStep = {
+    from: MoneyLayer;
+    to: MoneyLayer;
+    debitGl: string;
+    creditGl: string;
+    journalRef?: string;
+    status: 'pending' | 'posted' | 'skipped' | 'failed';
+};
+export type ZBankM0M4Request = {
+    idempotencyKey: string;
+    officeId?: number;
+    valueDate?: string;
+    currency: string;
+    amount: string;
+    creditorIban: string;
+    creditorBic?: string;
+    beneficiaryName?: string;
+    remittanceInfo?: string;
+    /** When set, M2→M3 hop posts GL + requests Chain 138 mint */
+    recipientAddress?: string;
+    tokenLineId?: string;
+};
 export type SettlementRecord = {
     settlementId: string;
     idempotencyKey: string;
@@ -74,6 +96,7 @@ export type SettlementRecord = {
     iso20022MessageId?: string;
     chainTxHash?: string;
     verbiageDocument?: string;
+    layerSteps?: ZBankLayerStep[];
     errors: string[];
     createdAt: string;
     updatedAt: string;
diff --git a/packages/settlement-core/src/money-supply.ts b/packages/settlement-core/src/money-supply.ts
index 2326c66..0692c16 100644
--- a/packages/settlement-core/src/money-supply.ts
+++ b/packages/settlement-core/src/money-supply.ts
@@ -117,6 +117,64 @@ export function m3TokenLoadAmount(requested: string, m2Broad: string, m3Outstand
 /** All settlement layers M0–M4 for production routing. */
 export const ALL_MONEY_LAYERS: MoneyLayer[] = ['M0', 'M1', 'M2', 'M3', 'M4'];
 
+export type ZBankGlProfile = {
+  glM0: string;
+  glM1: string;
+  glM2: string;
+  glM3: string;
+  glM4NearMoney: string;
+};
+
+/** IPSAS journal pairs for Z Online Bank full-stack settlement (office 24 matrix). */
+export function resolveZBankLayerJournal(
+  from: MoneyLayer,
+  to: MoneyLayer,
+  gl: ZBankGlProfile,
+): { debitGl: string; creditGl: string; narrative: string } | null {
+  const pairs: Record<string, { debitGl: string; creditGl: string; narrative: string }> = {
+    'M0-M1': {
+      debitGl: gl.glM0 || GL_CODES.M0_RESERVE,
+      creditGl: gl.glM1 || GL_CODES.M1_CIRCULATING,
+      narrative: 'Z Online Bank · M0→M1 reserve to circulating',
+    },
+    'M1-M2': {
+      debitGl: gl.glM1 || GL_CODES.M1_CIRCULATING,
+      creditGl: gl.glM2 || GL_CODES.M2_BROAD,
+      narrative: 'Z Online Bank · M1→M2 broad-money conversion',
+    },
+    'M2-M3': {
+      debitGl: gl.glM2 || GL_CODES.M2_BROAD,
+      creditGl: gl.glM3 || GL_CODES.M3_TOKEN_LIABILITY,
+      narrative: 'Z Online Bank · M2→M3 on-chain token liability',
+    },
+    'M3-M4': {
+      debitGl: gl.glM3 || GL_CODES.M3_TOKEN_LIABILITY,
+      creditGl: gl.glM4NearMoney || GL_CODES.SETTLEMENT_SUSPENSE,
+      narrative: 'Z Online Bank · M3→M4 settlement suspense',
+    },
+    'M2-M4': {
+      debitGl: gl.glM2 || GL_CODES.M2_BROAD,
+      creditGl: gl.glM4NearMoney || GL_CODES.SETTLEMENT_SUSPENSE,
+      narrative: 'Z Online Bank · M2→M4 SWIFT/RTGS outbound suspense',
+    },
+  };
+  return pairs[`${from}-${to}`] ?? null;
+}
+
+/** Ordered layer hops for Z Online Bank M0→M4 settlement. */
+export function zBankM0ToM4Hops(includeM3: boolean): { from: MoneyLayer; to: MoneyLayer }[] {
+  const hops: { from: MoneyLayer; to: MoneyLayer }[] = [
+    { from: 'M0', to: 'M1' },
+    { from: 'M1', to: 'M2' },
+  ];
+  if (includeM3) {
+    hops.push({ from: 'M2', to: 'M3' }, { from: 'M3', to: 'M4' });
+  } else {
+    hops.push({ from: 'M2', to: 'M4' });
+  }
+  return hops;
+}
+
 /** M4 outbound SWIFT/RTGS: move M1/M2 into GL 1000 settlement suspense while in flight. */
 export function resolveM4OutboundJournal(moneyLayers: MoneyLayer[], gl: {
   glM1: string;
diff --git a/packages/settlement-core/src/types.ts b/packages/settlement-core/src/types.ts
index ed6d535..a992136 100644
--- a/packages/settlement-core/src/types.ts
+++ b/packages/settlement-core/src/types.ts
@@ -90,6 +90,30 @@ export type TransferRequest = {
   currency?: string;
 };
 
+export type ZBankLayerStep = {
+  from: MoneyLayer;
+  to: MoneyLayer;
+  debitGl: string;
+  creditGl: string;
+  journalRef?: string;
+  status: 'pending' | 'posted' | 'skipped' | 'failed';
+};
+
+export type ZBankM0M4Request = {
+  idempotencyKey: string;
+  officeId?: number;
+  valueDate?: string;
+  currency: string;
+  amount: string;
+  creditorIban: string;
+  creditorBic?: string;
+  beneficiaryName?: string;
+  remittanceInfo?: string;
+  /** When set, M2→M3 hop posts GL + requests Chain 138 mint */
+  recipientAddress?: string;
+  tokenLineId?: string;
+};
+
 export type SettlementRecord = {
   settlementId: string;
   idempotencyKey: string;
@@ -100,6 +124,7 @@ export type SettlementRecord = {
   iso20022MessageId?: string;
   chainTxHash?: string;
   verbiageDocument?: string;
+  layerSteps?: ZBankLayerStep[];
   errors: string[];
   createdAt: string;
   updatedAt: string;
diff --git a/script/z-chain/DeployZChainEmoney.s.sol b/script/z-chain/DeployZChainEmoney.s.sol
new file mode 100644
index 0000000..84fd7eb
--- /dev/null
+++ b/script/z-chain/DeployZChainEmoney.s.sol
@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+import "forge-std/Script.sol";
+import "forge-std/console.sol";
+import "../../contracts/z-chain/ZChainUSDC.sol";
+import "../../contracts/emoney/AccountWalletRegistry.sol";
+
+/**
+ * @title DeployZChainEmoney
+ * @notice Deploys cUSDC + AccountWalletRegistry on Z Chain (900002)
+ */
+contract DeployZChainEmoney is Script {
+    function run() external {
+        uint256 deployerPrivateKey = vm.envUint("PRIVATE_KEY");
+        address deployer = vm.addr(deployerPrivateKey);
+        string memory rpcUrl = vm.envOr("CHAIN_900002_RPC_URL", string("http://127.0.0.1:8546"));
+
+        console.log("Deployer:", deployer);
+        console.log("RPC URL:", rpcUrl);
+        console.log("Chain ID: 900002");
+
+        vm.startBroadcast(deployerPrivateKey);
+
+        ZChainUSDC cUsdc = new ZChainUSDC(deployer);
+        AccountWalletRegistry registry = new AccountWalletRegistry(deployer);
+
+        vm.stopBroadcast();
+
+        console.log("\n=== Z Chain deployment ===");
+        console.log("cUSDC:", address(cUsdc));
+        console.log("AccountWalletRegistry:", address(registry));
+        console.log("\nUpdate config/z-chain-deployed.v1.json and hybx-omnl-cross-chain-lines.json chains.900002");
+    }
+}
diff --git a/scripts/deployment/activate-omnl-production.sh b/scripts/deployment/activate-omnl-production.sh
index d1eadab..d10c77c 100644
--- a/scripts/deployment/activate-omnl-production.sh
+++ b/scripts/deployment/activate-omnl-production.sh
@@ -81,7 +81,8 @@ log "  Central Bank:   https://secure.d-bis.org/central-bank"
 log "  Online banking: https://online.omdnl.org/central-bank"
 log "  Office 24:      https://office24.omdnl.org/office-24"
 log "  DBIS Trade:     https://exchange.d-bis.org/trade"
-log "  Digital Swap:   https://digital.omdnl.org/swap"
+log "  Digital Swap:   https://exchange.omdnl.org/trade (OMNL) | Z: https://zblockchainsystem.com/swap"
+log "  Z Ecosystem:    https://zblockchainsystem.com/z (separate product)"
 log "=== Health ==="
 curl -sf http://127.0.0.1:3011/api/v1/settlement/health | head -c 120 || true
 echo
diff --git a/scripts/deployment/activate-swift-production.sh b/scripts/deployment/activate-swift-production.sh
new file mode 100644
index 0000000..691560f
--- /dev/null
+++ b/scripts/deployment/activate-swift-production.sh
@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# Activate full SWIFT stack for Central Bank + Office 24 + Z Online Bank (production).
+set -euo pipefail
+
+REPO_DIR="${OMNL_BANK_ROOT:-$HOME/smom-dbis-138}"
+ENV_FILE="${OMNL_BANK_ENV:-$REPO_DIR/.env}"
+LISTENER_URL="${SWIFT_LISTENER_URL:-http://127.0.0.1:8788}"
+SETTLEMENT_BASE="${SETTLEMENT_HEALTH_URL:-https://secure.omdnl.org/settlement}"
+
+log() { echo "[$(date -Iseconds)] swift-activate $*"; }
+fail() { log "FAIL: $*"; exit 1; }
+
+[[ -f "$ENV_FILE" ]] || fail "Missing $ENV_FILE — load zardasht handoff first (chmod 600)"
+
+set -a
+# shellcheck disable=SC1090
+source "$ENV_FILE"
+set +a
+
+: "${OMNL_FINERACT_BASE_URL:?Set OMNL_FINERACT_BASE_URL}"
+: "${OMNL_FINERACT_PASSWORD:?Set OMNL_FINERACT_PASSWORD}"
+: "${OMNL_SUPER_ADMIN_OFFICE24_KEY:?Set OMNL_SUPER_ADMIN_OFFICE24_KEY}"
+
+export SETTLEMENT_MIDDLEWARE_CONFIG="${SETTLEMENT_MIDDLEWARE_CONFIG:-$REPO_DIR/config/settlement-middleware.production.v1.json}"
+export SWIFT_LISTENER_URL="${SWIFT_LISTENER_URL:-$LISTENER_URL}"
+export SETTLEMENT_ALLOW_HYBX_PRODUCTION="${SETTLEMENT_ALLOW_HYBX_PRODUCTION:-1}"
+export OMNL_PUBLIC_MONEY_SUPPLY="${OMNL_PUBLIC_MONEY_SUPPLY:-1}"
+
+log "1/5 Start SWIFT listener..."
+bash "$REPO_DIR/scripts/deployment/start-swift-listener-production.sh"
+
+log "2/5 Settlement health + Office 24..."
+health="$(curl -sS "${SETTLEMENT_BASE}/health")"
+echo "$health" | grep -q '"officeId":24' || fail "Office 24 not bound on settlement health"
+echo "$health" | grep -q '"status":"ok"' || fail "Settlement health not ok"
+
+log "3/5 Public money supply (Fineract live)..."
+ms="$(curl -sS "${SETTLEMENT_BASE}/public/money-supply")"
+echo "$ms" | grep -q 'fineractLive' || log "WARN: fineractLive not in money-supply response"
+
+log "4/5 SWIFT auth probe (empty external-transfer — expect validation error)..."
+code="$(curl -sS -o /tmp/swift-probe.json -w '%{http_code}' \
+  -X POST "${SETTLEMENT_BASE}/external-transfer" \
+  -H "Authorization: Bearer ${OMNL_SUPER_ADMIN_OFFICE24_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{}')"
+[[ "$code" == "400" || "$code" == "500" ]] || fail "external-transfer auth probe HTTP $code (expected 400/500)"
+grep -qi idempotencyKey /tmp/swift-probe.json || fail "Auth probe missing validation message"
+
+log "5/5 Inbound SWIFT stub (MT103 → listener)..."
+MT103='{1:F01OMNLUS33XXXX}{2:I103BANKUS33XXXXN}{4:
+:20:SWIFT-ACTIVATE-TEST
+:32A:260703USD1,00
+:59:/IQ98ZARD00000000000000000001
+Test Beneficiary
+:70:OMNL SWIFT activate probe chain138 cWUSDC
+-}'
+curl -sS -o /dev/null -w "listener=%{http_code}\n" \
+  -X POST "${SWIFT_LISTENER_URL}/inbound" \
+  -H "Content-Type: text/plain" \
+  ${SWIFT_LISTENER_WEBHOOK_TOKEN:+-H "Authorization: Bearer ${SWIFT_LISTENER_WEBHOOK_TOKEN}"} \
+  --data-binary "$MT103"
+
+log "SWIFT production stack active"
+log "  Listener:  ${SWIFT_LISTENER_URL}/health"
+log "  Settlement: ${SETTLEMENT_BASE}/health"
+log "  Portal:     /central-bank#z-settlement-protocols (MT102/MT103/SBLC/BG)"
+log "  Catalog:    config/swift-mt-catalog.v1.json"
+log ""
+log "MT types: MT103 MT102 MT202 MT910 MT940 MT942 MT950 + ISO20022 pacs/camt"
+log "Redeploy banking LXCs: bash scripts/deployment/deploy-omnl-bank-production.sh"
diff --git a/scripts/deployment/bootstrap-z-chain-anvil.ps1 b/scripts/deployment/bootstrap-z-chain-anvil.ps1
new file mode 100644
index 0000000..26d406d
--- /dev/null
+++ b/scripts/deployment/bootstrap-z-chain-anvil.ps1
@@ -0,0 +1,11 @@
+# Local Z Chain without Docker — Anvil (chainId 900002)
+$ErrorActionPreference = "Stop"
+$RpcPort = if ($env:Z_CHAIN_RPC_PORT) { $env:Z_CHAIN_RPC_PORT } else { "8546" }
+
+if (-not (Get-Command anvil -ErrorAction SilentlyContinue)) {
+  Write-Error "Install Foundry (anvil): https://book.getfoundry.sh/getting-started/installation"
+}
+
+Write-Host "Starting Anvil as Z Chain on http://127.0.0.1:$RpcPort (chainId 900002)"
+Write-Host "Use Anvil account #0 private key as PRIVATE_KEY for deploy."
+anvil --chain-id 900002 --port $RpcPort --host 127.0.0.1
diff --git a/scripts/deployment/bootstrap-z-chain-anvil.sh b/scripts/deployment/bootstrap-z-chain-anvil.sh
new file mode 100644
index 0000000..0393777
--- /dev/null
+++ b/scripts/deployment/bootstrap-z-chain-anvil.sh
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Local Z Chain without Docker — Anvil (chainId 900002) for contract deploy / wallet dev.
+set -euo pipefail
+
+RPC_PORT="${Z_CHAIN_RPC_PORT:-8546}"
+CHAIN_ID=900002
+
+if ! command -v anvil &>/dev/null; then
+  echo "ERROR: install Foundry (anvil) — https://book.getfoundry.sh/getting-started/installation"
+  exit 1
+fi
+
+echo "Starting Anvil as Z Chain on http://127.0.0.1:$RPC_PORT (chainId $CHAIN_ID)"
+echo "Account #0 private key is printed by Anvil — use as PRIVATE_KEY for deploy."
+echo ""
+exec anvil --chain-id "$CHAIN_ID" --port "$RPC_PORT" --host 127.0.0.1
diff --git a/scripts/deployment/bootstrap-z-chain-local.ps1 b/scripts/deployment/bootstrap-z-chain-local.ps1
new file mode 100644
index 0000000..ad10422
--- /dev/null
+++ b/scripts/deployment/bootstrap-z-chain-local.ps1
@@ -0,0 +1,66 @@
+# Bootstrap local Z Chain (chainId 900002) with Hyperledger Besu via Docker.
+$ErrorActionPreference = "Stop"
+
+$Root = (Resolve-Path (Join-Path $PSScriptRoot "..\..")).Path
+$NetworkDir = if ($env:Z_CHAIN_NETWORK_DIR) { $env:Z_CHAIN_NETWORK_DIR } else { Join-Path $Root "logs\z-chain-network" }
+$GenesisConfig = Join-Path $Root "config\z-chain-network-config.json"
+$RpcPort = if ($env:Z_CHAIN_RPC_PORT) { $env:Z_CHAIN_RPC_PORT } else { "8546" }
+$ContainerName = if ($env:Z_CHAIN_BESU_CONTAINER) { $env:Z_CHAIN_BESU_CONTAINER } else { "z-chain-besu" }
+
+try {
+  docker info 2>&1 | Out-Null
+  if ($LASTEXITCODE -ne 0) { throw "Docker daemon not running" }
+} catch {
+  Write-Error "Docker is installed but not running. Start Docker Desktop or run: scripts\deployment\complete-z-chain.ps1 (Hardhat fallback)"
+}
+
+if (-not (Test-Path $GenesisConfig)) {
+  Write-Error "Missing $GenesisConfig"
+}
+
+New-Item -ItemType Directory -Force -Path $NetworkDir | Out-Null
+
+$GenesisOut = Join-Path $NetworkDir "genesis.json"
+if (-not (Test-Path $GenesisOut)) {
+  Write-Host "Generating IBFT2 network files in $NetworkDir ..."
+  docker run --rm `
+    -v "${Root}\config:/config:ro" `
+    -v "${NetworkDir}:/network" `
+    hyperledger/besu:latest `
+    operator generate-blockchain-config `
+      --config-file=/config/z-chain-network-config.json `
+      --to=/network
+}
+
+$existing = docker ps -a --format "{{.Names}}" 2>$null | Where-Object { $_ -eq $ContainerName }
+if ($existing) {
+  Write-Host "Removing existing container $ContainerName ..."
+  docker rm -f $ContainerName | Out-Null
+}
+
+$NodeKey = Join-Path $NetworkDir "keys\node1\key"
+if (-not (Test-Path $NodeKey) -or -not (Test-Path $GenesisOut)) {
+  Write-Error "Generated network files missing under $NetworkDir"
+}
+
+Write-Host "Starting Z Chain Besu on http://127.0.0.1:$RpcPort (chainId 900002) ..."
+docker run -d `
+  --name $ContainerName `
+  -p "${RpcPort}:8545" `
+  -v "${NetworkDir}:/network:ro" `
+  hyperledger/besu:latest `
+  --data-path=/tmp/besu `
+  --genesis-file=/network/genesis.json `
+  --node-private-key-file=/network/keys/node1/key `
+  --rpc-http-enabled `
+  --rpc-http-api=ETH,NET,WEB3,IBFT,ADMIN,DEBUG `
+  --rpc-http-host=0.0.0.0 `
+  --rpc-http-port=8545 `
+  --rpc-http-cors-origins="*" `
+  --host-allowlist="*" `
+  --min-gas-price=0 | Out-Null
+
+Write-Host ""
+Write-Host "Z Chain local RPC: http://127.0.0.1:$RpcPort"
+Write-Host 'Set env: CHAIN_900002_RPC_URL=http://127.0.0.1:' + $RpcPort
+Write-Host 'Set env: VITE_RPC_URL_900002=http://127.0.0.1:' + $RpcPort
diff --git a/scripts/deployment/bootstrap-z-chain-local.sh b/scripts/deployment/bootstrap-z-chain-local.sh
new file mode 100644
index 0000000..f45eec2
--- /dev/null
+++ b/scripts/deployment/bootstrap-z-chain-local.sh
@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Bootstrap local Z Chain (chainId 900002) with Hyperledger Besu via Docker.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+NETWORK_DIR="${Z_CHAIN_NETWORK_DIR:-$ROOT/logs/z-chain-network}"
+GENESIS_CONFIG="$ROOT/config/z-chain-network-config.json"
+RPC_PORT="${Z_CHAIN_RPC_PORT:-8546}"
+CONTAINER_NAME="${Z_CHAIN_BESU_CONTAINER:-z-chain-besu}"
+
+cd "$ROOT"
+
+if ! command -v docker &>/dev/null; then
+  echo "ERROR: docker is required. Install Docker and retry."
+  exit 1
+fi
+
+if [[ ! -f "$GENESIS_CONFIG" ]]; then
+  echo "ERROR: missing $GENESIS_CONFIG"
+  exit 1
+fi
+
+mkdir -p "$NETWORK_DIR"
+
+if [[ ! -f "$NETWORK_DIR/genesis.json" ]]; then
+  echo "Generating IBFT2 network files in $NETWORK_DIR ..."
+  docker run --rm \
+    -v "$ROOT/config:/config:ro" \
+    -v "$NETWORK_DIR:/network" \
+    hyperledger/besu:latest \
+    operator generate-blockchain-config \
+      --config-file=/config/z-chain-network-config.json \
+      --to=/network
+fi
+
+if docker ps -a --format '{{.Names}}' | grep -qx "$CONTAINER_NAME"; then
+  echo "Removing existing container $CONTAINER_NAME ..."
+  docker rm -f "$CONTAINER_NAME" >/dev/null
+fi
+
+NODE_KEY="$NETWORK_DIR/keys/node1/key"
+GENESIS="$NETWORK_DIR/genesis.json"
+
+if [[ ! -f "$NODE_KEY" || ! -f "$GENESIS" ]]; then
+  echo "ERROR: generated network files missing under $NETWORK_DIR"
+  exit 1
+fi
+
+echo "Starting Z Chain Besu on http://127.0.0.1:$RPC_PORT (chainId 900002) ..."
+docker run -d \
+  --name "$CONTAINER_NAME" \
+  -p "${RPC_PORT}:8545" \
+  -v "$NETWORK_DIR:/network:ro" \
+  hyperledger/besu:latest \
+  --data-path=/tmp/besu \
+  --genesis-file=/network/genesis.json \
+  --node-private-key-file=/network/keys/node1/key \
+  --rpc-http-enabled \
+  --rpc-http-api=ETH,NET,WEB3,IBFT,ADMIN,DEBUG \
+  --rpc-http-host=0.0.0.0 \
+  --rpc-http-port=8545 \
+  --rpc-http-cors-origins="*" \
+  --host-allowlist="*" \
+  --min-gas-price=0
+
+echo ""
+echo "Z Chain local RPC: http://127.0.0.1:$RPC_PORT"
+echo "Export: CHAIN_900002_RPC_URL=http://127.0.0.1:$RPC_PORT"
+echo "Export: VITE_RPC_URL_900002=http://127.0.0.1:$RPC_PORT"
+echo "Verify: cast chain-id --rpc-url http://127.0.0.1:$RPC_PORT"
diff --git a/scripts/deployment/bootstrap-z-chain-production.sh b/scripts/deployment/bootstrap-z-chain-production.sh
new file mode 100644
index 0000000..64125be
--- /dev/null
+++ b/scripts/deployment/bootstrap-z-chain-production.sh
@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Production Z Chain Besu bootstrap (chainId 900002) on a banking LXC or VM.
+# Generates IBFT2 keys once, then runs Besu with persistent data under /opt/besu-z-chain.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+NETWORK_DIR="${Z_CHAIN_NETWORK_DIR:-/opt/besu-z-chain/network}"
+DATA_PATH="${Z_CHAIN_DATA_PATH:-/opt/besu-z-chain/data}"
+GENESIS_CONFIG="$ROOT/config/z-chain-network-config.json"
+RPC_PORT="${Z_CHAIN_RPC_PORT:-8546}"
+CONTAINER_NAME="${Z_CHAIN_BESU_CONTAINER:-z-chain-besu-prod}"
+
+if [[ $EUID -ne 0 ]]; then
+  echo "Run as root on the target host (or use sudo)."
+  exit 1
+fi
+
+if ! command -v docker &>/dev/null; then
+  echo "ERROR: docker required on production host"
+  exit 1
+fi
+
+mkdir -p "$NETWORK_DIR" "$DATA_PATH"
+
+if [[ ! -f "$NETWORK_DIR/genesis.json" ]]; then
+  echo "Generating IBFT2 network files in $NETWORK_DIR ..."
+  docker run --rm \
+    -v "$ROOT/config:/config:ro" \
+    -v "$NETWORK_DIR:/network" \
+    hyperledger/besu:latest \
+    operator generate-blockchain-config \
+      --config-file=/config/z-chain-network-config.json \
+      --to=/network
+fi
+
+docker rm -f "$CONTAINER_NAME" 2>/dev/null || true
+
+echo "Starting production Z Chain Besu on 0.0.0.0:$RPC_PORT ..."
+docker run -d \
+  --name "$CONTAINER_NAME" \
+  --restart unless-stopped \
+  -p "127.0.0.1:${RPC_PORT}:8545" \
+  -v "$NETWORK_DIR:/network:ro" \
+  -v "$DATA_PATH:/data" \
+  hyperledger/besu:latest \
+  --data-path=/data \
+  --genesis-file=/network/genesis.json \
+  --node-private-key-file=/network/keys/node1/key \
+  --rpc-http-enabled \
+  --rpc-http-api=ETH,NET,WEB3,IBFT,ADMIN \
+  --rpc-http-host=127.0.0.1 \
+  --rpc-http-port=8545 \
+  --host-allowlist="*" \
+  --min-gas-price=0
+
+echo ""
+echo "Production Z Chain RPC (localhost): http://127.0.0.1:$RPC_PORT"
+echo "Expose via nginx/Cloudflare as https://rpc.zblockchainsystem.com"
+echo "Z portal: https://zblockchainsystem.com"
diff --git a/scripts/deployment/build-z-ecosystem-stack.sh b/scripts/deployment/build-z-ecosystem-stack.sh
new file mode 100644
index 0000000..a4b9c44
--- /dev/null
+++ b/scripts/deployment/build-z-ecosystem-stack.sh
@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# Build and start Z Ecosystem stack only (no OMNL portal deploy).
+set -euo pipefail
+
+REPO_DIR="${Z_ECOSYSTEM_ROOT:-$HOME/smom-dbis-138}"
+LOG_DIR="${Z_ECOSYSTEM_LOG_DIR:-$HOME/z-ecosystem/logs}"
+ENV_FILE="${Z_ECOSYSTEM_ENV:-$REPO_DIR/config/z-ecosystem.local.env}"
+FRONTEND_PORT="${Z_ECOSYSTEM_FRONTEND_PORT:-3002}"
+API_PORT="${Z_TOKEN_AGGREGATION_PORT:-${PORT:-3000}}"
+
+log() { echo "[$(date -Iseconds)] $*"; }
+
+mkdir -p "$LOG_DIR"
+cd "$REPO_DIR"
+
+if [[ -f "$REPO_DIR/.env" ]]; then
+  set -a; set +u; source "$REPO_DIR/.env"; set -u; set +a
+fi
+if [[ -f "$ENV_FILE" ]]; then
+  set -a; set +u; source "$ENV_FILE"; set -u; set +a
+fi
+
+export VITE_ECOSYSTEM=z
+export VITE_ENABLE_Z_WALLET=true
+export OMNL_SUPPORTED_CHAINS_CONFIG="${Z_SUPPORTED_CHAINS_CONFIG:-$REPO_DIR/config/z-supported-chains.v1.json}"
+export SETTLEMENT_MIDDLEWARE_CONFIG="${SETTLEMENT_MIDDLEWARE_CONFIG:-$REPO_DIR/config/settlement-middleware.production.v1.json}"
+export CHAIN_900002_RPC_URL="${CHAIN_900002_RPC_URL:-https://rpc.zblockchainsystem.com}"
+export VITE_RPC_URL_900002="${VITE_RPC_URL_900002:-$CHAIN_900002_RPC_URL}"
+export VITE_Z_CHAIN_EXPLORER_URL="${VITE_Z_CHAIN_EXPLORER_URL:-https://explorer.zblockchainsystem.com}"
+export VITE_Z_ECOSYSTEM_URL="${VITE_Z_ECOSYSTEM_URL:-https://zblockchainsystem.com}"
+export VITE_TOKEN_AGGREGATION_URL="${VITE_TOKEN_AGGREGATION_URL:-/api/v1}"
+export VITE_SETTLEMENT_MIDDLEWARE_URL="${VITE_SETTLEMENT_MIDDLEWARE_URL:-/settlement}"
+export VITE_DBIS_EXCHANGE_URL="${VITE_DBIS_EXCHANGE_URL:-/exchange}"
+
+build_pkg() {
+  local dir="$1"
+  log "Building $dir..."
+  cd "$REPO_DIR/$dir"
+  NODE_ENV=development npm install --no-fund --no-audit
+  npm run build
+}
+
+for dir in packages/integration-foundation packages/settlement-core \
+  services/token-aggregation services/settlement-middleware services/dbis-exchange; do
+  build_pkg "$dir"
+done
+
+log "Building Z frontend (VITE_ECOSYSTEM=z)..."
+cd "$REPO_DIR/frontend-dapp"
+unset VITE_OMNL_API_KEY
+if command -v pnpm >/dev/null 2>&1; then
+  pnpm install --frozen-lockfile 2>/dev/null || pnpm install
+  VITE_ECOSYSTEM=z pnpm run build:z
+else
+  npm install
+  VITE_ECOSYSTEM=z npm run build:z
+fi
+
+start_svc() {
+  local name="$1"
+  local dir="$2"
+  local port="$3"
+  local cmd="$4"
+  log "Starting $name on :$port"
+  cd "$REPO_DIR/$dir"
+  pkill -f "smom-dbis-138/$dir" 2>/dev/null || true
+  fuser -k "${port}/tcp" 2>/dev/null || true
+  sleep 1
+  nohup env \
+    SETTLEMENT_MIDDLEWARE_CONFIG="$SETTLEMENT_MIDDLEWARE_CONFIG" \
+    OMNL_SUPPORTED_CHAINS_CONFIG="$OMNL_SUPPORTED_CHAINS_CONFIG" \
+    Z_SUPPORTED_CHAINS_CONFIG="$OMNL_SUPPORTED_CHAINS_CONFIG" \
+    PORT="$port" \
+    TOKEN_AGGREGATION_URL="${TOKEN_AGGREGATION_URL:-http://127.0.0.1:$port}" \
+    CHAIN_900002_RPC_URL="$CHAIN_900002_RPC_URL" \
+    AZURE_OPENAI_ENDPOINT="${AZURE_OPENAI_ENDPOINT:-}" \
+    AZURE_OPENAI_API_KEY="${AZURE_OPENAI_API_KEY:-}" \
+    AZURE_OPENAI_DEPLOYMENT="${AZURE_OPENAI_DEPLOYMENT:-}" \
+    AZURE_OPENAI_API_VERSION="${AZURE_OPENAI_API_VERSION:-2024-02-15-preview}" \
+    bash -c "$cmd" >"$LOG_DIR/$name.log" 2>&1 &
+  echo $! >"$LOG_DIR/$name.pid"
+}
+
+start_svc token-aggregation services/token-aggregation "$API_PORT" "npm run start"
+sleep 2
+start_svc settlement-middleware services/settlement-middleware 3011 "npm run start"
+sleep 2
+start_svc dbis-exchange services/dbis-exchange 3012 "npm run start"
+sleep 2
+
+pkill -f "serve -s.*$FRONTEND_PORT" 2>/dev/null || true
+cd "$REPO_DIR/frontend-dapp"
+nohup npx --yes serve -s dist -l "$FRONTEND_PORT" >"$LOG_DIR/frontend.log" 2>&1 &
+echo $! >"$LOG_DIR/frontend.pid"
+
+sleep 5
+log "Z health checks..."
+curl -sf "http://127.0.0.1:$API_PORT/api/v1/z-bot/health" | head -c 200 || true
+echo
+curl -sf "http://127.0.0.1:3011/api/v1/settlement/health" | head -c 200 || true
+echo
+curl -sf -o /dev/null -w "z-hub=%{http_code}\n" "http://127.0.0.1:$FRONTEND_PORT/z"
+curl -sf -o /dev/null -w "z-wallet=%{http_code}\n" "http://127.0.0.1:$FRONTEND_PORT/z-wallet"
+log "Z stack ready on :$FRONTEND_PORT"
diff --git a/scripts/deployment/complete-z-chain.ps1 b/scripts/deployment/complete-z-chain.ps1
new file mode 100644
index 0000000..00269cd
--- /dev/null
+++ b/scripts/deployment/complete-z-chain.ps1
@@ -0,0 +1,90 @@
+# Complete Z Chain local setup: RPC node + contract deploy + config sync.
+# Uses Docker Besu when available; otherwise Hardhat node chainId 900002.
+$ErrorActionPreference = "Stop"
+
+$Root = (Resolve-Path (Join-Path $PSScriptRoot "..\..")).Path
+$RpcPort = if ($env:Z_CHAIN_RPC_PORT) { $env:Z_CHAIN_RPC_PORT } else { "8546" }
+$RpcUrl = "http://127.0.0.1:$RpcPort"
+$NodeLog = Join-Path $Root "logs\z-chain-node.log"
+$ErrLog = Join-Path $Root "logs\z-chain-node.err.log"
+$PidFile = Join-Path $Root "logs\z-chain-node.pid"
+
+Set-Location $Root
+New-Item -ItemType Directory -Force -Path (Join-Path $Root "logs") | Out-Null
+
+function Test-RpcReady {
+  try {
+    $body = '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
+    $r = Invoke-RestMethod -Uri $RpcUrl -Method Post -Body $body -ContentType "application/json" -TimeoutSec 2
+    return ($r.result -eq "0xdbba2")
+  } catch {
+    return $false
+  }
+}
+
+function Stop-ZChainNode {
+  if (Test-Path $PidFile) {
+    $oldPid = Get-Content $PidFile -ErrorAction SilentlyContinue
+    if ($oldPid) {
+      Stop-Process -Id $oldPid -Force -ErrorAction SilentlyContinue
+    }
+    Remove-Item $PidFile -Force -ErrorAction SilentlyContinue
+  }
+  try {
+    docker rm -f z-chain-besu 2>$null | Out-Null
+  } catch {}
+  $conn = Get-NetTCPConnection -LocalPort $RpcPort -ErrorAction SilentlyContinue | Select-Object -First 1
+  if ($conn -and $conn.OwningProcess) {
+    Stop-Process -Id $conn.OwningProcess -Force -ErrorAction SilentlyContinue
+    Start-Sleep -Seconds 2
+  }
+}
+
+$dockerOk = $false
+try {
+  docker info 2>&1 | Out-Null
+  if ($LASTEXITCODE -eq 0) { $dockerOk = $true }
+} catch {}
+
+Stop-ZChainNode
+
+if ($dockerOk) {
+  Write-Host "Starting Z Chain via Docker Besu ..."
+  & "$PSScriptRoot\bootstrap-z-chain-local.ps1"
+} else {
+  $env:Z_CHAIN_LOCAL = "1"
+  $hardhat = Join-Path $Root "node_modules\.bin\hardhat.cmd"
+  $nodeCmd = "set Z_CHAIN_LOCAL=1&& `"$hardhat`" node --port $RpcPort --hostname 127.0.0.1"
+  $nodeProc = Start-Process -FilePath "cmd.exe" -ArgumentList @("/c", $nodeCmd) -WorkingDirectory $Root -PassThru -WindowStyle Hidden -RedirectStandardOutput $NodeLog -RedirectStandardError $ErrLog
+  $nodeProc.Id | Set-Content $PidFile
+  Start-Sleep -Seconds 8
+}
+
+$deadline = (Get-Date).AddSeconds(90)
+while (-not (Test-RpcReady)) {
+  if ((Get-Date) -gt $deadline) {
+    Write-Error "Z Chain RPC not ready at $RpcUrl after 90s. See $NodeLog and $ErrLog"
+  }
+  Start-Sleep -Seconds 2
+}
+Write-Host "Z Chain RPC ready at $RpcUrl"
+
+$env:CHAIN_900002_RPC_URL = $RpcUrl
+$env:Z_CHAIN_LOCAL = "1"
+if (-not $env:PRIVATE_KEY) {
+  $env:PRIVATE_KEY = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
+}
+
+Write-Host "Compiling Z Chain contracts ..."
+npx hardhat compile --config hardhat.zchain.config.js 2>&1 | Out-Null
+if ($LASTEXITCODE -ne 0) { throw "zchain compile failed" }
+
+Write-Host "Deploying Z Chain contracts ..."
+npx hardhat run scripts/deployment/deploy-z-chain-contracts.js --network zchain --config hardhat.zchain.config.js
+if ($LASTEXITCODE -ne 0) { throw "contract deploy failed" }
+
+Write-Host ""
+Write-Host "Z Chain setup complete."
+Write-Host "  RPC: $RpcUrl"
+Write-Host "  Set VITE_ENABLE_Z_WALLET=true and VITE_RPC_URL_900002=$RpcUrl"
+Write-Host "  Updated config/z-chain-deployed.v1.json"
diff --git a/scripts/deployment/deploy-omnl-bank-production.sh b/scripts/deployment/deploy-omnl-bank-production.sh
index fbbeb6d..00ee8f2 100644
--- a/scripts/deployment/deploy-omnl-bank-production.sh
+++ b/scripts/deployment/deploy-omnl-bank-production.sh
@@ -93,13 +93,18 @@ build_pkg() {
   local dir="$1"
   log "Building $dir..."
   cd "$REPO_DIR/$dir"
-  npm install --no-fund --no-audit
+  NODE_ENV=development npm install --no-fund --no-audit
   npm run build
 }
 
 for dir in packages/integration-foundation packages/settlement-core \
-  services/token-aggregation services/settlement-middleware services/dbis-exchange; do
-  build_pkg "$dir"
+  services/token-aggregation services/settlement-middleware services/dbis-exchange \
+  services/swift-listener; do
+  if [[ "$dir" == "services/swift-listener" ]]; then
+    build_pkg "$dir" || log "WARN: swift-listener build skipped — SWIFT inbound may use existing dist"
+  else
+    build_pkg "$dir"
+  fi
 done
 
 log "Building frontend..."
@@ -107,14 +112,17 @@ cd "$REPO_DIR/frontend-dapp"
 export VITE_TOKEN_AGGREGATION_URL="${VITE_TOKEN_AGGREGATION_URL:-/api/v1}"
 export VITE_SETTLEMENT_MIDDLEWARE_URL="${VITE_SETTLEMENT_MIDDLEWARE_URL:-/settlement}"
 export VITE_DBIS_EXCHANGE_URL="${VITE_DBIS_EXCHANGE_URL:-/exchange}"
+export VITE_ECOSYSTEM="${VITE_ECOSYSTEM:-omnl}"
+export VITE_ENABLE_Z_WALLET="${VITE_ENABLE_Z_WALLET:-false}"
+unset VITE_RPC_URL_900002 VITE_Z_CHAIN_EXPLORER_URL VITE_Z_ECOSYSTEM_URL
 # Never embed operator API keys in production frontend — nginx injects server-side.
 unset VITE_OMNL_API_KEY
 if command -v pnpm >/dev/null 2>&1; then
   pnpm install --frozen-lockfile 2>/dev/null || pnpm install
-  pnpm run build
+  VITE_ECOSYSTEM=omnl pnpm run build:omnl
 else
   npm install
-  npm run build
+  VITE_ECOSYSTEM=omnl npm run build:omnl
 fi
 
 start_svc() {
@@ -153,9 +161,14 @@ start_svc() {
     OMNL_ALLOW_CHAIN_MINT_EXECUTE="${OMNL_ALLOW_CHAIN_MINT_EXECUTE:-1}" \
     TOKEN_AGGREGATION_URL="${TOKEN_AGGREGATION_URL:-http://127.0.0.1:3000}" \
     HYBX_MIFOS_FINERACT_SIDECAR_URL="${HYBX_MIFOS_FINERACT_SIDECAR_URL:-}" \
-    SWIFT_LISTENER_URL="${SWIFT_LISTENER_URL:-}" \
+    SWIFT_LISTENER_URL="${SWIFT_LISTENER_URL:-http://127.0.0.1:8788}" \
     RPC_URL_138="${RPC_URL_138:-${CHAIN_138_RPC_URL:-}}" \
     CHAIN_138_RPC_URL="${CHAIN_138_RPC_URL:-${RPC_URL_138:-}}" \
+    CHAIN_900002_RPC_URL="${CHAIN_900002_RPC_URL:-}" \
+    AZURE_OPENAI_ENDPOINT="${AZURE_OPENAI_ENDPOINT:-}" \
+    AZURE_OPENAI_API_KEY="${AZURE_OPENAI_API_KEY:-}" \
+    AZURE_OPENAI_DEPLOYMENT="${AZURE_OPENAI_DEPLOYMENT:-}" \
+    AZURE_OPENAI_API_VERSION="${AZURE_OPENAI_API_VERSION:-2024-02-15-preview}" \
     OMNL_MINT_OPERATOR_PRIVATE_KEY="${OMNL_MINT_OPERATOR_PRIVATE_KEY:-}" \
     bash -c "$cmd" >"$LOG_DIR/$name.log" 2>&1 &
   echo $! >"$LOG_DIR/$name.pid"
@@ -168,6 +181,11 @@ sleep 2
 start_svc dbis-exchange services/dbis-exchange 3012 "npm run start"
 sleep 2
 
+if [[ "${OMNL_SWIFT_LISTENER_START:-1}" == "1" ]]; then
+  log "Starting SWIFT listener..."
+  bash "$REPO_DIR/scripts/deployment/start-swift-listener-production.sh" || log "WARN: SWIFT listener start failed"
+fi
+
 FRONTEND_PORT="${OMNL_BANK_FRONTEND_PORT:-3002}"
 pkill -f "serve -s.*$FRONTEND_PORT" 2>/dev/null || true
 cd "$REPO_DIR/frontend-dapp"
@@ -183,6 +201,8 @@ echo
 curl -sf "http://127.0.0.1:3012/api/v1/exchange/health" | head -c 200 || true
 echo
 curl -sf -o /dev/null -w "frontend=%{http_code}\n" "http://127.0.0.1:$FRONTEND_PORT/central-bank"
+curl -sf -o /dev/null -w "hub=%{http_code}\n" "http://127.0.0.1:$FRONTEND_PORT/hub"
+curl -sf "http://127.0.0.1:8788/health" 2>/dev/null | head -c 80 || log "WARN: SWIFT listener :8788 not reachable"
 
 if [[ -n "${DATABASE_URL:-}" ]] && [[ "${SEED_SUPER_ADMIN_USERS:-1}" == "1" ]]; then
   log "Seeding super-admin control-panel users..."
@@ -196,6 +216,7 @@ if [[ -n "${DATABASE_URL:-}" ]] && [[ "${SEED_SUPER_ADMIN_USERS:-1}" == "1" ]];
 fi
 
 log "OMNL Bank deploy complete"
+bash "$REPO_DIR/scripts/deployment/sync-guosmm-notices.sh" || log "WARN: GUOSMM sync check failed"
 log "  Central Bank: http://127.0.0.1:$FRONTEND_PORT/central-bank"
 log "  Office 24:    http://127.0.0.1:$FRONTEND_PORT/office-24"
 log "  DBIS Trade:   http://127.0.0.1:$FRONTEND_PORT/trade"
diff --git a/scripts/deployment/deploy-omnl-banking-portal-pct.sh b/scripts/deployment/deploy-omnl-banking-portal-pct.sh
index f40688a..37f28ea 100755
--- a/scripts/deployment/deploy-omnl-banking-portal-pct.sh
+++ b/scripts/deployment/deploy-omnl-banking-portal-pct.sh
@@ -48,7 +48,9 @@ tar -czf "$STAGE" \
   -C "$REPO_DIR" \
   config \
   frontend-dapp/dist \
+  packages/integration-foundation/package.json \
   packages/integration-foundation/dist \
+  packages/settlement-core/package.json \
   packages/settlement-core/dist \
   services/token-aggregation/dist \
   services/token-aggregation/package.json \
diff --git a/scripts/deployment/deploy-omnl-domains.sh b/scripts/deployment/deploy-omnl-domains.sh
index b656be6..2a4e644 100644
--- a/scripts/deployment/deploy-omnl-domains.sh
+++ b/scripts/deployment/deploy-omnl-domains.sh
@@ -42,5 +42,7 @@ check_host secure.d-bis.org /central-bank
 check_host office24.omdnl.org /office-24
 check_host digital.omdnl.org /swap
 
+log "Z Ecosystem domain (separate) — run scripts/deployment/deploy-z-domains.sh"
+
 log "OMNL domain deploy complete"
 log "DNS: point all domains A record to 76.53.10.34 (or Cloudflare proxy to origin)"
diff --git a/scripts/deployment/deploy-z-chain-contracts.js b/scripts/deployment/deploy-z-chain-contracts.js
new file mode 100644
index 0000000..1a506ff
--- /dev/null
+++ b/scripts/deployment/deploy-z-chain-contracts.js
@@ -0,0 +1,74 @@
+const { ethers } = require('hardhat');
+const fs = require('fs');
+const path = require('path');
+require('dotenv').config();
+
+const ROOT = path.resolve(__dirname, '../..');
+
+function syncAddresses(cUsdc, registry) {
+  const today = new Date().toISOString().slice(0, 10);
+
+  const deployedPath = path.join(ROOT, 'config/z-chain-deployed.v1.json');
+  const deployed = JSON.parse(fs.readFileSync(deployedPath, 'utf8'));
+  deployed.updated = today;
+  deployed.status = 'active';
+  deployed.contracts.cUSDC = cUsdc;
+  deployed.contracts.accountWalletRegistry = registry;
+  fs.writeFileSync(deployedPath, `${JSON.stringify(deployed, null, 2)}\n`);
+
+  const integrationPath = path.join(ROOT, 'config/z-chain-integration.v1.json');
+  const integration = JSON.parse(fs.readFileSync(integrationPath, 'utf8'));
+  integration.contracts.cUSDC = cUsdc;
+  integration.contracts.accountWalletRegistry = registry;
+  fs.writeFileSync(integrationPath, `${JSON.stringify(integration, null, 2)}\n`);
+
+  const hybxPath = path.join(ROOT, 'config/hybx-omnl-cross-chain-lines.json');
+  const hybx = JSON.parse(fs.readFileSync(hybxPath, 'utf8'));
+  for (const line of hybx.lines || []) {
+    if (line.chains?.['900002']) {
+      line.chains['900002'].tokenM1 = cUsdc;
+    }
+  }
+  fs.writeFileSync(hybxPath, `${JSON.stringify(hybx, null, 2)}\n`);
+
+  const broadcastDir = path.join(ROOT, 'broadcast/DeployZChainEmoney.s.sol/900002');
+  fs.mkdirSync(broadcastDir, { recursive: true });
+  const broadcast = {
+    transactions: [
+      { contractName: 'ZChainUSDC', contractAddress: cUsdc },
+      { contractName: 'AccountWalletRegistryZ', contractAddress: registry },
+    ],
+  };
+  fs.writeFileSync(path.join(broadcastDir, 'run-latest.json'), `${JSON.stringify(broadcast, null, 2)}\n`);
+
+  console.log('\nConfig updated:');
+  console.log('  cUSDC:', cUsdc);
+  console.log('  AccountWalletRegistry:', registry);
+}
+
+async function main() {
+  const [deployer] = await ethers.getSigners();
+  const network = await ethers.provider.getNetwork();
+  console.log('Deployer:', deployer.address);
+  console.log('Chain ID:', network.chainId.toString());
+  console.log('Balance:', ethers.formatEther(await ethers.provider.getBalance(deployer.address)));
+
+  const ZChainUSDC = await ethers.getContractFactory('ZChainUSDC');
+  const cUsdc = await ZChainUSDC.deploy(deployer.address);
+  await cUsdc.waitForDeployment();
+  const cUsdcAddress = await cUsdc.getAddress();
+  console.log('ZChainUSDC deployed:', cUsdcAddress);
+
+  const AccountWalletRegistry = await ethers.getContractFactory('AccountWalletRegistryZ');
+  const registry = await AccountWalletRegistry.deploy(deployer.address);
+  await registry.waitForDeployment();
+  const registryAddress = await registry.getAddress();
+  console.log('AccountWalletRegistry deployed:', registryAddress);
+
+  syncAddresses(cUsdcAddress, registryAddress);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
diff --git a/scripts/deployment/deploy-z-chain-contracts.sh b/scripts/deployment/deploy-z-chain-contracts.sh
new file mode 100644
index 0000000..c707cc6
--- /dev/null
+++ b/scripts/deployment/deploy-z-chain-contracts.sh
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# Deploy Z Chain contracts (cUSDC + AccountWalletRegistry) on chainId 900002.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+cd "$ROOT"
+
+RPC="${CHAIN_900002_RPC_URL:-http://127.0.0.1:8546}"
+
+if [[ -z "${PRIVATE_KEY:-}" ]]; then
+  echo "ERROR: set PRIVATE_KEY (Besu dev key #1 works for local bootstrap)"
+  exit 1
+fi
+
+echo "Deploying to Z Chain at $RPC ..."
+forge script script/z-chain/DeployZChainEmoney.s.sol:DeployZChainEmoney \
+  --rpc-url "$RPC" \
+  --chain-id 900002 \
+  --broadcast \
+  --profile zchain
+
+echo "Done. Copy deployed addresses into config/z-chain-deployed.v1.json"
+echo "Or run: node scripts/deployment/sync-z-chain-deployed-addresses.mjs"
diff --git a/scripts/deployment/deploy-z-domains.sh b/scripts/deployment/deploy-z-domains.sh
new file mode 100644
index 0000000..aeab118
--- /dev/null
+++ b/scripts/deployment/deploy-z-domains.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Install nginx vhost for Z Ecosystem (zblockchainsystem.com)
+set -euo pipefail
+
+REPO_DIR="${Z_ECOSYSTEM_ROOT:-${OMNL_BANK_ROOT:-$HOME/smom-dbis-138}}"
+VHOST_SRC="$REPO_DIR/deploy/nginx/z-ecosystem-domains.conf"
+VHOST_DST="/etc/nginx/sites-available/z-ecosystem-domains"
+VHOST_LINK="/etc/nginx/sites-enabled/z-ecosystem-domains"
+
+log() { echo "[$(date -Iseconds)] $*"; }
+
+if [ ! -f "$VHOST_SRC" ]; then
+  echo "Missing $VHOST_SRC" >&2
+  exit 1
+fi
+
+log "Installing Z Ecosystem nginx vhost..."
+sudo cp "$VHOST_SRC" "$VHOST_DST"
+SNIPPET_SRC="$REPO_DIR/deploy/nginx/z-ecosystem-common-locations.conf"
+SNIPPET_DST="/etc/nginx/snippets/z-ecosystem-common-locations.conf"
+sudo cp "$SNIPPET_SRC" "$SNIPPET_DST"
+sudo ln -sf "$VHOST_DST" "$VHOST_LINK"
+
+log "Testing nginx..."
+sudo nginx -t
+
+log "Reloading nginx..."
+sudo systemctl reload nginx
+
+check_host() {
+  local host="$1"
+  local expect="$2"
+  local code
+  code=$(curl -s -o /dev/null -w '%{http_code}' -H "Host: $host" "http://127.0.0.1/")
+  log "  $host -> HTTP $code (expect redirect toward $expect)"
+}
+
+check_host zblockchainsystem.com /z
+check_host www.zblockchainsystem.com /z
+
+log "Z domain deploy complete — https://zblockchainsystem.com/z"
diff --git a/scripts/deployment/deploy-z-ecosystem-production.sh b/scripts/deployment/deploy-z-ecosystem-production.sh
new file mode 100644
index 0000000..3e49dbc
--- /dev/null
+++ b/scripts/deployment/deploy-z-ecosystem-production.sh
@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Production deploy: Z Ecosystem on zblockchainsystem.com (separate from OMNL portals).
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+ENV_FILE="${Z_ECOSYSTEM_ENV:-$ROOT/config/z-ecosystem.production.env}"
+PROD_CFG="$ROOT/config/z-chain-production.v1.json"
+DOMAIN_CFG="$ROOT/config/z-ecosystem-production-domains.v1.json"
+
+log() { echo "[$(date -Iseconds)] $*"; }
+
+if [[ -f "$ROOT/.env" ]]; then
+  set -a
+  set +u
+  # shellcheck disable=SC1090
+  source "$ROOT/.env"
+  set -u
+  set +a
+fi
+if [[ -f "$ENV_FILE" ]]; then
+  set -a
+  set +u
+  # shellcheck disable=SC1090
+  source "$ENV_FILE"
+  set -u
+  set +a
+fi
+
+export CHAIN_900002_RPC_URL="${CHAIN_900002_RPC_URL:-https://rpc.zblockchainsystem.com}"
+export VITE_RPC_URL_900002="${VITE_RPC_URL_900002:-$CHAIN_900002_RPC_URL}"
+export VITE_Z_CHAIN_EXPLORER_URL="${VITE_Z_CHAIN_EXPLORER_URL:-https://explorer.zblockchainsystem.com}"
+export VITE_Z_ECOSYSTEM_URL="${VITE_Z_ECOSYSTEM_URL:-https://zblockchainsystem.com}"
+export VITE_ENABLE_Z_WALLET="${VITE_ENABLE_Z_WALLET:-true}"
+export VITE_TOKEN_AGGREGATION_URL="${VITE_TOKEN_AGGREGATION_URL:-/api/v1}"
+export VITE_SETTLEMENT_MIDDLEWARE_URL="${VITE_SETTLEMENT_MIDDLEWARE_URL:-/settlement}"
+export VITE_DBIS_EXCHANGE_URL="${VITE_DBIS_EXCHANGE_URL:-/exchange}"
+
+log "Z Ecosystem production deploy (zblockchainsystem.com)"
+log "  chain:   $PROD_CFG"
+log "  domain:  $DOMAIN_CFG"
+log "  portal:  $VITE_Z_ECOSYSTEM_URL"
+log "  rpc:     $CHAIN_900002_RPC_URL"
+
+if [[ "${Z_CHAIN_BOOTSTRAP_PROD:-0}" == "1" ]]; then
+  log "Bootstrapping Besu Z Chain..."
+  sudo bash "$ROOT/scripts/deployment/bootstrap-z-chain-production.sh"
+fi
+
+if [[ "${Z_CHAIN_DEPLOY_CONTRACTS:-0}" == "1" ]]; then
+  log "Deploying Z Chain contracts..."
+  node "$ROOT/scripts/deployment/deploy-z-chain-contracts.js" --network zchain
+  node "$ROOT/scripts/deployment/sync-z-chain-deployed-addresses.mjs"
+fi
+
+log "Build Z-only backend + frontend..."
+bash "$ROOT/scripts/deployment/build-z-ecosystem-stack.sh"
+
+log "Install Z domain nginx vhost..."
+bash "$ROOT/scripts/deployment/deploy-z-domains.sh"
+
+if [[ "${Z_ECOSYSTEM_PUSH_PCT:-0}" == "1" ]]; then
+  log "Pushing portal bundle to Proxmox LXC..."
+  bash "$ROOT/scripts/deployment/deploy-omnl-banking-portal-pct.sh"
+fi
+
+log "Done. Verify:"
+log "  curl -sf http://127.0.0.1:\${Z_TOKEN_AGGREGATION_PORT:-3100}/api/v1/z-bot/health"
+log "  curl -sf http://127.0.0.1:3011/api/v1/settlement/health"
+log "  curl -sI https://zblockchainsystem.com/z"
+log "  bash scripts/deployment/print-z-dns-records.sh"
diff --git a/scripts/deployment/deploy-z-ecosystem.ps1 b/scripts/deployment/deploy-z-ecosystem.ps1
new file mode 100644
index 0000000..463def1
--- /dev/null
+++ b/scripts/deployment/deploy-z-ecosystem.ps1
@@ -0,0 +1,135 @@
+# Deploy Z Ecosystem portal locally (chain + settlement + API + portal)
+$ErrorActionPreference = "Stop"
+$Root = (Resolve-Path (Join-Path $PSScriptRoot "..\..")).Path
+$LogDir = Join-Path $Root "logs"
+New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
+
+function Import-DotEnvFile([string]$Path) {
+  if (-not (Test-Path $Path)) { return }
+  Get-Content $Path | ForEach-Object {
+    $line = $_.Trim()
+    if ($line -eq "" -or $line.StartsWith("#")) { return }
+    if ($line -match '^\s*([^=]+)=(.*)$') {
+      $name = $matches[1].Trim()
+      $value = $matches[2].Trim().Trim('"').Trim("'")
+      Set-Item -Path "env:$name" -Value $value
+    }
+  }
+}
+
+function Test-ZChainRpc {
+  try {
+    $body = '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
+    $r = Invoke-RestMethod -Uri "http://127.0.0.1:8546" -Method Post -Body $body -ContentType "application/json" -TimeoutSec 2
+    return ($r.result -eq "0xdbba2")
+  } catch { return $false }
+}
+
+function Stop-Port($port) {
+  $conn = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue | Select-Object -First 1
+  if ($conn -and $conn.OwningProcess) {
+    Stop-Process -Id $conn.OwningProcess -Force -ErrorAction SilentlyContinue
+    Start-Sleep -Seconds 1
+  }
+}
+
+function Start-BackgroundService([string]$Name, [string]$WorkDir, [string]$Command, [string]$LogFile) {
+  Write-Host "Starting $Name ..."
+  Start-Process -FilePath "cmd.exe" -ArgumentList @("/c", "$Command > `"$LogFile`" 2>&1") `
+    -WorkingDirectory $WorkDir -WindowStyle Hidden
+}
+
+Set-Location $Root
+
+Import-DotEnvFile (Join-Path $Root ".env")
+Import-DotEnvFile (Join-Path $Root "config\z-ecosystem.local.env")
+
+$env:CHAIN_900002_RPC_URL = if ($env:CHAIN_900002_RPC_URL) { $env:CHAIN_900002_RPC_URL } else { "http://127.0.0.1:8546" }
+$env:SETTLEMENT_MIDDLEWARE_URL = if ($env:SETTLEMENT_MIDDLEWARE_URL) { $env:SETTLEMENT_MIDDLEWARE_URL } else { "http://127.0.0.1:3011" }
+$env:SETTLEMENT_URL = $env:SETTLEMENT_MIDDLEWARE_URL
+$env:TOKEN_AGGREGATION_URL = "http://127.0.0.1:3000"
+$env:VITE_ECOSYSTEM = "z"
+$env:OMNL_SUPPORTED_CHAINS_CONFIG = Join-Path $Root "config\z-supported-chains.v1.json"
+
+if (-not $env:SETTLEMENT_MIDDLEWARE_CONFIG) {
+  $env:SETTLEMENT_MIDDLEWARE_CONFIG = Join-Path $Root "config\settlement-middleware.production.v1.json"
+}
+if (-not $env:OMNL_SUPPORTED_CHAINS_CONFIG) {
+  $env:OMNL_SUPPORTED_CHAINS_CONFIG = Join-Path $Root "config\omnl-supported-chains.v1.json"
+}
+
+if (-not (Test-ZChainRpc)) {
+  Write-Host "Z Chain RPC not running - starting complete-z-chain ..."
+  & "$PSScriptRoot\complete-z-chain.ps1"
+}
+
+Write-Host "Building packages (settlement-core) ..."
+foreach ($pkg in @("packages\integration-foundation", "packages\settlement-core")) {
+  $pkgDir = Join-Path $Root $pkg
+  if (Test-Path $pkgDir) {
+    Set-Location $pkgDir
+    if (-not (Test-Path node_modules)) { npm install --legacy-peer-deps 2>&1 | Out-Null }
+    npm run build
+    if ($LASTEXITCODE -ne 0) { throw "$pkg build failed" }
+  }
+}
+
+Write-Host "Building settlement-middleware ..."
+Set-Location "$Root\services\settlement-middleware"
+if (-not (Test-Path node_modules)) { npm install --legacy-peer-deps 2>&1 | Out-Null }
+npm run build
+if ($LASTEXITCODE -ne 0) { throw "settlement-middleware build failed" }
+
+Write-Host "Building token-aggregation ..."
+Set-Location "$Root\services\token-aggregation"
+if (-not (Test-Path node_modules)) { npm install --legacy-peer-deps 2>&1 | Out-Null }
+npm run build
+if ($LASTEXITCODE -ne 0) { throw "token-aggregation build failed" }
+
+Write-Host "Building frontend-dapp (Z Ecosystem only) ..."
+Set-Location "$Root\frontend-dapp"
+if (-not (Test-Path node_modules)) { npm install --legacy-peer-deps 2>&1 | Out-Null }
+npm run build:z
+if ($LASTEXITCODE -ne 0) { throw "frontend build failed" }
+
+Stop-Port 3011
+Stop-Port 3000
+Stop-Port 3002
+
+$settlementLog = Join-Path $LogDir "settlement-middleware.log"
+$tokenLog = Join-Path $LogDir "token-aggregation.log"
+$portalLog = Join-Path $LogDir "portal-serve.log"
+
+Start-BackgroundService "settlement-middleware on :3011" "$Root\services\settlement-middleware" "npm start" $settlementLog
+Start-Sleep -Seconds 3
+
+Start-BackgroundService "token-aggregation on :3000" "$Root\services\token-aggregation" "npm start" $tokenLog
+Start-Sleep -Seconds 4
+
+$env:SETTLEMENT_URL = "http://127.0.0.1:3011"
+Start-BackgroundService "portal on :3002" "$Root\frontend-dapp" "npm run serve:portal" $portalLog
+Start-Sleep -Seconds 5
+
+$llmStatus = "rule-based"
+try {
+  $health = Invoke-RestMethod -Uri "http://localhost:3000/api/v1/z-bot/health" -TimeoutSec 5
+  $llmStatus = $health.llm.provider
+} catch { }
+
+$settlementStatus = "unknown"
+try {
+  $settlementStatus = (Invoke-RestMethod -Uri "http://localhost:3011/api/v1/settlement/health" -TimeoutSec 5).status
+} catch { $settlementStatus = "unreachable" }
+
+Write-Host ""
+Write-Host "Z Ecosystem deployed locally:"
+Write-Host "  Hub:         http://localhost:3002/z"
+Write-Host "  Wallet:      http://localhost:3002/z-wallet"
+Write-Host "  Z Bot API:   http://localhost:3000/api/v1/z-bot/health ($llmStatus)"
+Write-Host "  Settlement:  http://localhost:3011/api/v1/settlement/health ($settlementStatus)"
+Write-Host "  Z Chain RPC: $($env:CHAIN_900002_RPC_URL)"
+Write-Host "  Logs:        $LogDir"
+if ($llmStatus -eq "rule-based") {
+  Write-Host ""
+  Write-Host "Azure OpenAI: copy config/z-ecosystem.local.env.example to config/z-ecosystem.local.env and set AZURE_OPENAI_* then redeploy."
+}
diff --git a/scripts/deployment/enable-z-hosts-local.ps1 b/scripts/deployment/enable-z-hosts-local.ps1
new file mode 100644
index 0000000..c356049
--- /dev/null
+++ b/scripts/deployment/enable-z-hosts-local.ps1
@@ -0,0 +1,12 @@
+# Run as Administrator to map zblockchainsystem.com to this PC (local Z portal on :3002)
+$marker = '# Z Ecosystem only'
+$hostsPath = "$env:SystemRoot\System32\drivers\etc\hosts"
+$line = '127.0.0.1 zblockchainsystem.com www.zblockchainsystem.com rpc.zblockchainsystem.com explorer.zblockchainsystem.com'
+$content = Get-Content $hostsPath -Raw
+if ($content -match [regex]::Escape($marker)) {
+  Write-Host 'Z hosts entries already present.'
+  exit 0
+}
+Add-Content -Path $hostsPath -Value "`n$marker`n$line"
+Write-Host 'Added zblockchainsystem.com -> 127.0.0.1'
+Write-Host 'Open: http://zblockchainsystem.com:3002/z'
diff --git a/scripts/deployment/go-live-z-ecosystem.ps1 b/scripts/deployment/go-live-z-ecosystem.ps1
new file mode 100644
index 0000000..b4ef20c
--- /dev/null
+++ b/scripts/deployment/go-live-z-ecosystem.ps1
@@ -0,0 +1,138 @@
+# Go live — Z Ecosystem (production build + tunnel + deploy bundle)
+$ErrorActionPreference = "Stop"
+$Root = (Resolve-Path (Join-Path $PSScriptRoot "..\..")).Path
+$LogDir = Join-Path $Root "logs"
+$BundleDir = Join-Path $Root "dist\go-live"
+$BundleTar = Join-Path $BundleDir "z-ecosystem-portal.tar.gz"
+New-Item -ItemType Directory -Force -Path $LogDir, $BundleDir | Out-Null
+
+function Import-DotEnvFile([string]$Path) {
+  if (-not (Test-Path $Path)) { return }
+  Get-Content $Path | ForEach-Object {
+    $line = $_.Trim()
+    if ($line -eq "" -or $line.StartsWith("#")) { return }
+    if ($line -match '^\s*([^=]+)=(.*)$') {
+      Set-Item -Path "env:$($matches[1].Trim())" -Value $matches[2].Trim().Trim('"').Trim("'")
+    }
+  }
+}
+
+function Stop-Port($port) {
+  $conn = Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1
+  if ($conn -and $conn.OwningProcess) {
+    Stop-Process -Id $conn.OwningProcess -Force -ErrorAction SilentlyContinue
+    Start-Sleep -Seconds 1
+  }
+}
+
+Set-Location $Root
+Import-DotEnvFile (Join-Path $Root ".env")
+Import-DotEnvFile (Join-Path $Root "config\z-ecosystem.local.env")
+
+# Production frontend env (same-origin on zblockchainsystem.com)
+$env:VITE_ECOSYSTEM = "z"
+$env:VITE_TOKEN_AGGREGATION_URL = "/api/v1"
+$env:VITE_SETTLEMENT_MIDDLEWARE_URL = "/settlement"
+$env:VITE_DBIS_EXCHANGE_URL = "/exchange"
+$env:VITE_ENABLE_Z_WALLET = "true"
+$env:VITE_RPC_URL_900002 = if ($env:VITE_RPC_URL_900002) { $env:VITE_RPC_URL_900002 } else { "https://rpc.zblockchainsystem.com" }
+$env:VITE_Z_CHAIN_EXPLORER_URL = if ($env:VITE_Z_CHAIN_EXPLORER_URL) { $env:VITE_Z_CHAIN_EXPLORER_URL } else { "https://explorer.zblockchainsystem.com" }
+$env:VITE_Z_ECOSYSTEM_URL = if ($env:VITE_Z_ECOSYSTEM_URL) { $env:VITE_Z_ECOSYSTEM_URL } else { "https://zblockchainsystem.com" }
+Remove-Item Env:VITE_OMNL_API_KEY -ErrorAction SilentlyContinue
+
+Write-Host "=== 1/4 Local stack (Z Chain + APIs + portal) ==="
+& "$PSScriptRoot\deploy-z-ecosystem.ps1"
+
+Write-Host ""
+Write-Host "=== 2/4 Production frontend build (Z-only) ==="
+Set-Location "$Root\frontend-dapp"
+npm run build:z
+if ($LASTEXITCODE -ne 0) { throw "production frontend build failed" }
+
+Write-Host ""
+Write-Host "=== 3/4 Stage deploy bundle ==="
+$stageRoot = Join-Path $BundleDir "stage"
+if (Test-Path $stageRoot) { Remove-Item -Recurse -Force $stageRoot }
+New-Item -ItemType Directory -Force -Path $stageRoot | Out-Null
+
+$copyPaths = @(
+  "config",
+  "frontend-dapp\dist",
+  "packages\integration-foundation\package.json",
+  "packages\integration-foundation\dist",
+  "packages\settlement-core\package.json",
+  "packages\settlement-core\dist",
+  "services\token-aggregation\dist",
+  "services\token-aggregation\package.json",
+  "services\token-aggregation\package-lock.json",
+  "services\settlement-middleware\dist",
+  "services\settlement-middleware\package.json",
+  "services\settlement-middleware\package-lock.json",
+  "scripts\deployment\start-omnl-banking-portal.sh",
+  "scripts\deployment\deploy-z-ecosystem-production.sh",
+  "deploy\nginx\omnl-lxc-portal.conf",
+  "deploy\nginx\omnl-portal-auth-current.conf.inc"
+)
+
+foreach ($rel in $copyPaths) {
+  $src = Join-Path $Root $rel
+  if (-not (Test-Path $src)) {
+    Write-Host "  skip missing: $rel"
+    continue
+  }
+  $dst = Join-Path $stageRoot $rel
+  New-Item -ItemType Directory -Force -Path (Split-Path $dst -Parent) | Out-Null
+  Copy-Item -Path $src -Destination $dst -Recurse -Force
+}
+
+if (Get-Command tar -ErrorAction SilentlyContinue) {
+  if (Test-Path $BundleTar) { Remove-Item -Force $BundleTar }
+  tar -czf $BundleTar -C $stageRoot .
+  Write-Host "  bundle: $BundleTar"
+} else {
+  Write-Host "  tar not found - bundle folder: $stageRoot"
+}
+
+Write-Host ""
+Write-Host "=== 4/4 Public tunnel (cloudflared) ==="
+Stop-Port 4040
+$tunnelLog = Join-Path $LogDir "cloudflared-z-ecosystem.log"
+$cf = "C:\Program Files (x86)\cloudflared\cloudflared.exe"
+if (-not (Test-Path $cf)) { $cf = "cloudflared" }
+
+$tunnelErr = Join-Path $LogDir "cloudflared-z-ecosystem.err.log"
+Start-Process -FilePath "cmd.exe" -ArgumentList @("/c", "`"$cf`" tunnel --url http://localhost:3002 --metrics localhost:4040 > `"$tunnelLog`" 2> `"$tunnelErr`"") `
+  -WindowStyle Hidden
+
+$tunnelUrl = $null
+for ($i = 0; $i -lt 30; $i++) {
+  Start-Sleep -Seconds 1
+  if (Test-Path $tunnelLog) {
+    $log = Get-Content $tunnelLog -Raw -ErrorAction SilentlyContinue
+    if ($log -match '(https://[a-z0-9-]+\.trycloudflare\.com)') {
+      $tunnelUrl = $matches[1]
+      break
+    }
+  }
+}
+
+Write-Host ""
+Write-Host "Z Ecosystem GO LIVE"
+Write-Host "==================="
+if ($tunnelUrl) {
+  Write-Host "  Public tunnel:  $tunnelUrl/z"
+  Write-Host "  Z Wallet:       $tunnelUrl/z-wallet"
+  Write-Host "  Z Bot health:   $tunnelUrl/api/v1/z-bot/health"
+} else {
+  Write-Host "  Tunnel starting - see $tunnelLog"
+  Write-Host "  Local:          http://localhost:3002/z"
+}
+Write-Host ""
+Write-Host "Production portal zblockchainsystem.com - run on dev-bis-ali:"
+Write-Host '  cd ~/smom-dbis-138; git pull; bash scripts/deployment/deploy-z-ecosystem-production.sh'
+Write-Host '  # or push bundle to LXC:'
+Write-Host '  Z_ECOSYSTEM_PUSH_PCT=1 bash scripts/deployment/deploy-z-ecosystem-production.sh'
+Write-Host ""
+Write-Host "DNS still required for Z Chain RPC:"
+Write-Host '  rpc.zblockchainsystem.com -> Besu host port 8546'
+Write-Host '  explorer.zblockchainsystem.com -> explorer optional'
diff --git a/scripts/deployment/print-omnl-dns-records.sh b/scripts/deployment/print-omnl-dns-records.sh
index c967d08..60368df 100644
--- a/scripts/deployment/print-omnl-dns-records.sh
+++ b/scripts/deployment/print-omnl-dns-records.sh
@@ -16,7 +16,7 @@ Zone: omdnl.org
   A     secure    $ORIGIN_IP      yes     Central Bank (/central-bank)
   A     online    $ORIGIN_IP      yes     Online banking (/central-bank)
   A     forex     $ORIGIN_IP      yes     Forex terminal (/trade)
-  A     digital   $ORIGIN_IP      yes     Digital swap (/swap)
+  A     digital   $ORIGIN_IP      yes     Legacy swap (/swap) — prefer zblockchainsystem.com
 
 Zone: omdnl.org (Office 24)
   Type  Name      Content         Proxy   Dashboard
@@ -40,6 +40,9 @@ Live URLs once DNS is active:
   https://online.omdnl.org/central-bank
   https://forex.omdnl.org/trade
   https://digital.omdnl.org/swap
+  https://zblockchainsystem.com/z
+  https://zblockchainsystem.com/z-wallet
+  https://zblockchainsystem.com/swap
   https://office24.omdnl.org/office-24
   https://exchange.d-bis.org/trade
   https://secure.d-bis.org/central-bank
diff --git a/scripts/deployment/print-z-dns-records.sh b/scripts/deployment/print-z-dns-records.sh
new file mode 100644
index 0000000..50791f5
--- /dev/null
+++ b/scripts/deployment/print-z-dns-records.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# DNS records for Z Ecosystem (zblockchainsystem.com) — separate from OMNL
+
+ORIGIN_IP="${Z_ECOSYSTEM_ORIGIN_IP:-${OMNL_ORIGIN_IP:-76.53.10.34}}"
+
+cat <<EOF
+# Z Ecosystem DNS — zblockchainsystem.com (separate from OMNL)
+
+Zone: zblockchainsystem.com
+  Type  Name      Content         Proxy   Product
+  A     @         $ORIGIN_IP      yes     Z Hub (/z)
+  A     www       $ORIGIN_IP      yes     Z Hub (/z)
+  A     rpc       $ORIGIN_IP      yes     Z Chain RPC (:8546 on origin)
+  A     explorer  $ORIGIN_IP      yes     Z Chain explorer (optional)
+
+Live URLs after DNS:
+  https://zblockchainsystem.com/z
+  https://zblockchainsystem.com/z-wallet
+  https://zblockchainsystem.com/swap
+  https://zblockchainsystem.com/central-bank
+  https://zblockchainsystem.com/api/v1/z-bot/health
+  https://rpc.zblockchainsystem.com
+  https://explorer.zblockchainsystem.com
+EOF
diff --git a/scripts/deployment/start-omnl-banking-portal.sh b/scripts/deployment/start-omnl-banking-portal.sh
index d50cbc0..f3d2427 100644
--- a/scripts/deployment/start-omnl-banking-portal.sh
+++ b/scripts/deployment/start-omnl-banking-portal.sh
@@ -44,6 +44,7 @@ start_service() {
   local name="$1"
   local dir="$2"
   local cmd="$3"
+  local port="${4:-}"
   local active_root=""
   local alias_root
 
@@ -57,6 +58,20 @@ start_service() {
   [[ -n "$active_root" ]] || active_root="$ROOT"
   cd "${active_root}/${dir}"
 
+  if [[ -n "$port" ]]; then
+    if command -v fuser >/dev/null 2>&1; then
+      fuser -k "${port}/tcp" 2>/dev/null || true
+    else
+      pid="$(ss -H -tlnp "sport = :${port}" 2>/dev/null | sed -n 's/.*pid=\([0-9]*\).*/\1/p' | head -1)"
+      [[ -n "$pid" ]] && kill "$pid" 2>/dev/null || true
+    fi
+    sleep 1
+  fi
+
+  if [[ ! -d node_modules ]] || [[ ! -f node_modules/.package-lock.json ]]; then
+    NODE_ENV=development npm install --no-fund --no-audit
+  fi
+
   local -a env_args=(
     "SETTLEMENT_MIDDLEWARE_CONFIG=$SETTLEMENT_MIDDLEWARE_CONFIG"
     "DBIS_EXCHANGE_CONFIG=$DBIS_EXCHANGE_CONFIG"
@@ -95,11 +110,11 @@ start_service() {
   echo $! >"${LOG_DIR}/${name}.pid"
 }
 
-start_service token-aggregation services/token-aggregation "npm run start"
+start_service token-aggregation services/token-aggregation "npm run start" 3000
 sleep 2
-start_service settlement-middleware services/settlement-middleware "npm run start"
+start_service settlement-middleware services/settlement-middleware "npm run start" 3011
 sleep 2
-start_service dbis-exchange services/dbis-exchange "npm run start"
+start_service dbis-exchange services/dbis-exchange "npm run start" 3012
 sleep 2
 
 pkill -f "serve -s.*${FRONTEND_PORT}" 2>/dev/null || true
@@ -118,13 +133,7 @@ if command -v nginx >/dev/null 2>&1 && [[ -f "$NGINX_TEMPLATE" ]]; then
   echo "OMNL banking portal started under ${ROOT} (nginx :${FRONTEND_PORT})"
 else
   cd "${ROOT}/frontend-dapp"
-  if [[ -x "./node_modules/vite/bin/vite.js" || -f "./node_modules/vite/bin/vite.js" ]]; then
-    nohup node ./node_modules/vite/bin/vite.js preview --host 0.0.0.0 --port "$FRONTEND_PORT" \
-      >"${LOG_DIR}/frontend.log" 2>&1 &
-    echo "OMNL banking portal started under ${ROOT} (vite preview :${FRONTEND_PORT})"
-  else
-    nohup npx --yes serve -s dist -l "$FRONTEND_PORT" >"${LOG_DIR}/frontend.log" 2>&1 &
-    echo "OMNL banking portal started under ${ROOT} (serve :${FRONTEND_PORT})"
-  fi
+  nohup npx --yes serve -s dist -l "$FRONTEND_PORT" >"${LOG_DIR}/frontend.log" 2>&1 &
+  echo "OMNL banking portal started under ${ROOT} (serve :${FRONTEND_PORT})"
   echo $! >"${LOG_DIR}/frontend.pid"
 fi
diff --git a/scripts/deployment/start-swift-listener-production.sh b/scripts/deployment/start-swift-listener-production.sh
new file mode 100644
index 0000000..660bfc2
--- /dev/null
+++ b/scripts/deployment/start-swift-listener-production.sh
@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Start OMNL SWIFT listener (FIN webhook :8788 + file inbox + optional FIN TCP).
+# Run on dev VM or banking LXC host after .env is loaded (chmod 600).
+set -euo pipefail
+
+REPO_DIR="${OMNL_BANK_ROOT:-$HOME/smom-dbis-138}"
+ENV_FILE="${OMNL_BANK_ENV:-$REPO_DIR/.env}"
+LOG_DIR="${OMNL_BANK_LOG_DIR:-$HOME/omnl-bank/logs}"
+PORT="${SWIFT_LISTENER_PORT:-8788}"
+
+log() { echo "[$(date -Iseconds)] swift-listener $*"; }
+
+mkdir -p "$LOG_DIR"
+
+if [[ -f "$ENV_FILE" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "$ENV_FILE"
+  set +a
+fi
+
+export SWIFT_LISTENER_WEBHOOK="${SWIFT_LISTENER_WEBHOOK:-1}"
+export SWIFT_LISTENER_FILE_INBOX="${SWIFT_LISTENER_FILE_INBOX:-1}"
+export SWIFT_LISTENER_OMNL_FORWARD="${SWIFT_LISTENER_OMNL_FORWARD:-1}"
+export SWIFT_LISTENER_INTAKE_GATEWAY="${SWIFT_LISTENER_INTAKE_GATEWAY:-1}"
+export SWIFT_LISTENER_GATEWAY_EXECUTE="${SWIFT_LISTENER_GATEWAY_EXECUTE:-0}"
+export TOKEN_AGGREGATION_URL="${TOKEN_AGGREGATION_URL:-http://127.0.0.1:3000}"
+export OMNL_API_KEY="${OMNL_API_KEY:-${OMNL_SUPER_ADMIN_OFFICE24_KEY:-}}"
+export RPC_URL_138="${RPC_URL_138:-${CHAIN_138_RPC_URL:-http://192.168.11.211:8545}}"
+
+cd "$REPO_DIR/services/swift-listener"
+if [[ ! -d node_modules ]]; then
+  log "npm install..."
+  npm install --no-fund --no-audit
+fi
+if [[ ! -f dist/cli.js ]]; then
+  log "build..."
+  npm run build
+fi
+
+pkill -f "swift-listener/dist/cli.js" 2>/dev/null || true
+fuser -k "${PORT}/tcp" 2>/dev/null || true
+sleep 1
+
+log "Starting on :${PORT} (POST /inbound, GET /health)"
+nohup env \
+  OMNL_BANK_ROOT="$REPO_DIR" \
+  SWIFT_LISTENER_WEBHOOK="$SWIFT_LISTENER_WEBHOOK" \
+  SWIFT_LISTENER_FILE_INBOX="$SWIFT_LISTENER_FILE_INBOX" \
+  SWIFT_LISTENER_OMNL_FORWARD="$SWIFT_LISTENER_OMNL_FORWARD" \
+  SWIFT_LISTENER_INTAKE_GATEWAY="$SWIFT_LISTENER_INTAKE_GATEWAY" \
+  SWIFT_LISTENER_GATEWAY_EXECUTE="$SWIFT_LISTENER_GATEWAY_EXECUTE" \
+  SWIFT_LISTENER_WEBHOOK_TOKEN="${SWIFT_LISTENER_WEBHOOK_TOKEN:-}" \
+  HYBX_WEBHOOK_SECRET="${HYBX_WEBHOOK_SECRET:-}" \
+  TOKEN_AGGREGATION_URL="$TOKEN_AGGREGATION_URL" \
+  OMNL_API_KEY="$OMNL_API_KEY" \
+  RPC_URL_138="$RPC_URL_138" \
+  PRIVATE_KEY="${PRIVATE_KEY:-}" \
+  node dist/cli.js --project-root "$REPO_DIR" \
+  >"$LOG_DIR/swift-listener.log" 2>&1 &
+echo $! >"$LOG_DIR/swift-listener.pid"
+
+sleep 2
+if curl -sf "http://127.0.0.1:${PORT}/health" | head -c 120; then
+  echo
+  log "OK — set SWIFT_LISTENER_URL=http://127.0.0.1:${PORT} in .env for settlement-middleware"
+else
+  log "WARN: health check failed — see $LOG_DIR/swift-listener.log"
+  exit 1
+fi
diff --git a/scripts/deployment/sync-guosmm-notices.sh b/scripts/deployment/sync-guosmm-notices.sh
new file mode 100644
index 0000000..e69eeb6
--- /dev/null
+++ b/scripts/deployment/sync-guosmm-notices.sh
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Verify GUOSMM gazette notices are live and propagate config to banking stack.
+set -euo pipefail
+
+REPO_DIR="${OMNL_BANK_ROOT:-$HOME/smom-dbis-138}"
+REGISTRY="${REPO_DIR}/config/guosmm-notices.v1.json"
+log() { echo "[$(date -Iseconds)] guosmm-sync $*"; }
+
+[[ -f "$REGISTRY" ]] || { log "Missing $REGISTRY"; exit 1; }
+
+log "Verifying gazette URLs..."
+while IFS= read -r url; do
+  [[ -n "$url" ]] || continue
+  code="$(curl -sS -o /dev/null -w '%{http_code}' "$url")"
+  log "  $url -> HTTP $code"
+  [[ "$code" == "200" ]] || exit 1
+done < <(node -e "
+const r=require('${REGISTRY//\\/\\\\}');
+for (const n of r.notices) console.log(n.url);
+")
+
+log "API catalog probe (local token-aggregation)..."
+curl -sf "http://127.0.0.1:3000/api/v1/omnl/gazette/notices" | head -c 200 || log "WARN: local API not up — redeploy first"
+echo
+
+if [[ "${GUOSMM_SYNC_LXCS:-0}" == "1" ]]; then
+  PROXMOX_ROOT="${PROXMOX_ROOT:-/srv/projects/proxmox}"
+  if [[ -f "${PROXMOX_ROOT}/scripts/deployment/sync-zardasht-omnl-banking-portal-lxcs.sh" ]]; then
+    log "LXC sync..."
+    bash "${PROXMOX_ROOT}/scripts/deployment/sync-zardasht-omnl-banking-portal-lxcs.sh" --apply
+  fi
+fi
+
+log "GUOSMM notices deployed to config + API registry"
+log "  Portal: /central-bank and /hub (gazette section)"
+log "  API: GET /api/v1/omnl/gazette/notices"
diff --git a/scripts/deployment/sync-z-chain-deployed-addresses.mjs b/scripts/deployment/sync-z-chain-deployed-addresses.mjs
new file mode 100644
index 0000000..196d973
--- /dev/null
+++ b/scripts/deployment/sync-z-chain-deployed-addresses.mjs
@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Sync forge broadcast output into z-chain-deployed.v1.json and hybx cross-chain lines.
+ * Usage: node scripts/deployment/sync-z-chain-deployed-addresses.mjs [broadcast-run.json]
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, '../..');
+
+const broadcastPath =
+  process.argv[2] ||
+  resolve(root, 'broadcast/DeployZChainEmoney.s.sol/900002/run-latest.json');
+
+if (!existsSync(broadcastPath)) {
+  console.error(`Broadcast file not found: ${broadcastPath}`);
+  console.error('Deploy first: bash scripts/deployment/deploy-z-chain-contracts.sh');
+  process.exit(1);
+}
+
+const broadcast = JSON.parse(readFileSync(broadcastPath, 'utf8'));
+const txs = broadcast.transactions || [];
+let cUsdc = null;
+let registry = null;
+
+for (const tx of txs) {
+  const name = tx.contractName;
+  const addr = tx.contractAddress;
+  if (!addr) continue;
+  if (name === 'ZChainUSDC') cUsdc = addr;
+  if (name === 'AccountWalletRegistry' || name === 'AccountWalletRegistryZ') registry = addr;
+}
+
+if (!cUsdc || !registry) {
+  console.error('Could not find ZChainUSDC and AccountWalletRegistry in broadcast');
+  process.exit(1);
+}
+
+const deployedPath = resolve(root, 'config/z-chain-deployed.v1.json');
+const deployed = JSON.parse(readFileSync(deployedPath, 'utf8'));
+deployed.updated = new Date().toISOString().slice(0, 10);
+deployed.status = 'active';
+deployed.contracts.cUSDC = cUsdc;
+deployed.contracts.accountWalletRegistry = registry;
+writeFileSync(deployedPath, `${JSON.stringify(deployed, null, 2)}\n`);
+
+const integrationPath = resolve(root, 'config/z-chain-integration.v1.json');
+const integration = JSON.parse(readFileSync(integrationPath, 'utf8'));
+integration.contracts.cUSDC = cUsdc;
+integration.contracts.accountWalletRegistry = registry;
+writeFileSync(integrationPath, `${JSON.stringify(integration, null, 2)}\n`);
+
+const hybxPath = resolve(root, 'config/hybx-omnl-cross-chain-lines.json');
+const hybx = JSON.parse(readFileSync(hybxPath, 'utf8'));
+for (const line of hybx.lines || []) {
+  if (line.chains?.['900002']) {
+    line.chains['900002'].tokenM1 = cUsdc;
+  }
+}
+writeFileSync(hybxPath, `${JSON.stringify(hybx, null, 2)}\n`);
+
+console.log('Updated:');
+console.log('  cUSDC:', cUsdc);
+console.log('  AccountWalletRegistry:', registry);
+console.log('  config/z-chain-deployed.v1.json');
+console.log('  config/z-chain-integration.v1.json');
+console.log('  config/hybx-omnl-cross-chain-lines.json (chains.900002.tokenM1)');
diff --git a/services/settlement-middleware/dist/api/routes/settlement.js b/services/settlement-middleware/dist/api/routes/settlement.js
index c46e535..6ae4913 100644
--- a/services/settlement-middleware/dist/api/routes/settlement.js
+++ b/services/settlement-middleware/dist/api/routes/settlement.js
@@ -10,6 +10,7 @@ const transfer_1 = require("../../workflows/transfer");
 const office_scope_1 = require("../../workflows/office-scope");
 const settlement_store_1 = require("../../store/settlement-store");
 const swift_inbound_1 = require("../../workflows/swift-inbound");
+const z_bank_m0_m4_1 = require("../../workflows/z-bank-m0-m4");
 const fineract_1 = require("../../adapters/fineract");
 const auth_1 = require("../../middleware/auth");
 async function respondPublicMoneySupply(res, officeId) {
@@ -164,6 +165,27 @@ function createSettlementRouter() {
             });
         }
     });
+    router.post('/z-bank/settle-m0-m4', async (req, res) => {
+        if (!(0, auth_1.requireApiKey)(req, res))
+            return;
+        try {
+            const body = req.body;
+            if (!body.idempotencyKey || !body.creditorIban || !body.amount) {
+                res.status(400).json({ error: 'idempotencyKey, creditorIban, amount required' });
+                return;
+            }
+            const record = await (0, z_bank_m0_m4_1.processZBankM0ToM4)({
+                ...body,
+                officeId: (0, config_1.settlementOfficeId)(body.officeId),
+                currency: body.currency ?? 'USD',
+                beneficiaryName: body.beneficiaryName ?? 'Z Online Bank',
+            });
+            res.status(record.phase === 'FAILED' ? 422 : 200).json(record);
+        }
+        catch (e) {
+            res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+        }
+    });
     router.post('/swift/inbound', async (req, res) => {
         if (!(0, auth_1.requireApiKey)(req, res))
             return;
diff --git a/services/settlement-middleware/src/adapters/swift.ts b/services/settlement-middleware/src/adapters/swift.ts
index 43ed96a..0a9cd15 100644
--- a/services/settlement-middleware/src/adapters/swift.ts
+++ b/services/settlement-middleware/src/adapters/swift.ts
@@ -54,3 +54,45 @@ ${fields.beneficiary}
 :70:${fields.remittance}
 -}`;
 }
+
+/** MT202 — interbank cover / institution transfer (SBLC correspondent leg). */
+export function buildMt202Stub(fields: {
+  senderRef: string;
+  relatedRef: string;
+  currency: string;
+  amount: string;
+  valueDate: string;
+  orderingInstitution?: string;
+  accountWithInstitution?: string;
+  beneficiaryInstitution?: string;
+  remittance: string;
+}): string {
+  const ord = fields.orderingInstitution ? `:52A:${fields.orderingInstitution}\n` : '';
+  const acct = fields.accountWithInstitution ? `:57A:${fields.accountWithInstitution}\n` : '';
+  const ben = fields.beneficiaryInstitution ? `:58A:${fields.beneficiaryInstitution}\n` : '';
+  return `{1:F01OMNLUS33XXXX0000000000}{2:I202BANKUS33XXXXN}{4:
+:20:${fields.senderRef}
+:21:${fields.relatedRef}
+:32A:${fields.valueDate.replace(/-/g, '').slice(2)}${fields.currency}${fields.amount.replace('.', ',')}
+${ord}${acct}${ben}:70:${fields.remittance}
+-}`;
+}
+
+/** MT910 — confirmation of credit (advice to beneficiary bank). */
+export function buildMt910Stub(fields: {
+  transactionRef: string;
+  relatedRef: string;
+  currency: string;
+  amount: string;
+  valueDate: string;
+  accountWithInstitution?: string;
+  remittance: string;
+}): string {
+  const acct = fields.accountWithInstitution ? `:57A:${fields.accountWithInstitution}\n` : '';
+  return `{1:F01OMNLUS33XXXX0000000000}{2:I910BANKUS33XXXXN}{4:
+:20:${fields.transactionRef}
+:21:${fields.relatedRef}
+:32A:${fields.valueDate.replace(/-/g, '').slice(2)}${fields.currency}${fields.amount.replace('.', ',')}
+${acct}:72:${fields.remittance}
+-}`;
+}
diff --git a/services/settlement-middleware/src/api/routes/settlement.ts b/services/settlement-middleware/src/api/routes/settlement.ts
index e0e3cac..88659de 100644
--- a/services/settlement-middleware/src/api/routes/settlement.ts
+++ b/services/settlement-middleware/src/api/routes/settlement.ts
@@ -1,5 +1,5 @@
 import { Router, type Request, type Response } from 'express';
-import type { ExternalTransferRequest, TradeFinanceInstrument, TokenLoadRequest, TransferRequest } from '@dbis/settlement-core';
+import type { ExternalTransferRequest, TradeFinanceInstrument, TokenLoadRequest, TransferRequest, ZBankM0M4Request } from '@dbis/settlement-core';
 import { buildMoneySupplySnapshot, loadOmnlChainRegistry, getActiveChains } from '@dbis/settlement-core';
 import { loadConfig, loadOfficeProfile, settlementOfficeId } from '../../config';
 import {
@@ -12,6 +12,7 @@ import { processTransfer } from '../../workflows/transfer';
 import { bindOffice24 } from '../../workflows/office-scope';
 import { settlementStore } from '../../store/settlement-store';
 import { processSwiftInbound } from '../../workflows/swift-inbound';
+import { processZBankM0ToM4 } from '../../workflows/z-bank-m0-m4';
 import { fetchGlBalances, fineractOfficeReachable } from '../../adapters/fineract';
 import { requireApiKey } from '../../middleware/auth';
 
@@ -171,6 +172,26 @@ export function createSettlementRouter(): Router {
     }
   });
 
+  router.post('/z-bank/settle-m0-m4', async (req, res) => {
+    if (!requireApiKey(req, res)) return;
+    try {
+      const body = req.body as ZBankM0M4Request;
+      if (!body.idempotencyKey || !body.creditorIban || !body.amount) {
+        res.status(400).json({ error: 'idempotencyKey, creditorIban, amount required' });
+        return;
+      }
+      const record = await processZBankM0ToM4({
+        ...body,
+        officeId: settlementOfficeId(body.officeId),
+        currency: body.currency ?? 'USD',
+        beneficiaryName: body.beneficiaryName ?? 'Z Online Bank',
+      });
+      res.status(record.phase === 'FAILED' ? 422 : 200).json(record);
+    } catch (e) {
+      res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+    }
+  });
+
   router.post('/swift/inbound', async (req, res) => {
     if (!requireApiKey(req, res)) return;
     try {
diff --git a/services/settlement-middleware/src/workflows/external-transfer.ts b/services/settlement-middleware/src/workflows/external-transfer.ts
index 4dd0043..699659e 100644
--- a/services/settlement-middleware/src/workflows/external-transfer.ts
+++ b/services/settlement-middleware/src/workflows/external-transfer.ts
@@ -16,7 +16,7 @@ import { loadConfig, loadOfficeProfile, settlementOfficeId } from '../config';
 import { fetchGlBalances, postJournalEntry, resolveGlAccountId } from '../adapters/fineract';
 import { HybxProductionRail } from '../adapters/hybx-production';
 import { archiveIso20022, requestTokenMint } from '../adapters/omnl';
-import { buildMt102Stub, buildMt103Stub, forwardSwiftToListener } from '../adapters/swift';
+import { buildMt102Stub, buildMt103Stub, buildMt202Stub, buildMt910Stub, forwardSwiftToListener } from '../adapters/swift';
 import { settlementStore } from '../store/settlement-store';
 
 export async function processExternalTransfer(
@@ -130,6 +130,29 @@ export async function processExternalTransfer(
 
     if (cfg.rails.swift.enabled) {
       await forwardSwiftToListener(swiftRaw);
+      if (req.tradeFinance?.instrument === 'SBLC') {
+        const cover = buildMt202Stub({
+          senderRef: `${req.idempotencyKey}-COV`,
+          relatedRef: req.idempotencyKey,
+          currency: req.currency,
+          amount: req.amount,
+          valueDate: req.valueDate,
+          orderingInstitution: 'OMNLUS33',
+          beneficiaryInstitution: req.creditorBic ?? 'BANKUS33',
+          remittance: `SBLC cover ${req.tradeFinance.reference ?? req.idempotencyKey}`,
+        });
+        await forwardSwiftToListener(cover);
+      }
+      const advice = buildMt910Stub({
+        transactionRef: `${req.idempotencyKey}-ADV`,
+        relatedRef: req.idempotencyKey,
+        currency: req.currency,
+        amount: req.amount,
+        valueDate: req.valueDate,
+        accountWithInstitution: req.creditorBic,
+        remittance: `Credit confirmation ${req.beneficiaryName}`,
+      });
+      await forwardSwiftToListener(advice);
     }
     const iso = await archiveIso20022({
       messageType: swiftKind === 'MT102' ? 'pacs.008' : 'pacs.008',
diff --git a/services/settlement-middleware/src/workflows/z-bank-m0-m4.ts b/services/settlement-middleware/src/workflows/z-bank-m0-m4.ts
new file mode 100644
index 0000000..38eee5f
--- /dev/null
+++ b/services/settlement-middleware/src/workflows/z-bank-m0-m4.ts
@@ -0,0 +1,230 @@
+import { v4 as uuidv4 } from 'uuid';
+import {
+  ALL_MONEY_LAYERS,
+  buildMoneySupplySnapshot,
+  isIbanValid,
+  m2FiatToTokenLoadAmount,
+  m3TokenLoadAmount,
+  rollExternalTransferVerbiage,
+  resolveZBankLayerJournal,
+  zBankM0ToM4Hops,
+  type ExternalTransferRequest,
+  type SettlementRecord,
+  type ZBankLayerStep,
+  type ZBankM0M4Request,
+} from '@dbis/settlement-core';
+import { loadConfig, loadOfficeProfile, settlementOfficeId } from '../config';
+import { fetchGlBalances, postJournalEntry, resolveGlAccountId } from '../adapters/fineract';
+import { HybxProductionRail } from '../adapters/hybx-production';
+import { archiveIso20022, requestTokenMint } from '../adapters/omnl';
+import { buildMt103Stub, forwardSwiftToListener } from '../adapters/swift';
+import { settlementStore } from '../store/settlement-store';
+
+function toExternalRequest(input: ZBankM0M4Request, officeId: number): ExternalTransferRequest {
+  return {
+    idempotencyKey: input.idempotencyKey,
+    officeId,
+    valueDate: input.valueDate ?? new Date().toISOString().slice(0, 10),
+    currency: input.currency ?? 'USD',
+    amount: input.amount,
+    creditorIban: input.creditorIban,
+    creditorBic: input.creditorBic,
+    beneficiaryName: input.beneficiaryName ?? 'Z Online Bank',
+    orderingName: 'Z Online Bank — OMNL Office 24',
+    remittanceInfo: input.remittanceInfo ?? 'Z Online Bank full settlement M0→M4',
+    moneyLayers: ALL_MONEY_LAYERS,
+    rail: 'SWIFT',
+    swiftMessageKind: 'MT103',
+    convertToCrypto: input.recipientAddress
+      ? {
+          enabled: true,
+          targetChainId: 138,
+          tokenLineId: input.tokenLineId ?? 'USD-M2',
+          recipientAddress: input.recipientAddress,
+        }
+      : undefined,
+  };
+}
+
+export async function processZBankM0ToM4(input: ZBankM0M4Request): Promise<SettlementRecord> {
+  const cfg = loadConfig();
+  const profile = loadOfficeProfile();
+  const officeId = settlementOfficeId(input.officeId);
+  const includeM3 = Boolean(input.recipientAddress?.trim());
+  const req = toExternalRequest(input, officeId);
+
+  const existing = settlementStore.getByIdempotencyKey(req.idempotencyKey);
+  if (existing?.phase === 'SETTLED') return existing;
+
+  const now = new Date().toISOString();
+  let record: SettlementRecord = existing ?? {
+    settlementId: uuidv4(),
+    idempotencyKey: req.idempotencyKey,
+    phase: 'RECEIVED',
+    request: req,
+    layerSteps: [],
+    errors: [],
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  const advance = (phase: SettlementRecord['phase'], patch: Partial<SettlementRecord> = {}) => {
+    record = { ...record, phase, updatedAt: new Date().toISOString(), ...patch };
+    settlementStore.save(record);
+  };
+
+  const glProfile = {
+    glM0: profile.settlement.glM0 ?? cfg.moneySupply.glM0 ?? '1050',
+    glM1: profile.settlement.glM1 ?? cfg.moneySupply.glM1 ?? '2100',
+    glM2: profile.settlement.glM2 ?? cfg.moneySupply.glM2 ?? '2200',
+    glM3: profile.settlement.glM3 ?? cfg.moneySupply.glM3 ?? '2300',
+    glM4NearMoney:
+      profile.settlement.glM4NearMoney ?? cfg.moneySupply.glM4NearMoney ?? cfg.moneySupply.glSettlement ?? '1000',
+  };
+
+  try {
+    if (!isIbanValid(req.creditorIban)) {
+      throw new Error(`Invalid creditor IBAN: ${req.creditorIban}`);
+    }
+    advance('VALIDATED');
+
+    const verbiage = rollExternalTransferVerbiage(req);
+    advance('VERBIAGE_ROLLED', { verbiageDocument: verbiage });
+
+    const amount = parseFloat(req.amount) || 0;
+    const hops = zBankM0ToM4Hops(includeM3);
+    const steps: ZBankLayerStep[] = [];
+    let lastJournalRef: string | undefined;
+
+    if (amount > 0) {
+      const balances = await fetchGlBalances(officeId);
+      const snap = buildMoneySupplySnapshot(officeId, balances);
+
+      for (const hop of hops) {
+        const pair = resolveZBankLayerJournal(hop.from, hop.to, glProfile);
+        if (!pair) {
+          steps.push({
+            from: hop.from,
+            to: hop.to,
+            debitGl: '',
+            creditGl: '',
+            status: 'skipped',
+          });
+          continue;
+        }
+
+        if (hop.to === 'M3') {
+          const { fullyBacked } = m2FiatToTokenLoadAmount(req.amount, snap.M2.broadMoney);
+          const m3Check = m3TokenLoadAmount(req.amount, snap.M2.broadMoney, snap.M3.tokenLiabilities);
+          if (!fullyBacked || !m3Check.fullyBacked) {
+            steps.push({
+              from: hop.from,
+              to: hop.to,
+              debitGl: pair.debitGl,
+              creditGl: pair.creditGl,
+              status: 'failed',
+            });
+            throw new Error(
+              `M2/M3 backing insufficient (${m3Check.loadAmount}/${req.amount} M3 headroom)`,
+            );
+          }
+        }
+
+        const [debitGlId, creditGlId] = await Promise.all([
+          resolveGlAccountId(pair.debitGl),
+          resolveGlAccountId(pair.creditGl),
+        ]);
+        const ref = `${req.idempotencyKey}-${hop.from}${hop.to}`;
+        const je = await postJournalEntry({
+          officeId,
+          transactionDate: req.valueDate,
+          referenceNumber: ref,
+          comments: `${pair.narrative} · ${verbiage.slice(0, 200)}`,
+          debits: [{ glAccountId: debitGlId, amount }],
+          credits: [{ glAccountId: creditGlId, amount }],
+        });
+        lastJournalRef = String(je.resourceId);
+        steps.push({
+          from: hop.from,
+          to: hop.to,
+          debitGl: pair.debitGl,
+          creditGl: pair.creditGl,
+          journalRef: lastJournalRef,
+          status: 'posted',
+        });
+      }
+    }
+
+    advance('FINERACT_POSTED', { fineractJournalRef: lastJournalRef, layerSteps: steps });
+
+    if (cfg.rails.hybx.enabled) {
+      const hybx = new HybxProductionRail();
+      const pay = await hybx.dispatchPayment({
+        idempotencyKey: req.idempotencyKey,
+        amount: req.amount,
+        currency: req.currency,
+        creditorIban: req.creditorIban,
+        creditorBic: req.creditorBic,
+        beneficiaryName: req.beneficiaryName,
+        remittanceInfo: req.remittanceInfo,
+        rail: req.rail,
+      });
+      advance('HYBX_RAIL_DISPATCHED', { hybxPaymentId: pay.paymentId });
+    } else {
+      advance('HYBX_RAIL_DISPATCHED');
+    }
+
+    const swiftRaw = buildMt103Stub({
+      senderRef: req.idempotencyKey,
+      currency: req.currency,
+      amount: req.amount,
+      valueDate: req.valueDate,
+      orderingCustomer: req.orderingName ?? cfg.omnlLegalName,
+      beneficiary: req.beneficiaryName,
+      iban: req.creditorIban,
+      bic: req.creditorBic,
+      remittance: req.remittanceInfo,
+    });
+
+    if (cfg.rails.swift.enabled) {
+      await forwardSwiftToListener(swiftRaw);
+    }
+    const iso = await archiveIso20022({
+      messageType: 'pacs.008',
+      direction: 'OUTBOUND',
+      raw: swiftRaw,
+      settlementRef: record.settlementId,
+    });
+    advance('ISO20022_ARCHIVED', { iso20022MessageId: iso.messageId });
+
+    if (req.convertToCrypto?.enabled && req.convertToCrypto.recipientAddress) {
+      const balances = await fetchGlBalances(officeId);
+      const snap = buildMoneySupplySnapshot(officeId, balances);
+      const { loadAmount, fullyBacked } = m2FiatToTokenLoadAmount(req.amount, snap.M2.broadMoney);
+      const m3Check = m3TokenLoadAmount(loadAmount, snap.M2.broadMoney, snap.M3.tokenLiabilities);
+      if (fullyBacked && m3Check.fullyBacked) {
+        const mint = await requestTokenMint({
+          lineId: req.convertToCrypto.tokenLineId,
+          amount: m3Check.loadAmount,
+          recipient: req.convertToCrypto.recipientAddress,
+          settlementRef: record.settlementId,
+          dryRun: !cfg.production.allowChainMintExecute,
+        });
+        advance('CHAIN_MINT_REQUESTED', { chainTxHash: mint.txHash });
+      } else {
+        record.errors.push('M3 mint skipped — insufficient M2/M3 backing');
+        advance('CHAIN_MINT_REQUESTED');
+      }
+    } else {
+      advance('CHAIN_MINT_REQUESTED');
+    }
+
+    advance('SETTLED');
+    return record;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    record.errors.push(msg);
+    advance('FAILED');
+    return record;
+  }
+}
diff --git a/services/swift-listener/package.json b/services/swift-listener/package.json
index 181b35d..aa67e0f 100644
--- a/services/swift-listener/package.json
+++ b/services/swift-listener/package.json
@@ -4,7 +4,7 @@
   "description": "SWIFT FIN / ISO 20022 listener for Chain 138 and cW* asset broadcasts",
   "main": "dist/index.js",
   "scripts": {
-    "build": "tsc",
+    "build": "node ./node_modules/typescript/bin/tsc",
     "start": "node dist/cli.js",
     "dev": "ts-node src/cli.ts",
     "test": "vitest run",
diff --git a/services/token-aggregation/frontend/index.html b/services/token-aggregation/frontend/index.html
index 5a3f19e..2b8348c 100644
--- a/services/token-aggregation/frontend/index.html
+++ b/services/token-aggregation/frontend/index.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
     <title>Token Aggregation Control Panel</title>
   </head>
   <body>
diff --git a/services/token-aggregation/frontend/src/components/Layout.tsx b/services/token-aggregation/frontend/src/components/Layout.tsx
index e1d3083..7e3331c 100644
--- a/services/token-aggregation/frontend/src/components/Layout.tsx
+++ b/services/token-aggregation/frontend/src/components/Layout.tsx
@@ -1,11 +1,13 @@
 import { Outlet, Link, useLocation } from 'react-router-dom';
+import { useState } from 'react';
 import { useAuthStore } from '../stores/authStore';
-import { LogOut, Key, Network, Factory, BarChart3 } from 'lucide-react';
+import { LogOut, Key, Network, Factory, BarChart3, Menu } from 'lucide-react';
 import toast from 'react-hot-toast';
 
 export default function Layout() {
   const { user, logout } = useAuthStore();
   const location = useLocation();
+  const [menuOpen, setMenuOpen] = useState(false);
 
   const handleLogout = () => {
     logout();
@@ -21,14 +23,23 @@ export default function Layout() {
 
   return (
     <div className="min-h-screen bg-gray-50">
-      <nav className="bg-white shadow-sm border-b border-gray-200">
+      <nav className="bg-white shadow-sm border-b border-gray-200 sticky top-0 z-40">
         <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-          <div className="flex justify-between h-16">
-            <div className="flex">
-              <div className="flex-shrink-0 flex items-center">
-                <h1 className="text-xl font-bold text-gray-900">Token Aggregation Control Panel</h1>
-              </div>
-              <div className="hidden sm:ml-6 sm:flex sm:space-x-8">
+          <div className="flex justify-between h-14 sm:h-16">
+            <div className="flex items-center gap-2 min-w-0 flex-1">
+              <button
+                type="button"
+                className="sm:hidden p-2 rounded-md text-gray-600 hover:bg-gray-100 min-h-[44px] min-w-[44px] flex items-center justify-center"
+                aria-label="Open menu"
+                aria-expanded={menuOpen}
+                onClick={() => setMenuOpen(!menuOpen)}
+              >
+                <Menu className="h-6 w-6" />
+              </button>
+              <h1 className="text-base sm:text-xl font-bold text-gray-900 truncate">
+                Token Aggregation
+              </h1>
+              <div className="hidden sm:ml-6 sm:flex sm:space-x-6">
                 {navigation.map((item) => {
                   const Icon = item.icon;
                   const isActive = location.pathname === item.href;
@@ -36,34 +47,55 @@ export default function Layout() {
                     <Link
                       key={item.name}
                       to={item.href}
-                      className={`inline-flex items-center px-1 pt-1 border-b-2 text-sm font-medium ${
+                      className={`inline-flex items-center px-1 pt-1 border-b-2 text-sm font-medium min-h-[44px] ${
                         isActive
                           ? 'border-primary-500 text-gray-900'
                           : 'border-transparent text-gray-500 hover:border-gray-300 hover:text-gray-700'
                       }`}
                     >
-                      <Icon className="mr-2 h-4 w-4" />
+                      <Icon className="mr-2 h-4 w-4 shrink-0" />
                       {item.name}
                     </Link>
                   );
                 })}
               </div>
             </div>
-            <div className="flex items-center space-x-4">
-              <span className="text-sm text-gray-700">{user?.username}</span>
+            <div className="flex items-center gap-2 sm:gap-4 shrink-0">
+              <span className="text-xs sm:text-sm text-gray-700 truncate max-w-[6rem] sm:max-w-none">{user?.username}</span>
               <button
                 onClick={handleLogout}
-                className="inline-flex items-center px-3 py-2 border border-transparent text-sm leading-4 font-medium rounded-md text-gray-700 bg-white hover:bg-gray-50 focus:outline-none"
+                className="inline-flex items-center px-2 sm:px-3 py-2 border border-transparent text-sm font-medium rounded-md text-gray-700 bg-white hover:bg-gray-50 min-h-[44px]"
               >
-                <LogOut className="h-4 w-4 mr-2" />
-                Logout
+                <LogOut className="h-4 w-4 sm:mr-2" />
+                <span className="hidden sm:inline">Logout</span>
               </button>
             </div>
           </div>
+          {menuOpen && (
+            <div className="sm:hidden border-t border-gray-200 py-2 pb-3">
+              {navigation.map((item) => {
+                const Icon = item.icon;
+                const isActive = location.pathname === item.href;
+                return (
+                  <Link
+                    key={item.name}
+                    to={item.href}
+                    onClick={() => setMenuOpen(false)}
+                    className={`flex items-center px-3 py-3 text-sm font-medium rounded-md min-h-[44px] ${
+                      isActive ? 'bg-primary-50 text-primary-700' : 'text-gray-600 hover:bg-gray-50'
+                    }`}
+                  >
+                    <Icon className="mr-3 h-5 w-5" />
+                    {item.name}
+                  </Link>
+                );
+              })}
+            </div>
+          )}
         </div>
       </nav>
 
-      <main className="max-w-7xl mx-auto py-6 sm:px-6 lg:px-8">
+      <main className="max-w-7xl mx-auto py-4 sm:py-6 px-4 sm:px-6 lg:px-8 w-full min-w-0">
         <Outlet />
       </main>
     </div>
diff --git a/services/token-aggregation/frontend/src/index.css b/services/token-aggregation/frontend/src/index.css
index 70f4578..41d3e23 100644
--- a/services/token-aggregation/frontend/src/index.css
+++ b/services/token-aggregation/frontend/src/index.css
@@ -11,7 +11,7 @@
 body {
   margin: 0;
   min-height: 100vh;
-  background-color: #f9fafb;
+  background-color: #f0fdf4;
 }
 
 #root {
diff --git a/services/token-aggregation/public/omnl-api-base.js b/services/token-aggregation/public/omnl-api-base.js
new file mode 100644
index 0000000..2f79ad0
--- /dev/null
+++ b/services/token-aggregation/public/omnl-api-base.js
@@ -0,0 +1,8 @@
+(function () {
+  /** auto → same-origin /api/v1 (vite proxy, portal-serve, or token-aggregation). */
+  window.resolveOmnlApiBase = function () {
+    const meta = document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content')?.trim();
+    if (meta && meta !== 'auto') return meta.replace(/\/$/, '');
+    return '/api/v1';
+  };
+})();
diff --git a/services/token-aggregation/public/omnl-compliance-console.css b/services/token-aggregation/public/omnl-compliance-console.css
index 52c0325..41ed3ec 100644
--- a/services/token-aggregation/public/omnl-compliance-console.css
+++ b/services/token-aggregation/public/omnl-compliance-console.css
@@ -7,7 +7,7 @@
   --ok: #3dd68c;
   --warn: #f5c542;
   --bad: #f07178;
-  --accent: #6cb6ff;
+  --accent: #4ade80;
   --mono: ui-monospace, 'Cascadia Code', 'SF Mono', monospace;
 }
 
@@ -71,8 +71,8 @@ button, .btn {
 }
 
 button:hover, .btn:hover { border-color: var(--accent); color: var(--accent); }
-button.primary { background: #1a3a5c; border-color: #2d5f9a; }
-button.primary:hover { background: #224b78; }
+button.primary { background: #14532d; border-color: #22c55e; }
+button.primary:hover { background: #166534; }
 
 .grid {
   display: grid;
@@ -205,4 +205,15 @@ footer a { color: var(--accent); }
 
 @media (max-width: 640px) {
   .kv { grid-template-columns: 1fr; }
+  .wrap { padding-left: 0.75rem; padding-right: 0.75rem; }
+  header { flex-direction: column; align-items: stretch; }
+  .toolbar { width: 100%; }
+  .toolbar button,
+  .toolbar .btn {
+    min-height: 44px;
+    flex: 1 1 calc(50% - 0.25rem);
+    justify-content: center;
+  }
+  h1 { font-size: 1.15rem; }
+  pre, table { font-size: 12px; }
 }
diff --git a/services/token-aggregation/public/omnl-compliance-console.html b/services/token-aggregation/public/omnl-compliance-console.html
index da790d4..37c848d 100644
--- a/services/token-aggregation/public/omnl-compliance-console.html
+++ b/services/token-aggregation/public/omnl-compliance-console.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <meta name="omnl-api-base" content="/token-aggregation/api/v1" />
+  <meta name="omnl-api-base" content="auto" />
   <title>OMNL Compliance Console</title>
   <link rel="stylesheet" href="/omnl/static/omnl-compliance-console.css" />
 </head>
@@ -78,6 +78,7 @@
       </p>
     </footer>
   </div>
+  <script src="/omnl/static/omnl-api-base.js"></script>
   <script src="/omnl/static/omnl-compliance-console.js"></script>
 </body>
 </html>
diff --git a/services/token-aggregation/public/omnl-compliance-console.js b/services/token-aggregation/public/omnl-compliance-console.js
index 237c19f..e4b878c 100644
--- a/services/token-aggregation/public/omnl-compliance-console.js
+++ b/services/token-aggregation/public/omnl-compliance-console.js
@@ -1,8 +1,9 @@
 (function () {
   const params = new URLSearchParams(window.location.search);
   const accessToken = params.get('access_token') || '';
-  const apiBase =
-    document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content')?.trim() || '/api/v1';
+  const apiBase = window.resolveOmnlApiBase
+    ? window.resolveOmnlApiBase()
+    : document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content')?.trim() || '/api/v1';
 
   const els = {
     status: document.getElementById('load-status'),
@@ -140,12 +141,22 @@
 
   function renderExternal(data) {
     const ev = data.externalVisibility || {};
-    els.external.innerHTML = kv([
-      ['DefiLlama chain', ev.defiLlama && ev.defiLlama.chainPage],
-      ['Pricing PR', ev.defiLlama && ev.defiLlama.pr12094],
-      ['Bridge TVL PR', ev.defiLlama && ev.defiLlama.pr19451],
-      ['Safe deployments PR', ev.safeDeployments && ev.safeDeployments.pr1568],
-    ]);
+    const guosmm = ev.guosmmGazette || {};
+    const noticeLinks = (guosmm.notices || [])
+      .map(function (n) {
+        return '<a href="' + esc(n.url) + '" target="_blank" rel="noopener">' + esc(n.documentId) + '</a>';
+      })
+      .join(' · ');
+    els.external.innerHTML =
+      kv([
+        ['GUOSMM gazette', guosmm.base || '—'],
+        ['API registry', guosmm.apiRegistry || '/api/v1/omnl/gazette/notices'],
+        ['Notices', noticeLinks || '—'],
+        ['DefiLlama chain', ev.defiLlama && ev.defiLlama.chainPage],
+        ['Pricing PR', ev.defiLlama && ev.defiLlama.pr12094],
+        ['Bridge TVL PR', ev.defiLlama && ev.defiLlama.pr19451],
+        ['Safe deployments PR', ev.safeDeployments && ev.safeDeployments.pr1568],
+      ]);
   }
 
   function renderHoLiquidity(snap) {
@@ -162,7 +173,7 @@
       ['Reserve coverage', cov.coverageRatio != null ? cov.coverageRatio.toFixed(2) + '×' : '—'],
       ['Reserve assets', cov.reserveAssetsUsd != null ? '$' + Number(cov.reserveAssetsUsd).toLocaleString() : '—'],
       ['Issued c* USD', cov.issuedCStarUsd != null ? '$' + Number(cov.issuedCStarUsd).toLocaleString() : '—'],
-      ['Public API', '/token-aggregation/api/v1/omnl/ho-liquidity-snapshot'],
+      ['Public API', apiBase + '/omnl/ho-liquidity-snapshot'],
     ]);
   }
 
diff --git a/services/token-aggregation/public/omnl-dashboard.html b/services/token-aggregation/public/omnl-dashboard.html
index c6547da..0c475a7 100644
--- a/services/token-aggregation/public/omnl-dashboard.html
+++ b/services/token-aggregation/public/omnl-dashboard.html
@@ -2,14 +2,19 @@
 <html lang="en">
 <head>
   <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
   <title>HYBX OMNL — status</title>
   <style>
-    body { font-family: system-ui, sans-serif; margin: 1.5rem; max-width: 56rem; }
+    body { font-family: system-ui, sans-serif; margin: 1.5rem; max-width: 56rem; overflow-x: hidden; }
     h1 { font-size: 1.25rem; }
-    pre { background: #111; color: #eee; padding: 1rem; overflow: auto; border-radius: 6px; font-size: 12px; }
+    pre { background: #111; color: #eee; padding: 1rem; overflow: auto; border-radius: 6px; font-size: 12px; -webkit-overflow-scrolling: touch; }
     .err { color: #f66; }
-    a { color: #6cf; }
+    a { color: #6cf; word-break: break-word; }
+    @media (max-width: 640px) {
+      body { margin: 1rem 0.75rem; }
+      h1 { font-size: 1.1rem; }
+      p { font-size: 0.9rem; }
+    }
   </style>
 </head>
 <body>
@@ -21,20 +26,22 @@
   <pre id="reg">Loading…</pre>
   <h2>Fineract compare</h2>
   <pre id="fin">Loading…</pre>
+  <script src="/omnl/static/omnl-api-base.js"></script>
   <script>
     (function () {
       const params = new URLSearchParams(window.location.search);
       const accessToken = params.get('access_token') || '';
+      const apiBase = window.resolveOmnlApiBase ? window.resolveOmnlApiBase() : '/api/v1';
       const apiHeaders = accessToken ? { Authorization: 'Bearer ' + accessToken } : {};
       async function load() {
         try {
-          const r = await fetch('/api/v1/omnl/ipsas/registry');
+          const r = await fetch(apiBase + '/omnl/ipsas/registry');
           document.getElementById('reg').textContent = JSON.stringify(await r.json(), null, 2);
         } catch (e) {
           document.getElementById('reg').innerHTML = '<span class="err">' + e + '</span>';
         }
         try {
-          const f = await fetch('/api/v1/omnl/ipsas/fineract-compare', { headers: apiHeaders });
+          const f = await fetch(apiBase + '/omnl/ipsas/fineract-compare', { headers: apiHeaders });
           const t = await f.text();
           document.getElementById('fin').textContent = t;
         } catch (e) {
diff --git a/services/token-aggregation/public/omnl-settlement-terminal.html b/services/token-aggregation/public/omnl-settlement-terminal.html
index cfe56b5..17803b4 100644
--- a/services/token-aggregation/public/omnl-settlement-terminal.html
+++ b/services/token-aggregation/public/omnl-settlement-terminal.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <meta name="omnl-api-base" content="/api/v1" />
+  <meta name="omnl-api-base" content="auto" />
   <title>OMNL / HYBX Settlement Terminal</title>
   <link rel="stylesheet" href="/omnl/static/omnl-settlement-terminal.css" />
 </head>
@@ -70,6 +70,7 @@
       </p>
     </footer>
   </div>
+  <script src="/omnl/static/omnl-api-base.js"></script>
   <script src="/omnl/static/omnl-settlement-terminal.js"></script>
 </body>
 </html>
diff --git a/services/token-aggregation/public/omnl-settlement-terminal.js b/services/token-aggregation/public/omnl-settlement-terminal.js
index d2392e4..09e8174 100644
--- a/services/token-aggregation/public/omnl-settlement-terminal.js
+++ b/services/token-aggregation/public/omnl-settlement-terminal.js
@@ -1,5 +1,7 @@
 (function () {
-  const API_BASE = document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content') || '/api/v1';
+  const API_BASE = window.resolveOmnlApiBase
+    ? window.resolveOmnlApiBase()
+    : document.querySelector('meta[name="omnl-api-base"]')?.getAttribute('content') || '/api/v1';
   const screenEl = document.getElementById('terminal-screen');
   const jsonEl = document.getElementById('json-out');
   const inpRef = document.getElementById('inp-settlement-ref');
diff --git a/services/token-aggregation/public/reserve-dashboard.css b/services/token-aggregation/public/reserve-dashboard.css
index 0715470..eb0b892 100644
--- a/services/token-aggregation/public/reserve-dashboard.css
+++ b/services/token-aggregation/public/reserve-dashboard.css
@@ -8,7 +8,7 @@
   --fail: #ef4444;
   --warn: #f59e0b;
   --skip: #64748b;
-  --accent: #38bdf8;
+  --accent: #4ade80;
 }
 
 * { box-sizing: border-box; }
@@ -42,7 +42,7 @@ button, .btn {
   text-decoration: none;
   font-size: 0.875rem;
 }
-button.primary, .btn.primary { background: #0ea5e9; border-color: #0284c7; color: #041018; font-weight: 600; }
+button.primary, .btn.primary { background: #22c55e; border-color: #16a34a; color: #041008; font-weight: 600; }
 .status-bar {
   padding: 0.65rem 0.85rem;
   border-radius: 0.375rem;
@@ -104,3 +104,15 @@ footer a { color: var(--accent); }
   margin-bottom: 1rem;
   font-size: 0.9rem;
 }
+
+@media (max-width: 640px) {
+  .wrap { padding: 0.75rem; }
+  h1 { font-size: 1.25rem; }
+  .proof-row {
+    grid-template-columns: 2.5rem 1fr;
+    grid-template-rows: auto auto;
+  }
+  .proof-row .badge { grid-column: 2; justify-self: start; }
+  .toolbar button, .toolbar .btn { min-height: 44px; }
+  .raw { max-height: 16rem; font-size: 0.7rem; }
+}
diff --git a/services/token-aggregation/src/api/middleware/omnl-guards.ts b/services/token-aggregation/src/api/middleware/omnl-guards.ts
index 43719ce..72d3114 100644
--- a/services/token-aggregation/src/api/middleware/omnl-guards.ts
+++ b/services/token-aggregation/src/api/middleware/omnl-guards.ts
@@ -50,6 +50,7 @@ const OMNL_PUBLIC_PATH_SUFFIXES = ['/omnl/openapi.json', '/omnl/catalog', '/omnl
 
 function isPublicOmnlPath(path: string): boolean {
   if (OMNL_PUBLIC_PATH_SUFFIXES.some((s) => path.endsWith(s))) return true;
+  if (path.includes('/omnl/gazette/')) return true;
   // Compliance console is read-only; allow without API key when explicitly enabled (LAN operator UI).
   if (process.env.OMNL_COMPLIANCE_CONSOLE_PUBLIC === '1' && isComplianceConsolePath(path)) return true;
   return false;
@@ -60,14 +61,15 @@ function isPublicOmnlPath(path: string): boolean {
  * except openapi.json, catalog, and integration-status.
  */
 export function omnlRequireApiKeyInProduction(req: Request, res: Response, next: NextFunction): void {
-  if (!req.path.startsWith('/omnl')) {
+  const path = req.path || '';
+  if (!path.includes('/omnl/')) {
     next();
     return;
   }
   const requireKey =
     process.env.OMNL_REQUIRE_API_KEY === '1' ||
     (process.env.NODE_ENV || '').toLowerCase() === 'production';
-  if (!requireKey || isPublicOmnlPath(req.path)) {
+  if (!requireKey || isPublicOmnlPath(path)) {
     next();
     return;
   }
diff --git a/services/token-aggregation/src/api/routes/omnl.ts b/services/token-aggregation/src/api/routes/omnl.ts
index 39b4faa..5358767 100644
--- a/services/token-aggregation/src/api/routes/omnl.ts
+++ b/services/token-aggregation/src/api/routes/omnl.ts
@@ -15,6 +15,7 @@ import { omnlComplianceCore138, omnlReserveStore138 } from '../../services/omnl-
 import { computeOmnlReconcileAnchor } from '../../services/omnl-reconcile-anchor';
 import { getOmnlIntegrationStatus } from '../../services/omnl-integration-status';
 import { getOmnlApiCatalog } from '../../services/omnl-api-catalog';
+import { loadGuosmmNotices, getGuosmmNotice } from '../../services/omnl-gazette-notices';
 import omnlOpenApi from '../../resources/omnl-openapi.json';
 import {
   executeErc20Transfer,
@@ -53,6 +54,45 @@ function resolveMintTokenAddress(lineId: string, symbol?: string, tokenAddress?:
 const router = Router();
 router.use(omnlRateLimiter);
 router.use(omnlAuditMiddleware);
+
+/**
+ * Public discovery + gazette (registered before production API key gate).
+ */
+router.get('/omnl/openapi.json', (_req: Request, res: Response) => {
+  res.type('application/json').json(omnlOpenApi as Record<string, unknown>);
+});
+
+router.get('/omnl/catalog', (_req: Request, res: Response) => {
+  res.json(getOmnlApiCatalog());
+});
+
+router.get('/omnl/integration-status', (_req: Request, res: Response) => {
+  res.json({
+    generatedAt: new Date().toISOString(),
+    ...getOmnlIntegrationStatus(),
+  });
+});
+
+router.get('/omnl/gazette/notices', (_req: Request, res: Response) => {
+  const reg = loadGuosmmNotices();
+  res.json({
+    generatedAt: new Date().toISOString(),
+    gazetteBase: reg.gazetteBase,
+    count: reg.notices.length,
+    notices: reg.notices,
+  });
+});
+
+router.get('/omnl/gazette/notices/:documentId', (req: Request, res: Response) => {
+  const documentId = String(req.params.documentId ?? '');
+  const notice = getGuosmmNotice(documentId);
+  if (!notice) {
+    res.status(404).json({ error: 'Notice not found' });
+    return;
+  }
+  res.json(notice);
+});
+
 router.use(omnlRequireApiKeyInProduction);
 
 const REGISTRY_ABI: InterfaceAbi = [
@@ -66,30 +106,6 @@ const COORDINATOR_ABI: InterfaceAbi = [
   'function feeToken() view returns (address)',
 ];
 
-/**
- * GET /omnl/openapi.json — OpenAPI 3.0 document for Swagger UI / codegen.
- */
-router.get('/omnl/openapi.json', (_req: Request, res: Response) => {
-  res.type('application/json').json(omnlOpenApi as Record<string, unknown>);
-});
-
-/**
- * GET /omnl/catalog — machine-readable list of OMNL HTTP integrations.
- */
-router.get('/omnl/catalog', (_req: Request, res: Response) => {
-  res.json(getOmnlApiCatalog());
-});
-
-/**
- * GET /omnl/integration-status — which env-backed integrations are present (no secrets).
- */
-router.get('/omnl/integration-status', (_req: Request, res: Response) => {
-  res.json({
-    generatedAt: new Date().toISOString(),
-    ...getOmnlIntegrationStatus(),
-  });
-});
-
 /**
  * GET /omnl/reconcile-anchor — same SHA-256 as omnl-reconcile-report.mjs (IPSAS + matrix files).
  */
diff --git a/services/token-aggregation/src/api/routes/z-bot.ts b/services/token-aggregation/src/api/routes/z-bot.ts
new file mode 100644
index 0000000..513a315
--- /dev/null
+++ b/services/token-aggregation/src/api/routes/z-bot.ts
@@ -0,0 +1,35 @@
+import { Router, type Request, type Response } from 'express';
+import { zBotReply, zBotLlmStatus } from '../../services/z-bot-context';
+
+const router = Router();
+
+router.get('/z-bot/health', (_req: Request, res: Response) => {
+  const llm = zBotLlmStatus();
+  res.json({
+    service: 'z-bot',
+    status: 'ok',
+    llm,
+    fallback: 'rule-based when Azure OpenAI is not configured',
+  });
+});
+
+router.post('/z-bot/chat', async (req: Request, res: Response) => {
+  const { message, walletAddress, chainId } = req.body as {
+    message?: string;
+    sessionId?: string;
+    walletAddress?: string;
+    chainId?: number;
+  };
+  if (!message?.trim()) {
+    res.status(400).json({ error: 'message is required' });
+    return;
+  }
+  try {
+    const reply = await zBotReply(message.trim(), walletAddress, chainId);
+    res.json({ reply, sessionId: req.body.sessionId, llm: zBotLlmStatus().provider });
+  } catch (e) {
+    res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+  }
+});
+
+export default router;
diff --git a/services/token-aggregation/src/api/routes/z-wallet.ts b/services/token-aggregation/src/api/routes/z-wallet.ts
new file mode 100644
index 0000000..190164f
--- /dev/null
+++ b/services/token-aggregation/src/api/routes/z-wallet.ts
@@ -0,0 +1,43 @@
+import { Router, type Request, type Response } from 'express';
+import { loadZChainIntegration, fetchSettlementStatus } from '../../services/z-bot-context';
+
+const router = Router();
+
+router.get('/z-wallet/corridors', (_req: Request, res: Response) => {
+  try {
+    const integration = loadZChainIntegration() as {
+      internationalCorridors?: unknown[];
+      brand?: unknown;
+      chain?: unknown;
+    };
+    res.json({
+      brand: integration.brand,
+      chain: integration.chain,
+      corridors: integration.internationalCorridors ?? [],
+    });
+  } catch (e) {
+    res.status(500).json({ error: e instanceof Error ? e.message : String(e) });
+  }
+});
+
+router.get('/z-wallet/status/:ref', async (req: Request, res: Response) => {
+  const ref = String(req.params.ref);
+  if (!ref) {
+    res.status(400).json({ error: 'Missing settlement reference' });
+    return;
+  }
+  const rec = await fetchSettlementStatus(ref);
+  if (!rec) {
+    res.status(404).json({ error: 'Settlement not found', settlementId: ref });
+    return;
+  }
+  res.json({
+    settlementId: rec.settlementId ?? ref,
+    phase: rec.phase,
+    status: rec.phase ?? rec.status,
+    chainTxHash: rec.chainTxHash,
+    error: rec.error,
+  });
+});
+
+export default router;
diff --git a/services/token-aggregation/src/api/server.ts b/services/token-aggregation/src/api/server.ts
index 24a5bcd..6a3347c 100644
--- a/services/token-aggregation/src/api/server.ts
+++ b/services/token-aggregation/src/api/server.ts
@@ -26,6 +26,8 @@ import omnlIpsasRoutes from './routes/omnl-ipsas';
 import omnlPayoutJournalRoutes from './routes/omnl-payout-journal-routes';
 import omnlComplianceRoutes from './routes/omnl-compliance-routes';
 import omnlTerminalRoutes from './routes/omnl-terminal-routes';
+import zWalletRoutes from './routes/z-wallet';
+import zBotRoutes from './routes/z-bot';
 import checkpointRoutes from './routes/checkpoint';
 import reserveCapacityRoutes from './routes/reserve-capacity';
 import hoLiquidityRoutes from './routes/ho-liquidity-routes';
@@ -322,6 +324,8 @@ export class ApiServer {
     this.app.use('/api/v1', omnlRoutes);
     this.app.use('/api/v1', omnlIpsasRoutes);
     this.app.use('/api/v1', omnlPayoutJournalRoutes);
+    this.app.use('/api/v1', zWalletRoutes);
+    this.app.use('/api/v1', zBotRoutes);
     this.app.use('/api/v2', plannerV2Routes);
 
     // Admin routes (stricter rate limit)
diff --git a/services/token-aggregation/src/services/omnl-api-catalog.ts b/services/token-aggregation/src/services/omnl-api-catalog.ts
index eb8c932..c86a7e8 100644
--- a/services/token-aggregation/src/services/omnl-api-catalog.ts
+++ b/services/token-aggregation/src/services/omnl-api-catalog.ts
@@ -19,6 +19,8 @@ export function getOmnlApiCatalog(): {
     endpoints: [
       { method: 'GET', path: '/omnl/openapi.json', description: 'OpenAPI 3.0 JSON (Swagger-compatible)', auth: 'none' },
       { method: 'GET', path: '/omnl/catalog', description: 'This catalog (machine-readable)', auth: 'none' },
+      { method: 'GET', path: '/omnl/gazette/notices', description: 'GUOSMM official gazette notice registry', auth: 'none' },
+      { method: 'GET', path: '/omnl/gazette/notices/:documentId', description: 'Single GUOSMM notice by document ID', auth: 'none' },
       { method: 'GET', path: '/omnl/integration-status', description: 'Which env-backed integrations are configured', auth: 'none' },
       { method: 'GET', path: '/omnl/reconcile-anchor', description: 'SHA-256 of canonical IPSAS registry + journal matrix JSON', auth: 'OMNL_API_KEY when OMNL_REQUIRE_API_KEY=1' },
       { method: 'GET', path: '/omnl/reconcile/triple-state', description: 'Fineract + on-chain + custodian reconcile', query: ['lineId'], auth: 'OMNL_API_KEY' },
diff --git a/services/token-aggregation/src/services/omnl-compliance-console.ts b/services/token-aggregation/src/services/omnl-compliance-console.ts
index fd30396..0031b7c 100644
--- a/services/token-aggregation/src/services/omnl-compliance-console.ts
+++ b/services/token-aggregation/src/services/omnl-compliance-console.ts
@@ -6,6 +6,7 @@ import { getWeb3ComplianceSummary } from './omnl-web3-compliance';
 import { getComplianceSignoffsSummary } from './omnl-ifrs-disclosures';
 import { omnlReserveStore138 } from './omnl-chain138-addresses';
 import { buildSafeNotaryGateTransaction } from './omnl-safe-notary-gate-tx';
+import { loadGuosmmNotices } from './omnl-gazette-notices';
 
 function projectRoot(): string {
   return (
@@ -83,6 +84,11 @@ export interface ComplianceConsoleSnapshot {
   externalVisibility: {
     defiLlama: { chainPage: string; pr12094: string; pr19451: string; note: string };
     safeDeployments: { pr1568: string; note: string };
+    guosmmGazette: {
+      base: string;
+      apiRegistry: string;
+      notices: Array<{ documentId: string; title: string; url: string }>;
+    };
   };
   explorerBase: string;
 }
@@ -280,6 +286,15 @@ export async function buildComplianceConsoleSnapshot(
         pr1568: 'https://github.com/safe-global/safe-deployments/pull/1568',
         note: 'Safe Wallet npm registry for chain 138',
       },
+      guosmmGazette: {
+        base: loadGuosmmNotices().gazetteBase,
+        apiRegistry: '/api/v1/omnl/gazette/notices',
+        notices: loadGuosmmNotices().notices.map((n) => ({
+          documentId: n.documentId,
+          title: n.title,
+          url: n.url,
+        })),
+      },
     },
     explorerBase: process.env.EXPLORER_PUBLIC_URL?.trim() || 'https://explorer.d-bis.org',
   };
diff --git a/services/token-aggregation/src/services/omnl-gazette-notices.ts b/services/token-aggregation/src/services/omnl-gazette-notices.ts
new file mode 100644
index 0000000..08f0c9a
--- /dev/null
+++ b/services/token-aggregation/src/services/omnl-gazette-notices.ts
@@ -0,0 +1,49 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+export type GuosmmNotice = {
+  documentId: string;
+  series: string;
+  title: string;
+  documentType: string;
+  url: string;
+  publishedAt: string;
+  effectiveAt: string;
+  signingAuthority: string;
+  contentSha256: string;
+  [key: string]: unknown;
+};
+
+export type GuosmmNoticeRegistry = {
+  version: string;
+  gazetteBase: string;
+  updated: string;
+  notices: GuosmmNotice[];
+};
+
+function repoRoot(): string {
+  return (
+    process.env.OMNL_BANK_ROOT?.trim() ||
+    process.env.PROXMOX_ROOT?.trim() ||
+    resolve(process.cwd(), '../../..')
+  );
+}
+
+export function loadGuosmmNotices(): GuosmmNoticeRegistry {
+  const path = resolve(repoRoot(), 'config/guosmm-notices.v1.json');
+  if (!existsSync(path)) {
+    return { version: '0', gazetteBase: 'https://gazette.shosjj.org/notices/2026', updated: '', notices: [] };
+  }
+  return JSON.parse(readFileSync(path, 'utf8')) as GuosmmNoticeRegistry;
+}
+
+export function getGuosmmNotice(documentId: string): GuosmmNotice | null {
+  const reg = loadGuosmmNotices();
+  return reg.notices.find((n) => n.documentId === documentId) ?? null;
+}
+
+export function listGuosmmNoticesByScope(scope?: string): GuosmmNotice[] {
+  const reg = loadGuosmmNotices();
+  if (!scope) return reg.notices;
+  return reg.notices.filter((n) => Array.isArray(n.scope) && (n.scope as string[]).includes(scope));
+}
diff --git a/services/token-aggregation/src/services/z-bot-context.ts b/services/token-aggregation/src/services/z-bot-context.ts
new file mode 100644
index 0000000..dae6c79
--- /dev/null
+++ b/services/token-aggregation/src/services/z-bot-context.ts
@@ -0,0 +1,200 @@
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+
+function repoRoot(): string {
+  return resolve(__dirname, '../../../../..');
+}
+
+export function loadZChainIntegration(): Record<string, unknown> {
+  const p = resolve(repoRoot(), 'config/z-chain-integration.v1.json');
+  if (!existsSync(p)) {
+    throw new Error('config/z-chain-integration.v1.json not found');
+  }
+  return JSON.parse(readFileSync(p, 'utf8')) as Record<string, unknown>;
+}
+
+export function loadZEcosystem(): Record<string, unknown> {
+  const p = resolve(repoRoot(), 'config/z-ecosystem.v1.json');
+  if (!existsSync(p)) {
+    throw new Error('config/z-ecosystem.v1.json not found');
+  }
+  return JSON.parse(readFileSync(p, 'utf8')) as Record<string, unknown>;
+}
+
+function rpcUrl(chainId: number): string | undefined {
+  if (chainId === 138) return process.env.RPC_URL_138 || process.env.RPC_URL;
+  return process.env[`CHAIN_${chainId}_RPC_URL`];
+}
+
+export async function fetchWalletBalance(
+  walletAddress: string,
+  chainId: number,
+): Promise<string | null> {
+  const rpc = rpcUrl(chainId);
+  if (!rpc) return null;
+  try {
+    const res = await fetch(rpc, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        id: 1,
+        method: 'eth_getBalance',
+        params: [walletAddress, 'latest'],
+      }),
+    });
+    const json = (await res.json()) as { result?: string };
+    if (!json.result) return null;
+    const wei = BigInt(json.result);
+    const eth = Number(wei) / 1e18;
+    return eth.toFixed(6);
+  } catch {
+    return null;
+  }
+}
+
+export async function fetchSettlementStatus(ref: string): Promise<Record<string, unknown> | null> {
+  const base =
+    process.env.SETTLEMENT_MIDDLEWARE_URL?.replace(/\/$/, '') ||
+    'http://127.0.0.1:3011';
+  const path = base.includes('/settlement')
+    ? `${base}/api/v1/settlement/settlements/${encodeURIComponent(ref)}`
+    : `${base}/api/v1/settlement/settlements/${encodeURIComponent(ref)}`;
+  const headers: Record<string, string> = {};
+  const key = process.env.OMNL_API_KEY?.trim();
+  if (key) headers.Authorization = `Bearer ${key}`;
+  try {
+    const res = await fetch(path, { headers });
+    if (!res.ok) return null;
+    return (await res.json()) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+type ChatContext = {
+  walletAddress?: string;
+  chainId?: number;
+  balance?: string | null;
+  corridors: unknown[];
+  ecosystemRoutes: Record<string, string>;
+};
+
+export async function buildZBotContext(
+  walletAddress?: string,
+  chainId?: number,
+): Promise<ChatContext> {
+  const integration = loadZChainIntegration() as {
+    internationalCorridors?: unknown[];
+    brand?: { wallet?: string; bank?: string };
+  };
+  const ecosystem = loadZEcosystem() as { routes?: Record<string, string> };
+  const cid = chainId ?? 900002;
+  const balance = walletAddress ? await fetchWalletBalance(walletAddress, cid) : null;
+  return {
+    walletAddress,
+    chainId: cid,
+    balance,
+    corridors: integration.internationalCorridors ?? [],
+    ecosystemRoutes: ecosystem.routes ?? {},
+  };
+}
+
+function ruleBasedReply(message: string, ctx: ChatContext): string {
+  const lower = message.toLowerCase();
+  if (lower.includes('balance')) {
+    if (!ctx.walletAddress) {
+      return 'Connect your International Z Wallet first, then ask again for your balance.';
+    }
+    if (ctx.balance != null) {
+      return `Your Z Chain native balance is approximately ${ctx.balance} Z. For token balances, open the wallet panel.`;
+    }
+    return 'I could not read your on-chain balance right now. Check RPC configuration (CHAIN_900002_RPC_URL).';
+  }
+  if (lower.includes('iraq') || lower.includes('iran') || lower.includes('corridor') || lower.includes('send')) {
+    const lines = (ctx.corridors as { id: string; label: string; rails: string[] }[])
+      .map((c) => `• ${c.label} (${c.id}) — rails: ${c.rails.join(', ')}`)
+      .join('\n');
+    return `International corridors:\n${lines}\n\nUse the International transfer panel in the wallet to submit a payment. I cannot sign transactions.`;
+  }
+  if (lower.includes('transfer') && (lower.includes('status') || lower.includes('where'))) {
+    return 'Enter your settlement reference in the transfer status card after submitting, or paste the reference here and I will look it up on the next message with "status REF".';
+  }
+  const statusMatch = lower.match(/status\s+([a-f0-9-]{8,})/i);
+  if (statusMatch) {
+    return `Check transfer status in the wallet UI for reference ${statusMatch[1]}, or call GET /api/v1/z-wallet/status/${statusMatch[1]}.`;
+  }
+  if (lower.includes('bank') || lower.includes('z online')) {
+    return `Z Online Bank is at ${ctx.ecosystemRoutes.onlineBank ?? '/central-bank'} for M0–M4 settlement.`;
+  }
+  return `I can help with balance, international corridors (Iraq, Iran, EU, global), transfer status, and links to Z Online Bank. Try: "What is my balance?" or "How do I send to Iraq?"`;
+}
+
+export function zBotLlmStatus(): {
+  provider: 'azure-openai' | 'rule-based';
+  configured: boolean;
+  deployment?: string;
+  apiVersion: string;
+} {
+  const endpoint = process.env.AZURE_OPENAI_ENDPOINT?.trim();
+  const key = process.env.AZURE_OPENAI_API_KEY?.trim();
+  const deployment = process.env.AZURE_OPENAI_DEPLOYMENT?.trim();
+  const apiVersion = process.env.AZURE_OPENAI_API_VERSION?.trim() || '2024-02-15-preview';
+  const configured = Boolean(endpoint && key && deployment);
+  return {
+    provider: configured ? 'azure-openai' : 'rule-based',
+    configured,
+    deployment: deployment || undefined,
+    apiVersion,
+  };
+}
+
+export async function azureOpenAiReply(
+  message: string,
+  ctx: ChatContext,
+): Promise<string | null> {
+  const endpoint = process.env.AZURE_OPENAI_ENDPOINT?.replace(/\/$/, '');
+  const key = process.env.AZURE_OPENAI_API_KEY;
+  const deployment = process.env.AZURE_OPENAI_DEPLOYMENT;
+  if (!endpoint || !key || !deployment) return null;
+
+  const system = `You are Z Bot, assistant for International Z Wallet on Z Chain (chainId ${ctx.chainId}).
+Answer briefly. Never offer to sign transactions. Context: ${JSON.stringify(ctx)}`;
+  const apiVersion = process.env.AZURE_OPENAI_API_VERSION?.trim() || '2024-02-15-preview';
+  const url = `${endpoint}/openai/deployments/${deployment}/chat/completions?api-version=${apiVersion}`;
+  try {
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'api-key': key,
+      },
+      body: JSON.stringify({
+        messages: [
+          { role: 'system', content: system },
+          { role: 'user', content: message },
+        ],
+        max_tokens: 400,
+        temperature: 0.3,
+      }),
+    });
+    if (!res.ok) return null;
+    const data = (await res.json()) as {
+      choices?: { message?: { content?: string } }[];
+    };
+    return data.choices?.[0]?.message?.content?.trim() ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export async function zBotReply(
+  message: string,
+  walletAddress?: string,
+  chainId?: number,
+): Promise<string> {
+  const ctx = await buildZBotContext(walletAddress, chainId);
+  const llm = await azureOpenAiReply(message, ctx);
+  if (llm) return llm;
+  return ruleBasedReply(message, ctx);
+}