Add cross-chain addresses

.github/workflows/ci.yml

@@ -78,4 +78,4 @@ jobs:
         run: uv sync
 
       - name: Run validation script
-        run: uv run python scripts/validate_tokens.py
+        run: uv run python scripts/validate_tokens.py --validate-cross-chain

CONTRIBUTING.md

@@ -138,6 +138,52 @@ The `data.json` file contains the following fields:
 - `extensions`: Additional metadata about the token
   - `coinGeckoId`: The CoinGecko API ID for the token (if listed on CoinGecko)
   - `bridgeInfo`: Bridge information for bridged tokens
+  - `crossChainAddresses`: Token addresses on other chains (see below)
+
+### Cross-Chain Addresses
+
+If your token exists on other chains, you can include those addresses to help with cross-chain token identification and bridging:
+
+```json
+{
+  "extensions": {
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+      },
+      "56": {
+        "address": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+        "decimals": 18
+      },
+      "8453": {
+        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+      }
+    }
+  }
+}
+```
+
+**Chain ID Reference:**
+
+| Supported Chain ID | Network           |
+| ------------------ | ----------------- |
+| `1`                | Ethereum Mainnet  |
+| `10`               | Optimism          |
+| `56`               | BNB Chain         |
+| `137`              | Polygon           |
+| `999`              | HyperEVM          |
+| `8453`             | Base              |
+| `9745`             | Plasma            |
+| `42161`            | Arbitrum One      |
+| `43114`            | Avalanche C-Chain |
+
+**Fields per chain entry:**
+
+- `address` (required): The token contract address on that chain
+- `symbol` (optional): Expected symbol on this chain if it differs from the Monad token's symbol
+- `decimals` (optional): Expected decimals on this chain if they differ from the Monad token's decimals
+
+**Overrides:** Some tokens have different metadata across chains. Use `symbol` or `decimals` overrides when the cross-chain token's on-chain values differ from the Monad token.
 
 ## Important Notes
 

mainnet/AUSD/data.json

@@ -9,6 +9,30 @@
     "bridgeInfo": {
       "protocol": "LayerZero OFT",
       "bridgeAddress": "0x9CaB7Ede13dc56652E44D2404E969C212f22689b"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      },
+      "56": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      },
+      "137": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      },
+      "8453": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      },
+      "9745": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        "symbol": "AUSD0"
+      },
+      "42161": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      },
+      "43114": {
+        "address": "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"
+      }
     }
   }
 }

mainnet/BTC.b/data.json

@@ -5,9 +5,18 @@
   "symbol": "BTC.b",
   "decimals": 8,
   "extensions": {
+    "coinGeckoId": "bitcoin-avalanche-bridged-btc-b",
     "bridgeInfo": {
       "protocol": "Chainlink CCIP",
       "bridgeAddress": "0x33566fE5976AAa420F3d5C64996641Fc3858CaDB"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072"
+      },
+      "43114": {
+        "address": "0x152b9d0FdC40C096757F570A51E494bd4b943E50"
+      }
     }
   }
 }

mainnet/Cake/data.json

@@ -9,6 +9,20 @@
     "bridgeInfo": {
       "protocol": "LayerZero OFT",
       "bridgeAddress": "0xF59D81cd43f620E722E07f9Cb3f6E41B031017a3"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x152649eA73beAb28c5b49B26eb48f7EAD6d4c898"
+      },
+      "56": {
+        "address": "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82"
+      },
+      "8453": {
+        "address": "0x3055913c90Fcc1A6CE9a358911721eEb942013A1"
+      },
+      "42161": {
+        "address": "0x1b896893dfc86bb67Cf57767298b9073D2c1bA2c"
+      }
     }
   }
 }

mainnet/EUL/data.json

@@ -9,6 +9,23 @@
     "bridgeInfo": {
       "protocol": "LayerZero OFT",
       "bridgeAddress": "0x831257BFa5478111d2327e08c4068ec37Ac14B81"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xd9Fcd98c322942075A5C3860693e9f4f03AAE07b"
+      },
+      "56": {
+        "address": "0x2117E8b79e8E176A670c9fCf945d4348556bfFad"
+      },
+      "8453": {
+        "address": "0xa153Ad732F831a79b5575Fa02e793EC4E99181b0"
+      },
+      "42161": {
+        "address": "0x462cD9E0247b2e63831c3189aE738E5E9a5a4b64"
+      },
+      "43114": {
+        "address": "0x9ceeD3A7f753608372eeAb300486cc7c2F38AC68"
+      }
     }
   }
 }

mainnet/FOLKS/data.json

@@ -5,6 +5,30 @@
   "symbol": "FOLKS",
   "decimals": 6,
   "extensions": {
-    "coinGeckoId": "folks"
+    "coinGeckoId": "folks",
+    "bridgeInfo": {
+      "protocol": "Wormhole NTT",
+      "bridgeAddress": "0x93FE94Ad887a1B04DBFf1f736bfcD1698D4cfF66"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      },
+      "56": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      },
+      "137": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      },
+      "8453": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      },
+      "42161": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      },
+      "43114": {
+        "address": "0xFF7F8F301F7A706E3CfD3D2275f5dc0b9EE8009B"
+      }
+    }
   }
 }

mainnet/LBTC/data.json

@@ -9,6 +9,20 @@
     "bridgeInfo": {
       "protocol": "Chainlink CCIP",
       "bridgeAddress": "0x33566fE5976AAa420F3d5C64996641Fc3858CaDB"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x8236a87084f8B84306f72007F36F2618A5634494"
+      },
+      "56": {
+        "address": "0xecAc9C5F704e954931349Da37F60E39f515c11c1"
+      },
+      "8453": {
+        "address": "0xecAc9C5F704e954931349Da37F60E39f515c11c1"
+      },
+      "43114": {
+        "address": "0xecAc9C5F704e954931349Da37F60E39f515c11c1"
+      }
     }
   }
 }

mainnet/NXPC/data.json

@@ -9,6 +9,11 @@
     "bridgeInfo": {
       "protocol": "Chainlink CCIP",
       "bridgeAddress": "0x33566fE5976AAa420F3d5C64996641Fc3858CaDB"
+    },
+    "crossChainAddresses": {
+      "43114": {
+        "address": "0x5E0E90E268BC247Cc850c789A0DB0d5c7621fb59"
+      }
     }
   }
 }

mainnet/SolvBTC/data.json

@@ -9,6 +9,26 @@
     "bridgeInfo": {
       "protocol": "Chainlink CCIP",
       "bridgeAddress": "0x33566fE5976AAa420F3d5C64996641Fc3858CaDB"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x7A56E1C57C7475CCf742a1832B028F0456652F97"
+      },
+      "56": {
+        "address": "0x4aae823a6a0b376De6A78e74eCC5b079d38cBCf7"
+      },
+      "137": {
+        "address": "0xaE4EFbc7736f963982aACb17EFA37fCBAb924cB3"
+      },
+      "8453": {
+        "address": "0x3B86Ad95859b6AB773f55f8d94B4b9d443EE931f"
+      },
+      "42161": {
+        "address": "0x3647c54c4c2C65bC7a2D63c0Da2809B399DBBDC0"
+      },
+      "43114": {
+        "address": "0xbc78D84Ba0c46dFe32cf2895a19939c86b81a777"
+      }
     }
   }
 }

mainnet/USD1/data.json

@@ -9,6 +9,16 @@
     "bridgeInfo": {
       "protocol": "Chainlink CCIP",
       "bridgeAddress": "0x33566fE5976AAa420F3d5C64996641Fc3858CaDB"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d",
+        "decimals": 18
+      },
+      "56": {
+        "address": "0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d",
+        "decimals": 18
+      }
     }
   }
 }

mainnet/USDC/data.json

@@ -9,6 +9,33 @@
     "bridgeInfo": {
       "protocol": "Circle CCTP",
       "bridgeAddress": "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+      },
+      "10": {
+        "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"
+      },
+      "56": {
+        "address": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+        "decimals": 18
+      },
+      "137": {
+        "address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
+      },
+      "999": {
+        "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f"
+      },
+      "8453": {
+        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+      },
+      "42161": {
+        "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
+      },
+      "43114": {
+        "address": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"
+      }
     }
   }
 }

mainnet/USDT0/data.json

@@ -9,6 +9,28 @@
     "bridgeInfo": {
       "protocol": "LayerZero OFT",
       "bridgeAddress": "0x9151434b16b9763660705744891fA906F660EcC5"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+        "symbol": "USDT"
+      },
+      "10": {
+        "address": "0x01bFF41798a0BcF287b996046Ca68b395DbC1071",
+        "symbol": "USD₮0"
+      },
+      "999": {
+        "address": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+        "symbol": "USD₮0"
+      },
+      "9745": {
+        "address": "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+        "symbol": "USDT0"
+      },
+      "42161": {
+        "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+        "symbol": "USD₮0"
+      }
     }
   }
 }

mainnet/WBTC/data.json

@@ -9,6 +9,26 @@
     "bridgeInfo": {
       "protocol": "LayerZero OFT",
       "bridgeAddress": "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
+      },
+      "10": {
+        "address": "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"
+      },
+      "56": {
+        "address": "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"
+      },
+      "8453": {
+        "address": "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"
+      },
+      "42161": {
+        "address": "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f"
+      },
+      "43114": {
+        "address": "0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"
+      }
     }
   }
 }

mainnet/WETH/data.json

@@ -9,6 +9,11 @@
     "bridgeInfo": {
       "protocol": "Wormhole NTT",
       "bridgeAddress": "0x92957b3D0CaB3eA7110fEd1ccc4eF564981a59Fc"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
+      }
     }
   }
 }

mainnet/WMON/data.json

@@ -5,6 +5,15 @@
   "symbol": "WMON",
   "decimals": 18,
   "extensions": {
-    "coinGeckoId": "wrapped-monad"
+    "coinGeckoId": "wrapped-monad",
+    "bridgeInfo": {
+      "protocol": "Wormhole NTT",
+      "bridgeAddress": "0xFEA937F7124E19124671f1685671d3f04a9Af4E4"
+    },
+    "crossChainAddresses": {
+      "1": {
+        "address": "0x6917037F8944201b2648198a89906Edf863B9517"
+      }
+    }
   }
 }