@eth-optimism/actions-sdk 0.2.0 → 0.4.0

package/dist/swap/namespaces/BaseSwapNamespace.d.ts

@@ -0,0 +1,73 @@
+import type { SupportedChainId } from '../../constants/supportedChains.js';
+import type { SwapProvider } from '../core/SwapProvider.js';
+import type { SwapProviderName, SwapSettings } from '../../types/actions.js';
+import type { Asset } from '../../types/asset.js';
+import type { GetSwapMarketParams, GetSwapMarketsParams, SwapMarket, SwapProviderConfig, SwapProviders, SwapQuote, SwapQuoteParams } from '../../types/swap/index.js';
+/**
+ * Base swap namespace with shared read-only operations
+ */
+export declare abstract class BaseSwapNamespace {
+    protected readonly providers: SwapProviders;
+    protected readonly settings?: SwapSettings | undefined;
+    constructor(providers: SwapProviders, settings?: SwapSettings | undefined);
+    /**
+     * Get a swap quote with pre-built execution data.
+     * When `routing: 'price'` is set in settings and no explicit provider is requested,
+     * fetches quotes from all eligible providers in parallel and returns the best price.
+     * @param params - Quote parameters (assets, amounts, chain, optional provider)
+     * @returns The best available SwapQuote
+     */
+    getQuote(params: SwapQuoteParams): Promise<SwapQuote>;
+    /**
+     * Fetch quotes from all eligible providers in parallel and return the best.
+     * @param params - Quote parameters
+     * @returns The quote with the highest amountOut
+     * @throws If no provider returns a valid quote
+     */
+    private getBestQuote;
+    /**
+     * Fetch quotes from all eligible providers in parallel.
+     * Providers that don't support the pair or fail to quote are silently skipped.
+     * @param params - Quote parameters
+     * @returns Array of successful quotes (may be empty if all providers fail)
+     */
+    private fetchAllQuotes;
+    /**
+     * Fetch quotes from all eligible providers in parallel.
+     * Unlike getQuote(), returns all successful quotes instead of just the best.
+     * If an explicit provider is specified, returns a single-element array from that provider.
+     * @param params - Quote parameters (assets, amounts, chain, optional provider)
+     * @returns Array of SwapQuotes sorted by amountOut descending (best first)
+     */
+    getQuotes(params: SwapQuoteParams): Promise<SwapQuote[]>;
+    /**
+     * Get a specific swap market by ID.
+     * @param params - Market identifier (poolId + chainId)
+     * @param provider - Optional provider name to query directly instead of searching all
+     * @returns Market information
+     */
+    getMarket(params: GetSwapMarketParams, provider?: SwapProviderName): Promise<SwapMarket>;
+    /**
+     * Get available swap markets across all providers
+     * @param params - Optional filtering by chainId or asset
+     * @returns Promise resolving to array of markets from all providers
+     */
+    getMarkets(params?: GetSwapMarketsParams): Promise<SwapMarket[]>;
+    /**
+     * Get all supported chain IDs across all providers
+     */
+    supportedChainIds(): SupportedChainId[];
+    protected getAllProviders(): Array<SwapProvider<SwapProviderConfig>>;
+    /**
+     * Resolve which provider handles a request.
+     *
+     * Precedence:
+     * 1. Explicit `provider` param on the call
+     * 2. routing.defaultProvider (when no strategy set)
+     * 3. routing.strategy match (market-aware, defaultProvider as tiebreaker)
+     * 4. First provider whose allowlist matches
+     * 5. First configured provider
+     */
+    protected resolveProvider(provider: SwapProviderName | undefined, assetIn: Asset, assetOut: Asset, chainId: SupportedChainId): SwapProvider<SwapProviderConfig>;
+}
+//# sourceMappingURL=BaseSwapNamespace.d.ts.map

package/dist/swap/namespaces/BaseSwapNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSwapNamespace.d.ts","sourceRoot":"","sources":["../../../src/swap/namespaces/BaseSwapNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAE9B;;GAEG;AACH,8BAAsB,iBAAiB;IAEnC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa;IAC3C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY;gBADvB,SAAS,EAAE,aAAa,EACxB,QAAQ,CAAC,EAAE,YAAY,YAAA;IAG5C;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IA2B3D;;;;;OAKG;YACW,YAAY;IAmB1B;;;;;OAKG;YACW,cAAc;IAsB5B;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqB9D;;;;;OAKG;IACG,SAAS,CACb,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAqBtB;;;;OAIG;IACG,UAAU,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO1E;;OAEG;IACH,iBAAiB,IAAI,gBAAgB,EAAE;IAWvC,SAAS,CAAC,eAAe,IAAI,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAMpE;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CACvB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,KAAK,EACd,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,gBAAgB,GACxB,YAAY,CAAC,kBAAkB,CAAC;CA0CpC"}

package/dist/swap/namespaces/BaseSwapNamespace.js

@@ -0,0 +1,181 @@
+/**
+ * Base swap namespace with shared read-only operations
+ */
+export class BaseSwapNamespace {
+    constructor(providers, settings) {
+        this.providers = providers;
+        this.settings = settings;
+    }
+    /**
+     * Get a swap quote with pre-built execution data.
+     * When `routing: 'price'` is set in settings and no explicit provider is requested,
+     * fetches quotes from all eligible providers in parallel and returns the best price.
+     * @param params - Quote parameters (assets, amounts, chain, optional provider)
+     * @returns The best available SwapQuote
+     */
+    async getQuote(params) {
+        // Explicit provider — skip routing
+        if (params.provider) {
+            const provider = this.resolveProvider(params.provider, params.assetIn, params.assetOut, params.chainId);
+            return provider.getQuote(params);
+        }
+        // Price routing — quote all eligible providers, return best
+        if (this.settings?.routing === 'price') {
+            return this.getBestQuote(params);
+        }
+        // No routing — resolve single provider via fallback logic
+        const provider = this.resolveProvider(undefined, params.assetIn, params.assetOut, params.chainId);
+        return provider.getQuote(params);
+    }
+    /**
+     * Fetch quotes from all eligible providers in parallel and return the best.
+     * @param params - Quote parameters
+     * @returns The quote with the highest amountOut
+     * @throws If no provider returns a valid quote
+     */
+    async getBestQuote(params) {
+        const quotes = await this.fetchAllQuotes(params);
+        let best = null;
+        for (const quote of quotes) {
+            if (!best || quote.amountOutRaw > best.amountOutRaw) {
+                best = quote;
+            }
+        }
+        if (!best) {
+            throw new Error(`All providers failed to quote ${params.assetIn.metadata.symbol}/${params.assetOut.metadata.symbol}`);
+        }
+        return best;
+    }
+    /**
+     * Fetch quotes from all eligible providers in parallel.
+     * Providers that don't support the pair or fail to quote are silently skipped.
+     * @param params - Quote parameters
+     * @returns Array of successful quotes (may be empty if all providers fail)
+     */
+    async fetchAllQuotes(params) {
+        const eligible = this.getAllProviders().filter((p) => p.isMarketSupported(params.assetIn, params.assetOut, params.chainId));
+        if (eligible.length === 0) {
+            throw new Error(`No provider supports ${params.assetIn.metadata.symbol}/${params.assetOut.metadata.symbol} on chain ${params.chainId}`);
+        }
+        const results = await Promise.allSettled(eligible.map((p) => p.getQuote(params)));
+        return results
+            .filter((r) => r.status === 'fulfilled')
+            .map((r) => r.value);
+    }
+    /**
+     * Fetch quotes from all eligible providers in parallel.
+     * Unlike getQuote(), returns all successful quotes instead of just the best.
+     * If an explicit provider is specified, returns a single-element array from that provider.
+     * @param params - Quote parameters (assets, amounts, chain, optional provider)
+     * @returns Array of SwapQuotes sorted by amountOut descending (best first)
+     */
+    async getQuotes(params) {
+        if (params.provider) {
+            const provider = this.resolveProvider(params.provider, params.assetIn, params.assetOut, params.chainId);
+            return [await provider.getQuote(params)];
+        }
+        const quotes = await this.fetchAllQuotes(params);
+        return quotes.sort((a, b) => a.amountOutRaw > b.amountOutRaw
+            ? -1
+            : a.amountOutRaw < b.amountOutRaw
+                ? 1
+                : 0);
+    }
+    /**
+     * Get a specific swap market by ID.
+     * @param params - Market identifier (poolId + chainId)
+     * @param provider - Optional provider name to query directly instead of searching all
+     * @returns Market information
+     */
+    async getMarket(params, provider) {
+        if (provider) {
+            const named = this.providers[provider];
+            if (!named) {
+                throw new Error(`Swap provider "${provider}" not configured`);
+            }
+            return named.getMarket(params);
+        }
+        for (const p of this.getAllProviders()) {
+            try {
+                return await p.getMarket(params);
+            }
+            catch {
+                continue;
+            }
+        }
+        throw new Error(`Market with poolId ${params.poolId} not found on chain ${params.chainId}`);
+    }
+    /**
+     * Get available swap markets across all providers
+     * @param params - Optional filtering by chainId or asset
+     * @returns Promise resolving to array of markets from all providers
+     */
+    async getMarkets(params = {}) {
+        const results = await Promise.all(this.getAllProviders().map((p) => p.getMarkets(params)));
+        return results.flat();
+    }
+    /**
+     * Get all supported chain IDs across all providers
+     */
+    supportedChainIds() {
+        const chainIds = new Set();
+        for (const provider of this.getAllProviders()) {
+            for (const chainId of provider.supportedChainIds()) {
+                chainIds.add(chainId);
+            }
+        }
+        return Array.from(chainIds);
+    }
+    // SwapProviders keys are optional (uniswap?, velodrome?, etc.) so filter out unconfigured ones
+    getAllProviders() {
+        return Object.values(this.providers).filter((p) => p !== undefined);
+    }
+    /**
+     * Resolve which provider handles a request.
+     *
+     * Precedence:
+     * 1. Explicit `provider` param on the call
+     * 2. routing.defaultProvider (when no strategy set)
+     * 3. routing.strategy match (market-aware, defaultProvider as tiebreaker)
+     * 4. First provider whose allowlist matches
+     * 5. First configured provider
+     */
+    resolveProvider(provider, assetIn, assetOut, chainId) {
+        const allProviders = this.getAllProviders();
+        if (allProviders.length === 0) {
+            throw new Error('No swap provider configured');
+        }
+        // 1. Explicit provider param
+        if (provider) {
+            const named = this.providers[provider];
+            if (!named) {
+                throw new Error(`Swap provider "${provider}" not configured`);
+            }
+            return named;
+        }
+        // Single provider — no routing needed
+        if (allProviders.length === 1) {
+            return allProviders[0];
+        }
+        // 2. defaultProvider with no routing strategy — always use it
+        if (this.settings?.defaultProvider && !this.settings.routing) {
+            const provider = this.providers[this.settings.defaultProvider];
+            if (provider)
+                return provider;
+        }
+        // 3. Match by market allowlist
+        for (const p of allProviders) {
+            if (p.isMarketSupported(assetIn, assetOut, chainId)) {
+                return p;
+            }
+        }
+        // 4. Match by chain support
+        for (const p of allProviders) {
+            if (p.isChainSupported(chainId)) {
+                return p;
+            }
+        }
+        return allProviders[0];
+    }
+}
+//# sourceMappingURL=BaseSwapNamespace.js.map

package/dist/swap/namespaces/BaseSwapNamespace.js.map

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

package/dist/swap/namespaces/WalletSwapNamespace.d.ts

@@ -0,0 +1,34 @@
+import { BaseSwapNamespace } from './BaseSwapNamespace.js';
+import type { SwapSettings } from '../../types/actions.js';
+import type { SwapProviders, SwapQuote, SwapQuoteParams, SwapReceipt, WalletSwapParams } from '../../types/swap/index.js';
+import type { Wallet } from '../../wallet/core/wallets/abstract/Wallet.js';
+/**
+ * Wallet swap namespace with full operations including signing.
+ * Provides getQuote() for pricing and execute() for swapping tokens.
+ */
+export declare class WalletSwapNamespace extends BaseSwapNamespace {
+    private readonly wallet;
+    constructor(providers: SwapProviders, wallet: Wallet, settings?: SwapSettings);
+    /**
+     * Get a swap quote with the wallet address as recipient.
+     * Ensures calldata is encoded for the real wallet, not a placeholder.
+     */
+    getQuote(params: SwapQuoteParams): Promise<SwapQuote>;
+    /**
+     * Get quotes from all providers with the wallet address as recipient.
+     */
+    getQuotes(params: SwapQuoteParams): Promise<SwapQuote[]>;
+    /**
+     * Execute a token swap.
+     * Accepts either raw params (re-quotes internally) or a pre-built SwapQuote (skips re-quoting).
+     * @param params - Swap parameters or a pre-built SwapQuote from getQuote()
+     * @returns Swap receipt with transaction details
+     */
+    execute(params: WalletSwapParams | SwapQuote): Promise<SwapReceipt>;
+    private buildReceipt;
+    /**
+     * Execute swap transaction with approval batching
+     */
+    private executeTransaction;
+}
+//# sourceMappingURL=WalletSwapNamespace.d.ts.map

package/dist/swap/namespaces/WalletSwapNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletSwapNamespace.d.ts","sourceRoot":"","sources":["../../../src/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,WAAW,EAEX,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAA;AAEtE;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IAGtD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvB,SAAS,EAAE,aAAa,EACP,MAAM,EAAE,MAAM,EAC/B,QAAQ,CAAC,EAAE,YAAY;IAKzB;;;OAGG;IACY,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAOpE;;OAEG;IACY,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOvE;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBzE,OAAO,CAAC,YAAY;IAiBpB;;OAEG;YACW,kBAAkB;CA0BjC"}

package/dist/swap/namespaces/WalletSwapNamespace.js

@@ -0,0 +1,84 @@
+import { QUOTE_DISCRIMINATOR } from '../core/SwapProvider.js';
+import { BaseSwapNamespace } from './BaseSwapNamespace.js';
+/**
+ * Wallet swap namespace with full operations including signing.
+ * Provides getQuote() for pricing and execute() for swapping tokens.
+ */
+export class WalletSwapNamespace extends BaseSwapNamespace {
+    constructor(providers, wallet, settings) {
+        super(providers, settings);
+        this.wallet = wallet;
+    }
+    /**
+     * Get a swap quote with the wallet address as recipient.
+     * Ensures calldata is encoded for the real wallet, not a placeholder.
+     */
+    async getQuote(params) {
+        return super.getQuote({
+            ...params,
+            recipient: params.recipient ?? this.wallet.address,
+        });
+    }
+    /**
+     * Get quotes from all providers with the wallet address as recipient.
+     */
+    async getQuotes(params) {
+        return super.getQuotes({
+            ...params,
+            recipient: params.recipient ?? this.wallet.address,
+        });
+    }
+    /**
+     * Execute a token swap.
+     * Accepts either raw params (re-quotes internally) or a pre-built SwapQuote (skips re-quoting).
+     * @param params - Swap parameters or a pre-built SwapQuote from getQuote()
+     * @returns Swap receipt with transaction details
+     */
+    async execute(params) {
+        // Inject walletAddress — raw params need it for validation,
+        // quotes need it for on-chain allowance checks during approval building
+        const executeParams = QUOTE_DISCRIMINATOR in params
+            ? { ...params, recipient: this.wallet.address }
+            : { ...params, walletAddress: this.wallet.address };
+        const provider = this.resolveProvider(params.provider, params.assetIn, params.assetOut, params.chainId);
+        const swapTx = await provider.execute(executeParams);
+        const receipt = await this.executeTransaction(swapTx, params.chainId);
+        return this.buildReceipt(swapTx, receipt);
+    }
+    buildReceipt(swapTx, receipt) {
+        return {
+            receipt,
+            amountIn: swapTx.amountIn,
+            amountOut: swapTx.amountOut,
+            amountInRaw: swapTx.amountInRaw,
+            amountOutRaw: swapTx.amountOutRaw,
+            assetIn: swapTx.assetIn,
+            assetOut: swapTx.assetOut,
+            price: swapTx.price,
+            priceImpact: swapTx.priceImpact,
+        };
+    }
+    /**
+     * Execute swap transaction with approval batching
+     */
+    async executeTransaction(swapTx, chainId) {
+        const { transactionData } = swapTx;
+        const txs = [];
+        // Add token approval if needed
+        if (transactionData.tokenApproval) {
+            txs.push(transactionData.tokenApproval);
+        }
+        // Add Permit2 approval if needed
+        if (transactionData.permit2Approval) {
+            txs.push(transactionData.permit2Approval);
+        }
+        // Add main swap transaction
+        txs.push(transactionData.swap);
+        // Execute as batch if multiple transactions, otherwise single
+        if (txs.length > 1) {
+            return this.wallet.sendBatch(txs, chainId);
+        }
+        return this.wallet.send(transactionData.swap, chainId);
+    }
+}
+//# sourceMappingURL=WalletSwapNamespace.js.map

package/dist/swap/namespaces/WalletSwapNamespace.js.map

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

package/dist/swap/namespaces/__tests__/BaseSwapNamespace.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BaseSwapNamespace.spec.d.ts.map

package/dist/swap/namespaces/__tests__/BaseSwapNamespace.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSwapNamespace.spec.d.ts","sourceRoot":"","sources":["../../../../src/swap/namespaces/__tests__/BaseSwapNamespace.spec.ts"],"names":[],"mappings":""}

package/dist/swap/namespaces/__tests__/BaseSwapNamespace.spec.js

@@ -0,0 +1,245 @@
+import { describe, expect, it } from 'vitest';
+import { MockChainManager } from '../../../services/__mocks__/MockChainManager.js';
+import { createMockSwapProvider, MockSwapProvider, } from '../../__mocks__/MockSwapProvider.js';
+import { ActionsSwapNamespace } from '../ActionsSwapNamespace.js';
+describe('BaseSwapNamespace', () => {
+    const USDC = {
+        type: 'erc20',
+        address: { 84532: '0x036CbD53842c5426634e7929541eC2318f3dCF7e' },
+        metadata: { name: 'USD Coin', symbol: 'USDC', decimals: 6 },
+    };
+    const ETH = {
+        type: 'native',
+        address: { 84532: '0x0000000000000000000000000000000000000000' },
+        metadata: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+    };
+    describe('getQuote', () => {
+        it('delegates to provider getQuote', async () => {
+            const provider = createMockSwapProvider();
+            const namespace = new ActionsSwapNamespace({ uniswap: provider });
+            const result = await namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            });
+            expect(provider.mockGetQuote).toHaveBeenCalledTimes(1);
+            expect(result.price).toBe(1.5);
+            expect(result.execution).toBeDefined();
+            expect(result.execution.swapCalldata).toMatch(/^0x/);
+            expect(result.provider).toBe('uniswap');
+        });
+        it('throws if no provider configured', async () => {
+            const namespace = new ActionsSwapNamespace({});
+            await expect(namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            })).rejects.toThrow('No swap provider configured');
+        });
+    });
+    describe('getQuote with price routing', () => {
+        it('returns the best price across providers when routing is price', async () => {
+            const cheapProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.2, provider: 'uniswap' });
+            const expensiveProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.8, provider: 'velodrome' });
+            const namespace = new ActionsSwapNamespace({ uniswap: cheapProvider, velodrome: expensiveProvider }, { routing: 'price' });
+            const result = await namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            });
+            // Should pick velodrome because 1.8 > 1.2 (higher amountOut)
+            expect(result.provider).toBe('velodrome');
+        });
+        it('skips providers that fail to quote', async () => {
+            const workingProvider = createMockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { provider: 'velodrome' });
+            const failingProvider = createMockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { provider: 'uniswap' });
+            failingProvider.mockGetQuote.mockRejectedValue(new Error('RPC failure'));
+            const namespace = new ActionsSwapNamespace({ uniswap: failingProvider, velodrome: workingProvider }, { routing: 'price' });
+            const result = await namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            });
+            expect(result.provider).toBe('velodrome');
+        });
+        it('throws when all providers fail to quote', async () => {
+            const failingProvider = createMockSwapProvider({
+                marketAllowlist: [{ assets: [USDC, ETH] }],
+            });
+            failingProvider.mockGetQuote.mockRejectedValue(new Error('fail'));
+            const namespace = new ActionsSwapNamespace({ uniswap: failingProvider }, { routing: 'price' });
+            await expect(namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            })).rejects.toThrow('All providers failed');
+        });
+        it('uses explicit provider when specified, ignoring routing', async () => {
+            const cheapProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.2, provider: 'uniswap' });
+            const expensiveProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.8, provider: 'velodrome' });
+            const namespace = new ActionsSwapNamespace({ uniswap: cheapProvider, velodrome: expensiveProvider }, { routing: 'price' });
+            const result = await namespace.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+                provider: 'uniswap',
+            });
+            // Should use uniswap despite worse price because it was explicitly requested
+            expect(result.provider).toBe('uniswap');
+        });
+    });
+    describe('getQuotes', () => {
+        it('returns quotes from all eligible providers sorted by best price', async () => {
+            const cheapProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.2, provider: 'uniswap' });
+            const expensiveProvider = new MockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { defaultPrice: 1.8, provider: 'velodrome' });
+            const namespace = new ActionsSwapNamespace({
+                uniswap: cheapProvider,
+                velodrome: expensiveProvider,
+            });
+            const quotes = await namespace.getQuotes({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            });
+            expect(quotes).toHaveLength(2);
+            expect(quotes[0].provider).toBe('velodrome');
+            expect(quotes[1].provider).toBe('uniswap');
+        });
+        it('skips failed providers and returns successful ones', async () => {
+            const workingProvider = createMockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { provider: 'velodrome' });
+            const failingProvider = createMockSwapProvider({ marketAllowlist: [{ assets: [USDC, ETH] }] }, { provider: 'uniswap' });
+            failingProvider.mockGetQuote.mockRejectedValue(new Error('fail'));
+            const namespace = new ActionsSwapNamespace({
+                uniswap: failingProvider,
+                velodrome: workingProvider,
+            });
+            const quotes = await namespace.getQuotes({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+            });
+            expect(quotes).toHaveLength(1);
+            expect(quotes[0].provider).toBe('velodrome');
+        });
+        it('returns single-element array when explicit provider specified', async () => {
+            const provider1 = createMockSwapProvider(undefined, {
+                provider: 'uniswap',
+            });
+            const provider2 = new MockSwapProvider(undefined, {
+                supportedChains: [84532],
+                provider: 'velodrome',
+            });
+            const namespace = new ActionsSwapNamespace({
+                uniswap: provider1,
+                velodrome: provider2,
+            });
+            const quotes = await namespace.getQuotes({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+                provider: 'uniswap',
+            });
+            expect(quotes).toHaveLength(1);
+            expect(quotes[0].provider).toBe('uniswap');
+        });
+    });
+    describe('getMarket', () => {
+        it('delegates to provider getMarket', async () => {
+            const provider = createMockSwapProvider();
+            const namespace = new ActionsSwapNamespace({ uniswap: provider });
+            const result = await namespace.getMarket({
+                poolId: '0xpool123',
+                chainId: 84532,
+            });
+            expect(provider.mockGetMarket).toHaveBeenCalledTimes(1);
+            expect(result.marketId.poolId).toBe('0xpool123');
+        });
+        it('queries specific provider when specified', async () => {
+            const provider1 = createMockSwapProvider(undefined, {
+                provider: 'uniswap',
+            });
+            const provider2 = new MockSwapProvider(undefined, {
+                supportedChains: [84532],
+                provider: 'velodrome',
+            });
+            const namespace = new ActionsSwapNamespace({
+                uniswap: provider1,
+                velodrome: provider2,
+            });
+            await namespace.getMarket({ poolId: '0xpool123', chainId: 84532 }, 'velodrome');
+            expect(provider2.mockGetMarket).toHaveBeenCalledTimes(1);
+            expect(provider1.mockGetMarket).not.toHaveBeenCalled();
+        });
+        it('throws for unknown provider name', async () => {
+            const namespace = new ActionsSwapNamespace({
+                uniswap: createMockSwapProvider(),
+            });
+            await expect(namespace.getMarket({ poolId: '0x1', chainId: 84532 }, 'velodrome')).rejects.toThrow('not configured');
+        });
+    });
+    describe('getMarkets', () => {
+        it('aggregates markets from all providers', async () => {
+            const provider1 = createMockSwapProvider();
+            const provider2 = new MockSwapProvider(undefined, {
+                supportedChains: [84532],
+            });
+            const namespace = new ActionsSwapNamespace({
+                uniswap: provider1,
+                velodrome: provider2,
+            });
+            const result = await namespace.getMarkets({});
+            expect(result.length).toBeGreaterThanOrEqual(1);
+            expect(provider1.mockGetMarkets).toHaveBeenCalledTimes(1);
+            expect(provider2.mockGetMarkets).toHaveBeenCalledTimes(1);
+        });
+        it('returns empty array when no providers', async () => {
+            const namespace = new ActionsSwapNamespace({});
+            const result = await namespace.getMarkets({});
+            expect(result).toEqual([]);
+        });
+    });
+    describe('supportedChainIds', () => {
+        it('returns union of chains from all providers', () => {
+            const provider1 = createMockSwapProvider(undefined, {
+                supportedChains: [84532],
+            });
+            const provider2 = new MockSwapProvider(undefined, { supportedChains: [1, 10] }, new MockChainManager({
+                supportedChains: [1, 10],
+            }));
+            const namespace = new ActionsSwapNamespace({
+                uniswap: provider1,
+                velodrome: provider2,
+            });
+            const result = namespace.supportedChainIds();
+            expect(result).toContain(84532);
+            expect(result).toContain(1);
+            expect(result).toContain(10);
+            expect(result.length).toBe(3);
+        });
+        it('deduplicates chain IDs', () => {
+            const provider1 = createMockSwapProvider(undefined, {
+                supportedChains: [84532, 1],
+            });
+            const provider2 = new MockSwapProvider(undefined, {
+                supportedChains: [1],
+            });
+            const namespace = new ActionsSwapNamespace({
+                uniswap: provider1,
+                velodrome: provider2,
+            });
+            const result = namespace.supportedChainIds();
+            // Should have unique values only
+            expect(new Set(result).size).toBe(result.length);
+        });
+    });
+});
+//# sourceMappingURL=BaseSwapNamespace.spec.js.map