@awarizon/web3 1.3.1 → 1.3.3

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { erc20Abi, createPublicClient, http } from 'viem';
+import { erc20Abi, http, fallback, createPublicClient } from 'viem';
 import { WalletEngine } from '@awarizon/wallet-engine';
 export { ChainMismatchError, ChainSwitchError, InvalidMnemonicError, InvalidPrivateKeyError, WalletEngine, WalletNotConnectedError } from '@awarizon/wallet-engine';
 import { TransactionEngine } from '@awarizon/tx-engine';
@@ -83,6 +83,27 @@ function getSupportedChainIds() {
     return true;
   }).map((c) => c.id);
 }
+var FALLBACK_RPCS = {
+  5e3: "https://mantle-mainnet.public.blastapi.io",
+  // mantle
+  42220: "https://celo.drpc.org",
+  // celo
+  100: "https://gnosis.drpc.org",
+  // gnosis
+  250: "https://rpc.fantom.network",
+  // fantom
+  1284: "https://moonbeam.drpc.org"
+  // moonbeam
+};
+function getChainTransport(chain, rpcUrlOverride) {
+  if (rpcUrlOverride) return http(rpcUrlOverride);
+  const fallbackUrl = FALLBACK_RPCS[chain.id];
+  if (fallbackUrl) {
+    const primaryUrl = chain.rpcUrls.default.http[0];
+    return fallback([http(primaryUrl), http(fallbackUrl)]);
+  }
+  return http();
+}
 function trackEvent(telemetry, type, chain, functionName, success, start) {
   telemetry?.track({
     type,
@@ -362,6 +383,309 @@ var TelemetryClient = class {
     );
   }
 };
+
+// src/price/feeds.ts
+var AGGREGATOR_ABI = [
+  {
+    inputs: [],
+    name: "latestRoundData",
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "decimals",
+    outputs: [{ name: "", type: "uint8" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+var CHAINLINK_FEEDS = {
+  // Ethereum Mainnet
+  1: {
+    ETH: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
+    BTC: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88b",
+    BNB: "0x14e613AC84a31f709eadbEF3bf98585328207896",
+    MATIC: "0x7bAC85A8a13A4BcD8abb3eB7d6b4d632c895a5f6",
+    AVAX: "0xFF3EEb22B5E3dE6e705b44749C2559d704923FD7",
+    LINK: "0x2c1d072e956AFFC0D435Cb7AC308d97936742191",
+    UNI: "0x553303d460EE0afB37EdFf9bE42922D8FF63220e",
+    AAVE: "0x547a514d5e3769680Ce22B2361c10Ea13619e8a9",
+    MKR: "0xec1D1B3b0443256cc3860e24a46F108e699484Aa",
+    SNX: "0xDC3EA94CD0AC27d9A86C180091e7f78C683d3699",
+    CRV: "0xCd627aA160A6fA45Eb793D19Ef54f5062F20f33",
+    USDC: "0x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f6",
+    USDT: "0x3E7d1eAB13ad0104d2750B8863b489D65364e32D",
+    DAI: "0xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee9",
+    FRAX: "0xB9E1E3A9feFf48998E45Fa90847ed4D467E8BcfD"
+  },
+  // Base
+  8453: {
+    ETH: "0x71041dddad3595F9CEd3dCCFBe3D1F4b0a16Bb70",
+    BTC: "0x64c911996D3c6aC71f9b455B1E8E7266BcFBF15F",
+    LINK: "0x56a43EB56Da12C0dc1D972ACb089c06a5dEF8e69",
+    USDC: "0x7e860098F58bBFC8648a4311b374B1D669a2bc9b"
+  },
+  // Polygon
+  137: {
+    ETH: "0xF9680D99D6C9589e2a93a78A04A279e509205945",
+    BTC: "0xc907E116054Ad103354f2D350FD2514433D57F6f",
+    MATIC: "0xAB594600376Ec9fD91F8e885dADF0CE036862dE0",
+    LINK: "0xd9FFdb71EbE7496cC440152d43986Aae0AB76665",
+    AAVE: "0x72484B12719E23115761D5DA1646945632979bB6",
+    UNI: "0xdf0Fb4e4F928d2dCB76f438575fDD8682386e13C",
+    USDC: "0xfE4A8cc5b5B2366C1B58Bea3858e81843581b2F7",
+    USDT: "0x0A6513e40db6EB1b165753AD52E80663aea50545",
+    DAI: "0x4746DeC9e833A82EC7C2C1356372CcF2cfcD2F3D"
+  },
+  // Arbitrum One
+  42161: {
+    ETH: "0x639Fe6ab55C921f74e7fac1ee960C0B6293ba612",
+    BTC: "0x6ce185860a4963106506C203335A2910413708e9",
+    LINK: "0x86E53CF1B873786aC9Cc60cde71fFd0035d6df2d",
+    ARB: "0xb2A824043730FE05F3DA2efaFa1CBbe83fa548D6",
+    USDC: "0x50834F3163758fcC1Df9973b6e91f0F0F0434aD3",
+    USDT: "0x3f3f5dF88dC9F13eac63DF89EC16ef6e7E25DdE7"
+  },
+  // Optimism
+  10: {
+    ETH: "0x13e3Ee699D1909E989722E753853AE30b17e08c5",
+    BTC: "0xD702DD976Fb76Fffc2D3963D037dfDae5b04E593",
+    LINK: "0xCc232dcFAAE6354cE191Bd574108c1aD03f86450",
+    OP: "0x0D276FC14719f9292D5C1eA2198673d1f4269246",
+    USDC: "0x16a9FA2FDa030272Ce99B29CF780dFA30361d35f",
+    USDT: "0xECef79E109e997bCA29c1c0897ec9d7b03647F5E"
+  },
+  // BNB Smart Chain
+  56: {
+    BNB: "0x0567F2323251f0Aab15c8dFb1967E4e8A7D42aeE",
+    ETH: "0x9ef1B8c0E4F7dc8bF5719Ea496883DC6401d5b2",
+    BTC: "0x264990fbd0A4796A3E3d8E37C4d5F87a3aCa5Ebf",
+    LINK: "0xca236E327F629f9Fc2c30A4E95775EbF0B89fac8",
+    USDT: "0xB97Ad0E74fa7d920791E90258A6E2085088b4320",
+    DAI: "0x132d3C0B1D2cEa0BC552588063bdBb210FDeecfA"
+  },
+  // Avalanche C-Chain
+  43114: {
+    ETH: "0x976B3D034E162d8bD72D6b9C989d545b839003b0",
+    BTC: "0x2779D32d5166BAaa2B2b658333bA7e6Ec0C65743",
+    AVAX: "0x0A77230d17318075983913bC2145DB16C7366156",
+    LINK: "0x49ccd9ca821EfEab2b98c60DC60F518E765eDe9a",
+    USDC: "0xF096872672F44d6EBA71527d2277B6f4B77Ea29A",
+    USDT: "0xEBE676ee90Fe1112671f19b6B7459bC678B67e8a"
+  }
+};
+var COINGECKO_IDS = {
+  // Native tokens
+  ETH: "ethereum",
+  BTC: "bitcoin",
+  BNB: "binancecoin",
+  MATIC: "matic-network",
+  POL: "matic-network",
+  AVAX: "avalanche-2",
+  FTM: "fantom",
+  GLMR: "moonbeam",
+  CELO: "celo",
+  XDAI: "xdai",
+  GNO: "gnosis",
+  MNT: "mantle",
+  // Major stables
+  USDC: "usd-coin",
+  USDT: "tether",
+  DAI: "dai",
+  BUSD: "binance-usd",
+  FRAX: "frax",
+  LUSD: "liquity-usd",
+  GUSD: "gemini-dollar",
+  TUSD: "true-usd",
+  USDD: "usdd",
+  FDUSD: "first-digital-usd",
+  // DeFi blue chips
+  LINK: "chainlink",
+  UNI: "uniswap",
+  AAVE: "aave",
+  MKR: "maker",
+  SNX: "havven",
+  CRV: "curve-dao-token",
+  LDO: "lido-dao",
+  RPL: "rocket-pool",
+  BAL: "balancer",
+  COMP: "compound-governance-token",
+  YFI: "yearn-finance",
+  SUSHI: "sushi",
+  // L2 tokens
+  ARB: "arbitrum",
+  OP: "optimism",
+  IMX: "immutable-x",
+  // Other popular alts
+  DOGE: "dogecoin",
+  SHIB: "shiba-inu",
+  PEPE: "pepe",
+  WLD: "worldcoin-wld",
+  APE: "apecoin",
+  GRT: "the-graph",
+  ENS: "ethereum-name-service",
+  BLUR: "blur"
+};
+
+// src/price/index.ts
+var TWO_HOURS_SECS = 7200;
+async function fetchChainlink(publicClient, chainId, symbol) {
+  const feeds = CHAINLINK_FEEDS[chainId];
+  if (!feeds) return null;
+  const address = feeds[symbol.toUpperCase()];
+  if (!address) return null;
+  try {
+    const [roundData, rawDecimals] = await Promise.all([
+      publicClient.readContract({
+        address,
+        abi: AGGREGATOR_ABI,
+        functionName: "latestRoundData"
+      }),
+      publicClient.readContract({
+        address,
+        abi: AGGREGATOR_ABI,
+        functionName: "decimals"
+      })
+    ]);
+    const answer = roundData[1];
+    const updatedAt = Number(roundData[3]);
+    const decimals = Number(rawDecimals);
+    if (answer <= 0n) return null;
+    const price = Number(answer) / 10 ** decimals;
+    const stale = Date.now() / 1e3 - updatedAt > TWO_HOURS_SECS;
+    return { symbol: symbol.toUpperCase(), price, source: "chainlink", updatedAt, stale };
+  } catch {
+    return null;
+  }
+}
+var CG_BASE = "https://api.coingecko.com/api/v3";
+async function fetchCoinGecko(symbols) {
+  const ids = symbols.map((s) => COINGECKO_IDS[s.toUpperCase()]).filter(Boolean);
+  if (ids.length === 0) return {};
+  const url = `${CG_BASE}/simple/price?ids=${ids.join(",")}&vs_currencies=usd`;
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`[awarizon/price] CoinGecko returned ${res.status}`);
+  const data = await res.json();
+  const out = {};
+  for (const sym of symbols) {
+    const id = COINGECKO_IDS[sym.toUpperCase()];
+    const price = id ? data[id]?.usd : void 0;
+    if (price !== void 0) out[sym.toUpperCase()] = price;
+  }
+  return out;
+}
+var PriceEngine = class {
+  constructor(publicClient, chainId) {
+    this.publicClient = publicClient;
+    this.chainId = chainId;
+  }
+  /**
+   * Get the current USD price of a single token by symbol.
+   * Tries Chainlink first; falls back to CoinGecko on failure or missing feed.
+   *
+   * @param symbol - Token symbol: 'ETH', 'BTC', 'USDC', 'LINK', etc.
+   *
+   * @example
+   * const { price, source } = await awarizon.price.get('ETH')
+   */
+  async get(symbol) {
+    const sym = symbol.toUpperCase();
+    const chainlink = await fetchChainlink(this.publicClient, this.chainId, sym);
+    if (chainlink && !chainlink.stale) return chainlink;
+    if (COINGECKO_IDS[sym]) {
+      try {
+        const cgPrices = await fetchCoinGecko([sym]);
+        const price = cgPrices[sym];
+        if (price !== void 0) {
+          return { symbol: sym, price, source: "coingecko" };
+        }
+      } catch {
+        if (chainlink) return chainlink;
+      }
+    }
+    if (chainlink) return chainlink;
+    throw new Error(
+      `[awarizon/price] No price available for "${sym}". No Chainlink feed on chain ${this.chainId} and CoinGecko ID not registered. Supported symbols: ETH, BTC, BNB, MATIC, AVAX, LINK, UNI, AAVE, USDC, USDT, DAI, and more.`
+    );
+  }
+  /**
+   * Get USD prices for multiple tokens in one call.
+   * Chainlink feeds are read in parallel; CoinGecko batch-fetches all remaining
+   * symbols in a single HTTP request — efficient even for large lists.
+   *
+   * @param symbols - Array of token symbols: ['ETH', 'BTC', 'USDC']
+   *
+   * @example
+   * const prices = await awarizon.price.getMany(['ETH', 'BTC', 'USDC', 'ARB'])
+   * console.log(prices.ETH.price)   // 3421.57
+   * console.log(prices.ARB.source)  // 'coingecko' (no feed on most chains)
+   */
+  async getMany(symbols) {
+    const syms = symbols.map((s) => s.toUpperCase());
+    const chainlinkResults = await Promise.all(
+      syms.map((sym) => fetchChainlink(this.publicClient, this.chainId, sym))
+    );
+    const out = {};
+    const needsCG = [];
+    for (let i = 0; i < syms.length; i++) {
+      const sym = syms[i];
+      const cl = chainlinkResults[i];
+      if (cl && !cl.stale) {
+        out[sym] = cl;
+      } else {
+        needsCG.push(sym);
+      }
+    }
+    if (needsCG.length > 0) {
+      try {
+        const cgPrices = await fetchCoinGecko(needsCG);
+        for (const sym of needsCG) {
+          const price = cgPrices[sym];
+          if (price !== void 0) {
+            out[sym] = { symbol: sym, price, source: "coingecko" };
+          } else {
+            const cl = chainlinkResults[syms.indexOf(sym)];
+            if (cl) out[sym] = cl;
+          }
+        }
+      } catch {
+        for (const sym of needsCG) {
+          const cl = chainlinkResults[syms.indexOf(sym)];
+          if (cl) out[sym] = cl;
+        }
+      }
+    }
+    return out;
+  }
+  /**
+   * Check whether a Chainlink feed exists for the given symbol on the current chain.
+   *
+   * @example
+   * awarizon.price.hasFeed('ETH')  // true on mainnet, base, polygon, etc.
+   * awarizon.price.hasFeed('ARB')  // true on Arbitrum, false elsewhere
+   */
+  hasFeed(symbol) {
+    return !!CHAINLINK_FEEDS[this.chainId]?.[symbol.toUpperCase()];
+  }
+  /**
+   * Return all symbols that have a Chainlink feed on the current chain.
+   *
+   * @example
+   * awarizon.price.supportedSymbols()
+   * // → ['ETH', 'BTC', 'LINK', 'USDC', 'USDT', 'DAI'] on Base
+   */
+  supportedSymbols() {
+    return Object.keys(CHAINLINK_FEEDS[this.chainId] ?? {});
+  }
+};
 var ERC20_ABI = erc20Abi;
 var ERC721_ABI = [
   { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ type: "string" }] },
@@ -402,9 +726,9 @@ var WalletProxy = class {
     await this.ensureReady();
     return this.engine.create();
   }
-  async importMnemonic(mnemonic, accountIndex) {
+  async importMnemonic(mnemonic, addressIndex) {
     await this.ensureReady();
-    return this.engine.importMnemonic(mnemonic, accountIndex);
+    return this.engine.importMnemonic(mnemonic, addressIndex);
   }
   async importPrivateKey(privateKey) {
     await this.ensureReady();
@@ -482,12 +806,13 @@ var AwarizonWeb3 = class {
     this.chain = resolveChain(config.chain);
     this.publicClient = createPublicClient({
       chain: this.chain,
-      transport: http(config.rpcUrl)
+      transport: getChainTransport(this.chain, config.rpcUrl)
     });
     this._engine = new WalletEngine({
       chain: this.chain,
       publicClient: this.publicClient,
-      rpcUrl: config.rpcUrl
+      rpcUrl: config.rpcUrl,
+      getTransport: (chain) => getChainTransport(chain, config.rpcUrl)
     });
     this._txEngine = new TransactionEngine(
       this.publicClient,
@@ -499,6 +824,7 @@ var AwarizonWeb3 = class {
       this._engine,
       () => this._telemetry.ensureValidated()
     );
+    this.price = new PriceEngine(this.publicClient, this.chain.id);
     if (config.signer) {
       this._engine.connectExternal(config.signer);
     }
@@ -977,6 +1303,6 @@ Currently registered: ${registered}`
   }
 };
 
-export { ApiKeyRequiredError, AwarizonWeb3, CHAINS, ContractNotLoadedError, ERC1155_ABI, ERC20_ABI, ERC721_ABI, InvalidApiKeyError, NetworkMismatchError, ProviderError, TelemetryClient, UnsupportedChainError, getSupportedChainIds, resolveChain };
+export { ApiKeyRequiredError, AwarizonWeb3, CHAINLINK_FEEDS, CHAINS, COINGECKO_IDS, ContractNotLoadedError, ERC1155_ABI, ERC20_ABI, ERC721_ABI, InvalidApiKeyError, NetworkMismatchError, PriceEngine, ProviderError, TelemetryClient, UnsupportedChainError, getChainTransport, getSupportedChainIds, resolveChain };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map