@gearbox-protocol/sdk 15.0.0 → 15.1.0-next.2

package/dist/esm/sdk/chain/chains.js

@@ -1,422 +1,464 @@
-import { defineChain } from "viem";
-import {
-  arbitrum,
-  avalanche,
-  base,
-  berachain,
-  bsc,
-  etherlink,
-  hemi,
-  lisk,
-  mainnet,
-  megaeth,
-  monad,
-  optimism,
-  plasma,
-  somnia,
-  sonic,
-  worldchain
-} from "viem/chains";
-import { z } from "zod/v4";
 import { TypedObjectUtils } from "../utils/mappers.js";
+import { defineChain, isAddressEqual } from "viem";
+import { arbitrum, avalanche, base, berachain, bsc, etherlink, hemi, lisk, mainnet, megaeth, monad, optimism, plasma, somnia, sonic, worldchain } from "viem/chains";
+import { z } from "zod/v4";
+//#region src/sdk/chain/chains.ts
+/**
+* Tuple of all network labels the SDK can work with.
+**/
 const SUPPORTED_NETWORKS = [
-  "Mainnet",
-  "Arbitrum",
-  "Optimism",
-  "Base",
-  "Sonic",
-  "MegaETH",
-  "Monad",
-  "Berachain",
-  "Avalanche",
-  "BNB",
-  "WorldChain",
-  "Etherlink",
-  "Hemi",
-  "Lisk",
-  "Plasma",
-  "Somnia"
+	"Mainnet",
+	"Arbitrum",
+	"Optimism",
+	"Base",
+	"Sonic",
+	"MegaETH",
+	"Monad",
+	"Berachain",
+	"Avalanche",
+	"BNB",
+	"WorldChain",
+	"Etherlink",
+	"Hemi",
+	"Lisk",
+	"Plasma",
+	"Somnia"
 ];
+/**
+* Zod schema for validating/parsing network type strings.
+**/
 const NetworkType = z.enum(SUPPORTED_NETWORKS);
 function withPublicNode(chain, subdomain) {
-  return defineChain({
-    ...chain,
-    rpcUrls: {
-      ...chain.rpcUrls,
-      publicnode: {
-        http: [`https://${subdomain}.publicnode.com`],
-        webSocket: [`wss://${subdomain}.publicnode.com`]
-      }
-    }
-  });
+	return defineChain({
+		...chain,
+		rpcUrls: {
+			...chain.rpcUrls,
+			publicnode: {
+				http: [`https://${subdomain}.publicnode.com`],
+				webSocket: [`wss://${subdomain}.publicnode.com`]
+			}
+		}
+	});
 }
+/**
+* Pre-configured {@link GearboxChain} instances for every supported network.
+**/
 const chains = {
-  Mainnet: withPublicNode(
-    {
-      ...mainnet,
-      network: "Mainnet",
-      defaultMarketConfigurators: {
-        "0xc168343c791d56dd1da4b4b8b0cc1c1ec1a16e6b": "cp0x",
-        "0x3b56538833fc02f4f0e75609390f26ded0c32e42": "Re7",
-        "0x7a133fbd01736fd076158307c9476cc3877f1af5": "Invariant Group",
-        "0x09d8305F49374AEA6A78aF6C996df2913e8f3b19": "Tulipa",
-        "0x1b265b97eb169fb6668e3258007c3b0242c7bdbe": "KPK",
-        "0x9dddd1b9ce0ac8aa0c80e4ec141600b9bf0101c3": "UltraYield",
-        "0x601067eba24bb5b558a184fc082525637e96a42d": "Gami Labs"
-      },
-      testMarketConfigurators: {
-        "0x99df7330bf42d596af2e9d9836d4fc2077c574aa": "M11 Credit",
-        "0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize"
-      },
-      rwaFactories: [],
-      isPublic: true,
-      wellKnownToken: {
-        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
-        symbol: "USDC"
-      },
-      firstBlock: 22358644n,
-      gasLimit: 550000000n
-    },
-    "ethereum-rpc"
-  ),
-  Arbitrum: withPublicNode(
-    {
-      ...arbitrum,
-      network: "Arbitrum",
-      defaultMarketConfigurators: {
-        "0x01023850b360b88de0d0f84015bbba1eba57fe7e": "Chaos Labs"
-      },
-      rwaFactories: [],
-      isPublic: true,
-      wellKnownToken: {
-        address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
-        symbol: "USDC"
-      },
-      firstBlock: 184650310n,
-      gasLimit: 550000000n
-    },
-    "arbitrum-one-rpc"
-  ),
-  Optimism: withPublicNode(
-    {
-      ...optimism,
-      network: "Optimism",
-      defaultMarketConfigurators: {
-        "0x2a15969CE5320868eb609680751cF8896DD92De5": "Chaos Labs",
-        "0x9dddd1b9ce0ac8aa0c80e4ec141600b9bf0101c3": "UltraYield"
-      },
-      rwaFactories: [],
-      isPublic: true,
-      wellKnownToken: {
-        address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
-        symbol: "USDC"
-      },
-      firstBlock: 118410666n,
-      gasLimit: 550000000n
-    },
-    "optimism-rpc"
-  ),
-  Base: withPublicNode(
-    {
-      ...base,
-      network: "Base",
-      defaultMarketConfigurators: {},
-      rwaFactories: [],
-      isPublic: false,
-      wellKnownToken: {
-        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-        symbol: "USDC"
-      },
-      gasLimit: 550000000n
-    },
-    "base-rpc"
-  ),
-  Sonic: withPublicNode(
-    defineChain({
-      ...sonic,
-      network: "Sonic",
-      defaultMarketConfigurators: {
-        "0x8FFDd1F1433674516f83645a768E8900A2A5D076": "Chaos Labs"
-      },
-      rwaFactories: [],
-      isPublic: true,
-      blockExplorers: {
-        default: {
-          name: "Sonic Explorer",
-          url: "https://sonicscan.org",
-          apiUrl: "https://api.sonicscan.org/api"
-        }
-      },
-      wellKnownToken: {
-        address: "0x29219dd400f2Bf60E5a23d13Be72B486D4038894",
-        symbol: "USDC"
-      },
-      gasLimit: 550000000n,
-      firstBlock: 9779380n
-    }),
-    "sonic-rpc"
-  ),
-  MegaETH: defineChain({
-    ...megaeth,
-    network: "MegaETH",
-    defaultMarketConfigurators: {},
-    rwaFactories: [],
-    isPublic: false,
-    wellKnownToken: {
-      address: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
-      symbol: "USDm"
-    },
-    gasLimit: 550000000n
-  }),
-  // NOTE: Monad chain configs should be updated once the public mainnet is available
-  Monad: defineChain({
-    ...monad,
-    blockExplorers: {
-      default: {
-        name: "Monadscan",
-        url: "https://monadscan.com/"
-      }
-    },
-    network: "Monad",
-    defaultMarketConfigurators: {
-      "0x16956912813ab9a38d95730b52a8cf53e860a7c5": "Tulipa",
-      "0x7c6ee1bf9c1eb3ee55bdbdc1e8d0317aab718e0a": "UltraYield"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0xe7cd86e13AC4309349F30B3435a9d337750fC82D",
-      symbol: "USDT0"
-    },
-    firstBlock: 34650262n,
-    gasLimit: 150000000n
-  }),
-  Berachain: withPublicNode(
-    {
-      ...berachain,
-      network: "Berachain",
-      defaultMarketConfigurators: {},
-      rwaFactories: [],
-      isPublic: false,
-      blockExplorers: {
-        default: {
-          name: "Berascan",
-          url: "https://berascan.com",
-          apiUrl: "https://api.berascan.com/api"
-        }
-      },
-      wellKnownToken: {
-        address: "0x549943e04f40284185054145c6e4e9568c1d3241",
-        symbol: "USDC.e"
-      },
-      gasLimit: 550000000n
-    },
-    "berachain-rpc"
-  ),
-  Avalanche: withPublicNode(
-    {
-      ...avalanche,
-      network: "Avalanche",
-      defaultMarketConfigurators: {},
-      rwaFactories: [],
-      isPublic: false,
-      wellKnownToken: {
-        address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
-        symbol: "USDC"
-      },
-      gasLimit: 550000000n
-    },
-    "avalanche-c-chain-rpc"
-  ),
-  BNB: withPublicNode(
-    {
-      ...bsc,
-      network: "BNB",
-      defaultMarketConfigurators: {
-        "0x19037a281025b83fa37e3264b77af523ff87a3a4": "Chaos Labs",
-        "0x92dc4ee43e9b207e16fbf3fd1a6933563c0a0d35": "Re7"
-      },
-      testMarketConfigurators: {},
-      rwaFactories: [],
-      isPublic: true,
-      wellKnownToken: {
-        address: "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
-        symbol: "USDC"
-      },
-      firstBlock: 48761804n,
-      gasLimit: 550000000n
-    },
-    "bsc-rpc"
-  ),
-  WorldChain: defineChain({
-    ...worldchain,
-    network: "WorldChain",
-    defaultMarketConfigurators: {},
-    rwaFactories: [],
-    isPublic: false,
-    wellKnownToken: {
-      address: "0x79a02482a880bce3f13e09da970dc34db4cd24d1",
-      symbol: "USDC"
-    },
-    // TODO: has no block explorer API
-    gasLimit: 550000000n
-  }),
-  Etherlink: defineChain({
-    ...etherlink,
-    network: "Etherlink",
-    defaultMarketConfigurators: {
-      "0x577424f0e6f50db668cc1bc76babb87e36732291": "Re7"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0x796Ea11Fa2dD751eD01b53C372fFDB4AAa8f00F9",
-      symbol: "USDC"
-    },
-    firstBlock: 16672963n,
-    gasLimit: 550000000n
-  }),
-  Hemi: defineChain({
-    ...hemi,
-    network: "Hemi",
-    defaultMarketConfigurators: {
-      "0xc9961b8a0c763779690577f2c76962c086af2fe3": "Invariant Group"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0xad11a8BEb98bbf61dbb1aa0F6d6F2ECD87b35afA",
-      symbol: "USDC.e"
-    },
-    contracts: {
-      multicall3: {
-        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
-        blockCreated: 484490
-      }
-    },
-    gasLimit: 550000000n
-  }),
-  Lisk: defineChain({
-    ...lisk,
-    network: "Lisk",
-    defaultMarketConfigurators: {
-      "0x25778dbf0e56b7feb8358c4aa2f6f9e19a1c145a": "Re7"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0xF242275d3a6527d877f2c927a82D9b057609cc71",
-      symbol: "USDC.e"
-    },
-    gasLimit: 550000000n
-  }),
-  Plasma: defineChain({
-    ...plasma,
-    network: "Plasma",
-    defaultMarketConfigurators: {
-      "0x7a133fbd01736fd076158307c9476cc3877f1af5": "Invariant Group",
-      "0x4bce62622be621ce036691de98afcab0e41a77a3": "UltraYield",
-      "0xce1cf71a28837daaa7b92d00ca4ef2fd649c2a67": "Hyperithm",
-      "0x9655f82b585b11cee8a05576ed8efcf755cec04b": "TelosC"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0x5d72a9d9a9510cd8cbdba12ac62593a58930a948",
-      symbol: "aPlaUSDT0"
-    },
-    contracts: {
-      multicall3: {
-        address: "0xcA11bde05977b3631167028862bE2a173976CA11"
-      }
-    },
-    firstBlock: 670913n,
-    gasLimit: 550000000n
-  }),
-  Somnia: defineChain({
-    ...somnia,
-    contracts: {
-      multicall3: {
-        address: "0x5e44F178E8cF9B2F5409B6f18ce936aB817C5a11",
-        blockCreated: 38516341
-      }
-    },
-    blockTime: 200,
-    network: "Somnia",
-    defaultMarketConfigurators: {
-      "0x1ca8b92aa7233a9f8f7ba031ac45c878141adff0": "Invariant Group"
-    },
-    rwaFactories: [],
-    isPublic: true,
-    wellKnownToken: {
-      address: "0x67B302E35Aef5EEE8c32D934F5856869EF428330",
-      symbol: "USDT"
-    },
-    firstBlock: 147687380n,
-    gasLimit: 550000000n
-  })
+	Mainnet: withPublicNode({
+		...mainnet,
+		network: "Mainnet",
+		defaultMarketConfigurators: {
+			"0xc168343c791d56dd1da4b4b8b0cc1c1ec1a16e6b": "cp0x",
+			"0x3b56538833fc02f4f0e75609390f26ded0c32e42": "Re7",
+			"0x7a133fbd01736fd076158307c9476cc3877f1af5": "Invariant Group",
+			"0x09d8305F49374AEA6A78aF6C996df2913e8f3b19": "Tulipa",
+			"0x1b265b97eb169fb6668e3258007c3b0242c7bdbe": "KPK",
+			"0x9dddd1b9ce0ac8aa0c80e4ec141600b9bf0101c3": "UltraYield",
+			"0x601067eba24bb5b558a184fc082525637e96a42d": "Gami Labs"
+		},
+		testMarketConfigurators: {
+			"0x99df7330bf42d596af2e9d9836d4fc2077c574aa": "M11 Credit",
+			"0x610627d8d01a413bdd9b0a0b60070da7dd1e54ad": "Securitize",
+			"0xa770ce584adb6491a2138da6eaec33243bdcd248": "Testnet Curator"
+		},
+		rwaFactories: [],
+		underlyingAssetTypes: {
+			"0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0": "ETH",
+			"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": "ETH",
+			"0x18084fbA666a33d37592fA2633fD49a74DD93a88": "BTC",
+			"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "Stable",
+			"0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599": "BTC"
+		},
+		rwaTokens: [
+			"0x17418038ecF73BA4026c4f428547BF099706F27B",
+			"0x51C2d74017390CbBd30550179A16A1c28F7210fc",
+			"0x238a700eD6165261Cf8b2e544ba797BC11e466Ba",
+			"0x7433806912Eae67919e66aea853d46Fa0aef98A8"
+		],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+			symbol: "USDC"
+		},
+		firstBlock: 22358644n,
+		gasLimit: 550000000n
+	}, "ethereum-rpc"),
+	Arbitrum: withPublicNode({
+		...arbitrum,
+		network: "Arbitrum",
+		defaultMarketConfigurators: { "0x01023850b360b88de0d0f84015bbba1eba57fe7e": "Chaos Labs" },
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+			symbol: "USDC"
+		},
+		firstBlock: 184650310n,
+		gasLimit: 550000000n
+	}, "arbitrum-one-rpc"),
+	Optimism: withPublicNode({
+		...optimism,
+		network: "Optimism",
+		defaultMarketConfigurators: {
+			"0x2a15969CE5320868eb609680751cF8896DD92De5": "Chaos Labs",
+			"0x9dddd1b9ce0ac8aa0c80e4ec141600b9bf0101c3": "UltraYield"
+		},
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+			symbol: "USDC"
+		},
+		firstBlock: 118410666n,
+		gasLimit: 550000000n
+	}, "optimism-rpc"),
+	Base: withPublicNode({
+		...base,
+		network: "Base",
+		defaultMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: false,
+		wellKnownToken: {
+			address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+			symbol: "USDC"
+		},
+		gasLimit: 550000000n
+	}, "base-rpc"),
+	Sonic: withPublicNode(defineChain({
+		...sonic,
+		network: "Sonic",
+		defaultMarketConfigurators: { "0x8FFDd1F1433674516f83645a768E8900A2A5D076": "Chaos Labs" },
+		rwaFactories: [],
+		isPublic: true,
+		blockExplorers: { default: {
+			name: "Sonic Explorer",
+			url: "https://sonicscan.org",
+			apiUrl: "https://api.sonicscan.org/api"
+		} },
+		wellKnownToken: {
+			address: "0x29219dd400f2Bf60E5a23d13Be72B486D4038894",
+			symbol: "USDC"
+		},
+		gasLimit: 550000000n,
+		firstBlock: 9779380n
+	}), "sonic-rpc"),
+	MegaETH: defineChain({
+		...megaeth,
+		network: "MegaETH",
+		defaultMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: false,
+		wellKnownToken: {
+			address: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
+			symbol: "USDm"
+		},
+		gasLimit: 550000000n
+	}),
+	Monad: defineChain({
+		...monad,
+		blockExplorers: { default: {
+			name: "Monadscan",
+			url: "https://monadscan.com/"
+		} },
+		network: "Monad",
+		defaultMarketConfigurators: {
+			"0x16956912813ab9a38d95730b52a8cf53e860a7c5": "Tulipa",
+			"0x7c6ee1bf9c1eb3ee55bdbdc1e8d0317aab718e0a": "UltraYield"
+		},
+		underlyingAssetTypes: {
+			"0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A": "ETH",
+			"0x754704Bc059F8C67012fEd69BC8A327a5aafb603": "Stable",
+			"0xe7cd86e13AC4309349F30B3435a9d337750fC82D": "Stable",
+			"0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a": "Stable"
+		},
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0xe7cd86e13AC4309349F30B3435a9d337750fC82D",
+			symbol: "USDT0"
+		},
+		firstBlock: 34650262n,
+		gasLimit: 150000000n
+	}),
+	Berachain: withPublicNode({
+		...berachain,
+		network: "Berachain",
+		defaultMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: false,
+		blockExplorers: { default: {
+			name: "Berascan",
+			url: "https://berascan.com",
+			apiUrl: "https://api.berascan.com/api"
+		} },
+		wellKnownToken: {
+			address: "0x549943e04f40284185054145c6e4e9568c1d3241",
+			symbol: "USDC.e"
+		},
+		gasLimit: 550000000n
+	}, "berachain-rpc"),
+	Avalanche: withPublicNode({
+		...avalanche,
+		network: "Avalanche",
+		defaultMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: false,
+		wellKnownToken: {
+			address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+			symbol: "USDC"
+		},
+		gasLimit: 550000000n
+	}, "avalanche-c-chain-rpc"),
+	BNB: withPublicNode({
+		...bsc,
+		network: "BNB",
+		defaultMarketConfigurators: {
+			"0x19037a281025b83fa37e3264b77af523ff87a3a4": "Chaos Labs",
+			"0x92dc4ee43e9b207e16fbf3fd1a6933563c0a0d35": "Re7"
+		},
+		testMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
+			symbol: "USDC"
+		},
+		firstBlock: 48761804n,
+		gasLimit: 550000000n
+	}, "bsc-rpc"),
+	WorldChain: defineChain({
+		...worldchain,
+		network: "WorldChain",
+		defaultMarketConfigurators: {},
+		rwaFactories: [],
+		isPublic: false,
+		wellKnownToken: {
+			address: "0x79a02482a880bce3f13e09da970dc34db4cd24d1",
+			symbol: "USDC"
+		},
+		gasLimit: 550000000n
+	}),
+	Etherlink: defineChain({
+		...etherlink,
+		network: "Etherlink",
+		defaultMarketConfigurators: { "0x577424f0e6f50db668cc1bc76babb87e36732291": "Re7" },
+		underlyingAssetTypes: { "0x796Ea11Fa2dD751eD01b53C372fFDB4AAa8f00F9": "Stable" },
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0x796Ea11Fa2dD751eD01b53C372fFDB4AAa8f00F9",
+			symbol: "USDC"
+		},
+		firstBlock: 16672963n,
+		gasLimit: 550000000n
+	}),
+	Hemi: defineChain({
+		...hemi,
+		network: "Hemi",
+		defaultMarketConfigurators: { "0xc9961b8a0c763779690577f2c76962c086af2fe3": "Invariant Group" },
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0xad11a8BEb98bbf61dbb1aa0F6d6F2ECD87b35afA",
+			symbol: "USDC.e"
+		},
+		contracts: { multicall3: {
+			address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+			blockCreated: 484490
+		} },
+		gasLimit: 550000000n
+	}),
+	Lisk: defineChain({
+		...lisk,
+		network: "Lisk",
+		defaultMarketConfigurators: { "0x25778dbf0e56b7feb8358c4aa2f6f9e19a1c145a": "Re7" },
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0xF242275d3a6527d877f2c927a82D9b057609cc71",
+			symbol: "USDC.e"
+		},
+		gasLimit: 550000000n
+	}),
+	Plasma: defineChain({
+		...plasma,
+		network: "Plasma",
+		defaultMarketConfigurators: {
+			"0x7a133fbd01736fd076158307c9476cc3877f1af5": "Invariant Group",
+			"0x4bce62622be621ce036691de98afcab0e41a77a3": "UltraYield",
+			"0xce1cf71a28837daaa7b92d00ca4ef2fd649c2a67": "Hyperithm",
+			"0x9655f82b585b11cee8a05576ed8efcf755cec04b": "TelosC"
+		},
+		underlyingAssetTypes: {
+			"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb": "Stable",
+			"0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34": "Stable"
+		},
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0x5d72a9d9a9510cd8cbdba12ac62593a58930a948",
+			symbol: "aPlaUSDT0"
+		},
+		contracts: { multicall3: { address: "0xcA11bde05977b3631167028862bE2a173976CA11" } },
+		firstBlock: 670913n,
+		gasLimit: 550000000n
+	}),
+	Somnia: defineChain({
+		...somnia,
+		contracts: { multicall3: {
+			address: "0x5e44F178E8cF9B2F5409B6f18ce936aB817C5a11",
+			blockCreated: 38516341
+		} },
+		blockTime: 200,
+		network: "Somnia",
+		defaultMarketConfigurators: { "0x1ca8b92aa7233a9f8f7ba031ac45c878141adff0": "Invariant Group" },
+		underlyingAssetTypes: {
+			"0x28BEc7E30E6faee657a03e19Bf1128AaD7632A00": "Stable",
+			"0x046EDe9564A72571df6F5e44d0405360c0f4dCab": "ETH"
+		},
+		rwaFactories: [],
+		isPublic: true,
+		wellKnownToken: {
+			address: "0x67B302E35Aef5EEE8c32D934F5856869EF428330",
+			symbol: "USDT"
+		},
+		firstBlock: 147687380n,
+		gasLimit: 550000000n
+	})
 };
 const networkByChainId = Object.values(chains).reduce((acc, chain) => {
-  acc[chain.id] = chain.network;
-  return acc;
+	acc[chain.id] = chain.network;
+	return acc;
 }, {});
+/**
+* Returns the {@link GearboxChain} for a given chain ID or network type label.
+*
+* @param chainIdOrNetworkType - Numeric chain ID, bigint chain ID, or a {@link NetworkType} string.
+* @throws If the chain ID / network type is not supported.
+**/
 function getChain(chainIdOrNetworkType) {
-  const network = typeof chainIdOrNetworkType === "string" ? chainIdOrNetworkType : getNetworkType(Number(chainIdOrNetworkType));
-  const chain = chains[network];
-  if (!chain) {
-    throw new Error(`Unsupported network: ${network}`);
-  }
-  return chain;
+	const network = typeof chainIdOrNetworkType === "string" ? chainIdOrNetworkType : getNetworkType(Number(chainIdOrNetworkType));
+	const chain = chains[network];
+	if (!chain) throw new Error(`Unsupported network: ${network}`);
+	return chain;
 }
+/**
+* Resolves a numeric chain ID to its {@link NetworkType} label.
+*
+* @param chainId - Numeric or bigint chain ID.
+* @throws If the chain ID does not correspond to a supported network.
+**/
 function getNetworkType(chainId) {
-  const network = networkByChainId[Number(chainId)];
-  if (!network) throw new Error(`Unsupported network with chainId ${chainId}`);
-  return network;
+	const network = networkByChainId[Number(chainId)];
+	if (!network) throw new Error(`Unsupported network with chainId ${chainId}`);
+	return network;
 }
+/**
+* Chain IDs of chains named as {@link NetworkType} labels or as IDs already,
+* e.g. `sdk.opportunities.list({ chainIds: toChainIds(["Mainnet"]) })`.
+*
+* @param scope - Chains as labels, or already as IDs.
+* @throws If any entry is not a supported network.
+**/
+function toChainIds(scope) {
+	return scope.map((entry) => getChain(entry).id);
+}
+/**
+* Type guard that checks whether a chain ID belongs to a supported Gearbox network.
+*
+* @param chainId - Numeric chain ID, or `undefined`.
+**/
 function isSupportedNetwork(chainId) {
-  if (chainId === void 0) return false;
-  return !!networkByChainId[chainId];
+	if (chainId === void 0) return false;
+	return !!networkByChainId[chainId];
 }
+/**
+* Returns `true` if the given network or chain ID has a publicly deployed Gearbox instance.
+*
+* @param networkOrChainId - {@link NetworkType} string or numeric chain ID.
+**/
 function isPublicNetwork(networkOrChainId) {
-  return Object.values(chains).some((c) => {
-    if (typeof networkOrChainId === "string") {
-      return c.network === networkOrChainId && c.isPublic;
-    }
-    return c.id === Number(networkOrChainId) && c.isPublic;
-  });
+	return Object.values(chains).some((c) => {
+		if (typeof networkOrChainId === "string") return c.network === networkOrChainId && c.isPublic;
+		return c.id === Number(networkOrChainId) && c.isPublic;
+	});
 }
+/**
+* Looks up the {@link CuratorName} name for a market configurator address.
+*
+* Searches default and test market configurators across all chains, or
+* a single network if provided.
+*
+* @param marketConfigurator - On-chain market configurator address.
+* @param network - Optional network to restrict the search to.
+* @returns The curator name, or `undefined` if not found.
+**/
 function getCuratorName(marketConfigurator, network) {
-  const chainz = network ? [chains[network]] : Object.values(chains);
-  for (const c of chainz) {
-    for (const [a, curator] of TypedObjectUtils.entries({
-      ...c.defaultMarketConfigurators,
-      ...c.testMarketConfigurators
-    })) {
-      if (a.toLowerCase() === marketConfigurator.toLowerCase()) {
-        return curator;
-      }
-    }
-  }
-  return void 0;
+	const chainz = network ? [chains[network]] : Object.values(chains);
+	for (const c of chainz) for (const [a, curator] of TypedObjectUtils.entries({
+		...c.defaultMarketConfigurators,
+		...c.testMarketConfigurators
+	})) if (a.toLowerCase() === marketConfigurator.toLowerCase()) return curator;
 }
+/**
+* Finds the market configurator address for a given curator on a network.
+*
+* @param curator - Curator name to search for.
+* @param network - Network to search in.
+* @returns The market configurator address, or `undefined` if the curator
+*   has no configurator on this network.
+**/
 function findCuratorMarketConfigurator(curator, network) {
-  const { defaultMarketConfigurators, testMarketConfigurators } = chains[network];
-  const all = { ...defaultMarketConfigurators, ...testMarketConfigurators };
-  for (const [a, c] of TypedObjectUtils.entries(all)) {
-    if (c === curator) {
-      return a;
-    }
-  }
-  return void 0;
+	const { defaultMarketConfigurators, testMarketConfigurators } = chains[network];
+	const all = {
+		...defaultMarketConfigurators,
+		...testMarketConfigurators
+	};
+	for (const [a, c] of TypedObjectUtils.entries(all)) if (c === curator) return a;
 }
-export {
-  NetworkType,
-  SUPPORTED_NETWORKS,
-  chains,
-  findCuratorMarketConfigurator,
-  getChain,
-  getCuratorName,
-  getNetworkType,
-  isPublicNetwork,
-  isSupportedNetwork
-};
+/**
+* Looks up the {@link AssetType} of a token in hardcoded classifier.
+* Not all tokens are classified, only underlyings, so the default answer is `undefined`.
+*
+* @param token - Token address
+* @param network - Network the token lives on.
+* @returns The asset type, or `undefined` when the token is not classified
+**/
+function getAssetType(token, network) {
+	const table = chains[network].underlyingAssetTypes;
+	if (!table) return;
+	for (const [a, assetType] of TypedObjectUtils.entries(table)) if (isAddressEqual(a, token)) return assetType;
+}
+/**
+* Checks whether a token represents a real-world asset, per the curated list of
+* a network.
+*
+* @param token - Token address.
+* @param network - Network the token lives on.
+**/
+function isRWAToken(token, network) {
+	return !!chains[network].rwaTokens?.some((t) => isAddressEqual(t, token));
+}
+/**
+* Checks whether a pool is on the sunset list of a network.
+*
+* @param pool - Pool address.
+* @param network - Network the pool lives on.
+**/
+function isSunsetPool(pool, network) {
+	return !!chains[network].sunsetPools?.some((p) => isAddressEqual(p, pool));
+}
+/**
+* Checks whether a strategy is on the sunset list of a network. Both halves of
+* the strategy key must match: a credit manager can wind down one collateral
+* and keep the rest.
+*
+* @param creditManager - Credit manager address.
+* @param collateral - Target collateral of the strategy.
+* @param network - Network the strategy lives on.
+**/
+function isSunsetStrategy(creditManager, collateral, network) {
+	return !!chains[network].sunsetStrategies?.some((s) => isAddressEqual(s.creditManager, creditManager) && isAddressEqual(s.collateral, collateral));
+}
+//#endregion
+export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };