agentwallet-sdk 3.0.0 → 3.1.0

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

@@ -0,0 +1,116 @@
+import { CHAIN_IDS } from '../types.js';
+/** Chains where Uniswap V3 is deployed */
+const UNISWAP_CHAINS = ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon'];
+/**
+ * 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 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;
+        if (this.fetcher) {
+            return withTimeout(this.fetcher(params), timeoutMs);
+        }
+        // Production path: call Uniswap V3 QuoterV2 via public RPC
+        // We delegate to the real SwapModule.getQuote() when a publicClient is available.
+        // For the router's quote-comparison use case we call the Uniswap quote API.
+        const chainId = CHAIN_IDS[params.chain.toLowerCase()];
+        if (!chainId)
+            return null;
+        try {
+            // Use Uniswap's hosted quote API (no key required)
+            const url = `https://api.uniswap.org/v2/quote`;
+            const body = {
+                tokenInChainId: chainId,
+                tokenOutChainId: chainId,
+                tokenInAddress: params.fromToken,
+                tokenOutAddress: params.toToken,
+                amount: params.amount,
+                type: 'EXACT_INPUT',
+            };
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                if (!res.ok)
+                    return null;
+                const data = (await res.json());
+                const toAmount = BigInt(String(data.quote ?? '0'));
+                const gasEstimate = BigInt(String(data.gasUseEstimate ?? '150000'));
+                const gasUsd = Number(data.gasUseEstimateUSD ?? 0);
+                return buildQuote({
+                    provider: 'uniswap',
+                    params,
+                    toAmount,
+                    gasEstimate,
+                    gasEstimateUsd: gasUsd,
+                    platformFee: 0,
+                    priceImpact: Number(data.priceImpact ?? 0),
+                    route: parseUniRoute(data),
+                    estimatedTimeMs: 15000,
+                    mevProtected: false,
+                    metadata: data,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+}
+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'];
+    }
+}
+function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), ms)),
+    ]);
+}
+export function buildQuote(opts) {
+    // netOutput: toAmount minus gas cost normalised to token units (rough estimate)
+    // We subtract gasEstimateUsd * 1e6 from toAmount as a wei-equivalent penalty
+    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":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AACjG,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAE5C,kEAAkE;AAClE,MAAM,eAAe,GAA2B;IAC9C,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,MAAM,OAAO,aAAa;IAOxB,YAAY,UAGR,EAAE;QATG,SAAI,GAAG,IAAI,CAAC;QACZ,oBAAe,GAAG,YAAY,CAAC;QAStC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAmB,EAAE,SAAiB;QACnD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE/C,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,cAAc,8BAA8B,CAAC,CAAC;QACrE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,WAAW;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBACtC,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;oBAC/B,YAAY,EAAE,IAAI;oBAClB,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;YAE3D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC;YACvD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;YACzD,MAAM,cAAc,GAAG,MAAM,CAAE,IAAY,CAAC,eAAe,IAAK,IAAY,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC;YAElG,2BAA2B;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAA4C,CAAC;YAClE,MAAM,KAAK,GAAI,OAAe,EAAE,KAA8C,CAAC;YAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAExE,kBAAkB;YAClB,IAAI,MAA6C,CAAC;YAClD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAkD,CAAC;YACnE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;gBACvB,MAAM,GAAG;oBACP,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;oBACjB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;oBACrB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;oBACtC,QAAQ,EAAE,WAAW;iBACtB,CAAC;YACJ,CAAC;YAED,OAAO,UAAU,CAAC;gBAChB,QAAQ,EAAE,IAAI;gBACd,MAAM;gBACN,QAAQ;gBACR,WAAW;gBACX,cAAc;gBACd,WAAW,EAAE,EAAE,EAAE,0CAA0C;gBAC3D,WAAW,EAAE,CAAC;gBACd,KAAK;gBACL,eAAe,EAAE,KAAK;gBACtB,YAAY,EAAE,KAAK;gBACnB,MAAM;gBACN,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

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":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,EAEZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAyB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAI3F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAa,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AASvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAgCjF;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAE1C,MAAM,GAAE,eAAe,GAAG,uBAA4B;IA2BlE;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwEhE;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE;QACN,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE;YACzB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,KAAK,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,kBAAkB,CAAC,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,kBAAkB,CAAC,CAAC;KAClC,EACD,OAAO,CAAC,EAAE;QACR,oDAAoD;QACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,kFAAkF;QAClF,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,oDAAoD;QACpD,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,uDAAuD;QACvD,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,oBAAoB,CAAC;IAwDhC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAM9B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAI1C;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAM3E,+CAA+C;IAC/C,YAAY,IAAI,aAAa,GAAG,SAAS;IAIzC,0CAA0C;IAC1C,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAInC,+CAA+C;IAC/C,cAAc,IAAI,QAAQ,GAAG,SAAS;CAGvC"}

package/dist/swap/router/router.js

@@ -0,0 +1,224 @@
+import { buildDefaultProviders } from './providers/index.js';
+import { QuoteCache } from './cache.js';
+import { ProviderHealthTracker } from './health.js';
+import { FlashbotsProtectRpc } from './flashbots.js';
+import { SwapRSIEngine } from './rsi/engine.js';
+const DEFAULT_TIMEOUT_MS = 5000;
+const DEFAULT_STRATEGY = 'best-net-output';
+const DEFAULT_SLIPPAGE_BPS = 50;
+const DEFAULT_CACHE_TTL_MS = 3000;
+// ─── Strategy Scoring ────────────────────────────────────────────────────────
+export function scoreQuote(quote, strategy) {
+    // If we have USD pricing info, use normalized scoring
+    if (quote.toTokenDecimals !== undefined && quote.toTokenPriceUsd !== undefined) {
+        const outputUsd = (Number(quote.toAmount) / Math.pow(10, quote.toTokenDecimals)) * quote.toTokenPriceUsd;
+        const slippageCostUsd = outputUsd * (quote.priceImpact / 100);
+        switch (strategy) {
+            case 'best-net-output':
+                return outputUsd - quote.gasEstimateUsd - slippageCostUsd;
+            case 'fastest':
+                return -quote.estimatedTimeMs;
+            case 'lowest-gas':
+                return -quote.gasEstimateUsd;
+            case 'mev-protected':
+                return quote.mevProtected
+                    ? (outputUsd - quote.gasEstimateUsd) * 1.01
+                    : outputUsd - quote.gasEstimateUsd;
+        }
+    }
+    // Fallback: original scoring (for quotes without USD info)
+    switch (strategy) {
+        case 'best-net-output':
+            return Number(quote.toAmount) - quote.gasEstimateUsd * 1e6;
+        case 'fastest':
+            return -quote.estimatedTimeMs;
+        case 'lowest-gas':
+            return -Number(quote.gasEstimate);
+        case 'mev-protected':
+            return quote.mevProtected ? Number(quote.toAmount) * 1.01 : Number(quote.toAmount);
+    }
+}
+// ─── SmartSwapRouter ─────────────────────────────────────────────────────────
+export class SmartSwapRouter {
+    constructor(config = {}) {
+        this.strategy = config.strategy ?? DEFAULT_STRATEGY;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.slippageBps = config.slippageBps ?? DEFAULT_SLIPPAGE_BPS;
+        this.includeProviders = config.providers ? new Set(config.providers) : null;
+        this.excludeProviders = new Set(config.excludeProviders ?? []);
+        const ttl = config.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+        this.cache = ttl > 0 ? new QuoteCache(ttl) : null;
+        this.health = new ProviderHealthTracker(config.healthMaxFailures ?? 3, config.healthCooldownMs ?? 60000);
+        this.providers = buildDefaultProviders({
+            oneInchApiKey: config.oneInchApiKey,
+            zeroxApiKey: config.zeroxApiKey,
+            fetchers: config.fetchers,
+        });
+        // [MAX-ADDED] RSI engine — opt-in, disabled by default
+        if (config.rsi?.enabled) {
+            this.rsiEngine = new SwapRSIEngine(config.rsi, config.goals);
+        }
+    }
+    /**
+     * 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.
+     */
+    async getQuotes(params) {
+        // Cache check
+        if (this.cache) {
+            const cached = this.cache.get(params);
+            if (cached)
+                return cached;
+        }
+        const chain = params.chain.toLowerCase();
+        const enrichedParams = {
+            ...params,
+            slippageBps: params.slippageBps ?? this.slippageBps,
+        };
+        // Filter providers for this chain + health status
+        const eligible = this.providers.filter((p) => {
+            if (this.excludeProviders.has(p.name))
+                return false;
+            if (this.includeProviders && !this.includeProviders.has(p.name))
+                return false;
+            if (!p.supportedChains.includes(chain))
+                return false;
+            return this.health.isHealthy(p.name);
+        });
+        if (eligible.length === 0)
+            return [];
+        // Query all in parallel with timeout
+        const results = await Promise.allSettled(eligible.map((p) => p.getQuote(enrichedParams, this.timeoutMs)));
+        const quotes = [];
+        for (let i = 0; i < results.length; i++) {
+            const r = results[i];
+            const providerName = eligible[i].name;
+            if (r.status === 'fulfilled' && r.value !== null) {
+                this.health.recordSuccess(providerName);
+                quotes.push(r.value);
+            }
+            else if (r.status === 'rejected') {
+                this.health.recordFailure(providerName);
+            }
+            // null result (unsupported) → don't penalize health
+        }
+        // Rank by strategy
+        quotes.sort((a, b) => scoreQuote(b, this.strategy) - scoreQuote(a, this.strategy));
+        // [MAX-ADDED] Apply RSI learned weights if engine is active
+        if (this.rsiEngine) {
+            const weights = this.rsiEngine.getProviderWeights(chain, params.fromToken, params.toToken);
+            for (const q of quotes) {
+                const w = weights[q.provider] ?? 1.0;
+                if (w !== 1.0) {
+                    q.netOutput = BigInt(Math.round(Number(q.netOutput) * w));
+                }
+            }
+            // Re-sort after weight adjustment
+            quotes.sort((a, b) => scoreQuote(b, this.strategy) - scoreQuote(a, this.strategy));
+            // Check directives
+            const directiveResult = this.rsiEngine.evaluateDirectives({ chain });
+            if (!directiveResult.proceed) {
+                // Return empty — directive blocks this swap (e.g. gas too high)
+                return [];
+            }
+        }
+        // Store in cache
+        if (this.cache) {
+            this.cache.set(params, quotes);
+        }
+        return quotes;
+    }
+    /**
+     * Execute the best quote (or a specific one) via the provided wallet.
+     * Supports pre-flight simulation, Flashbots Protect routing, and receipt confirmation.
+     */
+    async executeSwap(quote, wallet, options) {
+        if (!quote.txData) {
+            throw new Error(`SmartSwapRouter: Quote from '${quote.provider}' does not include txData. ` +
+                `Use the provider's SDK directly to execute, or re-quote with a fromAddress.`);
+        }
+        // Pre-flight simulation
+        if (options?.simulate !== false && wallet.simulateTransaction) {
+            const sim = await wallet.simulateTransaction(quote.txData);
+            if (!sim.success) {
+                throw new Error(`SmartSwapRouter: Simulation failed — ${sim.error}. Transaction not sent.`);
+            }
+        }
+        let txHash;
+        // Flashbots Protect routing (Ethereum mainnet only)
+        if (options?.flashbotsProtect && quote.txData) {
+            if (!wallet.signTransaction) {
+                throw new Error('SmartSwapRouter: flashbotsProtect requires wallet.signTransaction()');
+            }
+            const signedTx = await wallet.signTransaction(quote.txData);
+            const flashbots = new FlashbotsProtectRpc();
+            txHash = await flashbots.sendTransaction(signedTx);
+        }
+        else {
+            if (!wallet.sendTransaction) {
+                throw new Error('SmartSwapRouter: wallet must implement sendTransaction()');
+            }
+            txHash = await wallet.sendTransaction(quote.txData);
+        }
+        // Optional receipt confirmation
+        if (options?.waitForReceipt && wallet.waitForTransaction) {
+            const receipt = await wallet.waitForTransaction(txHash, options.confirmations ?? 1);
+            return {
+                txHash,
+                quote,
+                chain: 'unknown',
+                receipt,
+                success: receipt.status === 'success',
+            };
+        }
+        return {
+            txHash,
+            quote,
+            chain: 'unknown',
+        };
+    }
+    /**
+     * Return provider names that support the given chain.
+     */
+    getProviders(chain) {
+        const lower = chain.toLowerCase();
+        return this.providers
+            .filter((p) => p.supportedChains.includes(lower))
+            .map((p) => p.name);
+    }
+    /**
+     * Return all chains supported by at least one provider.
+     */
+    getSupportedChains() {
+        const chains = new Set();
+        this.providers.forEach((p) => p.supportedChains.forEach((c) => chains.add(c)));
+        return Array.from(chains).sort();
+    }
+    /**
+     * Score a quote with the router's current strategy (exposed for testing/comparison).
+     */
+    scoreQuote(quote) {
+        return scoreQuote(quote, this.strategy);
+    }
+    /**
+     * Return health stats for all tracked providers.
+     */
+    getProviderHealth() {
+        return this.health.getStats();
+    }
+    // ── [MAX-ADDED] RSI Engine access ──────────────────────────────────────────
+    /** Get the RSI engine instance (if enabled) */
+    getRSIEngine() {
+        return this.rsiEngine;
+    }
+    /** Load previously persisted RSI state */
+    loadRSIState(state) {
+        this.rsiEngine?.loadState(state);
+    }
+    /** Export current RSI state for persistence */
+    exportRSIState() {
+        return this.rsiEngine?.exportState();
+    }
+}
+//# sourceMappingURL=router.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { RSIConfig, RSIState, WalletGoals, WalletDirective, SwapOutcome, MutationResult } from './types.js';
+export declare class SwapRSIEngine {
+    private state;
+    private config;
+    private pendingOutcomes;
+    constructor(config: RSIConfig, goals?: WalletGoals);
+    /** Record a swap outcome. Triggers mutation cycle when learningWindow is reached. */
+    recordOutcome(outcome: SwapOutcome): MutationResult | null;
+    /** Get learned provider weight for a specific chain+pair.
+     *  Returns multiplier (1.0 = neutral, >1 = preferred, <1 = deprioritized) */
+    getProviderWeight(provider: string, chain: string, fromToken: string, toToken: string): number;
+    /** Get all provider weights for a chain+pair (for SmartSwapRouter integration).
+     *  Builds a merged map: pair weights override chain weights override global weights. */
+    getProviderWeights(chain: string, fromToken: string, toToken: string): Record<string, number>;
+    /** Analyze recent outcomes and adjust provider weights */
+    runMutationCycle(): MutationResult;
+    private calculateSavingsVsBaseline;
+    private calculateWinRates;
+    private calculateQuoteAccuracy;
+    private calculateAvgLatency;
+    /** Check if a swap should proceed based on directives */
+    evaluateDirectives(params: {
+        chain: string;
+        gasGwei?: number;
+        amountUsd?: number;
+    }): {
+        proceed: boolean;
+        reason?: string;
+        adjustments?: Record<string, number>;
+    };
+    /** Detect arbitrage opportunities from recent quotes */
+    detectArbOpportunities(quotes: Array<{
+        provider: string;
+        toAmount: bigint;
+    }>): {
+        detected: boolean;
+        spreadBps: number;
+        bestProvider: string;
+        worstProvider: string;
+    } | null;
+    /** Add or replace a directive */
+    setDirective(directive: WalletDirective): void;
+    /** Get all directives */
+    getDirectives(): WalletDirective[];
+    /** Export full state for persistence */
+    exportState(): RSIState;
+    /** Load state from previous session */
+    loadState(state: RSIState): void;
+    /** Get current goals */
+    getGoals(): WalletGoals;
+    /** Update goals */
+    setGoals(goals: WalletGoals): void;
+    /** Get mutation history */
+    getMutationHistory(): MutationResult[];
+    /** Get total outcomes recorded */
+    getTotalOutcomes(): number;
+    /** Reset all learned weights back to 1.0 */
+    resetWeights(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/rsi/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EAEf,MAAM,YAAY,CAAC;AAiBpB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,eAAe,CAAqB;gBAEhC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW;IA4BlD,qFAAqF;IACrF,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI;IAmB1D;iFAC6E;IAC7E,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM;IAaT;4FACwF;IACxF,kBAAkB,CAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAwBzB,0DAA0D;IAC1D,gBAAgB,IAAI,cAAc;IAmOlC,OAAO,CAAC,0BAA0B;IAgBlC,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,mBAAmB;IAoB3B,yDAAyD;IACzD,kBAAkB,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG;QACF,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC;IAqDD,wDAAwD;IACxD,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC7E,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI;IAiCR,iCAAiC;IACjC,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAS9C,yBAAyB;IACzB,aAAa,IAAI,eAAe,EAAE;IAMlC,wCAAwC;IACxC,WAAW,IAAI,QAAQ;IAIvB,uCAAuC;IACvC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIhC,wBAAwB;IACxB,QAAQ,IAAI,WAAW;IAIvB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,2BAA2B;IAC3B,kBAAkB,IAAI,cAAc,EAAE;IAItC,kCAAkC;IAClC,gBAAgB,IAAI,MAAM;IAI1B,4CAA4C;IAC5C,YAAY,IAAI,IAAI;CAGrB"}