docs: update master documentation and push to Gitea (2026-03-06)

- MASTER_INDEX: Last Updated 2026-03-06; status 59/59 contracts; add NEXT_STEPS_LIST, CONTRACT_NEXT_STEPS_LIST - docs/README, NEXT_STEPS_INDEX, 06-besu/MASTER_INDEX: Last Updated 2026-03-06 - Contract check script: 59 addresses (PMM, vault/reserve, CompliantFiatTokens); canonical CCIP/router - New docs: EXECUTION_CHECKLIST, NEXT_STEPS_LIST, DOTENV_AUDIT, ADDITIONAL_PATHS, deployer gas runbook, WEMIX_ACQUISITION_TABLED, etc. - Config: deployer-gas-routes, cro-wemix-swap-routes, routing-registry, token-mapping - Scripts: check-contracts-on-chain-138, check-pmm-pool-balances-chain138, deployer-gas-auto-route, acquire-cro-and-wemix-gas - Operator rule: operator-lan-access-check.mdc Made-with: Cursor
2026-03-06 19:11:25 -08:00
parent d38174dc25
commit 3f76bc9507
63 changed files with 3439 additions and 107 deletions
--- a/config/contract-addresses.conf
+++ b/config/contract-addresses.conf
@@ -11,8 +11,8 @@ ADDR_CCIP_RECEIVER="0xC12236C03b28e675d376774FCE2C2C052488430F"
 ADDR_VOTING="0x022267b26400114aF01BaCcb92456Fe36cfccD93"

 ADDR_CCIP_SENDER="0x105F8A15b819948a89153505762444Ee9f324684"
-ADDR_CCIPWETH10_BRIDGE="0xe0E93247376aa097dB308B92e6Ba36bA015535D0"
-ADDR_CCIPWETH9_BRIDGE="${CCIPWETH9_BRIDGE_CHAIN138:-0x971cD9D156f193df8051E48043C476e53ECd4693}"
+ADDR_CCIPWETH10_BRIDGE="0xF5a87528cEb72312979DB0C51509489caF940721"
+ADDR_CCIPWETH9_BRIDGE="${CCIPWETH9_BRIDGE_CHAIN138:-0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5}"

 # alltra-lifi-settlement
 ADDR_MERCHANT_SETTLEMENT="0x16D9A2cB94A0b92721D93db4A6Cd8023D3338800"
--- a/config/cro-wemix-swap-routes.json
+++ b/config/cro-wemix-swap-routes.json
@@ -0,0 +1,143 @@
+{
+  "description": "Multiple swap routes to acquire Cronos (CRO) and Wemix (WEMIX) native gas for deployer. Used by scripts/deployment/acquire-cro-and-wemix-gas.sh and deployer-gas-auto-route. No in-repo execution: use aggregator UIs or future LiFi/Jumper API.",
+  "deployerAddress": "0x4A666F96fC8764181194447A7dFdb7d471b301C8",
+  "chains": {
+    "25": {
+      "name": "Cronos",
+      "nativeSymbol": "CRO",
+      "chainId": 25,
+      "requiredNative": "15",
+      "requiredUnit": "CRO",
+      "recipientNote": "Send CRO to deployer on Cronos mainnet (chain 25).",
+      "swapRoutes": [
+        {
+          "id": "swapspace-eth-cro",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["ETH"],
+          "toAsset": "CRO",
+          "url": "https://swapspace.co/exchange-pairs/cro-eth",
+          "description": "Swap ETH → CRO"
+        },
+        {
+          "id": "swapspace-bnb-cro",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["BNB"],
+          "toAsset": "CRO",
+          "url": "https://swapspace.co/exchange-pairs/cro-bnb",
+          "description": "Swap BNB → CRO"
+        },
+        {
+          "id": "swapspace-usdt-cro",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["USDT"],
+          "toAsset": "CRO",
+          "url": "https://swapspace.co/exchange-pairs/cro-usdt",
+          "description": "Swap USDT → CRO"
+        },
+        {
+          "id": "swapspace-usdc-cro",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["USDC"],
+          "toAsset": "CRO",
+          "url": "https://swapspace.co/exchange-pairs/cro-usdc",
+          "description": "Swap USDC → CRO"
+        },
+        {
+          "id": "changenow-cro",
+          "name": "ChangeNOW",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BNB", "USDT", "USDC", "BTC"],
+          "toAsset": "CRO",
+          "url": "https://changenow.io/currencies/cronos-cro",
+          "description": "Swap multiple assets → Cronos CRO"
+        },
+        {
+          "id": "simpleswap-cro",
+          "name": "SimpleSwap",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BTC", "USDT", "USDC", "BNB"],
+          "toAsset": "CRO",
+          "url": "https://simpleswap.io/coins/cronos",
+          "description": "Swap to Cronos (CRO)"
+        },
+        {
+          "id": "stealthex-cro",
+          "name": "StealthEX",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BTC", "USDT"],
+          "toAsset": "CRO",
+          "url": "https://stealthex.io/coin/cro",
+          "description": "Swap to CRO (Cronos)"
+        }
+      ]
+    },
+    "1111": {
+      "name": "Wemix",
+      "nativeSymbol": "WEMIX",
+      "chainId": 1111,
+      "requiredNative": "0.4",
+      "requiredUnit": "WEMIX",
+      "recipientNote": "Send WEMIX to deployer on Wemix mainnet (chain 1111).",
+      "swapRoutes": [
+        {
+          "id": "swapspace-bnb-wemix",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["BNB"],
+          "toAsset": "WEMIX",
+          "url": "https://swapspace.co/exchange-pairs/wemix-bnb",
+          "description": "Swap BNB → WEMIX"
+        },
+        {
+          "id": "swapspace-eth-wemix",
+          "name": "SwapSpace",
+          "type": "aggregator",
+          "fromAssets": ["ETH"],
+          "toAsset": "WEMIX",
+          "url": "https://swapspace.co/exchange-pairs/wemix-eth",
+          "description": "Swap ETH → WEMIX"
+        },
+        {
+          "id": "changenow-wemix-polygon",
+          "name": "ChangeNOW",
+          "type": "aggregator",
+          "fromAssets": ["POL", "MATIC"],
+          "toAsset": "WEMIX",
+          "url": "https://changenow.io/currencies/wemix-main/polygon-matic",
+          "description": "Swap Polygon (POL/MATIC) → WEMIX"
+        },
+        {
+          "id": "changenow-wemix",
+          "name": "ChangeNOW",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BNB", "USDT", "USDC"],
+          "toAsset": "WEMIX",
+          "url": "https://changenow.io/currencies/wemix-main",
+          "description": "Swap multiple assets → WEMIX"
+        },
+        {
+          "id": "simpleswap-wemix",
+          "name": "SimpleSwap",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BTC", "USDT", "BNB"],
+          "toAsset": "WEMIX",
+          "url": "https://simpleswap.io/coins/wemix",
+          "description": "Swap to WEMIX"
+        },
+        {
+          "id": "stealthex-wemix",
+          "name": "StealthEX",
+          "type": "aggregator",
+          "fromAssets": ["ETH", "BTC", "USDT"],
+          "toAsset": "WEMIX",
+          "url": "https://stealthex.io/coin/wemix",
+          "description": "Swap to WEMIX"
+        }
+      ]
+    }
+  }
+}
--- a/config/deployer-gas-routes.json
+++ b/config/deployer-gas-routes.json
@@ -0,0 +1,156 @@
+{
+  "description": "Chain-to-method mapping for deployer gas auto-route: swap/bridge ERC-20 to native gas per chain. Used by scripts/deployment/deployer-gas-auto-route.sh.",
+  "deployerAddress": "0x4A666F96fC8764181194447A7dFdb7d471b301C8",
+  "chains": [
+    {
+      "chainId": 138,
+      "name": "DeFi Oracle Meta Mainnet",
+      "nativeSymbol": "ETH",
+      "thresholdEther": "0.006",
+      "method": "internal",
+      "tokenAggregationBaseUrl": "https://dbis-api.d-bis.org/api/v1",
+      "tokenAggregationFallbackUrl": "http://192.168.11.140:3001",
+      "dodoPmmIntegration": "0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D",
+      "poolCusdtCusdc": "0x9fcB06Aa1FD5215DC0E91Fd098aeff4B62fEa5C8",
+      "cusdt": "0x93E66202A11B1772E55407B32B44e5Cd8eda7f22",
+      "cusdc": "0xf22258f57794CC8E06237084b353Ab30fFfa640b",
+      "weth9": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+      "note": "No cUSDT/cUSDC→WETH pool on 138; use genesis/validator for gas. Internal path for future c*→WETH pool if added."
+    },
+    {
+      "chainId": 1,
+      "name": "Ethereum Mainnet",
+      "nativeSymbol": "ETH",
+      "thresholdEther": "0.02",
+      "method": "protocolink",
+      "protocolinkChainKey": "mainnet",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 56,
+      "name": "BSC",
+      "nativeSymbol": "BNB",
+      "thresholdEther": "0.06",
+      "method": "protocolink",
+      "protocolinkChainKey": "bsc",
+      "supportedInputTokens": ["USDT", "USDC", "BUSD", "LINK"]
+    },
+    {
+      "chainId": 137,
+      "name": "Polygon",
+      "nativeSymbol": "MATIC",
+      "thresholdEther": "1.0",
+      "method": "protocolink",
+      "protocolinkChainKey": "polygon",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 100,
+      "name": "Gnosis",
+      "nativeSymbol": "xDAI",
+      "thresholdEther": "0.05",
+      "method": "protocolink",
+      "protocolinkChainKey": "gnosis",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "WXDAI"]
+    },
+    {
+      "chainId": 10,
+      "name": "Optimism",
+      "nativeSymbol": "ETH",
+      "thresholdEther": "0.005",
+      "method": "protocolink",
+      "protocolinkChainKey": "optimism",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 42161,
+      "name": "Arbitrum",
+      "nativeSymbol": "ETH",
+      "thresholdEther": "0.005",
+      "method": "protocolink",
+      "protocolinkChainKey": "arbitrum",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 8453,
+      "name": "Base",
+      "nativeSymbol": "ETH",
+      "thresholdEther": "0.005",
+      "method": "protocolink",
+      "protocolinkChainKey": "base",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 43114,
+      "name": "Avalanche",
+      "nativeSymbol": "AVAX",
+      "thresholdEther": "0.1",
+      "method": "protocolink",
+      "protocolinkChainKey": "avalanche",
+      "supportedInputTokens": ["USDT", "USDC", "LINK", "DAI"]
+    },
+    {
+      "chainId": 25,
+      "name": "Cronos",
+      "nativeSymbol": "CRO",
+      "thresholdEther": "15",
+      "method": "manual",
+      "manualInstructions": "Swap ETH/BNB/USDT/USDC to CRO via any listed aggregator; send to deployer on Cronos (chain 25). Required ~15 CRO. Multiple routes: config/cro-wemix-swap-routes.json.",
+      "manualLinks": [
+        "https://swapspace.co/exchange-pairs/cro-eth",
+        "https://swapspace.co/exchange-pairs/cro-bnb",
+        "https://changenow.io/currencies/cronos-cro",
+        "https://simpleswap.io/coins/cronos",
+        "https://stealthex.io/coin/cro"
+      ],
+      "swapRoutesConfig": "config/cro-wemix-swap-routes.json",
+      "note": "Protocolink does not support Cronos (400 unsupported); use manual aggregator. Run ./scripts/deployment/acquire-cro-and-wemix-gas.sh for all routes."
+    },
+    {
+      "chainId": 42220,
+      "name": "Celo",
+      "nativeSymbol": "CELO",
+      "thresholdEther": "0.1",
+      "method": "protocolink",
+      "protocolinkChainKey": "celo",
+      "supportedInputTokens": ["USDT", "USDC", "cUSD", "cEUR"],
+      "note": "Protocolink Celo support TBD; may need manual if not supported."
+    },
+    {
+      "chainId": 1111,
+      "name": "Wemix",
+      "nativeSymbol": "WEMIX",
+      "thresholdEther": "0.4",
+      "method": "manual",
+      "manualInstructions": "Swap ETH/BNB/POL to WEMIX via any listed aggregator; send to deployer on chain 1111. Required ~0.4 WEMIX. Multiple routes: config/cro-wemix-swap-routes.json.",
+      "manualLinks": [
+        "https://swapspace.co/exchange-pairs/wemix-bnb",
+        "https://swapspace.co/exchange-pairs/wemix-eth",
+        "https://changenow.io/currencies/wemix-main/polygon-matic",
+        "https://simpleswap.io/coins/wemix",
+        "https://stealthex.io/coin/wemix"
+      ],
+      "swapRoutesConfig": "config/cro-wemix-swap-routes.json",
+      "inRepoOption": "LiFi or Jumper API if 1111 supported; implement scripts/deployment/wemix-acquire-via-lifi.js when available."
+    },
+    {
+      "chainId": 651940,
+      "name": "ALL Mainnet",
+      "nativeSymbol": "ALL",
+      "thresholdEther": "0.1",
+      "method": "manual",
+      "note": "Alltra chain; use existing funding or alltra-lifi-settlement flows."
+    },
+    {
+      "chainId": 42793,
+      "name": "Etherlink",
+      "nativeSymbol": "XTZ",
+      "thresholdEther": "1",
+      "method": "manual",
+      "manualInstructions": "Acquire XTZ/tez for Etherlink gas via exchange or aggregator; send to deployer. Bridge/CCIP support TBD.",
+      "note": "Optional; token-mapping 138↔42793 added 2026-03-06. Add to routing-registry when bridge available."
+    }
+  ],
+  "slippageBpsMax": 150,
+  "maxAmountPerRunEther": "10"
+}
--- a/config/routing-registry.json
+++ b/config/routing-registry.json
@@ -1,5 +1,7 @@
 {
-  "description": "Routing registry: (fromChain, toChain, asset) -> pathType, bridgeAddress. Used by UI and indexer. See docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md.",
+  "description": "Routing registry: (fromChain, toChain, asset) -> pathType, bridgeAddress. Used by UI and indexer. Includes inbound (dest->138), WETH10, and LINK placeholder. See docs/11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md.",
+  "version": "1.1.0",
+  "updated": "2026-03-06",
  "routes": [
    {
      "fromChain": 138,
@@ -24,99 +26,324 @@
      "toChain": 1,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 1,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 1,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to MAINNET_CCIP_WETH9_BRIDGE from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 56,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 56,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 56,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_BSC from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 137,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 137,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 137,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_POLYGON from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 10,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 10,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 10,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_OPTIMISM from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 42161,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 42161,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 42161,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_ARBITRUM from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 43114,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 43114,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 43114,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_AVALANCHE from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 8453,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 8453,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 8453,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_BASE from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 100,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 100,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 100,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_GNOSIS from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 25,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 25,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 25,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_CRONOS from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 42220,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
    },
+    {
+      "fromChain": 42220,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 42220,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_CELO from .env"
+    },
    {
      "fromChain": 138,
      "toChain": 1111,
      "asset": "WETH",
      "pathType": "CCIP",
-      "bridgeAddress": "0x971cD9D156f193df8051E48043C476e53ECd4693",
+      "bridgeAddress": "0x9cba0D04Ae5f6f16e3C599025aB97a05c4A593d5",
      "bridgeChainId": 138,
      "label": "CCIPWETH9Bridge"
+    },
+    {
+      "fromChain": 1111,
+      "toChain": 138,
+      "asset": "WETH",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 1111,
+      "label": "CCIPWETH9Bridge",
+      "note": "Set to CCIPWETH9_BRIDGE_WEMIX from .env when deployed"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 1,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 56,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 137,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 10,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 42161,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 43114,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 8453,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 100,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 25,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 42220,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 1111,
+      "asset": "WETH10",
+      "pathType": "CCIP",
+      "bridgeAddress": "0xe0E93247376aa097dB308B92e6Ba36bA015535D0",
+      "bridgeChainId": 138,
+      "label": "CCIPWETH10Bridge"
+    },
+    {
+      "fromChain": 138,
+      "toChain": 1,
+      "asset": "LINK",
+      "pathType": "CCIP",
+      "bridgeAddress": "0x0000000000000000000000000000000000000000",
+      "bridgeChainId": 138,
+      "label": "CCIPRelayLINK",
+      "note": "When LINK relay supported per RELAY_BRIDGE_ADD_LINK_SUPPORT_RUNBOOK"
    }
-  ]
+  ],
+  "pathTypes": {
+    "ALT": "AlltraAdapter 138 <-> 651940",
+    "CCIP": "Chainlink CCIP WETH9/WETH10",
+    "LIFI": "LiFi aggregator (add when integrated)",
+    "JUMPER": "Jumper aggregator (add when integrated)"
+  }
 }
--- a/config/token-mapping-multichain.json
+++ b/config/token-mapping-multichain.json
@@ -26,6 +26,7 @@
    "137": "Polygon",
    "138": "SMOM-DBIS-138 (DeFi Oracle Meta)",
    "1111": "Wemix",
+    "42793": "Etherlink",
    "8453": "Base",
    "42161": "Arbitrum One",
    "42220": "Celo",
@@ -1376,6 +1377,41 @@
          "notes": "Wemix USDC – https://scan.wemix.com/address/0xE3F5a90F9cb311505cd691a46596599aA1A0AD7D (scan shows USD Coin; verify official Circle/bridged)"
        }
      ]
+    },
+    {
+      "fromChainId": 138,
+      "toChainId": 42793,
+      "notes": "Chain 138 ↔ Etherlink (42793). Custom relay or CCIP when supported; verify WETH/LINK addresses on Etherlink.",
+      "tokens": [
+        {
+          "key": "WETH9",
+          "name": "Wrapped Ether",
+          "addressFrom": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+          "addressTo": "0x0000000000000000000000000000000000000000",
+          "notes": "Set addressTo when Etherlink WETH canonical known"
+        },
+        {
+          "key": "Compliant_USDT",
+          "name": "cUSDT",
+          "addressFrom": "0x93E66202A11B1772E55407B32B44e5Cd8eda7f22",
+          "addressTo": "0x0000000000000000000000000000000000000000",
+          "notes": "Set when bridge/relay supports 138→42793"
+        },
+        {
+          "key": "Compliant_USDC",
+          "name": "cUSDC",
+          "addressFrom": "0xf22258f57794CC8E06237084b353Ab30fFfa640b",
+          "addressTo": "0x0000000000000000000000000000000000000000",
+          "notes": "Set when bridge/relay supports 138→42793"
+        },
+        {
+          "key": "LINK",
+          "name": "Chainlink",
+          "addressFrom": "0xb7721dD53A8c629d9f1Ba31a5819AFe250002b03",
+          "addressTo": "0x0000000000000000000000000000000000000000",
+          "notes": "Set when LINK relay supports 138→42793"
+        }
+      ]
    }
  ]
 }