agentwallet-sdk 5.0.0 → 5.0.1

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":"AAWA,OAAO,EAAE,qBAAqB,EAAgC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,gBAAgB,GAAiB,iBAAiB,CAAC;AACzD,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,gFAAgF;AAEhF,MAAM,UAAU,UAAU,CAAC,KAAsB,EAAE,QAAsB;IACvE,sDAAsD;IACtD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,SAAS,GACb,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QACzF,MAAM,eAAe,GAAG,SAAS,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QAE9D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,iBAAiB;gBACpB,OAAO,SAAS,GAAG,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC;YAC5D,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;YAChC,KAAK,YAAY;gBACf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;YAC/B,KAAK,eAAe;gBAClB,OAAO,KAAK,CAAC,YAAY;oBACvB,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI;oBAC3C,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC;QACzC,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,iBAAiB;YACpB,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;QAChC,KAAK,YAAY;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,KAAK,eAAe;YAClB,OAAO,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,MAAM,OAAO,eAAe;IAW1B,YAAY,SAAoD,EAAE;QAChE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC9D,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,oBAAoB,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAElD,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAqB,CACrC,MAAM,CAAC,iBAAiB,IAAI,CAAC,EAC7B,MAAM,CAAC,gBAAgB,IAAI,KAAK,CACjC,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,qBAAqB,CAAC;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QAEH,uDAAuD;QACvD,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,cAAc;QACd,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,cAAc,GAAgB;YAClC,GAAG,MAAM;YACT,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW;SACpD,CAAC;QAEF,kDAAkD;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3C,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACpD,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9E,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACrD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,qCAAqC;QACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAChE,CAAC;QAEF,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtC,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YAC1C,CAAC;YACD,oDAAoD;QACtD,CAAC;QAED,mBAAmB;QACnB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEnF,4DAA4D;QAC5D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;gBACrC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;oBACd,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YACD,kCAAkC;YAClC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAEnF,mBAAmB;YACnB,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC7B,gEAAgE;gBAChE,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,KAAsB,EACtB,MAuBC,EACD,OASC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,CAAC,QAAQ,6BAA6B;gBACzE,6EAA6E,CAChF,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,EAAE,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,CAAC,KAAK,yBAAyB,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,MAAc,CAAC;QAEnB,oDAAoD;QACpD,IAAI,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;YAC5C,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,EAAE,cAAc,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;YACpF,OAAO;gBACL,MAAM;gBACN,KAAK;gBACL,KAAK,EAAE,SAAS;gBAChB,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS;aACtC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM;YACN,KAAK;YACL,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAa;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,SAAS;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAsB;QAC/B,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,8EAA8E;IAE9E,+CAA+C;IAC/C,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0CAA0C;IAC1C,YAAY,CAAC,KAAe;QAC1B,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,+CAA+C;IAC/C,cAAc;QACZ,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IACvC,CAAC;CACF"}

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