# Author: Simon-Pierre Boucher
# Mail: contact@spboucher.ai
# Stablecoin registry — every entry verified 2026-08-05 via issuer docs
# (tether.to, developers.circle.com, docs.ethena.fi, developers.skyeco.com,
# paxosglobal GitHub, docs.usdt0.to, docs.blast.io, ripple/RLUSD-Implementation)
# AND a live on-chain read (EVM: eth_call symbol()/decimals(), re-checked by
# scripts/verify_tokens.py; non-EVM: native RPC metadata reads).
#
# Fields:
#   symbol          OUR canonical grouping key — volume/API queries aggregate
#                   on it (so USDT0 deployments group under USDT)
#   onchain_symbol  what the contract actually reports, when it differs
#   address         EVM contract (family: evm chains)
#   id / id_kind    non-EVM identifier (mint, jetton_master, issuer, asa,
#                   coin_type, denom, token_id, asset_id, contract)
#   native          true = issued by the issuer on that chain (redeemable);
#                   false = bridged/pegged wrapper — bridge counterparty risk
#   discontinued    issuer no longer mints/redeems; kept for historical data
#
# NEVER add an EVM address without running scripts/verify_tokens.py.

tokens:
  # ============================ EVM ============================
  ethereum:
    - {symbol: USDT,  address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", decimals: 6,  native: true}
    - {symbol: USDC,  address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", decimals: 6,  native: true}
    - {symbol: DAI,   address: "0x6B175474E89094C44Da98b954EedeAC495271d0F", decimals: 18, native: true}
    - {symbol: USDS,  address: "0xdC035D45d973E3EC169d2276DDab16f1e407384F", decimals: 18, native: true}
    - {symbol: USDe,  address: "0x4c9EDD5852cd905f086C759E8383e09bff1E68B3", decimals: 18, native: true}
    - {symbol: FDUSD, address: "0xc5f0f7b66764F6ec8C8Dff7BA683102295E16409", decimals: 18, native: true}
    - {symbol: PYUSD, address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8", decimals: 6,  native: true}
    - {symbol: RLUSD, address: "0x8292Bb45bf1Ee4d140127049757C2E0fF06317eD", decimals: 18, native: true}  # beware lookalike 0x708D2375...
    - {symbol: USDG,  address: "0xe343167631d89B6Ffc58B88d6b7fB0228795491D", decimals: 6,  native: true}
    - {symbol: TUSD,  address: "0x0000000000085d4780B73119b644AE5ecd22b376", decimals: 18, native: true}
    # --- major crypto (category: crypto — USD via price worker) ---
    - {symbol: WETH, address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", decimals: 18, native: true, category: crypto}
    - {symbol: WBTC, address: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599", decimals: 8,  native: false, category: crypto}
    - {symbol: LINK, address: "0x514910771AF9Ca656af840dff83E8264EcF986CA", decimals: 18, native: true, category: crypto}
    - {symbol: UNI,  address: "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984", decimals: 18, native: true, category: crypto}
    - {symbol: AAVE, address: "0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9", decimals: 18, native: true, category: crypto}
    - {symbol: SHIB, address: "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE", decimals: 18, native: true, category: crypto}
    - {symbol: PEPE, address: "0x6982508145454Ce325dDbE47a25d4ec3d2311933", decimals: 18, native: true, category: crypto}
    - {symbol: LDO,  address: "0x5A98FcBEA516Cf06857215779Fd812CA3beF1B32", decimals: 18, native: true, category: crypto}
    - {symbol: CRV,  address: "0xD533a949740bb3306d119CC777fa900bA034cd52", decimals: 18, native: true, category: crypto}
    - {symbol: ONDO, address: "0xfAbA6f8e4a5E8Ab82F62fe7C39859FA577269BE3", decimals: 18, native: true, category: crypto}
    - {symbol: MKR,  address: "0x9f8F72aA9304c8B593d555F12eF6589cC3A579A2", decimals: 18, native: true, category: crypto}  # bytes32 symbol
    - {symbol: ENA,  address: "0x57e114B691Db790C35207b2e685D4A43181e6061", decimals: 18, native: true, category: crypto}

  base:
    - {symbol: USDC, address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", decimals: 6,  native: true}
    - {symbol: USDe, address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}  # LayerZero OFT
    - {symbol: USDS, address: "0x820C137fa70C8691f0e44Dc420a5e53c168921Dc", decimals: 18, native: false}  # SkyLink
    - {symbol: DAI,  address: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb", decimals: 18, native: false}  # canonical bridge
    - {symbol: WETH,  address: "0x4200000000000000000000000000000000000006", decimals: 18, native: false, category: crypto}
    - {symbol: cbBTC, address: "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf", decimals: 8, native: true, category: crypto}

  arbitrum:
    - {symbol: USDC,  address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", decimals: 6,  native: true}
    - {symbol: USDT, onchain_symbol: "USD₮0", address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", decimals: 6, native: false}  # USDT0 legacy mesh
    - {symbol: USDe,  address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}
    - {symbol: USDS,  address: "0x6491c05A82219b8D1479057361ff1654749b876b", decimals: 18, native: false}  # SkyLink
    - {symbol: DAI,   address: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1", decimals: 18, native: false}
    - {symbol: PYUSD, address: "0x46850aD61C2B7d64d08c9C754F45254596696984", decimals: 6,  native: true}   # Paxos-issued
    - {symbol: ARB,  address: "0x912CE59144191C1204E64559FE8253a0e49E6548", decimals: 18, native: true, category: crypto}
    - {symbol: WETH, address: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", decimals: 18, native: false, category: crypto}
    - {symbol: WBTC, address: "0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f", decimals: 8,  native: false, category: crypto}
    - {symbol: LINK, address: "0xf97f4df75117a78c1A5a0DBb814Af92458539FB4", decimals: 18, native: false, category: crypto}

  optimism:
    - {symbol: USDC, address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", decimals: 6,  native: true}
    - {symbol: USDT, address: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58", decimals: 6,  native: false}  # legacy canonical bridge (dominant liquidity)
    - {symbol: USDT, onchain_symbol: "USD₮0", address: "0x01bFF41798a0BcF287b996046Ca68b395DbC1071", decimals: 6, native: false}  # new USDT0 OFT
    - {symbol: USDe, address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}
    - {symbol: DAI,  address: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1", decimals: 18, native: false}
    - {symbol: OP,   address: "0x4200000000000000000000000000000000000042", decimals: 18, native: true, category: crypto}
    - {symbol: WETH, address: "0x4200000000000000000000000000000000000006", decimals: 18, native: false, category: crypto}

  polygon:
    - {symbol: USDT, onchain_symbol: "USDT0", address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", decimals: 6, native: false}  # USDT0 legacy mesh
    - {symbol: USDC, address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", decimals: 6,  native: true}
    - {symbol: DAI,  address: "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063", decimals: 18, native: false}  # PoS bridge
    - {symbol: WPOL, address: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270", decimals: 18, native: true, category: crypto}
    - {symbol: WETH, address: "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619", decimals: 18, native: false, category: crypto}

  bsc:
    - {symbol: USDT,  address: "0x55d398326f99059fF775485246999027B3197955", decimals: 18, native: false}  # Binance-Peg, 18 decimals!
    - {symbol: USDC,  address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", decimals: 18, native: false}  # Binance-Peg
    - {symbol: USDe,  address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}
    - {symbol: FDUSD, address: "0xc5f0f7b66764F6ec8C8Dff7BA683102295E16409", decimals: 18, native: true}
    - {symbol: TUSD,  address: "0x40af3827F39D0EAcBF4A168f8D4ee67c121D11c9", decimals: 18, native: true}   # post-2023 contract swap
    - {symbol: DAI,   address: "0x1AF3F329e8BE154074D8769D1FFa4eE058B1DBc3", decimals: 18, native: false}  # Binance-Peg
    - {symbol: WBNB, address: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c", decimals: 18, native: true, category: crypto}
    - {symbol: CAKE, address: "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82", decimals: 18, native: true, category: crypto}
    - {symbol: ETH,  address: "0x2170Ed0880ac9A755fd29B2688956BD959F933F8", decimals: 18, native: false, category: crypto}  # Binance-Peg

  avalanche:
    - {symbol: USDT, address: "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7", decimals: 6,  native: true}
    - {symbol: USDC, address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E", decimals: 6,  native: true}
    - {symbol: DAI, onchain_symbol: "DAI.e", address: "0xd586E7F844cEa2F87f50152665BCbc2C279D8d70", decimals: 18, native: false}  # Avalanche Bridge
    - {symbol: TUSD, address: "0x1C20E891Bab6b1727d14Da358FAe2984Ed9B59EB", decimals: 18, native: true}
    - {symbol: WAVAX, address: "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7", decimals: 18, native: true, category: crypto}
    - {symbol: WETH, onchain_symbol: "WETH.e", address: "0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB", decimals: 18, native: false, category: crypto}

  celo:
    - {symbol: USDT, address: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e", decimals: 6, native: true}  # Tether native (2024)
    - {symbol: USDC, address: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C", decimals: 6, native: true}

  kaia:
    - {symbol: USDT, address: "0xd077A400968890Eacc75cdc901F0356c943e4fDb", decimals: 6, native: true}  # Tether native; NOT 0x5c13e3... (Wormhole)

  ink:
    - {symbol: USDT, onchain_symbol: "USD₮0", address: "0x0200C29006150606B650577BBE7B6248F58470c1", decimals: 6, native: false}
    - {symbol: USDC, address: "0x2D270e6886d130D724215A266106e6832161EAEd", decimals: 6, native: true}
    - {symbol: USDG, address: "0xe343167631d89B6Ffc58B88d6b7fB0228795491D", decimals: 6, native: true}  # same address as Ethereum

  scroll:
    - {symbol: USDe, address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}
    - {symbol: USDC, address: "0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4", decimals: 6,  native: false}  # canonical bridge (no Circle-native)
    - {symbol: USDT, address: "0xf55BEC9cafDbE8730f096Aa55dad6D22d44099Df", decimals: 6,  native: false}  # canonical bridge

  linea:
    - {symbol: USDC, address: "0x176211869cA2b568f2A7D4EE941E073a821EE1ff", decimals: 6, native: true}
    - {symbol: USDT, address: "0xA219439258ca9da29E9Cc4cE5596924745e12B93", decimals: 6, native: false}  # canonical bridge

  mantle:
    - {symbol: USDe, address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, native: false}
    - {symbol: USDT, onchain_symbol: "USDT0", address: "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", decimals: 6, native: false}  # USDT0 OFT
    - {symbol: USDT, address: "0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE", decimals: 6, native: false}  # legacy canonical bridge
    - {symbol: USDC, address: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9", decimals: 6, native: false}  # canonical bridge

  gnosis:
    - {symbol: DAI, onchain_symbol: "WXDAI", address: "0xe91D153E0b41518A2CE8Dd3d7944Fa863463a97d", decimals: 18, native: false}  # wrapped xDai (DAI is the gas token)
    - {symbol: USDC, onchain_symbol: "USDC.e", address: "0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0", decimals: 6, native: false}  # bridged standard
    - {symbol: USDC, address: "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83", decimals: 6, native: false}  # legacy omni-bridge "USD//C"

  zksync:
    - {symbol: USDC, address: "0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4", decimals: 6,  native: true}
    - {symbol: USDe, address: "0x39Fe7a0DACcE31Bd90418e3e659fb0b5f0B3Db0d", decimals: 18, native: false}  # ZKsync CREATE exception address

  blast:
    # USDB is a REBASING stablecoin: balances grow without Transfer events —
    # transfer indexing works, balance tracking needs eth_call snapshots
    - {symbol: USDB, address: "0x4300000000000000000000000000000000000003", decimals: 18, native: true}

  unichain:
    - {symbol: USDC, address: "0x078D782b760474a361dDA0AF3839290b0EF57AD6", decimals: 6, native: true}

  world_chain:
    - {symbol: USDC, address: "0x79A02482A880bCe3F13E09da970dC34dB4cD24D1", decimals: 6, native: true}

  sonic:
    - {symbol: USDC, address: "0x29219dd400f2Bf60E5a23d13Be72B486D4038894", decimals: 6, native: true}
    - {symbol: USDT, address: "0x6047828dc181963ba44974801FF68e538dA5eaF9", decimals: 6, native: false}  # Sonic Gateway bridge; not Tether-redeemable

  sei:
    - {symbol: USDT, onchain_symbol: "USD₮0", address: "0x9151434b16b9763660705744891fA906F660EcC5", decimals: 6, native: false}
    - {symbol: USDC, address: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392", decimals: 6, native: true}

  hyperevm:
    - {symbol: USDT, onchain_symbol: "USD₮0", address: "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", decimals: 6, native: false}
    - {symbol: USDC, address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f", decimals: 6, native: true}

  # ========================== NON-EVM ==========================
  # (indexed once their family adapters land — Deliverable 4)
  tron:
    - {symbol: USDT, id: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", id_kind: contract, decimals: 6, native: true}
    - {symbol: TUSD, id: "TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4", id_kind: contract, decimals: 18, native: true}
    - {symbol: USDC, id: "TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8", id_kind: contract, decimals: 6, native: false, discontinued: true}  # Circle exited Tron 2024/25

  solana:
    - {symbol: USDC,  id: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", id_kind: mint, decimals: 6, native: true}
    - {symbol: USDT,  id: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", id_kind: mint, decimals: 6, native: true}
    - {symbol: PYUSD, id: "2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo", id_kind: mint, decimals: 6, native: true, program: token-2022}
    - {symbol: USDG,  id: "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH", id_kind: mint, decimals: 6, native: true, program: token-2022}
    - {symbol: USDe,  id: "DEkqHyPN7GMRJ5cArtQFAWefqbZb33Hyf6s5iCwjEonT", id_kind: mint, decimals: 9, native: false}  # LayerZero OFT; 9 decimals!
    - {symbol: BONK, id: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", id_kind: mint, decimals: 5, native: true, category: crypto}
    - {symbol: JUP,  id: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN", id_kind: mint, decimals: 6, native: true, category: crypto}
    - {symbol: WIF,  id: "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm", id_kind: mint, decimals: 6, native: true, category: crypto}

  ton:
    - {symbol: USDT, id: "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs", id_kind: jetton_master, decimals: 6, native: true}

  xrpl:
    # XRPL issued currencies: decimal string amounts, no fixed decimals
    - {symbol: RLUSD, id: "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De", id_kind: issuer, currency_hex: "524C555344000000000000000000000000000000", native: true}
    - {symbol: USDC,  id: "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE", id_kind: issuer, currency_hex: "5553444300000000000000000000000000000000", native: true}  # Circle, June 2025

  stellar:
    - {symbol: USDC, id: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", id_kind: issuer, decimals: 7, native: true}

  noble:
    - {symbol: USDC, id: "uusdc", id_kind: denom, decimals: 6, native: true}

  aptos:
    # fungible-asset METADATA object addresses (not package addresses)
    - {symbol: USDC, id: "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b", id_kind: coin_type, decimals: 6, native: true}
    - {symbol: USDT, id: "0x357b0b74bc833e95a115ad22604854d6b0fca151cecd94111770e5d6ffc9dc2b", id_kind: coin_type, decimals: 6, native: true}

  sui:
    - {symbol: USDC, id: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC", id_kind: coin_type, decimals: 6, native: true}
    - {symbol: USDT, id: "0xc060006111016b8a020ad5b33834984a437aaa7d3c74c18e09a95d48aceab08c::coin::COIN", id_kind: coin_type, decimals: 6, native: false}  # Wormhole wUSDT (no Tether-native on Sui)

  algorand:
    - {symbol: USDC, id: "31566704", id_kind: asa, decimals: 6, native: true}
    - {symbol: USDT, id: "312769",   id_kind: asa, decimals: 6, native: true, discontinued: true}  # Tether wind-down Sept 2025

  near:
    - {symbol: USDT, id: "usdt.tether-token.near", id_kind: contract, decimals: 6, native: true}
    - {symbol: USDC, id: "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1", id_kind: contract, decimals: 6, native: true}

  tezos:
    - {symbol: USDT, id: "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o", id_kind: contract, token_id: 0, decimals: 6, native: true}  # FA2

  hedera:
    - {symbol: USDC, id: "0.0.456858", id_kind: token_id, decimals: 6, native: true}

  starknet:
    - {symbol: USDC, id: "0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb", id_kind: contract, decimals: 6, native: true}   # Circle native (CCTP V2)
    - {symbol: USDT, id: "0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8", id_kind: contract, decimals: 6, native: false}  # StarkGate bridge

  polkadot_asset_hub:
    - {symbol: USDT, id: "1984", id_kind: asset_id, decimals: 6, native: true}
    - {symbol: USDC, id: "1337", id_kind: asset_id, decimals: 6, native: true}

  eos:
    - {symbol: USDT, id: "tethertether", id_kind: contract, decimals: 4, native: true, discontinued: true}  # Tether wind-down Sept 2025

  bitcoin: []   # native BTC whale tracking only — configured in chains.yaml