agentwallet-sdk 5.0.0 → 5.0.2

package/dist/swap/SwapModule.js

@@ -0,0 +1,144 @@
+// SwapModule — Uniswap V3 token swap aggregator with 0.875% protocol fee
+import { encodeFunctionData, } from 'viem';
+import { UniswapV3RouterAbi, UniswapV3QuoterV2Abi, ERC20Abi } from './abi.js';
+import { PROTOCOL_FEE_BPS, DEFAULT_SLIPPAGE_BPS, UNISWAP_V3_BASE, } from './types.js';
+const FEE_TIERS = [100, 500, 3000, 10000];
+/** Calculate protocol fee: floor(amount * feeBps / 100_000) */
+export function calcProtocolFee(amount, feeBps) {
+    return (amount * BigInt(feeBps)) / 100000n;
+}
+/** Apply slippage: floor(amount * (10_000 - slippageBps) / 10_000) */
+export function applySlippage(amount, slippageBps) {
+    return (amount * BigInt(10000 - slippageBps)) / 10000n;
+}
+/** Encode deadline: block.timestamp + deadlineSecs */
+export function calcDeadline(deadlineSecs) {
+    return BigInt(Math.floor(Date.now() / 1000) + deadlineSecs);
+}
+export class SwapModule {
+    constructor(publicClient, walletClient, accountAddress, config) {
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.accountAddress = accountAddress;
+        this.config = {
+            routerAddress: UNISWAP_V3_BASE.ROUTER,
+            quoterAddress: UNISWAP_V3_BASE.QUOTER_V2,
+            feeBps: PROTOCOL_FEE_BPS,
+            feeWallet: accountAddress,
+            ...config,
+        };
+    }
+    async getQuote(tokenIn, tokenOut, amountIn, options = {}) {
+        const slippageBps = options.slippageBps ?? DEFAULT_SLIPPAGE_BPS;
+        const tiersToTry = options.feeTiers ?? FEE_TIERS;
+        const feeAmount = calcProtocolFee(amountIn, this.config.feeBps);
+        const amountInNet = amountIn - feeAmount;
+        if (amountInNet <= 0n) {
+            throw new Error(`SwapModule: amountIn (${amountIn}) is too small — fee (${feeAmount}) exceeds input`);
+        }
+        let bestQuote = null;
+        for (const fee of tiersToTry) {
+            try {
+                const result = await this.publicClient.readContract({
+                    address: this.config.quoterAddress,
+                    abi: UniswapV3QuoterV2Abi,
+                    functionName: 'quoteExactInputSingle',
+                    args: [{ tokenIn, tokenOut, amount: amountInNet, fee, sqrtPriceLimitX96: 0n }],
+                });
+                const [amountOut, , , gasEstimate] = result;
+                if (!bestQuote || amountOut > bestQuote.amountOut) {
+                    bestQuote = { amountOut, gasEstimate, feeTier: fee };
+                }
+            }
+            catch {
+                // Pool doesn't exist for this fee tier
+            }
+        }
+        if (!bestQuote) {
+            throw new Error(`SwapModule: No Uniswap V3 pool found for ${tokenIn} → ${tokenOut} on Base.`);
+        }
+        const amountOutMinimum = applySlippage(bestQuote.amountOut, slippageBps);
+        const effectiveRate = amountInNet > 0n ? Number(bestQuote.amountOut) / Number(amountInNet) : 0;
+        return {
+            tokenIn, tokenOut, amountInRaw: amountIn, amountInNet, feeAmount,
+            amountOut: bestQuote.amountOut, amountOutMinimum,
+            poolFeeTier: bestQuote.feeTier, effectiveRate, gasEstimate: bestQuote.gasEstimate,
+        };
+    }
+    async ensureApproval(token, spender, amount) {
+        const currentAllowance = (await this.publicClient.readContract({
+            address: token, abi: ERC20Abi, functionName: 'allowance',
+            args: [this.accountAddress, spender],
+        }));
+        if (currentAllowance >= amount)
+            return undefined;
+        const MAX_UINT256 = 115792089237316195423570985008687907853269984665640564039457584007913129639935n;
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('SwapModule: walletClient has no account');
+        const approveData = encodeFunctionData({
+            abi: ERC20Abi, functionName: 'approve', args: [spender, MAX_UINT256],
+        });
+        return this.walletClient.sendTransaction({
+            account, to: token, data: approveData, chain: this.walletClient.chain ?? null,
+        });
+    }
+    async transferFee(token, feeAmount, feeWallet) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('SwapModule: walletClient has no account');
+        const transferData = encodeFunctionData({
+            abi: ERC20Abi, functionName: 'transfer', args: [feeWallet, feeAmount],
+        });
+        return this.walletClient.sendTransaction({
+            account, to: token, data: transferData, chain: this.walletClient.chain ?? null,
+        });
+    }
+    async swap(tokenIn, tokenOut, amountIn, options = {}) {
+        const slippageBps = options.slippageBps ?? DEFAULT_SLIPPAGE_BPS;
+        const deadlineSecs = options.deadlineSecs ?? 300;
+        const feeWallet = options.feeWallet ?? this.config.feeWallet;
+        const quote = await this.getQuote(tokenIn, tokenOut, amountIn, { slippageBps, feeTiers: options.feeTiers });
+        if (quote.gasEstimate > 2000000n) {
+            console.warn(`SwapModule: High gas estimate (${quote.gasEstimate}). Pool may be illiquid.`);
+        }
+        const approvalTxHash = await this.ensureApproval(tokenIn, this.config.routerAddress, amountIn);
+        const approvalRequired = approvalTxHash !== undefined;
+        let feeTxHash;
+        if (quote.feeAmount > 0n && feeWallet !== this.accountAddress) {
+            feeTxHash = await this.transferFee(tokenIn, quote.feeAmount, feeWallet);
+        }
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('SwapModule: walletClient has no account');
+        const deadline = calcDeadline(deadlineSecs);
+        const swapData = encodeFunctionData({
+            abi: UniswapV3RouterAbi,
+            functionName: 'exactInputSingle',
+            args: [{
+                    tokenIn, tokenOut, fee: quote.poolFeeTier, recipient: this.accountAddress,
+                    amountIn: quote.amountInNet, amountOutMinimum: quote.amountOutMinimum, sqrtPriceLimitX96: 0n,
+                }],
+        });
+        const txHash = await this.walletClient.sendTransaction({
+            account, to: this.config.routerAddress, data: swapData, chain: this.walletClient.chain ?? null,
+        });
+        return { txHash, feeTxHash, quote, approvalRequired, approvalTxHash };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    setFeeWallet(address) {
+        this.config.feeWallet = address;
+    }
+}
+export function attachSwap(wallet, config) {
+    const swapModule = new SwapModule(wallet.publicClient, wallet.walletClient, wallet.address, config);
+    return {
+        ...wallet,
+        swapModule,
+        swap: swapModule.swap.bind(swapModule),
+        getQuote: swapModule.getQuote.bind(swapModule),
+    };
+}
+//# sourceMappingURL=SwapModule.js.map

package/dist/swap/SwapModule.js.map

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

package/dist/swap/abi.d.ts

@@ -0,0 +1,51 @@
+/** Uniswap V3 SwapRouter02 ABI — exactInputSingle */
+export declare const UniswapV3RouterAbi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+        components: {
+            name: string;
+            type: string;
+        }[];
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+/** Uniswap V3 QuoterV2 ABI — quoteExactInputSingle */
+export declare const UniswapV3QuoterV2Abi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+        components: {
+            name: string;
+            type: string;
+        }[];
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+/** Minimal ERC-20 ABI for allowance, approve, transferFrom */
+export declare const ERC20Abi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+//# sourceMappingURL=abi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../../src/swap/abi.ts"],"names":[],"mappings":"AACA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;GAwC9B,CAAC;AACF,sDAAsD;AACtD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;GAyBhC,CAAC;AACF,8DAA8D;AAC9D,eAAO,MAAM,QAAQ;;;;;;;;;;;;GA6CpB,CAAC"}

package/dist/swap/abi.js

@@ -0,0 +1,118 @@
+// [MAX-ADDED] ABIs for Uniswap V3 SwapRouter02 and QuoterV2 on Base Mainnet
+/** Uniswap V3 SwapRouter02 ABI — exactInputSingle */
+export const UniswapV3RouterAbi = [
+    {
+        name: 'exactInputSingle',
+        type: 'function',
+        stateMutability: 'payable',
+        inputs: [
+            {
+                name: 'params',
+                type: 'tuple',
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+    },
+    {
+        name: 'exactInput',
+        type: 'function',
+        stateMutability: 'payable',
+        inputs: [
+            {
+                name: 'params',
+                type: 'tuple',
+                components: [
+                    { name: 'path', type: 'bytes' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+    },
+];
+/** Uniswap V3 QuoterV2 ABI — quoteExactInputSingle */
+export const UniswapV3QuoterV2Abi = [
+    {
+        name: 'quoteExactInputSingle',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            {
+                name: 'params',
+                type: 'tuple',
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'amount', 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' },
+        ],
+    },
+];
+/** Minimal ERC-20 ABI for allowance, approve, transferFrom */
+export const ERC20Abi = [
+    {
+        name: 'allowance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        name: 'transfer',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        name: 'balanceOf',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        name: 'decimals',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint8' }],
+    },
+];
+//# sourceMappingURL=abi.js.map

package/dist/swap/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../src/swap/abi.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B;QACI,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACJ;gBACI,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACR,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC/B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC7C,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;iBACjD;aACJ;SACJ;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACpD;IACD;QACI,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACJ;gBACI,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACR,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;oBAC/B,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;iBAChD;aACJ;SACJ;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACpD;CACJ,CAAC;AACF,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC;QACI,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACJ;gBACI,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACR,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;oBACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC/B,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;iBACjD;aACJ;SACJ;QACD,OAAO,EAAE;YACL,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9C,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SAC3C;KACJ;CACJ,CAAC;AACF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB;QACI,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACJ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACvC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC3C;IACD;QACI,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACJ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACtC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACxC;IACD;QACI,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACJ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;YAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACtC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACxC;IACD;QACI,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC3C;IACD;QACI,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KACzC;CACJ,CAAC"}

package/dist/swap/index.d.ts

@@ -0,0 +1,5 @@
+export { SwapModule, attachSwap, calcProtocolFee, applySlippage, calcDeadline } from './SwapModule.js';
+export { UniswapV3RouterAbi, UniswapV3QuoterV2Abi, ERC20Abi } from './abi.js';
+export { BASE_TOKENS, UNISWAP_V3_BASE, PROTOCOL_FEE_BPS, DEFAULT_SLIPPAGE_BPS } from './types.js';
+export type { UniswapFeeTier, SwapQuote, SwapOptions, SwapResult, SwapModuleConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/swap/index.js

@@ -0,0 +1,4 @@
+export { SwapModule, attachSwap, calcProtocolFee, applySlippage, calcDeadline } from './SwapModule.js';
+export { UniswapV3RouterAbi, UniswapV3QuoterV2Abi, ERC20Abi } from './abi.js';
+export { BASE_TOKENS, UNISWAP_V3_BASE, PROTOCOL_FEE_BPS, DEFAULT_SLIPPAGE_BPS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/swap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { AggregatorQuote, QuoteParams } from './types.js';
+export declare class QuoteCache {
+    private cache;
+    private ttlMs;
+    constructor(ttlMs?: number);
+    private key;
+    get(params: QuoteParams): AggregatorQuote[] | null;
+    set(params: QuoteParams, quotes: AggregatorQuote[]): void;
+    clear(): void;
+    /** Number of currently cached (non-expired) entries */
+    size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/swap/router/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuE;IACpF,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,SAAO;IAIxB,OAAO,CAAC,GAAG;IAIX,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,EAAE,GAAG,IAAI;IAUlD,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;IAIzD,KAAK,IAAI,IAAI;IAIb,uDAAuD;IACvD,IAAI,IAAI,MAAM;CAGf"}

package/dist/swap/router/cache.js

@@ -0,0 +1,30 @@
+export class QuoteCache {
+    constructor(ttlMs = 3000) {
+        this.cache = new Map();
+        this.ttlMs = ttlMs;
+    }
+    key(params) {
+        return `${params.chain}:${params.fromToken}:${params.toToken}:${params.amount}`;
+    }
+    get(params) {
+        const entry = this.cache.get(this.key(params));
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > this.ttlMs) {
+            this.cache.delete(this.key(params));
+            return null;
+        }
+        return entry.quotes;
+    }
+    set(params, quotes) {
+        this.cache.set(this.key(params), { quotes, timestamp: Date.now() });
+    }
+    clear() {
+        this.cache.clear();
+    }
+    /** Number of currently cached (non-expired) entries */
+    size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/swap/router/cache.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,UAAU;IAIrB,YAAY,KAAK,GAAG,IAAI;QAHhB,UAAK,GAAG,IAAI,GAAG,EAA4D,CAAC;QAIlF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,GAAG,CAAC,MAAmB;QAC7B,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IAClF,CAAC;IAED,GAAG,CAAC,MAAmB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,MAAmB,EAAE,MAAyB;QAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,uDAAuD;IACvD,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+export declare class FlashbotsProtectRpc {
+    private readonly rpcUrl;
+    constructor(options?: {
+        fast?: boolean;
+        useMempool?: boolean;
+    });
+    sendTransaction(signedTx: string): Promise<string>;
+    getTransactionStatus(txHash: string): Promise<'pending' | 'included' | 'failed' | 'unknown'>;
+}
+//# sourceMappingURL=flashbots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flashbots.d.ts","sourceRoot":"","sources":["../../../src/swap/router/flashbots.ts"],"names":[],"mappings":"AAOA,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAOxD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBlD,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CASnG"}

package/dist/swap/router/flashbots.js

@@ -0,0 +1,43 @@
+// [MAX-ADDED] FlashbotsProtectRpc — MEV protection via Flashbots Protect RPC
+// Endpoint: https://rpc.flashbots.net
+// - Transactions are never sent to the public mempool
+// - Failed transactions don't cost gas
+// - MEV refunds if your tx creates MEV
+// Only works on Ethereum mainnet.
+export class FlashbotsProtectRpc {
+    constructor(options) {
+        let url = 'https://rpc.flashbots.net';
+        if (options?.fast)
+            url += '/fast';
+        if (options?.useMempool)
+            url += '?useMempool=true';
+        this.rpcUrl = url;
+    }
+    async sendTransaction(signedTx) {
+        const res = await fetch(this.rpcUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'eth_sendRawTransaction',
+                params: [signedTx],
+            }),
+        });
+        const data = (await res.json());
+        if (data.error)
+            throw new Error(`Flashbots: ${data.error.message}`);
+        return data.result ?? '';
+    }
+    async getTransactionStatus(txHash) {
+        const res = await fetch(`https://protect.flashbots.net/tx/${txHash}`, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const data = (await res.json());
+        const s = data.status;
+        if (s === 'pending' || s === 'included' || s === 'failed')
+            return s;
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=flashbots.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flashbots.js","sourceRoot":"","sources":["../../../src/swap/router/flashbots.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,sCAAsC;AACtC,sDAAsD;AACtD,uCAAuC;AACvC,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,OAAO,mBAAmB;IAG9B,YAAY,OAAkD;QAC5D,IAAI,GAAG,GAAG,2BAA2B,CAAC;QACtC,IAAI,OAAO,EAAE,IAAI;YAAE,GAAG,IAAI,OAAO,CAAC;QAClC,IAAI,OAAO,EAAE,UAAU;YAAE,GAAG,IAAI,kBAAkB,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,CAAC;gBACL,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE,CAAC,QAAQ,CAAC;aACnB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqD,CAAC;QACpF,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,MAAc;QACvC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oCAAoC,MAAM,EAAE,EAAE;YACpE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;QACvD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+export declare class ProviderHealthTracker {
+    private failures;
+    private lastFailureTime;
+    private readonly maxFailures;
+    private readonly cooldownMs;
+    constructor(maxFailures?: number, cooldownMs?: number);
+    recordSuccess(provider: string): void;
+    recordFailure(provider: string): void;
+    isHealthy(provider: string): boolean;
+    getStats(): Record<string, {
+        failures: number;
+        healthy: boolean;
+    }>;
+    /** Reset a provider back to healthy state */
+    reset(provider: string): void;
+}
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/swap/router/health.ts"],"names":[],"mappings":"AAEA,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,WAAW,SAAI,EAAE,UAAU,SAAQ;IAK/C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQpC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQlE,6CAA6C;IAC7C,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAI9B"}

package/dist/swap/router/health.js

@@ -0,0 +1,38 @@
+// [MAX-ADDED] ProviderHealthTracker — circuit-breaker style health tracking for swap providers
+export class ProviderHealthTracker {
+    constructor(maxFailures = 3, cooldownMs = 60000) {
+        this.failures = new Map(); // consecutive failures
+        this.lastFailureTime = new Map(); // timestamp of last recorded failure
+        this.maxFailures = maxFailures;
+        this.cooldownMs = cooldownMs;
+    }
+    recordSuccess(provider) {
+        this.failures.set(provider, 0);
+        this.lastFailureTime.delete(provider);
+    }
+    recordFailure(provider) {
+        this.failures.set(provider, (this.failures.get(provider) ?? 0) + 1);
+        this.lastFailureTime.set(provider, Date.now());
+    }
+    isHealthy(provider) {
+        const fails = this.failures.get(provider) ?? 0;
+        if (fails < this.maxFailures)
+            return true;
+        // After cooldown since last failure, allow retry
+        const lastFail = this.lastFailureTime.get(provider) ?? 0;
+        return Date.now() - lastFail > this.cooldownMs;
+    }
+    getStats() {
+        const stats = {};
+        for (const [name, fails] of this.failures) {
+            stats[name] = { failures: fails, healthy: this.isHealthy(name) };
+        }
+        return stats;
+    }
+    /** Reset a provider back to healthy state */
+    reset(provider) {
+        this.failures.delete(provider);
+        this.lastFailureTime.delete(provider);
+    }
+}
+//# sourceMappingURL=health.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/swap/router/health.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,MAAM,OAAO,qBAAqB;IAMhC,YAAY,WAAW,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK;QALvC,aAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,uBAAuB;QAC7D,oBAAe,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,qCAAqC;QAKxF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC1C,iDAAiD;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;IACjD,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAA2D,EAAE,CAAC;QACzE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,QAAgB;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+export { SmartSwapRouter, scoreQuote } from './router.js';
+export { QuoteCache } from './cache.js';
+export { ProviderHealthTracker } from './health.js';
+export { FlashbotsProtectRpc } from './flashbots.js';
+export { UniswapProvider, JupiterProvider, OneInchProvider, ZeroXProvider, ParaSwapProvider, CowSwapProvider, LiFiProvider, buildDefaultProviders, buildQuote, } from './providers/index.js';
+export type { AggregatorQuote, AggregatorSwapResult, QuoteParams, SmartSwapConfig, SwapStrategy, ISwapProvider, TransactionReceipt, } from './types.js';
+export { CHAIN_IDS, CHAIN_NAMES } from './types.js';
+export { SwapRSIEngine } from './rsi/index.js';
+export type { WalletGoals, WalletDirective, RSIConfig, RSIMetric, SwapOutcome, MutationResult, RSIState, ProviderWeights, } from './rsi/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/swap/router/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,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,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,eAAe,EACf,SAAS,EACT,SAAS,EACT,WAAW,EACX,cAAc,EACd,QAAQ,EACR,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/swap/router/index.js

@@ -0,0 +1,10 @@
+// [MAX-ADDED] SmartSwapRouter public API
+export { SmartSwapRouter, scoreQuote } from './router.js';
+export { QuoteCache } from './cache.js';
+export { ProviderHealthTracker } from './health.js';
+export { FlashbotsProtectRpc } from './flashbots.js';
+export { UniswapProvider, JupiterProvider, OneInchProvider, ZeroXProvider, ParaSwapProvider, CowSwapProvider, LiFiProvider, buildDefaultProviders, buildQuote, } from './providers/index.js';
+export { CHAIN_IDS, CHAIN_NAMES } from './types.js';
+// [MAX-ADDED] RSI Engine
+export { SwapRSIEngine } from './rsi/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/swap/router/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,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,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cowswap.d.ts","sourceRoot":"","sources":["../../../../src/swap/router/providers/cowswap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe/E,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,eAAe,WAAkB;IAE1C,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;CAiExF"}