agentwallet-sdk 4.0.5 → 5.0.1

package/dist/swap/router/providers/lifi.d.ts

@@ -0,0 +1,11 @@
+import type { ISwapProvider, AggregatorQuote, QuoteParams } from '../types.js';
+export declare class LiFiProvider implements ISwapProvider {
+    readonly name = "lifi";
+    readonly supportedChains: string[];
+    private readonly fetcher?;
+    constructor(options?: {
+        fetcher?: (p: QuoteParams) => Promise<AggregatorQuote | null>;
+    });
+    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
+}
+//# sourceMappingURL=lifi.d.ts.map

package/dist/swap/router/providers/lifi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/lifi.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA0C/E,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,eAAe,WAAe;IAEvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2D;gBAExE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;KAAO;IAIrF,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAmFxF"}

package/dist/swap/router/providers/lifi.js

@@ -0,0 +1,123 @@
+import { CHAIN_IDS } from '../types.js';
+import { buildQuote } from './uniswap.js';
+// LI.FI supports a large number of chains; list the main ones
+const LIFI_CHAINS = [
+    'ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'avalanche', 'bnb',
+    'gnosis', 'fantom', 'celo', 'moonbeam', 'moonriver', 'cronos', 'aurora',
+    'fuse', 'velas', 'evmos', 'boba', 'metis', 'okc', 'linea', 'scroll',
+    'zksync', 'polygonzkevm', 'mantle', 'blast', 'mode',
+];
+const LIFI_API_BASE = 'https://li.quest/v1';
+/** LI.FI uses chain IDs; supplement our map with extra chains */
+const LIFI_EXTRA_CHAIN_IDS = {
+    fantom: 250,
+    celo: 42220,
+    moonbeam: 1284,
+    moonriver: 1285,
+    cronos: 25,
+    aurora: 1313161554,
+    fuse: 122,
+    velas: 106,
+    evmos: 9001,
+    boba: 288,
+    metis: 1088,
+    okc: 66,
+    linea: 59144,
+    scroll: 534352,
+    zksync: 324,
+    polygonzkevm: 1101,
+    mantle: 5000,
+    blast: 81457,
+    mode: 34443,
+};
+function getChainId(chain) {
+    const id = CHAIN_IDS[chain] ?? LIFI_EXTRA_CHAIN_IDS[chain];
+    return id ?? null;
+}
+export class LiFiProvider {
+    constructor(options = {}) {
+        this.name = 'lifi';
+        this.supportedChains = LIFI_CHAINS;
+        this.fetcher = options.fetcher;
+    }
+    async getQuote(params, timeoutMs) {
+        if (!LIFI_CHAINS.includes(params.chain.toLowerCase()))
+            return null;
+        if (this.fetcher)
+            return this.fetcher(params);
+        const chainId = getChainId(params.chain.toLowerCase());
+        if (!chainId)
+            return null;
+        const url = new URL(`${LIFI_API_BASE}/quote`);
+        url.searchParams.set('fromChain', String(chainId));
+        url.searchParams.set('toChain', String(chainId)); // same-chain swap
+        url.searchParams.set('fromToken', params.fromToken);
+        url.searchParams.set('toToken', params.toToken);
+        url.searchParams.set('fromAmount', params.amount);
+        if (params.fromAddress)
+            url.searchParams.set('fromAddress', params.fromAddress);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url.toString(), {
+                headers: { 'Accept': 'application/json' },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            const estimate = data.estimate;
+            if (!estimate)
+                return null;
+            const toAmount = BigInt(String(estimate.toAmount ?? '0'));
+            const gasCosts = estimate.gasCosts;
+            const gasEstimate = BigInt(String(gasCosts?.[0]?.['estimate'] ?? '200000'));
+            const gasEstimateUsd = Number(gasCosts?.[0]?.['amountUSD'] ?? 0);
+            // Tool steps (bridges/swaps)
+            const action = data.action;
+            const includedSteps = data.includedSteps;
+            const route = includedSteps
+                ? includedSteps.map((s) => {
+                    const details = s['toolDetails'];
+                    return String(details?.['name'] ?? s['tool'] ?? 'LI.FI');
+                })
+                : ['LI.FI'];
+            // Extract tx data if available
+            let txData;
+            const tx = data.transactionRequest;
+            if (tx?.to && tx?.data) {
+                txData = {
+                    to: String(tx.to),
+                    data: String(tx.data),
+                    value: BigInt(String(tx.value ?? '0')),
+                    gasLimit: gasEstimate,
+                };
+            }
+            const feeCosts = estimate.feeCosts;
+            const totalFeeUsd = feeCosts?.reduce((sum, f) => sum + Number(f.amountUSD ?? 0), 0) ?? 0;
+            const sellAmtNum = Number(params.amount);
+            const platformFeeBps = sellAmtNum > 0 ? Math.round((totalFeeUsd / sellAmtNum) * 10000) : 0;
+            return buildQuote({
+                provider: 'lifi',
+                params,
+                toAmount,
+                gasEstimate,
+                gasEstimateUsd,
+                platformFee: platformFeeBps,
+                priceImpact: 0,
+                route: [...new Set(route)],
+                estimatedTimeMs: 20000,
+                mevProtected: false,
+                txData,
+                metadata: data,
+            });
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=lifi.js.map

package/dist/swap/router/providers/lifi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi.js","sourceRoot":"","sources":["../../../../src/swap/router/providers/lifi.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/providers/oneinch.d.ts

@@ -0,0 +1,13 @@
+import type { ISwapProvider, AggregatorQuote, QuoteParams } from '../types.js';
+export declare class OneInchProvider implements ISwapProvider {
+    readonly name = "1inch";
+    readonly supportedChains: string[];
+    private readonly apiKey;
+    private readonly fetcher?;
+    constructor(options?: {
+        apiKey?: string;
+        fetcher?: (p: QuoteParams) => Promise<AggregatorQuote | null>;
+    });
+    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
+}
+//# sourceMappingURL=oneinch.d.ts.map

package/dist/swap/router/providers/oneinch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneinch.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/oneinch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/E,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,eAAe,WAAkB;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2D;gBAExE,OAAO,GAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;KAC1D;IAKA,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CA+DxF"}

package/dist/swap/router/providers/oneinch.js

@@ -0,0 +1,71 @@
+import { CHAIN_IDS } from '../types.js';
+import { buildQuote } from './uniswap.js';
+const ONEINCH_CHAINS = ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'avalanche', 'bnb'];
+const ONEINCH_API_BASE = 'https://api.1inch.dev/swap/v6.0';
+export class OneInchProvider {
+    constructor(options = {}) {
+        this.name = '1inch';
+        this.supportedChains = ONEINCH_CHAINS;
+        this.apiKey = options.apiKey;
+        this.fetcher = options.fetcher;
+    }
+    async getQuote(params, timeoutMs) {
+        if (!ONEINCH_CHAINS.includes(params.chain.toLowerCase()))
+            return null;
+        if (!this.apiKey && !this.fetcher)
+            return null; // No key = skip gracefully
+        if (this.fetcher)
+            return this.fetcher(params);
+        const chainId = CHAIN_IDS[params.chain.toLowerCase()];
+        if (!chainId)
+            return null;
+        const url = new URL(`${ONEINCH_API_BASE}/${chainId}/quote`);
+        url.searchParams.set('src', params.fromToken);
+        url.searchParams.set('dst', params.toToken);
+        url.searchParams.set('amount', params.amount);
+        if (params.fromAddress)
+            url.searchParams.set('from', params.fromAddress);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url.toString(), {
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            const toAmount = BigInt(String(data.toAmount ?? data.dstAmount ?? '0'));
+            const gasEstimate = BigInt(String(data.estimatedGas ?? '200000'));
+            // 1inch doesn't return gas USD directly; estimate at ~30 gwei
+            const gasEstimateUsd = Number(gasEstimate) * 30e-9 * 2500; // rough: 30 gwei * $2500 ETH
+            // Extract protocol route
+            const protocols = data.protocols;
+            const route = [];
+            protocols?.forEach((outer) => outer?.forEach((inner) => inner?.forEach((hop) => hop?.name && !route.includes(hop.name) && route.push(hop.name))));
+            return buildQuote({
+                provider: '1inch',
+                params,
+                toAmount,
+                gasEstimate,
+                gasEstimateUsd,
+                platformFee: 0,
+                priceImpact: 0,
+                route: route.length > 0 ? route : ['1inch'],
+                estimatedTimeMs: 30000, // Fusion orders can take ~30s
+                mevProtected: true, // 1inch Fusion is MEV-protected
+                metadata: data,
+            });
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=oneinch.js.map

package/dist/swap/router/providers/oneinch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneinch.js","sourceRoot":"","sources":["../../../../src/swap/router/providers/oneinch.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/providers/paraswap.d.ts

@@ -0,0 +1,11 @@
+import type { ISwapProvider, AggregatorQuote, QuoteParams } from '../types.js';
+export declare class ParaSwapProvider implements ISwapProvider {
+    readonly name = "paraswap";
+    readonly supportedChains: string[];
+    private readonly fetcher?;
+    constructor(options?: {
+        fetcher?: (p: QuoteParams) => Promise<AggregatorQuote | null>;
+    });
+    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
+}
+//# sourceMappingURL=paraswap.d.ts.map

package/dist/swap/router/providers/paraswap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paraswap.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/paraswap.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/E,qBAAa,gBAAiB,YAAW,aAAa;IACpD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,eAAe,WAAmB;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2D;gBAExE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;KAAO;IAIrF,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAmExF"}

package/dist/swap/router/providers/paraswap.js

@@ -0,0 +1,73 @@
+import { CHAIN_IDS } from '../types.js';
+import { buildQuote } from './uniswap.js';
+const PARASWAP_CHAINS = ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'avalanche'];
+const PARASWAP_API_BASE = 'https://apiv5.paraswap.io';
+export class ParaSwapProvider {
+    constructor(options = {}) {
+        this.name = 'paraswap';
+        this.supportedChains = PARASWAP_CHAINS;
+        this.fetcher = options.fetcher;
+    }
+    async getQuote(params, timeoutMs) {
+        if (!PARASWAP_CHAINS.includes(params.chain.toLowerCase()))
+            return null;
+        if (this.fetcher)
+            return this.fetcher(params);
+        const chainId = CHAIN_IDS[params.chain.toLowerCase()];
+        if (!chainId)
+            return null;
+        const url = new URL(`${PARASWAP_API_BASE}/prices`);
+        url.searchParams.set('srcToken', params.fromToken);
+        url.searchParams.set('destToken', params.toToken);
+        url.searchParams.set('amount', params.amount);
+        url.searchParams.set('network', String(chainId));
+        url.searchParams.set('side', 'SELL');
+        if (params.fromAddress)
+            url.searchParams.set('userAddress', params.fromAddress);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url.toString(), {
+                headers: { 'Accept': 'application/json' },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            const priceRoute = data.priceRoute;
+            if (!priceRoute)
+                return null;
+            const toAmount = BigInt(String(priceRoute.destAmount ?? '0'));
+            const gasEstimate = BigInt(String(priceRoute.gasCost ?? '200000'));
+            const gasEstimateUsd = Number(priceRoute.gasCostUSD ?? 0);
+            const priceImpact = Number(priceRoute.tokenTransferProxy ?? 0);
+            // Parse bestRoute
+            const bestRoute = priceRoute.bestRoute;
+            const route = [];
+            bestRoute?.forEach((leg) => leg.swaps?.forEach((swap) => swap.swapExchanges?.forEach((ex) => {
+                if (ex.exchange && !route.includes(ex.exchange))
+                    route.push(ex.exchange);
+            })));
+            return buildQuote({
+                provider: 'paraswap',
+                params,
+                toAmount,
+                gasEstimate,
+                gasEstimateUsd,
+                platformFee: 0,
+                priceImpact,
+                route: route.length > 0 ? route : ['ParaSwap'],
+                estimatedTimeMs: 15000,
+                mevProtected: false,
+                metadata: priceRoute,
+            });
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=paraswap.js.map

package/dist/swap/router/providers/paraswap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paraswap.js","sourceRoot":"","sources":["../../../../src/swap/router/providers/paraswap.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/providers/uniswap.d.ts

@@ -0,0 +1,31 @@
+import type { ISwapProvider, AggregatorQuote, QuoteParams } from '../types.js';
+/**
+ * UniswapProvider — wraps the existing Uniswap V3 QuoterV2 via on-chain read.
+ * In router context we simulate a quote using known pool data.
+ * For real execution, use SwapModule directly.
+ */
+export declare class UniswapProvider implements ISwapProvider {
+    readonly name = "uniswap";
+    readonly supportedChains: string[];
+    /** Optional QuoterV2 fetch override for testing */
+    private readonly fetcher?;
+    constructor(options?: {
+        fetcher?: (p: QuoteParams) => Promise<AggregatorQuote | null>;
+    });
+    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
+}
+export declare function buildQuote(opts: {
+    provider: string;
+    params: QuoteParams;
+    toAmount: bigint;
+    gasEstimate: bigint;
+    gasEstimateUsd: number;
+    platformFee: number;
+    priceImpact: number;
+    route: string[];
+    estimatedTimeMs: number;
+    mevProtected: boolean;
+    txData?: AggregatorQuote['txData'];
+    metadata?: Record<string, unknown>;
+}): AggregatorQuote;
+//# sourceMappingURL=uniswap.d.ts.map

package/dist/swap/router/providers/uniswap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/uniswap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/E;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,eAAe,WAAkB;IAE1C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2D;gBAExE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;KAAO;IAIrF,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CA+DxF;AAsBD,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,eAAe,CAwBlB"}

package/dist/swap/router/providers/uniswap.js

@@ -0,0 +1,237 @@
+import { CHAIN_IDS } from '../types.js';
+
+/** Chains where Uniswap V3 is deployed */
+const UNISWAP_CHAINS = ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon'];
+
+// ─── On-chain QuoterV2 addresses ─────────────────────────────────────────────
+// QuoterV2 is a stateless read-only contract — no wallet, no gas needed for reads
+const QUOTER_V2_ADDRESS = {
+  arbitrum:  '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  ethereum:  '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  optimism:  '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  base:      '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+  polygon:   '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+};
+
+// Public RPC endpoints — free, no auth required
+const PUBLIC_RPC = {
+  arbitrum:  'https://arb1.arbitrum.io/rpc',
+  ethereum:  'https://eth.llamarpc.com',
+  optimism:  'https://mainnet.optimism.io',
+  base:      'https://mainnet.base.org',
+  polygon:   'https://polygon-rpc.com',
+};
+
+// Uniswap V3 fee tiers to try in priority order
+const FEE_TIERS = [500, 3000, 10000];
+
+// QuoterV2 quoteExactInputSingle ABI (struct params variant — V2 interface)
+const QUOTER_V2_ABI = [
+  {
+    name: 'quoteExactInputSingle',
+    type: 'function',
+    stateMutability: 'nonpayable',
+    inputs: [
+      {
+        name: 'params',
+        type: 'tuple',
+        components: [
+          { name: 'tokenIn',             type: 'address' },
+          { name: 'tokenOut',            type: 'address' },
+          { name: 'amountIn',            type: 'uint256' },
+          { name: 'fee',                 type: 'uint24'  },
+          { name: 'sqrtPriceLimitX96',   type: 'uint160' },
+        ],
+      },
+    ],
+    outputs: [
+      { name: 'amountOut',                    type: 'uint256' },
+      { name: 'sqrtPriceX96After',            type: 'uint160' },
+      { name: 'initializedTicksCrossed',      type: 'uint32'  },
+      { name: 'gasEstimate',                  type: 'uint256' },
+    ],
+  },
+];
+
+// Module-level viem client cache to avoid re-creating per quote
+const _clientCache = {};
+
+/**
+ * Get (or create) a cached viem public client for a given chain.
+ * Lazy-imports viem so the module loads even in environments without viem on PATH.
+ */
+async function getViemClient(chain) {
+  if (_clientCache[chain]) return _clientCache[chain];
+
+  const rpc = PUBLIC_RPC[chain];
+  if (!rpc) return null;
+
+  try {
+    // Dynamic import — resolves from SDK node_modules
+    const { createPublicClient, http } = await import('viem');
+    const client = createPublicClient({ transport: http(rpc, { timeout: 5000 }) });
+    _clientCache[chain] = client;
+    return client;
+  } catch (err) {
+    console.warn(`[UniswapProvider] viem import failed: ${err?.message}`);
+    return null;
+  }
+}
+
+/**
+ * Call QuoterV2.quoteExactInputSingle on-chain for a given fee tier.
+ * Returns amountOut as bigint, or null on failure.
+ */
+async function quoteOnChain(client, chain, tokenIn, tokenOut, amountIn, fee) {
+  const quoterAddr = QUOTER_V2_ADDRESS[chain];
+  if (!quoterAddr) return null;
+
+  try {
+    const result = await client.simulateContract({
+      address: quoterAddr,
+      abi: QUOTER_V2_ABI,
+      functionName: 'quoteExactInputSingle',
+      args: [{
+        tokenIn:           tokenIn,
+        tokenOut:          tokenOut,
+        amountIn:          BigInt(amountIn),
+        fee:               fee,
+        sqrtPriceLimitX96: 0n,
+      }],
+    });
+    // simulateContract returns { result: [amountOut, ...] }
+    const amountOut = result?.result?.[0] ?? result?.result ?? null;
+    return amountOut ? BigInt(String(amountOut)) : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Try all fee tiers in order, return first successful amountOut.
+ * Parallel-races all three tiers for minimum latency.
+ */
+async function getBestOnChainQuote(chain, tokenIn, tokenOut, amountIn, timeoutMs) {
+  const client = await getViemClient(chain);
+  if (!client) return null;
+
+  // Race all fee tiers in parallel — fastest non-null wins
+  const deadline = new Promise((_, rej) => setTimeout(() => rej(new Error('timeout')), timeoutMs));
+
+  const raceResult = await Promise.race([
+    (async () => {
+      const results = await Promise.allSettled(
+        FEE_TIERS.map(fee => quoteOnChain(client, chain, tokenIn, tokenOut, amountIn, fee))
+      );
+      // Return the best (largest) successful amountOut
+      let best = null;
+      for (const r of results) {
+        if (r.status === 'fulfilled' && r.value !== null) {
+          if (best === null || r.value > best) best = r.value;
+        }
+      }
+      return best;
+    })(),
+    deadline,
+  ]).catch(() => null);
+
+  return raceResult ?? null;
+}
+
+/**
+ * UniswapProvider — on-chain QuoterV2 via viem (no API key, no hosted service).
+ * Replaces the blocked api.uniswap.org/v2/quote endpoint.
+ */
+export class UniswapProvider {
+  constructor(options = {}) {
+    this.name = 'uniswap';
+    this.supportedChains = UNISWAP_CHAINS;
+    this.fetcher = options.fetcher;
+  }
+
+  async getQuote(params, timeoutMs) {
+    if (!UNISWAP_CHAINS.includes(params.chain.toLowerCase())) return null;
+
+    // Custom fetcher (test injection) takes priority
+    if (this.fetcher) {
+      return withTimeout(this.fetcher(params), timeoutMs);
+    }
+
+    const chain = params.chain.toLowerCase();
+
+    try {
+      // ── On-chain QuoterV2 path ──────────────────────────────────────────
+      const amountOut = await getBestOnChainQuote(
+        chain,
+        params.fromToken,
+        params.toToken,
+        params.amount,
+        timeoutMs ?? 5000,
+      );
+
+      if (!amountOut || amountOut === 0n) return null;
+
+      // Gas estimate: 150k base + pool hops (single hop ≈ 150k)
+      const gasEstimate = 150000n;
+      // Rough gas USD: 0.1 gwei × 150k gas × ETH price (~$2200) / 1e18 ≈ $0.03
+      const gasEstimateUsd = 0.03;
+
+      return buildQuote({
+        provider: 'uniswap',
+        params,
+        toAmount: amountOut,
+        gasEstimate,
+        gasEstimateUsd,
+        platformFee: 0,
+        priceImpact: 0,   // QuoterV2 doesn't return price impact directly
+        route: ['Uniswap V3 (on-chain)'],
+        estimatedTimeMs: 12000,
+        mevProtected: false,
+        metadata: { source: 'QuoterV2_onchain', chain },
+      });
+    } catch {
+      return null;
+    }
+  }
+}
+
+function withTimeout(promise, ms) {
+  return Promise.race([
+    promise,
+    new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), ms)),
+  ]);
+}
+
+function parseUniRoute(data) {
+  try {
+    const routes = data.route;
+    const seen = new Set();
+    routes?.flat()?.forEach((hop) => hop?.protocol && seen.add(hop.protocol));
+    return seen.size > 0 ? Array.from(seen) : ['Uniswap V3'];
+  } catch {
+    return ['Uniswap V3'];
+  }
+}
+
+export function buildQuote(opts) {
+  const gasDeductionWei = BigInt(Math.round(opts.gasEstimateUsd * 1e6));
+  const netOutput = opts.toAmount > gasDeductionWei ? opts.toAmount - gasDeductionWei : 0n;
+  return {
+    provider: opts.provider,
+    fromToken: opts.params.fromToken,
+    toToken: opts.params.toToken,
+    fromAmount: BigInt(opts.params.amount),
+    toAmount: opts.toAmount,
+    gasEstimate: opts.gasEstimate,
+    gasEstimateUsd: opts.gasEstimateUsd,
+    platformFee: opts.platformFee,
+    netOutput,
+    priceImpact: opts.priceImpact,
+    route: opts.route,
+    estimatedTimeMs: opts.estimatedTimeMs,
+    mevProtected: opts.mevProtected,
+    txData: opts.txData,
+    metadata: opts.metadata,
+  };
+}
+//# sourceMappingURL=uniswap.js.map

package/dist/swap/router/providers/uniswap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap.js","sourceRoot":"","sources":["../../../../src/swap/router/providers/uniswap.ts"],"names":[],"mappings":"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"}

package/dist/swap/router/providers/zerox.d.ts

@@ -0,0 +1,13 @@
+import type { ISwapProvider, AggregatorQuote, QuoteParams } from '../types.js';
+export declare class ZeroXProvider implements ISwapProvider {
+    readonly name = "0x";
+    readonly supportedChains: string[];
+    private readonly apiKey;
+    private readonly fetcher?;
+    constructor(options?: {
+        apiKey?: string;
+        fetcher?: (p: QuoteParams) => Promise<AggregatorQuote | null>;
+    });
+    getQuote(params: QuoteParams, timeoutMs: number): Promise<AggregatorQuote | null>;
+}
+//# sourceMappingURL=zerox.d.ts.map

package/dist/swap/router/providers/zerox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerox.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/zerox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkB/E,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,eAAe,WAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA2D;gBAExE,OAAO,GAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;KAC1D;IAKA,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAyExF"}