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"]
+  }
+}