agentwallet-sdk 5.0.0 → 5.0.2

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"}

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

@@ -0,0 +1,94 @@
+import { CHAIN_IDS } from '../types.js';
+import { buildQuote } from './uniswap.js';
+const ZEROX_CHAINS = ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'avalanche', 'bnb'];
+const ZEROX_API_BASE = 'https://api.0x.org';
+/** 0x chain name mapping (some differ from our internal names) */
+const ZEROX_CHAIN_MAP = {
+    ethereum: 'ethereum',
+    base: 'base',
+    arbitrum: 'arbitrum',
+    optimism: 'optimism',
+    polygon: 'polygon',
+    avalanche: 'avalanche',
+    bnb: 'bsc',
+};
+export class ZeroXProvider {
+    constructor(options = {}) {
+        this.name = '0x';
+        this.supportedChains = ZEROX_CHAINS;
+        this.apiKey = options.apiKey;
+        this.fetcher = options.fetcher;
+    }
+    async getQuote(params, timeoutMs) {
+        if (!ZEROX_CHAINS.includes(params.chain.toLowerCase()))
+            return null;
+        if (!this.apiKey && !this.fetcher)
+            return null;
+        if (this.fetcher)
+            return this.fetcher(params);
+        const chainId = CHAIN_IDS[params.chain.toLowerCase()];
+        if (!chainId)
+            return null;
+        const url = new URL(`${ZEROX_API_BASE}/swap/allowance-holder/quote`);
+        url.searchParams.set('chainId', String(chainId));
+        url.searchParams.set('sellToken', params.fromToken);
+        url.searchParams.set('buyToken', params.toToken);
+        url.searchParams.set('sellAmount', params.amount);
+        if (params.fromAddress)
+            url.searchParams.set('taker', params.fromAddress);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url.toString(), {
+                headers: {
+                    '0x-api-key': this.apiKey ?? '',
+                    '0x-version': 'v2',
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            const toAmount = BigInt(String(data.buyAmount ?? '0'));
+            const gasEstimate = BigInt(String(data.gas ?? '200000'));
+            const gasEstimateUsd = Number(data.totalNetworkFee ?? data.gasEstimateUsd ?? 0);
+            // Parse route from sources
+            const sources = data.route;
+            const fills = sources?.fills;
+            const route = fills ? [...new Set(fills.map((f) => f.source))] : ['0x'];
+            // Extract tx data
+            let txData;
+            const tx = data.transaction;
+            if (tx?.to && tx?.data) {
+                txData = {
+                    to: String(tx.to),
+                    data: String(tx.data),
+                    value: BigInt(String(tx.value ?? '0')),
+                    gasLimit: gasEstimate,
+                };
+            }
+            return buildQuote({
+                provider: '0x',
+                params,
+                toAmount,
+                gasEstimate,
+                gasEstimateUsd,
+                platformFee: 15, // 0x charges ~0.15% platform fee (15 bps)
+                priceImpact: 0,
+                route,
+                estimatedTimeMs: 15000,
+                mevProtected: false,
+                txData,
+                metadata: data,
+            });
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=zerox.js.map

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

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

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

@@ -0,0 +1,86 @@
+import type { AggregatorQuote, AggregatorSwapResult, QuoteParams, SmartSwapConfig, SwapStrategy, TransactionReceipt } from './types.js';
+import { type ProviderRegistryOptions } from './providers/index.js';
+import { SwapRSIEngine } from './rsi/engine.js';
+import type { RSIState } from './rsi/types.js';
+export declare function scoreQuote(quote: AggregatorQuote, strategy: SwapStrategy): number;
+export declare class SmartSwapRouter {
+    private readonly providers;
+    private readonly strategy;
+    private readonly timeoutMs;
+    private readonly slippageBps;
+    private readonly includeProviders;
+    private readonly excludeProviders;
+    private readonly cache;
+    private readonly health;
+    private readonly rsiEngine;
+    constructor(config?: SmartSwapConfig & ProviderRegistryOptions);
+    /**
+     * Get quotes from all applicable providers in parallel, ranked by strategy.
+     * Providers that fail or don't support the chain/pair return null and are skipped.
+     * Results are cached for cacheTtlMs (default 3s) to deduplicate burst requests.
+     */
+    getQuotes(params: QuoteParams): Promise<AggregatorQuote[]>;
+    /**
+     * Execute the best quote (or a specific one) via the provided wallet.
+     * Supports pre-flight simulation, Flashbots Protect routing, and receipt confirmation.
+     */
+    executeSwap(quote: AggregatorQuote, wallet: {
+        sendTransaction?: (tx: {
+            to: string;
+            data: string;
+            value: bigint;
+            gasLimit: bigint;
+        }) => Promise<string>;
+        simulateTransaction?: (tx: {
+            to: string;
+            data: string;
+            value: bigint;
+            gasLimit: bigint;
+        }) => Promise<{
+            success: boolean;
+            error?: string;
+        }>;
+        signTransaction?: (tx: {
+            to: string;
+            data: string;
+            value: bigint;
+            gasLimit: bigint;
+        }) => Promise<string>;
+        waitForTransaction?: (txHash: string, confirmations: number) => Promise<TransactionReceipt>;
+    }, options?: {
+        /** Run simulation before sending (default: true) */
+        simulate?: boolean;
+        /** Route through Flashbots Protect RPC (Ethereum mainnet only, default: false) */
+        flashbotsProtect?: boolean;
+        /** Wait for transaction receipt (default: false) */
+        waitForReceipt?: boolean;
+        /** Number of confirmations to wait for (default: 1) */
+        confirmations?: number;
+    }): Promise<AggregatorSwapResult>;
+    /**
+     * Return provider names that support the given chain.
+     */
+    getProviders(chain: string): string[];
+    /**
+     * Return all chains supported by at least one provider.
+     */
+    getSupportedChains(): string[];
+    /**
+     * Score a quote with the router's current strategy (exposed for testing/comparison).
+     */
+    scoreQuote(quote: AggregatorQuote): number;
+    /**
+     * Return health stats for all tracked providers.
+     */
+    getProviderHealth(): Record<string, {
+        failures: number;
+        healthy: boolean;
+    }>;
+    /** Get the RSI engine instance (if enabled) */
+    getRSIEngine(): SwapRSIEngine | undefined;
+    /** Load previously persisted RSI state */
+    loadRSIState(state: RSIState): void;
+    /** Export current RSI state for persistence */
+    exportRSIState(): RSIState | undefined;
+}
+//# sourceMappingURL=router.d.ts.map

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

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