@eth-optimism/actions-sdk 0.3.0 → 0.5.0

package/dist/swap/providers/uniswap/encoding.d.ts

@@ -20,8 +20,8 @@ interface ResolvedPoolParams {
 export interface GetQuoteParams {
     assetIn: Asset;
     assetOut: Asset;
-    amountInWei?: bigint;
-    amountOutWei?: bigint;
+    amountInRaw?: bigint;
+    amountOutRaw?: bigint;
     chainId: SupportedChainId;
     publicClient: PublicClient;
     quoterAddress: Address;
@@ -36,8 +36,8 @@ export interface GetQuoteParams {
  */
 export declare function getQuote(params: GetQuoteParams): Promise<SwapPrice>;
 export interface EncodeSwapParams {
-    amountInWei?: bigint;
-    amountOutWei?: bigint;
+    amountInRaw?: bigint;
+    amountOutRaw?: bigint;
     assetIn: Asset;
     assetOut: Asset;
     slippage: number;

package/dist/swap/providers/uniswap/encoding.js

@@ -35,9 +35,9 @@ function resolvePoolParams(assetIn, assetOut, chainId, fee, tickSpacing) {
  * Get a swap quote from the Quoter contract
  */
 export async function getQuote(params) {
-    const { assetIn, assetOut, amountInWei, amountOutWei, chainId, publicClient, quoterAddress, poolManagerAddress, fee, tickSpacing, } = params;
+    const { assetIn, assetOut, amountInRaw, amountOutRaw, chainId, publicClient, quoterAddress, poolManagerAddress, fee, tickSpacing, } = params;
     const { tokenIn, zeroForOne, poolKey } = resolvePoolParams(assetIn, assetOut, chainId, fee, tickSpacing);
-    const isExactInput = amountInWei !== undefined;
+    const isExactInput = amountInRaw !== undefined;
     // Read pool mid-price and quote in parallel — no extra sequential RPC call
     const [sqrtPriceX96, quoteResult] = await Promise.all([
         getPoolSqrtPrice({ publicClient, poolManagerAddress, poolKey }),
@@ -50,7 +50,7 @@ export async function getQuote(params) {
                     {
                         poolKey,
                         zeroForOne,
-                        exactAmount: amountInWei,
+                        exactAmount: amountInRaw,
                         hookData: '0x',
                     },
                 ],
@@ -63,14 +63,14 @@ export async function getQuote(params) {
                     {
                         poolKey,
                         zeroForOne,
-                        exactAmount: amountOutWei,
+                        exactAmount: amountOutRaw,
                         hookData: '0x',
                     },
                 ],
             }),
     ]);
-    const amountIn = isExactInput ? amountInWei : quoteResult.result[0];
-    const amountOut = isExactInput ? quoteResult.result[0] : amountOutWei;
+    const amountIn = isExactInput ? amountInRaw : quoteResult.result[0];
+    const amountOut = isExactInput ? quoteResult.result[0] : amountOutRaw;
     const gasEstimate = quoteResult.result[1];
     const price = calculatePrice(amountIn, amountOut, assetIn, assetOut);
     const priceInverse = calculatePrice(amountOut, amountIn, assetOut, assetIn);
@@ -95,8 +95,8 @@ export async function getQuote(params) {
         priceInverse,
         amountIn: parseFloat(formatUnits(amountIn, assetIn.metadata.decimals)),
         amountOut: parseFloat(formatUnits(amountOut, assetOut.metadata.decimals)),
-        amountInWei: amountIn,
-        amountOutWei: amountOut,
+        amountInRaw: amountIn,
+        amountOutRaw: amountOut,
         priceImpact,
         route,
         gasEstimate,
@@ -114,13 +114,13 @@ const TAKE_ALL = 0x0f;
  * @description Builds calldata for executing a V4 swap through Universal Router
  */
 export function encodeUniversalRouterSwap(params) {
-    const { amountInWei, assetIn, assetOut, slippage, deadline, chainId, quote, fee, tickSpacing, } = params;
+    const { amountInRaw, assetIn, assetOut, slippage, deadline, chainId, quote, fee, tickSpacing, } = params;
     const { tokenIn, tokenOut, zeroForOne, poolKey } = resolvePoolParams(assetIn, assetOut, chainId, fee, tickSpacing);
-    const isExactInput = amountInWei !== undefined;
+    const isExactInput = amountInRaw !== undefined;
     let actions;
     let actionParams;
     if (isExactInput) {
-        const minAmountOut = (quote.amountOutWei * BigInt(Math.round((1 - slippage) * 10000))) / 10000n;
+        const minAmountOut = (quote.amountOutRaw * BigInt(Math.round((1 - slippage) * 10000))) / 10000n;
         actions =
             `0x${[SWAP_EXACT_IN_SINGLE, SETTLE_ALL, TAKE_ALL].map((a) => a.toString(16).padStart(2, '0')).join('')}`;
         actionParams = [
@@ -128,18 +128,18 @@ export function encodeUniversalRouterSwap(params) {
                 {
                     poolKey,
                     zeroForOne,
-                    amountIn: amountInWei,
+                    amountIn: amountInRaw,
                     amountOutMinimum: minAmountOut,
                     hookData: '0x',
                 },
             ]),
-            encodeAbiParameters(CURRENCY_AMOUNT_PARAMS, [tokenIn, amountInWei]),
+            encodeAbiParameters(CURRENCY_AMOUNT_PARAMS, [tokenIn, amountInRaw]),
             encodeAbiParameters(CURRENCY_AMOUNT_PARAMS, [tokenOut, minAmountOut]),
         ];
     }
     else {
-        const maxAmountIn = quote.amountInWei +
-            (quote.amountInWei * BigInt(Math.round(slippage * 10000))) / 10000n;
+        const maxAmountIn = quote.amountInRaw +
+            (quote.amountInRaw * BigInt(Math.round(slippage * 10000))) / 10000n;
         actions =
             `0x${[SWAP_EXACT_OUT_SINGLE, SETTLE_ALL, TAKE_ALL].map((a) => a.toString(16).padStart(2, '0')).join('')}`;
         actionParams = [
@@ -147,7 +147,7 @@ export function encodeUniversalRouterSwap(params) {
                 {
                     poolKey,
                     zeroForOne,
-                    amountOut: quote.amountOutWei,
+                    amountOut: quote.amountOutRaw,
                     amountInMaximum: maxAmountIn,
                     hookData: '0x',
                 },
@@ -155,7 +155,7 @@ export function encodeUniversalRouterSwap(params) {
             encodeAbiParameters(CURRENCY_AMOUNT_PARAMS, [tokenIn, maxAmountIn]),
             encodeAbiParameters(CURRENCY_AMOUNT_PARAMS, [
                 tokenOut,
-                quote.amountOutWei,
+                quote.amountOutRaw,
             ]),
         ];
     }

package/dist/swap/providers/uniswap/markets.d.ts

@@ -0,0 +1,19 @@
+import type { SupportedChainId } from '../../../constants/supportedChains.js';
+import type { Asset } from '../../../types/asset.js';
+import type { SwapMarket } from '../../../types/swap/index.js';
+import type { UniswapMarketConfig } from './types.js';
+/** Validated Uniswap market config with required fee and tickSpacing */
+export type ValidUniswapConfig = UniswapMarketConfig & {
+    fee: number;
+    tickSpacing: number;
+};
+/**
+ * Filter market allowlist to configs with required fee and tickSpacing.
+ */
+export declare function getValidMarketConfigs(allowlist?: UniswapMarketConfig[]): ValidUniswapConfig[];
+/**
+ * Expand a single UniswapMarketConfig into SwapMarket objects for a given chain.
+ * Used as the `toMarkets` callback for shared findMarket/expandMarkets.
+ */
+export declare function configToMarkets(config: ValidUniswapConfig, chainId: SupportedChainId, asset?: Asset): SwapMarket[];
+//# sourceMappingURL=markets.d.ts.map

package/dist/swap/providers/uniswap/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../../../src/swap/providers/uniswap/markets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,mBAAmB,EAAE,GAChC,kBAAkB,EAAE,CAKtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,KAAK,GACZ,UAAU,EAAE,CAMd"}

package/dist/swap/providers/uniswap/markets.js

@@ -0,0 +1,48 @@
+import { encodeAbiParameters, keccak256 } from 'viem';
+import { UNISWAP } from '../../../constants/providers.js';
+import { assetPairs } from '../../core/markets.js';
+import { POOL_KEY_ABI_TYPE } from './abis.js';
+/**
+ * Filter market allowlist to configs with required fee and tickSpacing.
+ */
+export function getValidMarketConfigs(allowlist) {
+    return (allowlist ?? []).filter((f) => f.fee !== undefined && f.tickSpacing !== undefined);
+}
+/**
+ * Expand a single UniswapMarketConfig into SwapMarket objects for a given chain.
+ * Used as the `toMarkets` callback for shared findMarket/expandMarkets.
+ */
+export function configToMarkets(config, chainId, asset) {
+    return assetPairs(config.assets, asset)
+        .map(([a, b]) => pairToMarket(a, b, chainId, config.fee, config.tickSpacing))
+        .filter((m) => m !== null);
+}
+/**
+ * Build a SwapMarket from two assets and V4 pool parameters.
+ * Computes a deterministic poolId from the sorted pool key.
+ * @returns SwapMarket, or null if either asset lacks an address on this chain
+ */
+function pairToMarket(assetA, assetB, chainId, fee, tickSpacing) {
+    const addrA = assetA.address[chainId];
+    const addrB = assetB.address[chainId];
+    if (!addrA || addrA === 'native' || !addrB || addrB === 'native')
+        return null;
+    const [currency0, currency1] = addrA.toLowerCase() < addrB.toLowerCase() ? [addrA, addrB] : [addrB, addrA];
+    // V4 requires currency0 < currency1 for deterministic pool keys
+    // PoolId = keccak256(abi.encode(PoolKey)) per V4's PoolIdLibrary
+    // @see https://github.com/Uniswap/v4-core/blob/main/src/types/PoolId.sol
+    const poolId = keccak256(encodeAbiParameters(POOL_KEY_ABI_TYPE, [
+        currency0,
+        currency1,
+        fee,
+        tickSpacing,
+        '0x0000000000000000000000000000000000000000',
+    ]));
+    return {
+        marketId: { poolId, chainId },
+        assets: [assetA, assetB],
+        fee,
+        provider: UNISWAP,
+    };
+}
+//# sourceMappingURL=markets.js.map

package/dist/swap/providers/uniswap/markets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.js","sourceRoot":"","sources":["../../../../src/swap/providers/uniswap/markets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AAYpE;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiC;IAEjC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAC7B,CAAC,CAAC,EAA2B,EAAE,CAC7B,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,CACrD,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,OAAyB,EACzB,KAAa;IAEb,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACd,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAC5D;SACA,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CACnB,MAAa,EACb,MAAa,EACb,OAAyB,EACzB,GAAW,EACX,WAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE7E,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAC1B,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAE7E,gEAAgE;IAChE,iEAAiE;IACjE,yEAAyE;IACzE,MAAM,MAAM,GAAG,SAAS,CACtB,mBAAmB,CAAC,iBAAiB,EAAE;QACrC,SAAoB;QACpB,SAAoB;QACpB,GAAG;QACH,WAAW;QACX,4CAAuD;KACxD,CAAC,CACH,CAAA;IAED,OAAO;QACL,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,GAAG;QACH,QAAQ,EAAE,OAAO;KAClB,CAAA;AACH,CAAC"}

package/dist/swap/providers/uniswap/types.d.ts

@@ -9,12 +9,13 @@ export interface UniswapMarketConfig extends SwapMarketConfig {
     tickSpacing?: number;
 }
 /**
- * Uniswap swap provider configuration
+ * Uniswap swap provider configuration.
+ * Provider-level values override the shared SwapGlobalConfig.
  */
 export interface UniswapSwapProviderConfig extends SwapProviderConfig {
     marketAllowlist?: UniswapMarketConfig[];
     marketBlocklist?: UniswapMarketConfig[];
-    /** Permit2 approval expiry in seconds from now. Defaults to 30 days. */
-    permit2ExpirySeconds?: number;
+    /** Permit2 sub-approval expiration override in seconds from now. */
+    permit2ExpirationSeconds?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/swap/providers/uniswap/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/swap/providers/uniswap/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,uBAAuB,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACvC,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACvC,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/swap/providers/uniswap/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,uBAAuB,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACvC,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACvC,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC"}

package/dist/swap/providers/velodrome/VelodromeSwapProvider.d.ts

@@ -0,0 +1,50 @@
+import type { SupportedChainId } from '../../../constants/supportedChains.js';
+import type { SwapQuoteParamsResolved } from '../../../ens/types.js';
+import { SwapProvider } from '../../core/SwapProvider.js';
+import type { VelodromeSwapProviderConfig } from './types.js';
+import type { GetSwapMarketParams, GetSwapMarketsParams, ResolvedSwapParams, SwapMarket, SwapQuote, SwapTransaction } from '../../../types/swap/index.js';
+/**
+ * Velodrome/Aerodrome swap provider for OP Stack chains.
+ * Supports v2 AMM pools, CL/Slipstream concentrated liquidity pools,
+ * v2 routers (Optimism, Base), leaf routers (Relay chains), and Universal Router (Base Sepolia).
+ */
+export declare class VelodromeSwapProvider extends SwapProvider<VelodromeSwapProviderConfig> {
+    /** @returns Chain IDs where Velodrome/Aerodrome contracts are deployed */
+    protocolSupportedChainIds(): SupportedChainId[];
+    /**
+     * Build a swap transaction from raw parameters.
+     * @param params - Resolved swap parameters (amounts as raw bigint, defaults applied)
+     * @returns Transaction data ready for wallet execution
+     * @throws If amountOut is provided (Velodrome only supports exact-input swaps)
+     */
+    protected _execute(params: ResolvedSwapParams): Promise<SwapTransaction>;
+    /**
+     * Find a specific market by poolId from the allowlist.
+     * @param params - Pool ID and chain to look up
+     * @returns Matching market
+     * @throws If no matching market found in config
+     */
+    protected _getMarket(params: GetSwapMarketParams): Promise<SwapMarket>;
+    /**
+     * Expand the market allowlist into concrete SwapMarket objects.
+     * @param params - Optional filters (chainId, asset)
+     * @returns All configured markets matching the filters
+     */
+    protected _getMarkets(params: GetSwapMarketsParams): Promise<SwapMarket[]>;
+    /**
+     * Get a full swap quote with pricing, slippage bounds, and pre-built execution data.
+     * @param params - Quote parameters (assets, amounts, chain, slippage, deadline)
+     * @returns SwapQuote with amounts, price, route, and encoded calldata
+     * @throws If amountOut is provided (Velodrome only supports exact-input)
+     */
+    protected _getQuote(params: SwapQuoteParamsResolved): Promise<SwapQuote>;
+    protected _buildApprovals(quote: SwapQuote): Promise<{
+        tokenApproval: import("../../../index.js").TransactionData | undefined;
+    }>;
+    /**
+     * Resolve market config to a discriminated pool config.
+     * @throws If pair not in allowlist, or has both/neither stable and tickSpacing
+     */
+    private resolveVelodromeMarketConfig;
+}
+//# sourceMappingURL=VelodromeSwapProvider.d.ts.map

package/dist/swap/providers/velodrome/VelodromeSwapProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VelodromeSwapProvider.d.ts","sourceRoot":"","sources":["../../../../src/swap/providers/velodrome/VelodromeSwapProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAe1D,OAAO,KAAK,EAEV,2BAA2B,EAC5B,MAAM,qCAAqC,CAAA;AAE5C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAG9B;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,YAAY,CAAC,2BAA2B,CAAC;IAClF,0EAA0E;IAC1E,yBAAyB,IAAI,gBAAgB,EAAE;IAI/C;;;;;OAKG;cACa,QAAQ,CACtB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,eAAe,CAAC;IAuB3B;;;;;OAKG;cACa,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAS5E;;;;OAIG;cACa,WAAW,CACzB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;IASxB;;;;;OAKG;cACa,SAAS,CACvB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,SAAS,CAAC;cAuEL,eAAe,CAAC,KAAK,EAAE,SAAS;;;IAkBhD;;;OAGG;IACH,OAAO,CAAC,4BAA4B;CAerC"}

package/dist/swap/providers/velodrome/VelodromeSwapProvider.js

@@ -0,0 +1,140 @@
+import { formatUnits } from 'viem';
+import { VELODROME } from '../../../constants/providers.js';
+import { expandMarkets, findMarket } from '../../core/markets.js';
+import { SwapProvider } from '../../core/SwapProvider.js';
+import { getChainConfig, getSupportedChainIds, getValidMarketConfigs, } from './config.js';
+import { buildTokenApproval, encodePoolSwap, fetchPoolQuote, } from './encoding/index.js';
+import { configToMarkets, resolvePoolConfig, } from './markets.js';
+import { getAssetAddress, isNativeAsset } from '../../../utils/assets.js';
+/**
+ * Velodrome/Aerodrome swap provider for OP Stack chains.
+ * Supports v2 AMM pools, CL/Slipstream concentrated liquidity pools,
+ * v2 routers (Optimism, Base), leaf routers (Relay chains), and Universal Router (Base Sepolia).
+ */
+export class VelodromeSwapProvider extends SwapProvider {
+    /** @returns Chain IDs where Velodrome/Aerodrome contracts are deployed */
+    protocolSupportedChainIds() {
+        return getSupportedChainIds();
+    }
+    /**
+     * Build a swap transaction from raw parameters.
+     * @param params - Resolved swap parameters (amounts as raw bigint, defaults applied)
+     * @returns Transaction data ready for wallet execution
+     * @throws If amountOut is provided (Velodrome only supports exact-input swaps)
+     */
+    async _execute(params) {
+        if (params.amountOutRaw !== undefined) {
+            throw new Error('Velodrome/Aerodrome does not support exact-output swaps. Provide amountIn instead of amountOut.');
+        }
+        const swapQuote = await this._getQuote({
+            assetIn: params.assetIn,
+            assetOut: params.assetOut,
+            amountIn: params.amountInRaw
+                ? parseFloat(formatUnits(params.amountInRaw, params.assetIn.metadata.decimals))
+                : undefined,
+            chainId: params.chainId,
+            slippage: params.slippage,
+            deadline: params.deadline,
+            recipient: params.recipient,
+        });
+        return this.buildSwapTransactions(swapQuote);
+    }
+    /**
+     * Find a specific market by poolId from the allowlist.
+     * @param params - Pool ID and chain to look up
+     * @returns Matching market
+     * @throws If no matching market found in config
+     */
+    async _getMarket(params) {
+        return findMarket(getValidMarketConfigs(this._config.marketAllowlist), params.chainId, params.poolId, configToMarkets);
+    }
+    /**
+     * Expand the market allowlist into concrete SwapMarket objects.
+     * @param params - Optional filters (chainId, asset)
+     * @returns All configured markets matching the filters
+     */
+    async _getMarkets(params) {
+        return expandMarkets({
+            configs: getValidMarketConfigs(this._config.marketAllowlist),
+            filters: params,
+            supportedChainIds: this.supportedChainIds(),
+            toMarkets: configToMarkets,
+        });
+    }
+    /**
+     * Get a full swap quote with pricing, slippage bounds, and pre-built execution data.
+     * @param params - Quote parameters (assets, amounts, chain, slippage, deadline)
+     * @returns SwapQuote with amounts, price, route, and encoded calldata
+     * @throws If amountOut is provided (Velodrome only supports exact-input)
+     */
+    async _getQuote(params) {
+        const { chainId, assetIn, assetOut } = params;
+        if (params.amountOut !== undefined) {
+            throw new Error('Velodrome/Aerodrome does not support exact-output swaps. Provide amountIn instead of amountOut.');
+        }
+        const chain = getChainConfig(chainId);
+        const publicClient = this.chainManager.getPublicClient(chainId);
+        const poolConfig = this.resolveVelodromeMarketConfig(assetIn, assetOut, chainId);
+        const { slippage, now, deadline, recipient, amountInRaw } = this.resolveQuoteDefaults(params);
+        const { internalQuote, providerContext } = await fetchPoolQuote(poolConfig, { assetIn, assetOut, amountInRaw, chainId, publicClient, chain });
+        const { amountOutMinRaw, amountOutMin } = this.computeSlippageBounds(internalQuote.amountOutRaw, slippage, assetOut);
+        const swapCalldata = encodePoolSwap(poolConfig, {
+            assetIn,
+            assetOut,
+            amountInRaw,
+            amountOutMinRaw,
+            recipient,
+            deadline,
+            chainId,
+            chain,
+        });
+        return {
+            assetIn,
+            assetOut,
+            chainId,
+            amountIn: internalQuote.amountIn,
+            amountInRaw,
+            amountOut: internalQuote.amountOut,
+            amountOutRaw: internalQuote.amountOutRaw,
+            amountOutMin,
+            amountOutMinRaw,
+            price: internalQuote.amountOut / internalQuote.amountIn,
+            priceInverse: internalQuote.amountIn / internalQuote.amountOut,
+            priceImpact: internalQuote.priceImpact,
+            route: internalQuote.route,
+            execution: {
+                swapCalldata,
+                routerAddress: chain.contracts.router,
+                value: isNativeAsset(assetIn) ? amountInRaw : 0n,
+                providerContext,
+            },
+            provider: VELODROME,
+            slippage,
+            deadline,
+            quotedAt: now,
+            expiresAt: deadline,
+            gasEstimate: internalQuote.gasEstimate,
+            quotedRecipient: recipient,
+        };
+    }
+    async _buildApprovals(quote) {
+        const chain = getChainConfig(quote.chainId);
+        const publicClient = this.chainManager.getPublicClient(quote.chainId);
+        const tokenApproval = isNativeAsset(quote.assetIn)
+            ? undefined
+            : await buildTokenApproval(getAssetAddress(quote.assetIn, quote.chainId), chain.contracts.router, chain.metadata.routerType, quote.amountInRaw, quote.recipient, publicClient);
+        return { tokenApproval };
+    }
+    /**
+     * Resolve market config to a discriminated pool config.
+     * @throws If pair not in allowlist, or has both/neither stable and tickSpacing
+     */
+    resolveVelodromeMarketConfig(assetIn, assetOut, chainId) {
+        const config = this.resolveMarketConfig(assetIn, assetOut, chainId);
+        if (!config) {
+            throw new Error(`No market config for pair ${assetIn.metadata.symbol}/${assetOut.metadata.symbol}`);
+        }
+        return resolvePoolConfig(config);
+    }
+}
+//# sourceMappingURL=VelodromeSwapProvider.js.map

package/dist/swap/providers/velodrome/VelodromeSwapProvider.js.map

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

package/dist/swap/providers/velodrome/__tests__/VelodromeSwapProvider.network.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=VelodromeSwapProvider.network.test.d.ts.map

package/dist/swap/providers/velodrome/__tests__/VelodromeSwapProvider.network.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VelodromeSwapProvider.network.test.d.ts","sourceRoot":"","sources":["../../../../../src/swap/providers/velodrome/__tests__/VelodromeSwapProvider.network.test.ts"],"names":[],"mappings":""}