@eth-optimism/actions-sdk 0.3.0 → 0.4.0

package/dist/swap/core/markets.d.ts

@@ -0,0 +1,47 @@
+import type { Address } from 'viem';
+import type { SupportedChainId } from '../../constants/supportedChains.js';
+import type { Asset } from '../../types/asset.js';
+import type { GetSwapMarketsParams, SwapMarket, SwapMarketConfig } from '../../types/swap/index.js';
+/**
+ * Sentinel address meaning "send output to msg.sender" in Universal Router commands.
+ * The Universal Router maps address(1) to msg.sender and address(2) to the router itself.
+ * Only valid in Universal Router calldata encoding — do not use as a general-purpose address.
+ * Both Uniswap and Velodrome/Aerodrome Universal Router forks use this convention.
+ * @see https://github.com/Uniswap/universal-router/blob/main/contracts/libraries/Constants.sol
+ */
+export declare const UNIVERSAL_ROUTER_MSG_SENDER: Address;
+/**
+ * Generate unique asset pairs, optionally filtered to pairs containing a required asset.
+ * @param assets - Full list of assets from a market config
+ * @param requiredAsset - If set, only pairs including this asset are returned
+ */
+export declare function assetPairs(assets: Asset[], requiredAsset?: Asset): Array<[Asset, Asset]>;
+/**
+ * Sort two addresses for deterministic pool ID computation.
+ * @returns [lower, higher] addresses
+ */
+export declare function sortAddressPair(addrA: string, addrB: string): [string, string];
+/**
+ * Find a specific market by poolId across a set of configs.
+ * @param configs - Valid market configs to search
+ * @param chainId - Target chain
+ * @param poolId - Pool ID to match
+ * @param toMarkets - Provider-specific function that expands a config into SwapMarket[]
+ * @returns Matching market
+ * @throws If no matching market found
+ */
+export declare function findMarket<T extends SwapMarketConfig>(configs: T[], chainId: SupportedChainId, poolId: string, toMarkets: (config: T, chainId: SupportedChainId) => SwapMarket[]): SwapMarket;
+/**
+ * Expand market configs into concrete SwapMarket objects with optional filters.
+ * @param options.configs - Valid market configs
+ * @param options.filters - Optional chainId and asset filters
+ * @param options.supportedChainIds - All chain IDs this provider supports
+ * @param options.toMarkets - Provider-specific function that expands a config into SwapMarket[]
+ */
+export declare function expandMarkets<T extends SwapMarketConfig>(options: {
+    configs: T[];
+    filters: GetSwapMarketsParams;
+    supportedChainIds: SupportedChainId[];
+    toMarkets: (config: T, chainId: SupportedChainId, asset?: Asset) => SwapMarket[];
+}): SwapMarket[];
+//# sourceMappingURL=markets.d.ts.map

package/dist/swap/core/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../../src/swap/core/markets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EACU,OAAO,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,CAAC,EAAE,KAAK,GACpB,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAMvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,gBAAgB,EACnD,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,KAAK,UAAU,EAAE,GAChE,UAAU,CASZ;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,gBAAgB,EAAE,OAAO,EAAE;IACjE,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,OAAO,EAAE,oBAAoB,CAAA;IAC7B,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;IACrC,SAAS,EAAE,CACT,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,KAAK,KACV,UAAU,EAAE,CAAA;CAClB,GAAG,UAAU,EAAE,CAaf"}

package/dist/swap/core/markets.js

@@ -0,0 +1,65 @@
+/**
+ * Sentinel address meaning "send output to msg.sender" in Universal Router commands.
+ * The Universal Router maps address(1) to msg.sender and address(2) to the router itself.
+ * Only valid in Universal Router calldata encoding — do not use as a general-purpose address.
+ * Both Uniswap and Velodrome/Aerodrome Universal Router forks use this convention.
+ * @see https://github.com/Uniswap/universal-router/blob/main/contracts/libraries/Constants.sol
+ */
+export const UNIVERSAL_ROUTER_MSG_SENDER = '0x0000000000000000000000000000000000000001';
+/**
+ * Generate unique asset pairs, optionally filtered to pairs containing a required asset.
+ * @param assets - Full list of assets from a market config
+ * @param requiredAsset - If set, only pairs including this asset are returned
+ */
+export function assetPairs(assets, requiredAsset) {
+    return assets
+        .flatMap((a, i) => assets.slice(i + 1).map((b) => [a, b]))
+        .filter(([a, b]) => !requiredAsset || a === requiredAsset || b === requiredAsset);
+}
+/**
+ * Sort two addresses for deterministic pool ID computation.
+ * @returns [lower, higher] addresses
+ */
+export function sortAddressPair(addrA, addrB) {
+    return addrA.toLowerCase() < addrB.toLowerCase()
+        ? [addrA, addrB]
+        : [addrB, addrA];
+}
+/**
+ * Find a specific market by poolId across a set of configs.
+ * @param configs - Valid market configs to search
+ * @param chainId - Target chain
+ * @param poolId - Pool ID to match
+ * @param toMarkets - Provider-specific function that expands a config into SwapMarket[]
+ * @returns Matching market
+ * @throws If no matching market found
+ */
+export function findMarket(configs, chainId, poolId, toMarkets) {
+    for (const config of configs) {
+        if (config.chainId !== undefined && config.chainId !== chainId)
+            continue;
+        const match = toMarkets(config, chainId).find((m) => m.marketId.poolId === poolId);
+        if (match)
+            return match;
+    }
+    throw new Error(`Market with poolId ${poolId} not found on chain ${chainId}`);
+}
+/**
+ * Expand market configs into concrete SwapMarket objects with optional filters.
+ * @param options.configs - Valid market configs
+ * @param options.filters - Optional chainId and asset filters
+ * @param options.supportedChainIds - All chain IDs this provider supports
+ * @param options.toMarkets - Provider-specific function that expands a config into SwapMarket[]
+ */
+export function expandMarkets(options) {
+    const { configs, filters, supportedChainIds, toMarkets } = options;
+    return configs.flatMap((config) => {
+        const chainIds = filters.chainId
+            ? [filters.chainId]
+            : config.chainId
+                ? [config.chainId]
+                : supportedChainIds;
+        return chainIds.flatMap((chainId) => toMarkets(config, chainId, filters.asset));
+    });
+}
+//# sourceMappingURL=markets.js.map

package/dist/swap/core/markets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.js","sourceRoot":"","sources":["../../../src/swap/core/markets.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,4CAAuD,CAAA;AAEzD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,MAAe,EACf,aAAqB;IAErB,OAAO,MAAM;SACV,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACzE,MAAM,CACL,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,aAAa,CACzE,CAAA;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,KAAa;IAEb,OAAO,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE;QAC9C,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,OAAY,EACZ,OAAyB,EACzB,MAAc,EACd,SAAiE;IAEjE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;YAAE,SAAQ;QACxE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CACpC,CAAA;QACD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,uBAAuB,OAAO,EAAE,CAAC,CAAA;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAA6B,OASzD;IACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAClE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO;YAC9B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACnB,CAAC,CAAC,MAAM,CAAC,OAAO;gBACd,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBAClB,CAAC,CAAC,iBAAiB,CAAA;QAEvB,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAC1C,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/swap/index.d.ts

@@ -4,4 +4,6 @@ export { BaseSwapNamespace } from './namespaces/BaseSwapNamespace.js';
 export { WalletSwapNamespace } from './namespaces/WalletSwapNamespace.js';
 export type { UniswapMarketConfig, UniswapSwapProviderConfig, } from './providers/uniswap/types.js';
 export { UniswapSwapProvider } from './providers/uniswap/UniswapSwapProvider.js';
+export type { VelodromeMarketConfig, VelodromeSwapProviderConfig, } from './providers/velodrome/types.js';
+export { VelodromeSwapProvider } from './providers/velodrome/VelodromeSwapProvider.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAG9E,YAAY,EACV,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAG9E,YAAY,EACV,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA;AACrF,YAAY,EACV,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAA"}

package/dist/swap/index.js

@@ -5,4 +5,5 @@ export { ActionsSwapNamespace } from './namespaces/ActionsSwapNamespace.js';
 export { BaseSwapNamespace } from './namespaces/BaseSwapNamespace.js';
 export { WalletSwapNamespace } from './namespaces/WalletSwapNamespace.js';
 export { UniswapSwapProvider } from './providers/uniswap/UniswapSwapProvider.js';
+export { VelodromeSwapProvider } from './providers/velodrome/VelodromeSwapProvider.js';
 //# sourceMappingURL=index.js.map

package/dist/swap/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1D,aAAa;AACb,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAO9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE1D,aAAa;AACb,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAO9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAA;AAKrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAA"}

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

@@ -1,7 +1,7 @@
 import { BaseSwapNamespace } from './BaseSwapNamespace.js';
 /**
- * Actions swap namespace (read-only, no wallet required)
- * @description Provides price(), getMarket(), and getMarkets() for read-only access without a wallet
+ * Actions swap namespace (read-only, no wallet required).
+ * Provides getQuote(), getMarket(), and getMarkets() for read-only access without a wallet.
  */
 export declare class ActionsSwapNamespace extends BaseSwapNamespace {
 }

package/dist/swap/namespaces/ActionsSwapNamespace.js

@@ -1,7 +1,7 @@
 import { BaseSwapNamespace } from './BaseSwapNamespace.js';
 /**
- * Actions swap namespace (read-only, no wallet required)
- * @description Provides price(), getMarket(), and getMarkets() for read-only access without a wallet
+ * Actions swap namespace (read-only, no wallet required).
+ * Provides getQuote(), getMarket(), and getMarkets() for read-only access without a wallet.
  */
 export class ActionsSwapNamespace extends BaseSwapNamespace {
 }

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

@@ -1,22 +1,52 @@
 import type { SupportedChainId } from '../../constants/supportedChains.js';
 import type { SwapProvider } from '../core/SwapProvider.js';
-import type { GetSwapMarketParams, GetSwapMarketsParams, SwapMarket, SwapPrice, SwapPriceParams, SwapProviderConfig, SwapProviders } from '../../types/swap/index.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;
-    constructor(providers: SwapProviders);
+    protected readonly settings?: SwapSettings | undefined;
+    constructor(providers: SwapProviders, settings?: SwapSettings | undefined);
     /**
-     * Get price quote for a swap
+     * 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
      */
-    price(params: SwapPriceParams): Promise<SwapPrice>;
+    getQuote(params: SwapQuoteParams): Promise<SwapQuote>;
     /**
-     * Get a specific swap market
-     * @param params - Market identifier
+     * 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): Promise<SwapMarket>;
+    getMarket(params: GetSwapMarketParams, provider?: SwapProviderName): Promise<SwapMarket>;
     /**
      * Get available swap markets across all providers
      * @param params - Optional filtering by chainId or asset
@@ -28,6 +58,16 @@ export declare abstract class BaseSwapNamespace {
      */
     supportedChainIds(): SupportedChainId[];
     protected getAllProviders(): Array<SwapProvider<SwapProviderConfig>>;
-    protected getProvider(): 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

@@ -1 +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,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,uBAAuB,CAAA;AAE9B;;GAEG;AACH,8BAAsB,iBAAiB;IACzB,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa;gBAAxB,SAAS,EAAE,aAAa;IAEvD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAKxD;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKjE;;;;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;IAOpE,SAAS,CAAC,WAAW,IAAI,YAAY,CAAC,kBAAkB,CAAC;CAO1D"}
+{"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

@@ -2,24 +2,108 @@
  * Base swap namespace with shared read-only operations
  */
 export class BaseSwapNamespace {
-    constructor(providers) {
+    constructor(providers, settings) {
         this.providers = providers;
+        this.settings = settings;
     }
     /**
-     * Get price quote for a swap
+     * 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 price(params) {
-        const provider = this.getProvider();
-        return provider.getPrice(params);
+    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
-     * @param params - Market identifier
+     * 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) {
-        const provider = this.getProvider();
-        return provider.getMarket(params);
+    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
@@ -42,17 +126,56 @@ export class BaseSwapNamespace {
         }
         return Array.from(chainIds);
     }
-    // SwapProviders keys are optional (uniswap?, aerodrome?, etc.) so filter out unconfigured ones
+    // SwapProviders keys are optional (uniswap?, velodrome?, etc.) so filter out unconfigured ones
     getAllProviders() {
         return Object.values(this.providers).filter((p) => p !== undefined);
     }
-    // Future: resolve the best provider for given params (e.g. best price across Uniswap, Aerodrome, etc.)
-    getProvider() {
-        const provider = this.providers.uniswap;
-        if (!provider) {
+    /**
+     * 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');
         }
-        return provider;
+        // 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

@@ -1 +1 @@
-{"version":3,"file":"BaseSwapNamespace.js","sourceRoot":"","sources":["../../../src/swap/namespaces/BaseSwapNamespace.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAgB,iBAAiB;IACrC,YAA+B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAE3D;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAuB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QACnC,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAA2B;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QACnC,OAAO,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACnC,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;;OAEG;IACH,iBAAiB;QACf,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAA;QAC5C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBACnD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAED,+FAA+F;IACrF,eAAe;QACvB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CACzC,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,KAAK,SAAS,CAC9D,CAAA;IACH,CAAC;IAED,uGAAuG;IAC7F,WAAW;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAA;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF"}
+{"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

@@ -1,19 +1,31 @@
 import { BaseSwapNamespace } from './BaseSwapNamespace.js';
-import type { SwapProviders, SwapReceipt, WalletSwapParams } from '../../types/swap/index.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 (full operations with signing)
- * @description Provides execute() for swapping tokens
+ * 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);
+    constructor(providers: SwapProviders, wallet: Wallet, settings?: SwapSettings);
     /**
-     * Execute a token swap
-     * @param params - Swap parameters including chainId
+     * 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): Promise<SwapReceipt>;
+    execute(params: WalletSwapParams | SwapQuote): Promise<SwapReceipt>;
+    private buildReceipt;
     /**
      * Execute swap transaction with approval batching
      */

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

@@ -1 +1 @@
-{"version":3,"file":"WalletSwapNamespace.d.ts","sourceRoot":"","sources":["../../../src/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EACV,aAAa,EACb,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;IAKjC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAyB7D;;OAEG;YACW,kBAAkB;CA0BjC"}
+{"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

@@ -1,33 +1,57 @@
+import { QUOTE_DISCRIMINATOR } from '../core/SwapProvider.js';
 import { BaseSwapNamespace } from './BaseSwapNamespace.js';
 /**
- * Wallet swap namespace (full operations with signing)
- * @description Provides execute() for swapping tokens
+ * 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) {
-        super(providers);
+    constructor(providers, wallet, settings) {
+        super(providers, settings);
         this.wallet = wallet;
     }
     /**
-     * Execute a token swap
-     * @param params - Swap parameters including chainId
-     * @returns Swap receipt with transaction details
+     * Get a swap quote with the wallet address as recipient.
+     * Ensures calldata is encoded for the real wallet, not a placeholder.
      */
-    async execute(params) {
-        const provider = this.getProvider();
-        // Build swap transaction
-        const swapTx = await provider.execute({
+    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,
-            walletAddress: this.wallet.address,
+            recipient: params.recipient ?? this.wallet.address,
         });
-        // Execute transaction(s)
+    }
+    /**
+     * 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,
-            amountInWei: swapTx.amountInWei,
-            amountOutWei: swapTx.amountOutWei,
+            amountInRaw: swapTx.amountInRaw,
+            amountOutRaw: swapTx.amountOutRaw,
             assetIn: swapTx.assetIn,
             assetOut: swapTx.assetOut,
             price: swapTx.price,

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

@@ -1 +1 @@
-{"version":3,"file":"WalletSwapNamespace.js","sourceRoot":"","sources":["../../../src/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAS1E;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YACE,SAAwB,EACP,MAAc;QAE/B,KAAK,CAAC,SAAS,CAAC,CAAA;QAFC,WAAM,GAAN,MAAM,CAAQ;IAGjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAwB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAEnC,yBAAyB;QACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YACpC,GAAG,MAAM;YACT,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SACnC,CAAC,CAAA;QAEF,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAErE,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;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,MAAuB,EACvB,OAAyB;QAEzB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA;QAClC,MAAM,GAAG,GAAG,EAAE,CAAA;QAEd,+BAA+B;QAC/B,IAAI,eAAe,CAAC,aAAa,EAAE,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;QACzC,CAAC;QAED,iCAAiC;QACjC,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,CAAA;QAC3C,CAAC;QAED,4BAA4B;QAC5B,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAE9B,8DAA8D;QAC9D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC;CACF"}
+{"version":3,"file":"WalletSwapNamespace.js","sourceRoot":"","sources":["../../../src/swap/namespaces/WalletSwapNamespace.ts"],"names":[],"mappings":"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"}