@upshiftfinance/sdk 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,93 @@
+import type { IAddress, IPoolFunctions } from '../../types';
+/**
+ * Table of Contents
+ * - Hardcoded Addresses
+ * - Vault Functions to Call
+ * - Subgraph URLs
+ * - Vault Receipt Symbol Mapping
+ */
+/**
+ * Hardcoded subaccount addresses for specific vaults allocations
+ */
+export declare const VAULT_ALLOCATION_SUBACCOUNTS: {
+    AgoraAUSD: {
+        address: IAddress;
+        subaccount: IAddress;
+        useDebank: boolean;
+    };
+    earnAUSD: {
+        address: IAddress;
+        subaccount: IAddress;
+        useDebank: boolean;
+    };
+    MonarqXRP: {
+        address: IAddress;
+        subaccount: IAddress;
+        useDebank: boolean;
+    };
+};
+/**
+ * @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
+ */
+export declare const MULTI_ASSET_VAULTS: `0x${string}`[];
+export declare const WRAPPER_ADAPTOR: {
+    43114: IAddress;
+    1: IAddress;
+};
+/**
+ * @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
+ */
+export declare const OLD_LENDING_POOLS: `0x${string}`[];
+export declare const IDLE_CAPITAL_BORROWER_ADDRESS: `0x${string}`[];
+/**
+ * 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.
+ */
+export declare const TVL_EXCLUDED_VAULTS: ReadonlySet<string>;
+/**
+ * Vault Functions to Call
+ */
+/**
+ * The functions to call on the vault contract
+ * @returns The functions to call
+ */
+export declare const VAULT_FUNCTIONS_V1: IPoolFunctions[];
+export declare const VAULT_FUNCTIONS_V2: IPoolFunctions[];
+export declare const VAULT_FUNCTIONS_V2_RECEIPT: IPoolFunctions[];
+export declare const VAULT_FUNCTIONS_V2_WHITELISTED_ASSETS: IPoolFunctions[];
+/**
+ * NEMO ETH Yield vault address (lowercase for comparisons)
+ */
+export declare const NEMO_VAULT_ADDRESS = "0xa422c3018c46ba90a14acd14f96cb60616f5c91b";
+/**
+ * Subgraph base URL
+ * @deprecated use getVaultMetadata to fetch subgraph URLs from the backend
+ */
+export declare const GOLDSKY_BASE_URL = "https://api.goldsky.com/api/public/project_cm9g0xy3o4j6v01vd34r3hvv9/subgraphs";
+/**
+ * Subgraph URLs
+ * @deprecated use getVaultMetadata to fetch subgraph URLs from the backend
+ */
+export declare const SUBGRAPH_VAULT_URLS: Record<VaultSymbols, string>;
+/**
+ * Vault Receipt Symbol Mapping
+ * @deprecated use getVaultMetadata to fetch vault symbols from the backend
+ */
+type VaultSymbols = 'predlp' | 'sentusd' | 'pregrid' | 'repouscc' | 'earnxrp' | 'tivkbtc' | 'tivusdt0' | 'supermon' | 'earnmon' | 'k3europ' | 'wmon/ausd' | 'wbtc/ausd' | 'earnausd_monad' | 'sausd' | 'farmbold' | 'sentuscc' | 'sentbtc' | 'svusdc' | 'apusdc' | 'testwethtsa' | 'tacusr' | 'upinjusdt' | 'tac-teth' | 'upausd' | 'taccbbtc' | 'xupusdc' | 'uptbtc' | 'gteth' | 'ageth' | 'upusdc' | 'hgeth' | 'upssylva' | 'hbbtc' | 'hbhype' | 'upazt' | 'susdt' | 'upedge' | 'coreusdc' | 'upcusdo' | 'shifteth' | 'upsusde' | 'uplbtc' | 'upavax' | 'tacrseth' | 'musd' | 'earnausd' | 'alpineusdcflagship' | 'alpinecoinshiftusdc' | 'upbtc' | 'upstrbtc' | 'maxiusr' | 'upgammausdc' | 'xhype' | 'wildusd' | 'alpinebtc' | 'prenusd' | 'upyzusd' | 'upnusd' | 'hlpe' | 'nemo eth yield';
+/**
+ * Vault Symbols Mapping
+ * @deprecated use getVaultMetadata to fetch vault symbols from the backend
+ */
+export declare const VAULT_SYMBOLS: Record<IAddress, string>;
+/**
+ * Vault Symbols Reverse Mapping
+ * @deprecated use getVaultMetadata to fetch vault symbols from the backend
+ */
+export declare const VAULT_SYMBOLS_REVERSE: Record<VaultSymbols, IAddress>;
+export {};

package/lib/core/constants/vaults.js

@@ -0,0 +1,277 @@
+"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',
+    'depositsPaused',
+    'maxDepositAmount',
+];
+exports.VAULT_FUNCTIONS_V2 = [
+    'assetsWhitelistAddress',
+    'getTotalAssets',
+    'asset',
+    'withdrawalFee',
+    'maxDepositAmount',
+    'lagDuration',
+    'withdrawalsPaused',
+    'depositsPaused',
+    'depositCap',
+    // MUST stay last: `getEvmVaultV2` reads the receipt token positionally as
+    // the final entry of this list.
+    '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/public/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,106 @@
+import type { IChainId, IChainObj } from '../../types';
+/**
+ * Non-EVM chains the SDK routes to its own adapters, keyed by adapter name.
+ *
+ * Each gets a synthetic negative `chainId` so it can share numeric chain-ID
+ * parameters with EVM chains without ever colliding with a real EVM ID. The
+ * IDs match the backend's `chain` column (Solana `-1`, Sui `-2`, Stellar `-3`),
+ * so a backend vault row's `chain` can be compared to these directly.
+ */
+export declare const SPECIAL_CHAINS: {
+    solana: {
+        name: string;
+        chainId: number;
+        explorer: string;
+    };
+    sui: {
+        name: string;
+        chainId: number;
+        explorer: string;
+    };
+    stellar: {
+        name: string;
+        chainId: number;
+        explorer: string;
+    };
+};
+/**
+ * Chain ID used to address Sui vaults: `-2`, the same synthetic ID the backend
+ * stores for Sui vault rows (see {@link SPECIAL_CHAINS}).
+ *
+ * Kept as its own export because callers and the Sui adapter import it by
+ * name. It lives in `core/` rather than `adapters/sui/constants.ts` so `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: number;
+/**
+ * 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, X Layer —
+ * whose native OKB is also 18 decimals).
+ *
+ * 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,
+ * X Layer on 2026-08-11) —
+ * 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[]>;