upshift-finance 1.0.0

package/lib/core/constants/vaults.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VAULT_SYMBOLS_REVERSE = exports.VAULT_SYMBOLS = exports.SUBGRAPH_VAULT_URLS = exports.GOLDSKY_BASE_URL = exports.NEMO_VAULT_ADDRESS = exports.VAULT_FUNCTIONS_V2_WHITELISTED_ASSETS = exports.VAULT_FUNCTIONS_V2_RECEIPT = exports.VAULT_FUNCTIONS_V2 = exports.VAULT_FUNCTIONS_V1 = exports.TVL_EXCLUDED_VAULTS = exports.IDLE_CAPITAL_BORROWER_ADDRESS = exports.OLD_LENDING_POOLS = exports.WRAPPER_ADAPTOR = exports.MULTI_ASSET_VAULTS = exports.VAULT_ALLOCATION_SUBACCOUNTS = void 0;
+const ethers_1 = require("ethers");
+/**
+ * Table of Contents
+ * - Hardcoded Addresses
+ * - Vault Functions to Call
+ * - Subgraph URLs
+ * - Vault Receipt Symbol Mapping
+ */
+/**
+ * Hardcoded subaccount addresses for specific vaults allocations
+ */
+exports.VAULT_ALLOCATION_SUBACCOUNTS = {
+    // For the Agora AUSD vault, fetch the vault allocations from the Caleb subaccount
+    AgoraAUSD: {
+        address: (0, ethers_1.getAddress)('0x828BC5895b78b2fb591018Ca5bDC2064742D6D0f'),
+        subaccount: (0, ethers_1.getAddress)('0xFff71B0b66f076C60Fa2f176a34a6EA709ccF21B'),
+        useDebank: false,
+    },
+    // For the Earn AUSD (Monad) vault, fetch the vault loans from the RockawayX subaccount
+    // fetch the rest of the exposures from Debank
+    earnAUSD: {
+        address: (0, ethers_1.getAddress)('0x36eDbF0C834591BFdfCaC0Ef9605528c75c406aA'),
+        subaccount: (0, ethers_1.getAddress)('0xC8c0Ffb8Ff3BDA26321224e800B3B38AEaB48799'),
+        useDebank: true,
+    },
+    // For the Monarq XRP Yield Vault (Flare), surface the borrower subaccount and
+    // keep vault-level Debank exposure (mirrors earnAUSD).
+    MonarqXRP: {
+        address: (0, ethers_1.getAddress)('0x2439D4bb753A0f3777d4C9011AFacc475ba6B951'),
+        subaccount: (0, ethers_1.getAddress)('0xF755B2244C1C1f20cA03C3Bb472175C9a4E250f2'),
+        useDebank: true,
+    },
+};
+/**
+ * @deprecated use the backend responses /tokenized_vault internal_type field to determine if the vault is an old lending pool
+ * @todo use the backend responses /tokenized_vault internal_type field to determine if the vault is an old lending pool
+ */
+exports.MULTI_ASSET_VAULTS = [
+    //Wild
+    (0, ethers_1.getAddress)('0x18EE038C114a07f4B08b420fb1E4149a4F357249'),
+    //Yuzu
+    (0, ethers_1.getAddress)('0x517677A19D8ae6FF600FB86C3C7bFCCD651e3eec'),
+    //HyENA
+    (0, ethers_1.getAddress)('0x8fFDcd8A96d293f45aA044d10b899F9D71897E8a'),
+    //SingularV
+    (0, ethers_1.getAddress)('0xd411aCaE2Bc7019322277A21ff005d94705661C5'),
+    //Neutrl
+    (0, ethers_1.getAddress)('0xAEEb2fB279a5aA837367B9D2582F898a63b06ca1'),
+    // HCL Stroom
+    (0, ethers_1.getAddress)('0x0C949AAf28bF0318bAa5f2cbF2F2D970f57879aB'),
+    //Aptos Aave
+    (0, ethers_1.getAddress)('0xA38d92eC538e9aa3edb980b89701A9d38a1FE015'),
+    // Sentora USCC
+    (0, ethers_1.getAddress)('0x63C5d615e937697a80606788965E209414738820'),
+    // Sentora wBTC
+    (0, ethers_1.getAddress)('0x3cC0D33B1AEac3d23eA89214b3AC5B4607032167'),
+];
+exports.WRAPPER_ADAPTOR = {
+    43114: (0, ethers_1.getAddress)('0xb2C57614B93c41A7Ec3B91980C0Bb7453904c6e8'),
+    1: (0, ethers_1.getAddress)('0x044155804b2ef8fc53C69E3661ceA9b905EDE7Bc'),
+};
+/**
+ * @deprecated use the backend responses /tokenized_vault internal_type field to determine if the vault is an old lending pool
+ * @todo use the backend responses /tokenized_vault internal_type field to determine if the vault is an old lending pool
+ */
+exports.OLD_LENDING_POOLS = [
+    (0, ethers_1.getAddress)('0xe1B4d34E8754600962Cd944B535180Bd758E6c2e'),
+    (0, ethers_1.getAddress)('0xEBac5e50003d4B17Be422ff9775043cD61002f7f'),
+    (0, ethers_1.getAddress)('0x80E1048eDE66ec4c364b4F22C8768fc657FF6A42'),
+];
+exports.IDLE_CAPITAL_BORROWER_ADDRESS = [
+    (0, ethers_1.getAddress)('0x2151C90C93F52bE82186f162c86DaEABc8911188'),
+    (0, ethers_1.getAddress)('0xb74c137E5f976dbdCC638Ec9fd3e05d6D9124E55'),
+];
+/**
+ * Vault addresses to exclude from `getTotalDeposited` TVL aggregation.
+ * Addresses are lowercased so EVM, Solana, Sui and Stellar vaults can be
+ * checked uniformly (don't wrap them with `getAddress` — non-EVM addresses
+ * would throw). Add an address here to drop its `latest_reported_tvl` from
+ * the headline number — e.g. closed pre-deposit vaults, test vaults, or
+ * migrated v1 pools that are double-counted by a v2 successor.
+ */
+exports.TVL_EXCLUDED_VAULTS = new Set([
+    '0x3299A525986D2e94B3FC6c641C158f5e12dB912d', // Fluent Pre Deposit Vault (migrated to fluent mainnet)
+    // '0x866C6c6627303Be103814150fC0e886BE5D9ea83', // Neutrl Pre Deposit Vault (migrated to Neutrl mainnet)
+].map((a) => a.toLowerCase()));
+/**
+ * Vault Functions to Call
+ */
+/**
+ * The functions to call on the vault contract
+ * @returns The functions to call
+ */
+exports.VAULT_FUNCTIONS_V1 = [
+    'decimals',
+    'asset',
+    'totalSupply',
+    'totalAssets',
+    'maxSupply',
+    'withdrawalFee',
+    'lagDuration',
+    'withdrawalsPaused',
+    'maxDepositAmount',
+];
+exports.VAULT_FUNCTIONS_V2 = [
+    'assetsWhitelistAddress',
+    'getTotalAssets',
+    'asset',
+    'withdrawalFee',
+    'maxDepositAmount',
+    'lagDuration',
+    'withdrawalsPaused',
+    'depositCap',
+    'lpTokenAddress',
+];
+exports.VAULT_FUNCTIONS_V2_RECEIPT = [
+    'decimals',
+    'totalSupply',
+];
+exports.VAULT_FUNCTIONS_V2_WHITELISTED_ASSETS = [
+    'getWhitelistedAssets',
+];
+/**
+ * NEMO ETH Yield vault address (lowercase for comparisons)
+ */
+exports.NEMO_VAULT_ADDRESS = '0xa422c3018c46ba90a14acd14f96cb60616f5c91b';
+/**
+ * Subgraph base URL
+ * @deprecated use getVaultMetadata to fetch subgraph URLs from the backend
+ */
+exports.GOLDSKY_BASE_URL = 'https://api.goldsky.com/api/private/project_cm9g0xy3o4j6v01vd34r3hvv9/subgraphs';
+/**
+ * Subgraph URLs
+ * @deprecated use getVaultMetadata to fetch subgraph URLs from the backend
+ */
+exports.SUBGRAPH_VAULT_URLS = {
+    testwethtsa: ``,
+    tacusr: `${exports.GOLDSKY_BASE_URL}/august-eth-tacUSR/1.0.0/gn`,
+    upinjusdt: `${exports.GOLDSKY_BASE_URL}/august-eth-upINJUSDT/1.0.0/gn`,
+    'tac-teth': `${exports.GOLDSKY_BASE_URL}/august-eth-tactETH/1.0.0/gn`,
+    upbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-upBTC/1.0.0/gn`,
+    upausd: `${exports.GOLDSKY_BASE_URL}/august-avax-upAUSD/1.0.0/gn`,
+    taccbbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-TACcbBTC/1.0.0/gn`,
+    xupusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-xUpUSDC/1.0.0/gn`,
+    uptbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-uptBTC/1.0.0/gn`,
+    gteth: `${exports.GOLDSKY_BASE_URL}/august-eth-gtETH/1.0.0/gn`,
+    ageth: `${exports.GOLDSKY_BASE_URL}/august-eth-agETH/1.0.0/gn`,
+    upusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-upUSDC/1.0.0/gn`,
+    hgeth: `${exports.GOLDSKY_BASE_URL}/august-eth-hgETH/1.0.0/gn`,
+    upssylva: `${exports.GOLDSKY_BASE_URL}/august-eth-upsSYLVA/1.0.0/gn`,
+    hbbtc: `${exports.GOLDSKY_BASE_URL}/august-hyperevm-hbBTC/1.0.0/gn`,
+    hbhype: `${exports.GOLDSKY_BASE_URL}/august-hyperevm-hyperbeat/1.0.0/gn`,
+    upazt: `${exports.GOLDSKY_BASE_URL}/august-eth-upAZT/1.0.0/gn`,
+    susdt: `${exports.GOLDSKY_BASE_URL}/august-bsc-sUSDT/1.0.0/gn`,
+    upedge: `${exports.GOLDSKY_BASE_URL}/august-eth-upEDGE/1.0.0/gn`,
+    coreusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-coreUSDC/1.0.0/gn`,
+    upcusdo: `${exports.GOLDSKY_BASE_URL}/august-eth-upcUSDO/1.0.0/gn`,
+    shifteth: `${exports.GOLDSKY_BASE_URL}/august-eth-shiftETH/1.0.0/gn`,
+    upsusde: `${exports.GOLDSKY_BASE_URL}/august-eth-upsUSDe/1.0.0/gn`,
+    uplbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-upLBTC/1.0.0/gn`,
+    upavax: `${exports.GOLDSKY_BASE_URL}/august-avax-upAVAX/1.0.0/gn`,
+    tacrseth: `${exports.GOLDSKY_BASE_URL}/august-eth-TACrsEth/1.0.0/gn`,
+    musd: `${exports.GOLDSKY_BASE_URL}/august-mezo-mUSD/1.0.0/gn`,
+    wildusd: `${exports.GOLDSKY_BASE_URL}/august-eth-wildUSD/1.0.0/gn`,
+    earnausd: `${exports.GOLDSKY_BASE_URL}/august-eth-earnAUSD/1.0.0/gn`,
+    alpinecoinshiftusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-AlpineCoinshiftUSDC/1.0.0/gn`,
+    alpineusdcflagship: `${exports.GOLDSKY_BASE_URL}/august-eth-AlpineUSDCFlagship/1.0.0/gn`,
+    upstrbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-UpStrBTC/1.0.0/gn`,
+    maxiusr: `${exports.GOLDSKY_BASE_URL}/august-eth-maxiUSR/1.0.0/gn`,
+    upgammausdc: `${exports.GOLDSKY_BASE_URL}/august-eth-upGAMMAusdc/1.0.0/gn`,
+    xhype: `${exports.GOLDSKY_BASE_URL}/august-hyperevm-xHYPE/1.0.0/gn`,
+    alpinebtc: `${exports.GOLDSKY_BASE_URL}/august-eth-AlpineBTC/1.0.0/gn`,
+    prenusd: `${exports.GOLDSKY_BASE_URL}/august-eth-preNUSD/1.0.0/gn`,
+    upyzusd: `${exports.GOLDSKY_BASE_URL}/august-plasma-upyzUSD/1.0.0/gn`,
+    hlpe: `${exports.GOLDSKY_BASE_URL}/august-hyperevm-HLPe/1.0.0/gn`,
+    svusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-svUSDC/1.0.0/gn`,
+    apusdc: `${exports.GOLDSKY_BASE_URL}/august-eth-apUSDC/1.0.0/gn`,
+    upnusd: `${exports.GOLDSKY_BASE_URL}/august-eth-upNUSD/1.0.0/gn`,
+    sentuscc: `${exports.GOLDSKY_BASE_URL}/august-eth-sentUSCC/1.0.0/gn`,
+    sentbtc: `${exports.GOLDSKY_BASE_URL}/august-eth-sentBTC/1.0.0/gn`,
+    farmbold: `${exports.GOLDSKY_BASE_URL}/august-eth-farmBOLD/1.0.0/gn`,
+    sausd: `${exports.GOLDSKY_BASE_URL}/august-monad-sAUSD/1.0.0/gn`,
+    earnausd_monad: `${exports.GOLDSKY_BASE_URL}/august-monad-earnAUSD/1.0.0/gn`,
+    'wmon/ausd': `${exports.GOLDSKY_BASE_URL}/august-monad-wMONAUSD/1.0.0/gn`,
+    'wbtc/ausd': `${exports.GOLDSKY_BASE_URL}/august-monad-wBTCAUSD/1.0.0/gn`,
+    supermon: `${exports.GOLDSKY_BASE_URL}/august-monad-superMON/1.0.0/gn`,
+    earnmon: `${exports.GOLDSKY_BASE_URL}/august-monad-earnMON/1.0.0/gn`,
+    k3europ: `${exports.GOLDSKY_BASE_URL}/august-eth-k3EUROP/1.0.0/gn`,
+    pregrid: `${exports.GOLDSKY_BASE_URL}/august-eth-preGRID/1.0.0/gn`,
+    repouscc: `${exports.GOLDSKY_BASE_URL}/august-eth-repoUSCC/1.0.0/gn`,
+    earnxrp: `${exports.GOLDSKY_BASE_URL}/august-flare-earnXRP/1.0.0/gn`,
+    tivkbtc: `${exports.GOLDSKY_BASE_URL}/august-ink-TIVKBTC/1.0.0/gn`,
+    tivusdt0: `${exports.GOLDSKY_BASE_URL}/august-ink-TIVUSDT0/1.0.0/gn`,
+    sentusd: `${exports.GOLDSKY_BASE_URL}/august-eth-sentUSD/1.0.0/gn`,
+    predlp: `${exports.GOLDSKY_BASE_URL}/august-eth-preDLP/1.0.0/gn`,
+    'nemo eth yield': `${exports.GOLDSKY_BASE_URL}/august-mainnet-nemo-eth-yield/1.0.0/gn`,
+};
+/**
+ * Vault Symbols Mapping
+ * @deprecated use getVaultMetadata to fetch vault symbols from the backend
+ */
+exports.VAULT_SYMBOLS = {
+    '0xaBC578B79892FC0Dc2906Ab5749862622aD38695': 'preDLP',
+    '0x74aD2F789Ed583DBd141bbdafC673fE1F033718b': 'sentUSD',
+    '0x71BE0E419FbB98762C7b6D9e81EaFdA99363333c': 'TIVKBTC',
+    '0x727e37b4252B8a200D32445F2aFB741A308c55F0': 'TIVUSDT0',
+    '0x373D7d201C8134D4a2f7b5c63560da217e3dEA28': 'earnXRP',
+    '0x2Cb3b86C32e723BE255E5ec4E443a0CA90876634': 'repoUSCC',
+    '0x7b2B5B1c2710C7253ED6cbC912BB5f66B5A21649': 'preGRID',
+    '0x792C7c5fB5C996E588b9F4A5FB201C79974e267C': 'superMON',
+    '0x5E7568bf8DF8792aE467eCf5638d7c4D18A1881C': 'earnMON',
+    '0x0243755a22E37b835486fdAE9A839523ADABd336': 'k3EUROP',
+    '0xD793c04B87386A6bb84ee61D98e0065FdE7fdA5E': 'sAUSD',
+    '0x64996271ee085ef9e6E939Ab3eACd93F7d7080db': 'wMON/AUSD',
+    '0xB667D005695D7f530A5621549aE31d9409486E29': 'wBTC/AUSD',
+    '0x36eDbF0C834591BFdfCaC0Ef9605528c75c406aA': 'earnAUSD_monad',
+    '0x686c83Aa81ba206354fDcbc2cd282B4531365E29': 'tacUSR',
+    '0x02991EE6134dEE504668e2227C5879Dd78EfCDc3': 'upINJUSDT',
+    '0xf7b65fBA4d02110089fC6e2bE6d73809b45852f8': 'tac-tETH',
+    '0x3408b22d8895753C9A3e14e4222E981d4E9A599E': 'upAUSD',
+    '0xeb402fc96C7ed2f889d837C9976D6d821c1B5f01': 'TACcbBTC',
+    '0x396A3f77EE1faf5A3C46e878bA7b7a2dcbe55517': 'xUpUSDC',
+    '0x8AcA0841993ef4C87244d519166e767f49362C21': 'uptBTC',
+    '0x5Fde59415625401278c4d41C6beFCe3790eb357f': 'gtETH',
+    '0xe1B4d34E8754600962Cd944B535180Bd758E6c2e': 'agETH',
+    '0x80E1048eDE66ec4c364b4F22C8768fc657FF6A42': 'upUSDC',
+    '0xc824A08dB624942c5E5F330d56530cD1598859fD': 'hgETH',
+    '0xc428439fB7B1EFE56360Eb837Ca98F551fdD9B26': 'upsSYLVA',
+    '0xc061d38903b99aC12713B550C2CB44B221674F94': 'hbBTC',
+    '0x96C6cBB6251Ee1c257b2162ca0f39AA5Fa44B1FB': 'hbHYPE',
+    '0x69FC3f84FD837217377d9Dae0212068cEB65818e': 'upAZT',
+    '0xD0b717ef23817b1a127139830Cf0FcD449ef74F0': 'sUSDT',
+    '0xEAA3b922E9fEbCa37d1c02D2142A59595094C605': 'upEDGE',
+    '0xE9B725010A9E419412ed67d0fA5f3A5f40159D32': 'coreUSDC',
+    '0x7383c2454D23A1e34B35ba02674be0a41Bd5aa56': 'upcUSDO',
+    '0xB78dAf3fD674B81ebeaaa88d711506fa069E1C5E': 'shiftETH',
+    '0xd684AF965b1c17D628ee0d77cae94259c41260F4': 'upsUSDe',
+    '0x8EC5C8642397791cff83563C9C83b9C1409D5F48': 'testWETHTSA',
+    '0x4e2D90f0307A93b54ACA31dc606F93FE6b9132d2': 'upLBTC',
+    '0xB2bFb52cfc40584AC4e9e2B36a5B8d6554A56e0b': 'upAVAX',
+    '0x419386E3Ef42368e602720CC458e00c0B28c47A7': 'TACrsEth',
+    '0x221B2D9aD7B994861Af3f4c8A80c86C4aa86Bf53': 'mUSD',
+    '0x828BC5895b78b2fb591018Ca5bDC2064742D6D0f': 'earnAUSD',
+    '0xD066649Bcb7d8D3335fE29CaD0AED6E17D5828B5': 'AlpineUSDCFlagship',
+    '0x0985C88929A776a2E059615137a48bA5A473E25D': 'AlpineCoinshiftUSDC',
+    '0xEBac5e50003d4B17Be422ff9775043cD61002f7f': 'upBTC',
+    '0x787f5541Ee40cD0c94175251686DDBbcf69A7344': 'UpStrBTC',
+    '0xdA89af5bF2eb0B225d787aBfA9095610f2E79e7D': 'maxiUSR',
+    '0x998D7b14c123c1982404562b68edDB057b0477cB': 'upGAMMAusdc',
+    '0x3a214b33A648f17fdcb78eD895dD0579dc3cc330': 'xHYPE',
+    '0x18EE038C114a07f4B08b420fb1E4149a4F357249': 'wildUSD',
+    '0x6625bA54DC861e9f5c678983dBa5BA96d19a9224': 'AlpineBTC',
+    '0x866C6c6627303Be103814150fC0e886BE5D9ea83': 'preNUSD',
+    '0x8fFDcd8A96d293f45aA044d10b899F9D71897E8a': 'HLPe',
+    '0xd411aCaE2Bc7019322277A21ff005d94705661C5': 'svUSDC',
+    '0xA38d92eC538e9aa3edb980b89701A9d38a1FE015': 'apUSDC',
+    '0x0C949AAf28bF0318bAa5f2cbF2F2D970f57879aB': 'UpStrBTC',
+    '0x517677A19D8ae6FF600FB86C3C7bFCCD651e3eec': 'upyzUSD',
+    '0xAEEb2fB279a5aA837367B9D2582F898a63b06ca1': 'upNUSD',
+    '0x3cC0D33B1AEac3d23eA89214b3AC5B4607032167': 'sentBTC',
+    '0x63C5d615e937697a80606788965E209414738820': 'sentUSCC',
+    '0xb2FdA773822E5a04c8A70348d66257DD5Cf442DB': 'farmBOLD',
+    '0xA422C3018C46ba90a14AcD14f96CB60616F5c91B': 'NEMO ETH Yield',
+};
+/**
+ * Vault Symbols Reverse Mapping
+ * @deprecated use getVaultMetadata to fetch vault symbols from the backend
+ */
+exports.VAULT_SYMBOLS_REVERSE = Object.fromEntries(Object.entries(exports.VAULT_SYMBOLS).map(([key, value]) => [value, key]));
+//# sourceMappingURL=vaults.js.map

package/lib/core/constants/web3.d.ts

@@ -0,0 +1,91 @@
+import type { IChainId, IChainObj } from '../../types';
+export declare const SPECIAL_CHAINS: {
+    solana: {
+        name: string;
+        chainId: number;
+        explorer: string;
+    };
+    stellar: {
+        name: string;
+        chainId: number;
+        explorer: string;
+    };
+};
+/**
+ * Chain ID used to address Sui vaults.
+ *
+ * Unlike Solana (`-1`) and Stellar (`-3`), Sui does not use a synthetic
+ * negative ID — `101` is the SLIP-44-derived value the Sui adapter has always
+ * used. It lives here rather than in `adapters/sui/constants.ts` so that
+ * `core/` can recognise it without importing the adapter layer (which would
+ * create a `core → adapters` back-edge); the adapter re-exports it.
+ */
+export declare const SUI_CHAIN_ID = 101;
+/**
+ * Chain IDs the SDK understands that are **not** served by an EVM JSON-RPC
+ * provider. Callers may legitimately pass these to vault methods without a
+ * matching entry in the `providers` map — the request routes through the
+ * Solana / Stellar / Sui adapter instead.
+ */
+export declare const NON_EVM_CHAIN_IDS: ReadonlySet<number>;
+export declare const NATIVE_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/**
+ * Decimal precision of the native gas token on every EVM chain this SDK
+ * supports (ETH, Base, Arbitrum, Avalanche, Polygon, BNB, HyperEVM, Unichain,
+ * Mezo, Monad, Plasma, Ink, Flare, Katana, Citrea, Fluent, Tempo).
+ *
+ * All of them use 18-decimal native tokens, so this is a single constant rather
+ * than a per-chain map. It exists because the native token has no ERC-20
+ * `decimals()` to read on-chain: when a subgraph row denominates an amount in
+ * the native token it is flagged with a sentinel address ({@link NATIVE_ADDRESS}
+ * or the zero address) instead of a real contract, and callers must substitute
+ * this value rather than attempting (and failing) a `decimals()` read.
+ *
+ * Non-EVM natives differ (SOL is 9, XLM is 7) and are handled by their own
+ * adapters — those chains never flow through the EVM `decimals()` path this
+ * constant serves.
+ */
+export declare const EVM_NATIVE_DECIMALS = 18;
+export declare const MIN_ABIS: {
+    name: string;
+    symbol: string;
+    decimals: string;
+    totalSupply: string;
+    approve: string;
+    allowance: string;
+    managementFeePercent: string;
+};
+export declare const ORACLE_CONTRACTS: {
+    1: string;
+    43114: string;
+    42161: string;
+    8453: string;
+    10: string;
+};
+export declare const NETWORKS: Record<IChainId, IChainObj>;
+export declare const AVAILABLE_CHAINS: IChainId[];
+/**
+ * Canonical [Multicall3](https://github.com/mds1/multicall) address, deployed
+ * via the deterministic deployer to the same address on most EVM chains.
+ * @internal
+ */
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+/**
+ * Chains where the canonical Multicall3 deployment was **verified on-chain**
+ * (`eth_getCode` returned the 3808-byte runtime at {@link MULTICALL3_ADDRESS};
+ * checked per chain on 2026-07-14, Tempo checked separately on 2026-07-15) —
+ * deterministic-deployer presence is NOT assumed. Chains outside this set
+ * keep the per-call read path.
+ *
+ * Deliberately excluded from `NETWORKS`:
+ * - 4114 (Citrea) — `eth_getCode` returned `0x` (not deployed).
+ * - -1 (Solana), -3 (Stellar) — non-EVM, no Multicall3.
+ * @internal
+ */
+export declare const MULTICALL3_VERIFIED_CHAINS: ReadonlySet<number>;
+/**
+ * Fallbacks
+ */
+export declare const FALLBACK_DECIMALS = 18;
+export declare const FALLBACK_CHAINID = 42161;
+export declare const FALLBACK_RPC_URLS: Record<number, string[]>;

package/lib/core/constants/web3.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_RPC_URLS = exports.FALLBACK_CHAINID = exports.FALLBACK_DECIMALS = exports.MULTICALL3_VERIFIED_CHAINS = exports.MULTICALL3_ADDRESS = exports.AVAILABLE_CHAINS = exports.NETWORKS = exports.ORACLE_CONTRACTS = exports.MIN_ABIS = exports.EVM_NATIVE_DECIMALS = exports.NATIVE_ADDRESS = exports.NON_EVM_CHAIN_IDS = exports.SUI_CHAIN_ID = exports.SPECIAL_CHAINS = void 0;
+// Special Chains
+exports.SPECIAL_CHAINS = {
+    solana: {
+        name: 'Solana',
+        chainId: -1,
+        explorer: 'https://solscan.io',
+    },
+    stellar: {
+        name: 'Stellar',
+        chainId: -3,
+        explorer: 'https://stellar.expert',
+    },
+};
+/**
+ * Chain ID used to address Sui vaults.
+ *
+ * Unlike Solana (`-1`) and Stellar (`-3`), Sui does not use a synthetic
+ * negative ID — `101` is the SLIP-44-derived value the Sui adapter has always
+ * used. It lives here rather than in `adapters/sui/constants.ts` so that
+ * `core/` can recognise it without importing the adapter layer (which would
+ * create a `core → adapters` back-edge); the adapter re-exports it.
+ */
+exports.SUI_CHAIN_ID = 101;
+/**
+ * Chain IDs the SDK understands that are **not** served by an EVM JSON-RPC
+ * provider. Callers may legitimately pass these to vault methods without a
+ * matching entry in the `providers` map — the request routes through the
+ * Solana / Stellar / Sui adapter instead.
+ */
+exports.NON_EVM_CHAIN_IDS = new Set([
+    exports.SPECIAL_CHAINS.solana.chainId,
+    exports.SPECIAL_CHAINS.stellar.chainId,
+    exports.SUI_CHAIN_ID,
+]);
+// General
+exports.NATIVE_ADDRESS = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE';
+/**
+ * Decimal precision of the native gas token on every EVM chain this SDK
+ * supports (ETH, Base, Arbitrum, Avalanche, Polygon, BNB, HyperEVM, Unichain,
+ * Mezo, Monad, Plasma, Ink, Flare, Katana, Citrea, Fluent, Tempo).
+ *
+ * All of them use 18-decimal native tokens, so this is a single constant rather
+ * than a per-chain map. It exists because the native token has no ERC-20
+ * `decimals()` to read on-chain: when a subgraph row denominates an amount in
+ * the native token it is flagged with a sentinel address ({@link NATIVE_ADDRESS}
+ * or the zero address) instead of a real contract, and callers must substitute
+ * this value rather than attempting (and failing) a `decimals()` read.
+ *
+ * Non-EVM natives differ (SOL is 9, XLM is 7) and are handled by their own
+ * adapters — those chains never flow through the EVM `decimals()` path this
+ * constant serves.
+ */
+exports.EVM_NATIVE_DECIMALS = 18;
+exports.MIN_ABIS = {
+    name: 'function name() view returns (string)',
+    symbol: 'function symbol() view returns (string)',
+    decimals: 'function decimals() view returns (uint8)',
+    totalSupply: 'function totalSupply() view returns (uint256)',
+    approve: 'function approve(address spender, uint256 value) external returns (bool success)',
+    allowance: 'function allowance(address owner, address spender) external view returns (uint256)',
+    managementFeePercent: 'function managementFeePercent() view returns (uint256)',
+};
+// Search: New Chain
+exports.ORACLE_CONTRACTS = {
+    1: '0xA4E24C498D5B28517787D8407eFdcB157A4FbF50', // mainnet
+    43114: '0x755537Cb5C76E06Bb492CF7c73567e252769c5f5', // avax
+    42161: '0x24F7BC5CA6E4b53cF7311dE1f5bF8Ba528400E1e', // arbitrum
+    8453: '0x07858dF2D8D9aB1DCAAA8b743eb80C6250DFA947', // base
+    10: '0xe0049eBCCB23Cb81c3d4C9Fa175b32876b70C2AB', // OP
+};
+// Networks
+// Search: New Chain
+// @todo: this should be used for wagmi configs
+exports.NETWORKS = {
+    1: {
+        name: 'Ethereum',
+        chainId: 1,
+        explorer: 'https://etherscan.io',
+    },
+    42161: {
+        name: 'Arbitrum One',
+        chainId: 42161,
+        explorer: 'https://arbiscan.io',
+    },
+    8453: {
+        name: 'Base',
+        chainId: 8453,
+        explorer: 'https://basescan.org',
+    },
+    43114: {
+        name: 'Avalanche',
+        chainId: 43114,
+        explorer: 'https://snowscan.xyz',
+    },
+    137: {
+        name: 'Polygon',
+        chainId: 137,
+        explorer: 'https://polygonscan.com',
+    },
+    56: {
+        name: 'BNB Smart Chain',
+        chainId: 56,
+        explorer: 'https://bscscan.com',
+    },
+    999: {
+        name: 'HyperEVM',
+        chainId: 999,
+        explorer: 'https://hyperevmscan.io',
+    },
+    130: {
+        name: 'Unichain',
+        chainId: 130,
+        explorer: 'https://uniscan.xyz',
+    },
+    31612: {
+        name: 'Mezo',
+        chainId: 31612,
+        explorer: 'https://explorer.mezo.org',
+    },
+    143: {
+        name: 'Monad',
+        chainId: 143,
+        explorer: 'https://monadscan.com',
+    },
+    9745: {
+        name: 'Plasma',
+        chainId: 9745,
+        explorer: 'https://plasmascan.to',
+    },
+    57073: {
+        name: 'Ink',
+        chainId: 57073,
+        explorer: 'https://explorer.inkonchain.com',
+    },
+    14: {
+        name: 'Flare',
+        chainId: 14,
+        explorer: 'https://flarescan.com',
+    },
+    747474: {
+        name: 'Katana',
+        chainId: 747474,
+        explorer: 'https://explorer.katanarpc.com',
+    },
+    4114: {
+        name: 'Citrea',
+        chainId: 4114,
+        explorer: 'https://explorer.mainnet.citrea.xyz',
+    },
+    25363: {
+        name: 'Fluent',
+        chainId: 25363,
+        explorer: 'https://fluentscan.xyz',
+    },
+    4217: {
+        name: 'Tempo',
+        chainId: 4217,
+        explorer: 'https://explore.tempo.xyz',
+    },
+};
+exports.AVAILABLE_CHAINS = Object.keys(exports.NETWORKS).map((c) => Number(c));
+/**
+ * Canonical [Multicall3](https://github.com/mds1/multicall) address, deployed
+ * via the deterministic deployer to the same address on most EVM chains.
+ * @internal
+ */
+exports.MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+/**
+ * Chains where the canonical Multicall3 deployment was **verified on-chain**
+ * (`eth_getCode` returned the 3808-byte runtime at {@link MULTICALL3_ADDRESS};
+ * checked per chain on 2026-07-14, Tempo checked separately on 2026-07-15) —
+ * deterministic-deployer presence is NOT assumed. Chains outside this set
+ * keep the per-call read path.
+ *
+ * Deliberately excluded from `NETWORKS`:
+ * - 4114 (Citrea) — `eth_getCode` returned `0x` (not deployed).
+ * - -1 (Solana), -3 (Stellar) — non-EVM, no Multicall3.
+ * @internal
+ */
+exports.MULTICALL3_VERIFIED_CHAINS = new Set([
+    1, // Ethereum
+    42161, // Arbitrum One
+    8453, // Base
+    43114, // Avalanche
+    137, // Polygon
+    56, // BNB Smart Chain
+    999, // HyperEVM
+    130, // Unichain
+    31612, // Mezo
+    143, // Monad
+    9745, // Plasma
+    57073, // Ink
+    14, // Flare
+    747474, // Katana
+    25363, // Fluent
+    4217, // Tempo
+]);
+/**
+ * Fallbacks
+ */
+exports.FALLBACK_DECIMALS = 18;
+exports.FALLBACK_CHAINID = 42161;
+exports.FALLBACK_RPC_URLS = {
+    // Ethereum Mainnet
+    1: ['https://ethereum-rpc.publicnode.com'],
+    42161: ['https://arbitrum-one-rpc.publicnode.com'],
+    8453: ['https://base-rpc.publicnode.com'],
+    43114: ['https://avalanche-c-chain-rpc.publicnode.com'],
+    143: ['https://monad-mainnet.g.alchemy.com/v2/public'],
+    999: ['https://rpc.hyperliquid.xyz/evm'],
+    239: ['https://rpc.ankr.com/tac'],
+    80094: ['https://berachain-rpc.publicnode.com'],
+    59144: ['https://linea-rpc.publicnode.com'],
+    43111: ['https://rpc.hemi.network/rpc'],
+    146: ['https://rpc.soniclabs.com'],
+    534352: ['https://scroll.api.onfinality.io/public'],
+    10: ['https://optimism-mainnet.public.blastapi.io'],
+    9745: ['https://rpc.plasma.to'],
+    57073: ['https://rpc-gel.inkonchain.com'],
+    14: ['https://flare-api.flare.network/ext/C/rpc'],
+    747474: ['https://rpc.katana.network'],
+    4114: ['https://rpc.mainnet.citrea.xyz'],
+    25363: ['https://rpc.fluent.xyz'],
+    4217: ['https://rpc.mainnet.tempo.xyz'],
+};
+//# sourceMappingURL=web3.js.map