@eth-optimism/actions-sdk 0.4.0 → 0.6.0

package/dist/{swap → actions/swap}/namespaces/BaseSwapNamespace.js

@@ -1,10 +1,14 @@
+import { BaseNamespace } from '../../shared/BaseNamespace.js';
+import { MarketNotAllowedError, MarketNotFoundError, ProviderNotConfiguredError, } from '../../../core/error/errors.js';
+import { passthroughResolver, } from '../../../services/nameservices/ens/utils.js';
 /**
  * Base swap namespace with shared read-only operations
  */
-export class BaseSwapNamespace {
-    constructor(providers, settings) {
-        this.providers = providers;
+export class BaseSwapNamespace extends BaseNamespace {
+    constructor(providers, resolveRecipient, settings) {
+        super(providers);
         this.settings = settings;
+        this.resolveRecipient = resolveRecipient ?? passthroughResolver;
     }
     /**
      * Get a swap quote with pre-built execution data.
@@ -14,67 +18,35 @@ export class BaseSwapNamespace {
      * @returns The best available SwapQuote
      */
     async getQuote(params) {
+        const recipient = await this.resolveRecipient(params.recipient);
+        const resolved = { ...params, recipient };
         // Explicit provider — skip routing
-        if (params.provider) {
-            const provider = this.resolveProvider(params.provider, params.assetIn, params.assetOut, params.chainId);
-            return provider.getQuote(params);
+        if (resolved.provider) {
+            return this.resolveProvider(resolved.provider, resolved.assetIn, resolved.assetOut, resolved.chainId).getQuote(resolved);
         }
         // Price routing — quote all eligible providers, return best
         if (this.settings?.routing === 'price') {
-            return this.getBestQuote(params);
+            return this.getBestQuote(resolved);
         }
         // No routing — resolve single provider via fallback logic
-        const provider = this.resolveProvider(undefined, params.assetIn, params.assetOut, params.chainId);
-        return provider.getQuote(params);
+        return this.resolveProvider(undefined, resolved.assetIn, resolved.assetOut, resolved.chainId).getQuote(resolved);
     }
     /**
-     * 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.
+     * Fetch quotes from all providers with the wallet address as recipient.
      * 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 recipient = await this.resolveRecipient(params.recipient);
+        const resolved = { ...params, recipient };
+        if (resolved.provider) {
+            return [
+                await this.resolveProvider(resolved.provider, resolved.assetIn, resolved.assetOut, resolved.chainId).getQuote(resolved),
+            ];
         }
-        const quotes = await this.fetchAllQuotes(params);
+        const quotes = await this.fetchAllQuotes(resolved);
         return quotes.sort((a, b) => a.amountOutRaw > b.amountOutRaw
             ? -1
             : a.amountOutRaw < b.amountOutRaw
@@ -91,7 +63,7 @@ export class BaseSwapNamespace {
         if (provider) {
             const named = this.providers[provider];
             if (!named) {
-                throw new Error(`Swap provider "${provider}" not configured`);
+                throw new ProviderNotConfiguredError({ provider });
             }
             return named.getMarket(params);
         }
@@ -103,7 +75,10 @@ export class BaseSwapNamespace {
                 continue;
             }
         }
-        throw new Error(`Market with poolId ${params.poolId} not found on chain ${params.chainId}`);
+        throw new MarketNotFoundError({
+            chainId: params.chainId,
+            poolId: params.poolId,
+        });
     }
     /**
      * Get available swap markets across all providers
@@ -114,22 +89,6 @@ export class BaseSwapNamespace {
         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.
      *
@@ -143,13 +102,13 @@ export class BaseSwapNamespace {
     resolveProvider(provider, assetIn, assetOut, chainId) {
         const allProviders = this.getAllProviders();
         if (allProviders.length === 0) {
-            throw new Error('No swap provider configured');
+            throw new ProviderNotConfiguredError({ provider: 'swap' });
         }
         // 1. Explicit provider param
         if (provider) {
             const named = this.providers[provider];
             if (!named) {
-                throw new Error(`Swap provider "${provider}" not configured`);
+                throw new ProviderNotConfiguredError({ provider });
             }
             return named;
         }
@@ -177,5 +136,50 @@ export class BaseSwapNamespace {
         }
         return allProviders[0];
     }
+    /**
+     * 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 MarketNotAllowedError({
+                assetInSymbol: params.assetIn.metadata.symbol,
+                assetOutSymbol: params.assetOut.metadata.symbol,
+                chainId: params.chainId,
+                reason: 'All providers failed to quote this pair',
+            });
+        }
+        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 MarketNotAllowedError({
+                assetInSymbol: params.assetIn.metadata.symbol,
+                assetOutSymbol: params.assetOut.metadata.symbol,
+                chainId: params.chainId,
+                reason: 'No configured provider supports this pair on this chain',
+            });
+        }
+        const results = await Promise.allSettled(eligible.map((p) => p.getQuote(params)));
+        return results
+            .filter((r) => r.status === 'fulfilled')
+            .map((r) => r.value);
+    }
 }
 //# sourceMappingURL=BaseSwapNamespace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSwapNamespace.js","sourceRoot":"","sources":["../../../../src/actions/swap/namespaces/BaseSwapNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAGjE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,mBAAmB,GAEpB,MAAM,sCAAsC,CAAA;AAe7C;;GAEG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,aAG/C;IAGC,YACE,SAAwB,EACxB,gBAAoC,EACjB,QAAuB;QAE1C,KAAK,CAAC,SAAS,CAAC,CAAA;QAFG,aAAQ,GAAR,QAAQ,CAAe;QAG1C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,IAAI,mBAAmB,CAAA;IACjE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAuB;QACpC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAA4B,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAA;QAElE,mCAAmC;QACnC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,eAAe,CACzB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,CACjB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACtB,CAAC;QAED,4DAA4D;QAC5D,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QACpC,CAAC;QAED,0DAA0D;QAC1D,OAAO,IAAI,CAAC,eAAe,CACzB,SAAS,EACT,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,CACjB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACtB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,MAAuB;QACrC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAA4B,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAA;QAElE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,MAAM,IAAI,CAAC,eAAe,CACxB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,OAAO,CACjB,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACrB,CAAA;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QAClD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1B,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;YAC7B,CAAC,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;gBAC/B,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,CACR,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CACb,MAA2B,EAC3B,QAA2B;QAE3B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,0BAA0B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;YACpD,CAAC;YACD,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAQ;YACV,CAAC;QACH,CAAC;QACD,MAAM,IAAI,mBAAmB,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,SAA+B,EAAE;QAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACxD,CAAA;QACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IAED;;;;;;;;;OASG;IACO,eAAe,CACvB,QAAsC,EACtC,OAAc,EACd,QAAe,EACf,OAAyB;QAEzB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QAC3C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,0BAA0B,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,6BAA6B;QAC7B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,0BAA0B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;YACpD,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,sCAAsC;QACtC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,YAAY,CAAC,CAAC,CAAC,CAAA;QACxB,CAAC;QAED,8DAA8D;QAC9D,IAAI,IAAI,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;YAC9D,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAA;QAC/B,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;gBACpD,OAAO,CAAC,CAAA;YACV,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,CAAA;YACV,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CACxB,MAA+B;QAE/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAEhD,IAAI,IAAI,GAAqB,IAAI,CAAA;QACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpD,IAAI,GAAG,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,qBAAqB,CAAC;gBAC9B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAC7C,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;gBAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,yCAAyC;aAClD,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,cAAc,CAC1B,MAA+B;QAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CACrE,CAAA;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,qBAAqB,CAAC;gBAC9B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAC7C,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;gBAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,yDAAyD;aAClE,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CACxC,CAAA;QAED,OAAO,OAAO;aACX,MAAM,CACL,CAAC,CAAC,EAA0C,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CACxE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,56 @@
+import { BaseSwapNamespace } from './BaseSwapNamespace.js';
+import type { RecipientResolver } from '../../../services/nameservices/ens/utils.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, resolveRecipient?: RecipientResolver, 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). When a pre-built quote is passed, its recipient must
+     * equal this wallet's address — otherwise the calldata would route output
+     * tokens to a different address (a real risk on Velodrome v2/leaf paths
+     * where the recipient is encoded directly into the swap call). Re-quote via
+     * `wallet.swap.getQuote(...)` to bind the quote to this wallet.
+     * @param params - Swap parameters or a pre-built SwapQuote from getQuote()
+     * @returns Swap receipt with transaction details
+     * @throws If `params` is a SwapQuote whose recipient differs from this wallet
+     */
+    execute(params: WalletSwapParams | SwapQuote): Promise<SwapReceipt>;
+    /**
+     * Validate that a pre-built quote is bound to this wallet. Throws when the
+     * quote's recipient differs from `wallet.address` — silently swapping
+     * recipients would route output tokens to the wrong address on routers that
+     * encode the recipient directly into calldata (e.g. Velodrome v2/leaf).
+     */
+    private requireQuoteForThisWallet;
+    /**
+     * Inject `walletAddress` (needed for validation and on-chain allowance
+     * checks) and resolve any ENS recipient so providers only ever receive an
+     * `Address`.
+     */
+    private resolveRawParams;
+    private buildReceipt;
+    /**
+     * Send a swap transaction, collecting any token/Permit2 approvals ahead
+     * of the swap call. Defers to `executeTransactionBatch` for the actual
+     * 1-vs-N send/sendBatch dispatch.
+     */
+    private dispatch;
+}
+//# sourceMappingURL=WalletSwapNamespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletSwapNamespace.d.ts","sourceRoot":"","sources":["../../../../src/actions/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AAGlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAC7E,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;AAG9B,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,gBAAgB,CAAC,EAAE,iBAAiB,EACpC,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;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBzE;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;OAIG;YACW,gBAAgB;IAY9B,OAAO,CAAC,YAAY;IAiBpB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAajB"}

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

@@ -0,0 +1,109 @@
+import { isAddressEqual } from 'viem';
+import { QUOTE_DISCRIMINATOR } from '../core/SwapProvider.js';
+import { BaseSwapNamespace } from './BaseSwapNamespace.js';
+import { executeTransactionBatch } from '../../../wallet/core/utils/executeTransactionBatch.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, resolveRecipient, settings) {
+        super(providers, resolveRecipient, 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). When a pre-built quote is passed, its recipient must
+     * equal this wallet's address — otherwise the calldata would route output
+     * tokens to a different address (a real risk on Velodrome v2/leaf paths
+     * where the recipient is encoded directly into the swap call). Re-quote via
+     * `wallet.swap.getQuote(...)` to bind the quote to this wallet.
+     * @param params - Swap parameters or a pre-built SwapQuote from getQuote()
+     * @returns Swap receipt with transaction details
+     * @throws If `params` is a SwapQuote whose recipient differs from this wallet
+     */
+    async execute(params) {
+        const executeParams = QUOTE_DISCRIMINATOR in params
+            ? this.requireQuoteForThisWallet(params)
+            : await this.resolveRawParams(params);
+        const provider = this.resolveProvider(params.provider, params.assetIn, params.assetOut, params.chainId);
+        const swapTx = await provider.execute(executeParams);
+        const receipt = await this.dispatch(swapTx, params.chainId);
+        return this.buildReceipt(swapTx, receipt);
+    }
+    /**
+     * Validate that a pre-built quote is bound to this wallet. Throws when the
+     * quote's recipient differs from `wallet.address` — silently swapping
+     * recipients would route output tokens to the wrong address on routers that
+     * encode the recipient directly into calldata (e.g. Velodrome v2/leaf).
+     */
+    requireQuoteForThisWallet(quote) {
+        if (!isAddressEqual(quote.recipient, this.wallet.address)) {
+            throw new Error(`SwapQuote was generated for a different recipient (${quote.recipient}). ` +
+                `Re-quote via wallet.swap.getQuote(...) so calldata is bound to this wallet (${this.wallet.address}).`);
+        }
+        return quote;
+    }
+    /**
+     * Inject `walletAddress` (needed for validation and on-chain allowance
+     * checks) and resolve any ENS recipient so providers only ever receive an
+     * `Address`.
+     */
+    async resolveRawParams(params) {
+        return {
+            ...params,
+            walletAddress: this.wallet.address,
+            recipient: await this.resolveRecipient(params.recipient ?? this.wallet.address),
+        };
+    }
+    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,
+        };
+    }
+    /**
+     * Send a swap transaction, collecting any token/Permit2 approvals ahead
+     * of the swap call. Defers to `executeTransactionBatch` for the actual
+     * 1-vs-N send/sendBatch dispatch.
+     */
+    dispatch(swapTx, chainId) {
+        const { transactionData } = swapTx;
+        const txs = [];
+        if (transactionData.tokenApproval)
+            txs.push(transactionData.tokenApproval);
+        if (transactionData.permit2Approval) {
+            txs.push(transactionData.permit2Approval);
+        }
+        txs.push(transactionData.swap);
+        return executeTransactionBatch(this.wallet, txs, chainId);
+    }
+}
+//# sourceMappingURL=WalletSwapNamespace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WalletSwapNamespace.js","sourceRoot":"","sources":["../../../../src/actions/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAA;AAclF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAA;AAGxF;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YACE,SAAwB,EACP,MAAc,EAC/B,gBAAoC,EACpC,QAAuB;QAEvB,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAA;QAJ3B,WAAM,GAAN,MAAM,CAAQ;IAKjC,CAAC;IAED;;;OAGG;IACM,KAAK,CAAC,QAAQ,CAAC,MAAuB;QAC7C,OAAO,KAAK,CAAC,QAAQ,CAAC;YACpB,GAAG,MAAM;YACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;SACnD,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,SAAS,CAAC,MAAuB;QAC9C,OAAO,KAAK,CAAC,SAAS,CAAC;YACrB,GAAG,MAAM;YACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;SACnD,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoC;QAChD,MAAM,aAAa,GACjB,mBAAmB,IAAI,MAAM;YAC3B,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC;YACxC,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CACnC,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,OAAO,CACf,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACpD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAC3D,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;OAKG;IACK,yBAAyB,CAAC,KAAgB;QAChD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,sDAAsD,KAAK,CAAC,SAAS,KAAK;gBACxE,+EAA+E,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CACzG,CAAA;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,gBAAgB,CAC5B,MAAwB;QAExB,OAAO;YACL,GAAG,MAAM;YACT,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAClC,SAAS,EAAE,MAAM,IAAI,CAAC,gBAAgB,CACpC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CACxC;SACF,CAAA;IACH,CAAC;IAEO,YAAY,CAClB,MAAuB,EACvB,OAA+B;QAE/B,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAA;IACH,CAAC;IAED;;;;OAIG;IACK,QAAQ,CACd,MAAuB,EACvB,OAAyB;QAEzB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA;QAClC,MAAM,GAAG,GAAsB,EAAE,CAAA;QACjC,IAAI,eAAe,CAAC,aAAa;YAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;QAC1E,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,CAAA;QAC3C,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC9B,OAAO,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IAC3D,CAAC;CACF"}

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

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

package/dist/{swap → actions/swap}/namespaces/__tests__/BaseSwapNamespace.spec.js

@@ -1,7 +1,7 @@
 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';
+import { MockChainManager } from '../../../../services/__mocks__/MockChainManager.js';
 describe('BaseSwapNamespace', () => {
     const USDC = {
         type: 'erc20',
@@ -36,14 +36,14 @@ describe('BaseSwapNamespace', () => {
                 assetOut: ETH,
                 amountIn: 100,
                 chainId: 84532,
-            })).rejects.toThrow('No swap provider configured');
+            })).rejects.toThrow("A 'swap' provider is not 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 namespace = new ActionsSwapNamespace({ uniswap: cheapProvider, velodrome: expensiveProvider }, undefined, { routing: 'price' });
             const result = await namespace.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,
@@ -57,7 +57,7 @@ describe('BaseSwapNamespace', () => {
             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 namespace = new ActionsSwapNamespace({ uniswap: failingProvider, velodrome: workingProvider }, undefined, { routing: 'price' });
             const result = await namespace.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,
@@ -71,7 +71,7 @@ describe('BaseSwapNamespace', () => {
                 marketAllowlist: [{ assets: [USDC, ETH] }],
             });
             failingProvider.mockGetQuote.mockRejectedValue(new Error('fail'));
-            const namespace = new ActionsSwapNamespace({ uniswap: failingProvider }, { routing: 'price' });
+            const namespace = new ActionsSwapNamespace({ uniswap: failingProvider }, undefined, { routing: 'price' });
             await expect(namespace.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,
@@ -82,7 +82,7 @@ describe('BaseSwapNamespace', () => {
         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 namespace = new ActionsSwapNamespace({ uniswap: cheapProvider, velodrome: expensiveProvider }, undefined, { routing: 'price' });
             const result = await namespace.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,

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

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

package/dist/actions/swap/namespaces/__tests__/WalletSwapNamespace.spec.d.ts.map

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

package/dist/{swap → actions/swap}/namespaces/__tests__/WalletSwapNamespace.spec.js

@@ -96,6 +96,36 @@ describe('WalletSwapNamespace', () => {
                 walletAddress: mockWalletAddress,
             }));
         });
+        it('defaults recipient to wallet address when omitted', async () => {
+            const provider = createMockSwapProvider();
+            const wallet = createMockWallet();
+            const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
+            await namespace.execute({
+                amountIn: 100,
+                assetIn: USDC,
+                assetOut: ETH,
+                chainId: 84532,
+            });
+            expect(provider.mockExecute).toHaveBeenCalledWith(expect.objectContaining({
+                recipient: mockWalletAddress,
+            }));
+        });
+        it('preserves explicit recipient over wallet address', async () => {
+            const provider = createMockSwapProvider();
+            const wallet = createMockWallet();
+            const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
+            const customRecipient = '0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA';
+            await namespace.execute({
+                amountIn: 100,
+                assetIn: USDC,
+                assetOut: ETH,
+                chainId: 84532,
+                recipient: customRecipient,
+            });
+            expect(provider.mockExecute).toHaveBeenCalledWith(expect.objectContaining({
+                recipient: customRecipient,
+            }));
+        });
         it('throws when no provider configured', async () => {
             const wallet = createMockWallet();
             const namespace = new WalletSwapNamespace({}, wallet);
@@ -104,7 +134,7 @@ describe('WalletSwapNamespace', () => {
                 assetIn: USDC,
                 assetOut: ETH,
                 chainId: 84532,
-            })).rejects.toThrow('No swap provider configured');
+            })).rejects.toThrow("A 'swap' provider is not configured");
         });
         it('executes swap from a SwapQuote (skips re-quoting)', async () => {
             const provider = createMockSwapProvider();
@@ -138,7 +168,7 @@ describe('WalletSwapNamespace', () => {
                 chainId: 84532,
             });
             // Quote should have wallet address as the encoded recipient
-            expect(quote.quotedRecipient).toBe(mockWalletAddress);
+            expect(quote.recipient).toBe(mockWalletAddress);
         });
         it('preserves explicit recipient over wallet address', async () => {
             const provider = createMockSwapProvider();
@@ -152,49 +182,83 @@ describe('WalletSwapNamespace', () => {
                 chainId: 84532,
                 recipient: customRecipient,
             });
-            expect(quote.quotedRecipient).toBe(customRecipient);
+            expect(quote.recipient).toBe(customRecipient);
         });
     });
     describe('execute with recipient mismatch', () => {
-        it('re-encodes when quote recipient differs from wallet', async () => {
+        it('throws when quote.recipient does not match wallet.address', async () => {
             const provider = createMockSwapProvider();
             const wallet = createMockWallet();
             const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
-            // Get quote without wallet (simulates ActionsSwapNamespace quote)
+            // Get quote without wallet (simulates ActionsSwapNamespace quote — recipient
+            // defaults to UNIVERSAL_ROUTER_MSG_SENDER, not the executing wallet)
             const quote = await provider.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,
                 amountIn: 100,
                 chainId: 84532,
-                // No recipient — uses placeholder
             });
-            // quotedRecipient should be the placeholder, not the wallet
-            expect(quote.quotedRecipient).not.toBe(mockWalletAddress);
-            // Execute through wallet namespace — should re-quote with correct recipient
-            const result = await namespace.execute(quote);
-            expect(result.price).toBeDefined();
-            // Provider's getQuote should have been called twice:
-            // 1) original quote, 2) re-quote with wallet address
-            expect(provider.mockGetQuote).toHaveBeenCalledTimes(2);
+            expect(quote.recipient).not.toBe(mockWalletAddress);
+            await expect(namespace.execute(quote)).rejects.toThrow(/generated for a different recipient/i);
+            // Provider's getQuote was called once (the original); execute did not re-quote.
+            expect(provider.mockGetQuote).toHaveBeenCalledTimes(1);
+        });
+        it('throws on a quote built for a different wallet address', async () => {
+            const provider = createMockSwapProvider();
+            const wallet = createMockWallet();
+            const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
+            const otherWallet = '0x9999999999999999999999999999999999999999';
+            const quote = await provider.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+                recipient: otherWallet,
+            });
+            expect(quote.recipient).toBe(otherWallet);
+            await expect(namespace.execute(quote)).rejects.toThrow(/generated for a different recipient/i);
         });
-        it('skips re-encode when quote already has correct recipient', async () => {
+        it('executes when quote.recipient equals wallet.address', async () => {
             const provider = createMockSwapProvider();
             const wallet = createMockWallet();
             const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
-            // Get quote through wallet namespace (has correct recipient)
             const quote = await namespace.getQuote({
                 assetIn: USDC,
                 assetOut: ETH,
                 amountIn: 100,
                 chainId: 84532,
             });
-            expect(quote.quotedRecipient).toBe(mockWalletAddress);
-            // Execute — should NOT re-quote
+            expect(quote.recipient).toBe(mockWalletAddress);
             const result = await namespace.execute(quote);
             expect(result.price).toBeDefined();
-            // getQuote called only once (the original)
+            // Single getQuote call — no re-quote, no re-encode.
             expect(provider.mockGetQuote).toHaveBeenCalledTimes(1);
         });
+        it('executes when quote.recipient differs only in case from wallet.address', async () => {
+            // Address with hex letters so case actually changes the string. The
+            // wallet uses checksummed casing; the quote uses lowercase. Without
+            // `isAddressEqual` the strict `!==` would falsely reject.
+            const checksummedAddress = '0xAbCdEf1234567890aBcDeF1234567890ABcDeF12';
+            const lowercaseAddress = checksummedAddress.toLowerCase();
+            const provider = createMockSwapProvider();
+            const wallet = {
+                address: checksummedAddress,
+                send: vi.fn().mockResolvedValue({ transactionHash: '0xtx1' }),
+                sendBatch: vi.fn().mockResolvedValue({ transactionHash: '0xtx2' }),
+            };
+            const namespace = new WalletSwapNamespace({ uniswap: provider }, wallet);
+            const quote = await provider.getQuote({
+                assetIn: USDC,
+                assetOut: ETH,
+                amountIn: 100,
+                chainId: 84532,
+                recipient: lowercaseAddress,
+            });
+            expect(quote.recipient).toBe(lowercaseAddress);
+            expect(quote.recipient).not.toBe(checksummedAddress);
+            const result = await namespace.execute(quote);
+            expect(result.price).toBeDefined();
+        });
     });
     describe('inherits read-only methods', () => {
         it('has getMarkets method from BaseSwapNamespace', async () => {