@awarizon/web3 1.3.0 → 1.3.2

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Chain, WalletClient, Address, Abi, PublicClient, Hex } from 'viem';
+import { PublicClient, Chain, WalletClient, Address, Abi, Hex, Transport } from 'viem';
 export { Abi, Address, Chain, Hash, TransactionReceipt, WalletClient } from 'viem';
 import { WalletEngine, CreatedWallet, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, ConnectorInfo, ExternalWalletClient, EIP1193Provider, SignTypedDataParams, WalletChangeEvent, ChainChangeEvent } from '@awarizon/wallet-engine';
 export { ChainChangeEvent, ChainMismatchError, ChainSwitchError, ConnectorInfo, CreatedWallet, EIP1193Provider, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, InvalidMnemonicError, InvalidPrivateKeyError, SignTypedDataParams, WalletChangeEvent, WalletEngine, WalletNotConnectedError } from '@awarizon/wallet-engine';
@@ -6,6 +6,78 @@ import { TransactionResult } from '@awarizon/tx-engine';
 export { ContractExecutionError, GasEstimationError, SimulationError, TransactionEngine, TransactionResult, TransactionTimeoutError } from '@awarizon/tx-engine';
 export { DuplicateFunctionError, InvalidABIError, UnsupportedABIItemError, generateAllMethodSignatures, generateMethodSignature, isPayableFunction, isWriteFunction, parseABI } from '@awarizon/abi-engine';
 
+interface PriceResult {
+    /** Uppercase token symbol (e.g. "ETH", "USDC") */
+    symbol: string;
+    /** Current USD price */
+    price: number;
+    /** Where the price came from */
+    source: 'chainlink' | 'coingecko';
+    /** Unix timestamp of the last update (only set for chainlink source) */
+    updatedAt?: number;
+    /** True when chainlink data is older than 2 hours */
+    stale?: boolean;
+}
+/**
+ * Fetches USD prices via Chainlink on-chain feeds (primary) with automatic
+ * fallback to CoinGecko's free API when no feed exists for the current chain.
+ *
+ * Attached to the SDK as `awarizon.price`.
+ *
+ * @example
+ * ```ts
+ * const { price } = await awarizon.price.get('ETH')
+ * // → { symbol: 'ETH', price: 3421.57, source: 'chainlink', updatedAt: 1720000000 }
+ *
+ * const prices = await awarizon.price.getMany(['ETH', 'BTC', 'USDC', 'ARB'])
+ * // → { ETH: { price: 3421 }, BTC: { price: 68200 }, ... }
+ * ```
+ */
+declare class PriceEngine {
+    private readonly publicClient;
+    private readonly chainId;
+    constructor(publicClient: PublicClient, chainId: number);
+    /**
+     * 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')
+     */
+    get(symbol: string): Promise<PriceResult>;
+    /**
+     * 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)
+     */
+    getMany(symbols: string[]): Promise<Record<string, PriceResult>>;
+    /**
+     * 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: string): boolean;
+    /**
+     * 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(): string[];
+}
+
 interface AwarizonConfig {
     /**
      * Target chain. Accepts:
@@ -723,6 +795,14 @@ declare class AwarizonWeb3 {
     readonly publicClient: PublicClient;
     /** Wallet management — create, import, or connect external wallets */
     readonly wallet: WalletProxy;
+    /**
+     * Token price engine — Chainlink on-chain feeds with CoinGecko fallback.
+     *
+     * @example
+     * const { price } = await awarizon.price.get('ETH')
+     * const prices = await awarizon.price.getMany(['ETH', 'BTC', 'USDC'])
+     */
+    readonly price: PriceEngine;
     private readonly _engine;
     private readonly _txEngine;
     private readonly _telemetry;
@@ -1024,6 +1104,26 @@ declare const CHAINS: Record<string, Chain>;
 declare function resolveChain(chain: Chain | string): Chain;
 /** Returns a list of all unique supported chain IDs */
 declare function getSupportedChainIds(): number[];
+/**
+ * Build the viem Transport for a chain.
+ *
+ * Priority:
+ *  1. If the caller supplied an explicit `rpcUrlOverride`, use it directly.
+ *  2. For chains with a known-unreliable default RPC, wrap primary + fallback
+ *     in viem's `fallback()` transport — primary is always tried first.
+ *  3. All other chains: plain `http()` with viem's chain default.
+ *
+ * @example
+ * // Fallback kicks in automatically for mantle, celo, gnosis, fantom, moonbeam
+ * const transport = getChainTransport(mantle)
+ *
+ * // User override bypasses fallback entirely — they know what they want
+ * const transport = getChainTransport(mantle, "https://my-own-rpc.example.com")
+ */
+declare function getChainTransport(chain: Chain, rpcUrlOverride?: string): Transport;
+
+declare const CHAINLINK_FEEDS: Record<number, Record<string, Address>>;
+declare const COINGECKO_IDS: Record<string, string>;
 
 type TelemetryEventType = 'contract.read' | 'contract.write' | 'contract.gas_estimate' | 'wallet.create' | 'wallet.import' | 'chain.switch';
 interface TelemetryEvent {
@@ -1083,4 +1183,4 @@ declare class TelemetryClient {
     private _flushBeacon;
 }
 
-export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type ContractRegistryEntry, ERC1155_ABI, ERC20_ABI, ERC721_ABI, type Erc1155Contract, type Erc20Contract, type Erc721Contract, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getSupportedChainIds, resolveChain };
+export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINLINK_FEEDS, CHAINS, COINGECKO_IDS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type ContractRegistryEntry, ERC1155_ABI, ERC20_ABI, ERC721_ABI, type Erc1155Contract, type Erc20Contract, type Erc721Contract, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, PriceEngine, type PriceResult, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getChainTransport, getSupportedChainIds, resolveChain };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Chain, WalletClient, Address, Abi, PublicClient, Hex } from 'viem';
+import { PublicClient, Chain, WalletClient, Address, Abi, Hex, Transport } from 'viem';
 export { Abi, Address, Chain, Hash, TransactionReceipt, WalletClient } from 'viem';
 import { WalletEngine, CreatedWallet, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, ConnectorInfo, ExternalWalletClient, EIP1193Provider, SignTypedDataParams, WalletChangeEvent, ChainChangeEvent } from '@awarizon/wallet-engine';
 export { ChainChangeEvent, ChainMismatchError, ChainSwitchError, ConnectorInfo, CreatedWallet, EIP1193Provider, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, InvalidMnemonicError, InvalidPrivateKeyError, SignTypedDataParams, WalletChangeEvent, WalletEngine, WalletNotConnectedError } from '@awarizon/wallet-engine';
@@ -6,6 +6,78 @@ import { TransactionResult } from '@awarizon/tx-engine';
 export { ContractExecutionError, GasEstimationError, SimulationError, TransactionEngine, TransactionResult, TransactionTimeoutError } from '@awarizon/tx-engine';
 export { DuplicateFunctionError, InvalidABIError, UnsupportedABIItemError, generateAllMethodSignatures, generateMethodSignature, isPayableFunction, isWriteFunction, parseABI } from '@awarizon/abi-engine';
 
+interface PriceResult {
+    /** Uppercase token symbol (e.g. "ETH", "USDC") */
+    symbol: string;
+    /** Current USD price */
+    price: number;
+    /** Where the price came from */
+    source: 'chainlink' | 'coingecko';
+    /** Unix timestamp of the last update (only set for chainlink source) */
+    updatedAt?: number;
+    /** True when chainlink data is older than 2 hours */
+    stale?: boolean;
+}
+/**
+ * Fetches USD prices via Chainlink on-chain feeds (primary) with automatic
+ * fallback to CoinGecko's free API when no feed exists for the current chain.
+ *
+ * Attached to the SDK as `awarizon.price`.
+ *
+ * @example
+ * ```ts
+ * const { price } = await awarizon.price.get('ETH')
+ * // → { symbol: 'ETH', price: 3421.57, source: 'chainlink', updatedAt: 1720000000 }
+ *
+ * const prices = await awarizon.price.getMany(['ETH', 'BTC', 'USDC', 'ARB'])
+ * // → { ETH: { price: 3421 }, BTC: { price: 68200 }, ... }
+ * ```
+ */
+declare class PriceEngine {
+    private readonly publicClient;
+    private readonly chainId;
+    constructor(publicClient: PublicClient, chainId: number);
+    /**
+     * 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')
+     */
+    get(symbol: string): Promise<PriceResult>;
+    /**
+     * 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)
+     */
+    getMany(symbols: string[]): Promise<Record<string, PriceResult>>;
+    /**
+     * 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: string): boolean;
+    /**
+     * 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(): string[];
+}
+
 interface AwarizonConfig {
     /**
      * Target chain. Accepts:
@@ -723,6 +795,14 @@ declare class AwarizonWeb3 {
     readonly publicClient: PublicClient;
     /** Wallet management — create, import, or connect external wallets */
     readonly wallet: WalletProxy;
+    /**
+     * Token price engine — Chainlink on-chain feeds with CoinGecko fallback.
+     *
+     * @example
+     * const { price } = await awarizon.price.get('ETH')
+     * const prices = await awarizon.price.getMany(['ETH', 'BTC', 'USDC'])
+     */
+    readonly price: PriceEngine;
     private readonly _engine;
     private readonly _txEngine;
     private readonly _telemetry;
@@ -1024,6 +1104,26 @@ declare const CHAINS: Record<string, Chain>;
 declare function resolveChain(chain: Chain | string): Chain;
 /** Returns a list of all unique supported chain IDs */
 declare function getSupportedChainIds(): number[];
+/**
+ * Build the viem Transport for a chain.
+ *
+ * Priority:
+ *  1. If the caller supplied an explicit `rpcUrlOverride`, use it directly.
+ *  2. For chains with a known-unreliable default RPC, wrap primary + fallback
+ *     in viem's `fallback()` transport — primary is always tried first.
+ *  3. All other chains: plain `http()` with viem's chain default.
+ *
+ * @example
+ * // Fallback kicks in automatically for mantle, celo, gnosis, fantom, moonbeam
+ * const transport = getChainTransport(mantle)
+ *
+ * // User override bypasses fallback entirely — they know what they want
+ * const transport = getChainTransport(mantle, "https://my-own-rpc.example.com")
+ */
+declare function getChainTransport(chain: Chain, rpcUrlOverride?: string): Transport;
+
+declare const CHAINLINK_FEEDS: Record<number, Record<string, Address>>;
+declare const COINGECKO_IDS: Record<string, string>;
 
 type TelemetryEventType = 'contract.read' | 'contract.write' | 'contract.gas_estimate' | 'wallet.create' | 'wallet.import' | 'chain.switch';
 interface TelemetryEvent {
@@ -1083,4 +1183,4 @@ declare class TelemetryClient {
     private _flushBeacon;
 }
 
-export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type ContractRegistryEntry, ERC1155_ABI, ERC20_ABI, ERC721_ABI, type Erc1155Contract, type Erc20Contract, type Erc721Contract, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getSupportedChainIds, resolveChain };
+export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINLINK_FEEDS, CHAINS, COINGECKO_IDS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type ContractRegistryEntry, ERC1155_ABI, ERC20_ABI, ERC721_ABI, type Erc1155Contract, type Erc20Contract, type Erc721Contract, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, PriceEngine, type PriceResult, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getChainTransport, getSupportedChainIds, resolveChain };

package/dist/index.js

@@ -82,6 +82,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 viem.http(rpcUrlOverride);
+  const fallbackUrl = FALLBACK_RPCS[chain.id];
+  if (fallbackUrl) {
+    const primaryUrl = chain.rpcUrls.default.http[0];
+    return viem.fallback([viem.http(primaryUrl), viem.http(fallbackUrl)]);
+  }
+  return viem.http();
+}
 function trackEvent(telemetry, type, chain, functionName, success, start) {
   telemetry?.track({
     type,
@@ -361,6 +382,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 = viem.erc20Abi;
 var ERC721_ABI = [
   { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ type: "string" }] },
@@ -481,12 +805,13 @@ var AwarizonWeb3 = class {
     this.chain = resolveChain(config.chain);
     this.publicClient = viem.createPublicClient({
       chain: this.chain,
-      transport: viem.http(config.rpcUrl)
+      transport: getChainTransport(this.chain, config.rpcUrl)
     });
     this._engine = new walletEngine.WalletEngine({
       chain: this.chain,
       publicClient: this.publicClient,
-      rpcUrl: config.rpcUrl
+      rpcUrl: config.rpcUrl,
+      getTransport: (chain) => getChainTransport(chain, config.rpcUrl)
     });
     this._txEngine = new txEngine.TransactionEngine(
       this.publicClient,
@@ -498,6 +823,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);
     }
@@ -1054,16 +1380,20 @@ Object.defineProperty(exports, "parseABI", {
 });
 exports.ApiKeyRequiredError = ApiKeyRequiredError;
 exports.AwarizonWeb3 = AwarizonWeb3;
+exports.CHAINLINK_FEEDS = CHAINLINK_FEEDS;
 exports.CHAINS = CHAINS;
+exports.COINGECKO_IDS = COINGECKO_IDS;
 exports.ContractNotLoadedError = ContractNotLoadedError;
 exports.ERC1155_ABI = ERC1155_ABI;
 exports.ERC20_ABI = ERC20_ABI;
 exports.ERC721_ABI = ERC721_ABI;
 exports.InvalidApiKeyError = InvalidApiKeyError;
 exports.NetworkMismatchError = NetworkMismatchError;
+exports.PriceEngine = PriceEngine;
 exports.ProviderError = ProviderError;
 exports.TelemetryClient = TelemetryClient;
 exports.UnsupportedChainError = UnsupportedChainError;
+exports.getChainTransport = getChainTransport;
 exports.getSupportedChainIds = getSupportedChainIds;
 exports.resolveChain = resolveChain;
 //# sourceMappingURL=index.js.map