@eth-optimism/actions-sdk 0.3.0 → 0.5.0

package/dist/services/tokenBalance.js

@@ -1,31 +1,35 @@
 import { erc20Abi, formatEther, formatUnits } from 'viem';
+import { ETH } from '../constants/assets.js';
 /**
  * Fetch ETH balance across all supported chains
  * @param chainManager - The chain manager
  * @param walletAddress - The wallet address
- * @returns Promise resolving to array of ETH balances
+ * @returns Promise resolving to ETH balance
  */
 export async function fetchETHBalance(chainManager, walletAddress) {
     const supportedChains = chainManager.getSupportedChains();
     const chainBalancePromises = supportedChains.map(async (chainId) => {
         const publicClient = chainManager.getPublicClient(chainId);
-        const balance = await publicClient.getBalance({
+        const balanceRaw = await publicClient.getBalance({
             address: walletAddress,
         });
         return {
             chainId,
-            balance,
-            tokenAddress: 'native',
-            formattedBalance: formatEther(balance),
+            balanceRaw,
+            balance: parseFloat(formatEther(balanceRaw)),
         };
     });
-    const chainBalances = await Promise.all(chainBalancePromises);
-    const totalBalance = chainBalances.reduce((total, { balance }) => total + balance, 0n);
+    const chainResults = await Promise.all(chainBalancePromises);
+    const totalBalanceRaw = chainResults.reduce((total, { balanceRaw }) => total + balanceRaw, 0n);
+    const chains = {};
+    for (const { chainId, balance, balanceRaw } of chainResults) {
+        chains[chainId] = { balance, balanceRaw };
+    }
     return {
-        symbol: 'ETH',
-        totalBalance,
-        totalFormattedBalance: formatEther(totalBalance),
-        chainBalances,
+        asset: ETH,
+        totalBalance: parseFloat(formatEther(totalBalanceRaw)),
+        totalBalanceRaw,
+        chains,
     };
 }
 /**
@@ -35,27 +39,30 @@ export async function fetchERC20Balance(chainManager, walletAddress, asset) {
     const supportedChains = chainManager.getSupportedChains();
     const chainsWithToken = supportedChains.filter((chainId) => asset.address[chainId]);
     const chainBalancePromises = chainsWithToken.map(async (chainId) => {
-        const { balance, tokenAddress } = await fetchERC20BalanceForChain(asset, chainId, walletAddress, chainManager);
+        const balanceRaw = await fetchBalanceForChain(asset, chainId, walletAddress, chainManager);
         return {
             chainId,
-            balance,
-            tokenAddress,
-            formattedBalance: formatUnits(balance, asset.metadata.decimals),
+            balanceRaw,
+            balance: parseFloat(formatUnits(balanceRaw, asset.metadata.decimals)),
         };
     });
-    const chainBalances = await Promise.all(chainBalancePromises);
-    const totalBalance = chainBalances.reduce((total, { balance }) => total + balance, 0n);
+    const chainResults = await Promise.all(chainBalancePromises);
+    const totalBalanceRaw = chainResults.reduce((total, { balanceRaw }) => total + balanceRaw, 0n);
+    const chains = {};
+    for (const { chainId, balance, balanceRaw } of chainResults) {
+        chains[chainId] = { balance, balanceRaw };
+    }
     return {
-        symbol: asset.metadata.symbol,
-        totalBalance,
-        totalFormattedBalance: formatUnits(totalBalance, asset.metadata.decimals),
-        chainBalances,
+        asset,
+        totalBalance: parseFloat(formatUnits(totalBalanceRaw, asset.metadata.decimals)),
+        totalBalanceRaw,
+        chains,
     };
 }
 /**
  * Fetch balance for this asset on a specific chain
  */
-async function fetchERC20BalanceForChain(asset, chainId, walletAddress, chainManager) {
+async function fetchBalanceForChain(asset, chainId, walletAddress, chainManager) {
     const tokenAddress = asset.address[chainId];
     if (!tokenAddress) {
         throw new Error(`${asset.metadata.symbol} not supported on chain ${chainId}`);
@@ -63,19 +70,13 @@ async function fetchERC20BalanceForChain(asset, chainId, walletAddress, chainMan
     const publicClient = chainManager.getPublicClient(chainId);
     // Handle native ETH balance
     if (asset.type === 'native' || tokenAddress === 'native') {
-        return {
-            balance: await publicClient.getBalance({
-                address: walletAddress,
-            }),
-            tokenAddress: 'native',
-        };
+        return publicClient.getBalance({ address: walletAddress });
     }
-    const balance = await publicClient.readContract({
+    return publicClient.readContract({
         address: tokenAddress,
         abi: erc20Abi,
         functionName: 'balanceOf',
         args: [walletAddress],
     });
-    return { balance, tokenAddress };
 }
 //# sourceMappingURL=tokenBalance.js.map

package/dist/services/tokenBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenBalance.js","sourceRoot":"","sources":["../../src/services/tokenBalance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tokenBalance.js","sourceRoot":"","sources":["../../src/services/tokenBalance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAEzD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAK3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAA0B,EAC1B,aAAsB;IAEtB,MAAM,eAAe,GAAG,YAAY,CAAC,kBAAkB,EAAE,CAAA;IACzD,MAAM,oBAAoB,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,YAAY,GAAG,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QAC1D,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC;YAC/C,OAAO,EAAE,aAAa;SACvB,CAAC,CAAA;QACF,OAAO;YACL,OAAO;YACP,UAAU;YACV,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;SAC7C,CAAA;IACH,CAAC,CAAC,CAAA;IACF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAC5D,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,UAAU,EAC7C,EAAE,CACH,CAAA;IAED,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,YAAY,EAAE,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG;QACV,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QACtD,eAAe;QACf,MAAM;KACP,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAA0B,EAC1B,aAAsB,EACtB,KAAY;IAEZ,MAAM,eAAe,GAAG,YAAY,CAAC,kBAAkB,EAAE,CAAA;IACzD,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAC5C,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CACpC,CAAA;IAED,MAAM,oBAAoB,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAC3C,KAAK,EACL,OAAO,EACP,aAAa,EACb,YAAY,CACb,CAAA;QACD,OAAO;YACL,OAAO;YACP,UAAU;YACV,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SACtE,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAC5D,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,UAAU,EAC7C,EAAE,CACH,CAAA;IAED,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,YAAY,EAAE,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,KAAK;QACL,YAAY,EAAE,UAAU,CACtB,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACtD;QACD,eAAe;QACf,MAAM;KACP,CAAA;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CACjC,KAAY,EACZ,OAAyB,EACzB,aAAsB,EACtB,YAA0B;IAE1B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,2BAA2B,OAAO,EAAE,CAC7D,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAE1D,4BAA4B;IAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,YAAY,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO,YAAY,CAAC,YAAY,CAAC;QAC/B,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,aAAa,CAAC;KACtB,CAAC,CAAA;AACJ,CAAC"}

package/dist/services/tokenBalance.spec.js

@@ -17,17 +17,15 @@ describe('TokenBalance', () => {
         it('should fetch token balance across supported chains', async () => {
             const balance = await fetchERC20Balance(chainManager, walletAddress, MockUSDCAsset);
             expect(balance).toEqual({
-                symbol: 'USDC',
-                totalBalance: 1000000n,
-                totalFormattedBalance: '1',
-                chainBalances: [
-                    {
-                        chainId: unichain.id,
-                        balance: 1000000n,
-                        formattedBalance: '1',
-                        tokenAddress: MockUSDCAsset.address[unichain.id],
+                asset: MockUSDCAsset,
+                totalBalance: 1,
+                totalBalanceRaw: 1000000n,
+                chains: {
+                    [unichain.id]: {
+                        balance: 1,
+                        balanceRaw: 1000000n,
                     },
-                ],
+                },
             });
         });
         it('should return zero balance when token not supported on any chains', async () => {
@@ -44,10 +42,10 @@ describe('TokenBalance', () => {
             };
             const balance = await fetchERC20Balance(chainManager, walletAddress, unsupportedAsset);
             expect(balance).toEqual({
-                symbol: 'UNSUPPORTED',
-                totalBalance: 0n,
-                totalFormattedBalance: '0',
-                chainBalances: [],
+                asset: unsupportedAsset,
+                totalBalance: 0,
+                totalBalanceRaw: 0n,
+                chains: {},
             });
         });
     });
@@ -55,17 +53,15 @@ describe('TokenBalance', () => {
         it('should fetch ETH balance across supported chains', async () => {
             const balance = await fetchETHBalance(chainManager, walletAddress);
             expect(balance).toEqual({
-                symbol: 'ETH',
-                totalBalance: 1000000n,
-                totalFormattedBalance: '0.000000000001',
-                chainBalances: [
-                    {
-                        chainId: unichain.id,
-                        balance: 1000000n,
-                        formattedBalance: '0.000000000001',
-                        tokenAddress: ETH.address[unichain.id],
+                asset: ETH,
+                totalBalance: 0.000000000001,
+                totalBalanceRaw: 1000000n,
+                chains: {
+                    [unichain.id]: {
+                        balance: 0.000000000001,
+                        balanceRaw: 1000000n,
                     },
-                ],
+                },
             });
         });
     });

package/dist/services/tokenBalance.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenBalance.spec.js","sourceRoot":"","sources":["../../src/services/tokenBalance.spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAE3E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAG/E,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,YAA0B,CAAA;IAC9B,MAAM,aAAa,GAAY,4CAA4C,CAAA;IAE3E,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,GAAG,IAAI,gBAAgB,CAAC;YAClC,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,cAAc,EAAE,QAAQ;SACzB,CAAQ,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,YAAY,EACZ,aAAa,EACb,aAAa,CACd,CAAA;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,QAAQ;gBACtB,qBAAqB,EAAE,GAAG;gBAC1B,aAAa,EAAE;oBACb;wBACE,OAAO,EAAE,QAAQ,CAAC,EAAE;wBACpB,OAAO,EAAE,QAAQ;wBACjB,gBAAgB,EAAE,GAAG;wBACrB,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAE;qBAClD;iBACF;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;YACjF,MAAM,gBAAgB,GAAU;gBAC9B,QAAQ,EAAE;oBACR,MAAM,EAAE,aAAa;oBACrB,IAAI,EAAE,mBAAmB;oBACzB,QAAQ,EAAE,EAAE;iBACb;gBACD,OAAO,EAAE;oBACP,KAAK,EAAE,4CAA4C;iBAC7C;gBACR,IAAI,EAAE,OAAO;aACd,CAAA;YAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,YAAY,EACZ,aAAa,EACb,gBAAgB,CACjB,CAAA;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,aAAa;gBACrB,YAAY,EAAE,EAAE;gBAChB,qBAAqB,EAAE,GAAG;gBAC1B,aAAa,EAAE,EAAE;aAClB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;YAElE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,KAAK;gBACb,YAAY,EAAE,QAAQ;gBACtB,qBAAqB,EAAE,gBAAgB;gBACvC,aAAa,EAAE;oBACb;wBACE,OAAO,EAAE,QAAQ,CAAC,EAAE;wBACpB,OAAO,EAAE,QAAQ;wBACjB,gBAAgB,EAAE,gBAAgB;wBAClC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAE;qBACxC;iBACF;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"tokenBalance.spec.js","sourceRoot":"","sources":["../../src/services/tokenBalance.spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAE3E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAG/E,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,YAA0B,CAAA;IAC9B,MAAM,aAAa,GAAY,4CAA4C,CAAA;IAE3E,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,GAAG,IAAI,gBAAgB,CAAC;YAClC,eAAe,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,cAAc,EAAE,QAAQ;SACzB,CAAQ,CAAA;IACX,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,YAAY,EACZ,aAAa,EACb,aAAa,CACd,CAAA;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,KAAK,EAAE,aAAa;gBACpB,YAAY,EAAE,CAAC;gBACf,eAAe,EAAE,QAAQ;gBACzB,MAAM,EAAE;oBACN,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;wBACb,OAAO,EAAE,CAAC;wBACV,UAAU,EAAE,QAAQ;qBACrB;iBACF;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;YACjF,MAAM,gBAAgB,GAAU;gBAC9B,QAAQ,EAAE;oBACR,MAAM,EAAE,aAAa;oBACrB,IAAI,EAAE,mBAAmB;oBACzB,QAAQ,EAAE,EAAE;iBACb;gBACD,OAAO,EAAE;oBACP,KAAK,EAAE,4CAA4C;iBAC7C;gBACR,IAAI,EAAE,OAAO;aACd,CAAA;YAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,YAAY,EACZ,aAAa,EACb,gBAAgB,CACjB,CAAA;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,KAAK,EAAE,gBAAgB;gBACvB,YAAY,EAAE,CAAC;gBACf,eAAe,EAAE,EAAE;gBACnB,MAAM,EAAE,EAAE;aACX,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;YAElE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;gBACtB,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,cAAc;gBAC5B,eAAe,EAAE,QAAQ;gBACzB,MAAM,EAAE;oBACN,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;wBACb,OAAO,EAAE,cAAc;wBACvB,UAAU,EAAE,QAAQ;qBACrB;iBACF;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/swap/__mocks__/MockSwapProvider.d.ts

@@ -2,32 +2,44 @@ import { type MockedFunction } from 'vitest';
 import type { SupportedChainId } from '../../constants/supportedChains.js';
 import type { ChainManager } from '../../services/ChainManager.js';
 import { SwapProvider } from '../core/SwapProvider.js';
-import type { GetSwapMarketParams, GetSwapMarketsParams, ResolvedSwapParams, SwapMarket, SwapPrice, SwapPriceParams, SwapProviderConfig, SwapTransaction } from '../../types/swap/index.js';
+import type { SwapSettings } from '../../types/actions.js';
+import type { Asset } from '../../types/asset.js';
+import type { GetSwapMarketParams, GetSwapMarketsParams, ResolvedSwapParams, SwapMarket, SwapProviderConfig, SwapQuote, SwapQuoteParams, SwapTransaction } from '../../types/swap/index.js';
+import type { TransactionData } from '../../types/transaction.js';
 export interface MockSwapProviderConfig {
     supportedChains: SupportedChainId[];
-    defaultPrice: string;
+    defaultPrice: number;
     defaultPriceImpact: number;
+    provider: 'uniswap' | 'velodrome';
 }
 /**
  * Mock Swap Provider for testing
  */
 export declare class MockSwapProvider extends SwapProvider<SwapProviderConfig> {
     mockExecute: MockedFunction<(params: ResolvedSwapParams) => Promise<SwapTransaction>>;
-    mockGetPrice: MockedFunction<(params: SwapPriceParams) => Promise<SwapPrice>>;
+    mockGetQuote: MockedFunction<(params: SwapQuoteParams) => Promise<SwapQuote>>;
+    mockBuildApprovals: MockedFunction<(quote: SwapQuote) => Promise<{
+        tokenApproval?: TransactionData;
+        permit2Approval?: TransactionData;
+    }>>;
     mockGetMarket: MockedFunction<(params: GetSwapMarketParams) => Promise<SwapMarket>>;
     mockGetMarkets: MockedFunction<(params: GetSwapMarketsParams) => Promise<SwapMarket[]>>;
     private _supportedChains;
     private mockProviderConfig;
-    constructor(config?: SwapProviderConfig, mockConfig?: Partial<MockSwapProviderConfig>, chainManager?: ChainManager);
-    supportedChainIds(): SupportedChainId[];
+    constructor(config?: SwapProviderConfig, mockConfig?: Partial<MockSwapProviderConfig>, chainManager?: ChainManager, settings?: SwapSettings);
+    protocolSupportedChainIds(): SupportedChainId[];
     reset(): void;
-    testValidateMarketAllowed(assetIn: any, assetOut: any, chainId: SupportedChainId): void;
+    testValidateMarketAllowed(assetIn: Asset, assetOut: Asset, chainId: SupportedChainId): void;
     protected _execute(params: ResolvedSwapParams): Promise<SwapTransaction>;
-    protected _getPrice(params: SwapPriceParams): Promise<SwapPrice>;
+    protected _getQuote(params: SwapQuoteParams): Promise<SwapQuote>;
+    protected _buildApprovals(quote: SwapQuote): Promise<{
+        tokenApproval?: TransactionData;
+        permit2Approval?: TransactionData;
+    }>;
     protected _getMarket(params: GetSwapMarketParams): Promise<SwapMarket>;
     protected _getMarkets(params: GetSwapMarketsParams): Promise<SwapMarket[]>;
     private createMockSwapTransaction;
-    private createMockPrice;
+    private createMockQuote;
     private createMockMarket;
     private createMockMarkets;
 }

package/dist/swap/__mocks__/MockSwapProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockSwapProvider.d.ts","sourceRoot":"","sources":["../../../src/swap/__mocks__/MockSwapProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAM,MAAM,QAAQ,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,gBAAgB,EAAE,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAC7D,WAAW,EAAE,cAAc,CAChC,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,eAAe,CAAC,CACzD,CAAA;IACM,YAAY,EAAE,cAAc,CACjC,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,CAAC,CAChD,CAAA;IACM,aAAa,EAAE,cAAc,CAClC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,UAAU,CAAC,CACrD,CAAA;IACM,cAAc,EAAE,cAAc,CACnC,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CACxD,CAAA;IAED,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,kBAAkB,CAAwB;gBAGhD,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY;IA+B7B,iBAAiB,IAAI,gBAAgB,EAAE;IAIvC,KAAK,IAAI,IAAI;IAKN,yBAAyB,CAC9B,OAAO,EAAE,GAAG,EACZ,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,gBAAgB,GACxB,IAAI;cAIS,QAAQ,CACtB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,eAAe,CAAC;cAIX,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;cAItD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;cAI5D,WAAW,CACzB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,iBAAiB;CAQ1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC3C,gBAAgB,CAElB"}
+{"version":3,"file":"MockSwapProvider.d.ts","sourceRoot":"","sources":["../../../src/swap/__mocks__/MockSwapProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAM,MAAM,QAAQ,CAAA;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,gBAAgB,EAAE,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,SAAS,GAAG,WAAW,CAAA;CAClC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAC7D,WAAW,EAAE,cAAc,CAChC,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,eAAe,CAAC,CACzD,CAAA;IACM,YAAY,EAAE,cAAc,CACjC,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,CAAC,CAChD,CAAA;IACM,kBAAkB,EAAE,cAAc,CACvC,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;QAC5B,aAAa,CAAC,EAAE,eAAe,CAAA;QAC/B,eAAe,CAAC,EAAE,eAAe,CAAA;KAClC,CAAC,CACH,CAAA;IACM,aAAa,EAAE,cAAc,CAClC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,UAAU,CAAC,CACrD,CAAA;IACM,cAAc,EAAE,cAAc,CACnC,CAAC,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CACxD,CAAA;IAED,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,kBAAkB,CAAwB;gBAGhD,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,EAC3B,QAAQ,CAAC,EAAE,YAAY;IAqCzB,yBAAyB,IAAI,gBAAgB,EAAE;IAI/C,KAAK,IAAI,IAAI;IAKN,yBAAyB,CAC9B,OAAO,EAAE,KAAK,EACd,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,gBAAgB,GACxB,IAAI;cAIS,QAAQ,CACtB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,eAAe,CAAC;cAIX,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;cAItD,eAAe,CAAC,KAAK,EAAE,SAAS;wBAlF5B,eAAe;0BACb,eAAe;;cAqFrB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;cAI5D,WAAW,CACzB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,iBAAiB;CAQ1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC3C,gBAAgB,CAElB"}

package/dist/swap/__mocks__/MockSwapProvider.js

@@ -5,23 +5,28 @@ import { SwapProvider } from '../core/SwapProvider.js';
  * Mock Swap Provider for testing
  */
 export class MockSwapProvider extends SwapProvider {
-    constructor(config, mockConfig, chainManager) {
-        super(config || {}, chainManager || new MockChainManager());
+    constructor(config, mockConfig, chainManager, settings) {
+        super(config || {}, chainManager ||
+            new MockChainManager({
+                supportedChains: [84532],
+            }), settings);
         this._supportedChains = mockConfig?.supportedChains ?? [
             84532,
         ];
         this.mockProviderConfig = {
             supportedChains: this._supportedChains,
-            defaultPrice: mockConfig?.defaultPrice ?? '1.5',
+            defaultPrice: mockConfig?.defaultPrice ?? 1.5,
             defaultPriceImpact: mockConfig?.defaultPriceImpact ?? 0.001,
+            provider: mockConfig?.provider ?? 'uniswap',
         };
         // Create mocked functions
         this.mockExecute = vi
             .fn()
             .mockImplementation(this.createMockSwapTransaction.bind(this));
-        this.mockGetPrice = vi
+        this.mockGetQuote = vi
             .fn()
-            .mockImplementation(this.createMockPrice.bind(this));
+            .mockImplementation(this.createMockQuote.bind(this));
+        this.mockBuildApprovals = vi.fn().mockResolvedValue({});
         this.mockGetMarket = vi
             .fn()
             .mockImplementation(this.createMockMarket.bind(this));
@@ -29,7 +34,7 @@ export class MockSwapProvider extends SwapProvider {
             .fn()
             .mockImplementation(this.createMockMarkets.bind(this));
     }
-    supportedChainIds() {
+    protocolSupportedChainIds() {
         return this._supportedChains;
     }
     reset() {
@@ -42,8 +47,11 @@ export class MockSwapProvider extends SwapProvider {
     async _execute(params) {
         return this.mockExecute(params);
     }
-    async _getPrice(params) {
-        return this.mockGetPrice(params);
+    async _getQuote(params) {
+        return this.mockGetQuote(params);
+    }
+    async _buildApprovals(quote) {
+        return this.mockBuildApprovals(quote);
     }
     async _getMarket(params) {
         return this.mockGetMarket(params);
@@ -52,13 +60,13 @@ export class MockSwapProvider extends SwapProvider {
         return this.mockGetMarkets(params);
     }
     createMockSwapTransaction(params) {
-        const amountIn = params.amountInWei ?? 1000000n;
+        const amountIn = params.amountInRaw ?? 1000000n;
         const amountOut = 1500000000000000000n;
         return {
             amountIn: 1.0,
             amountOut: 1.5,
-            amountInWei: amountIn,
-            amountOutWei: amountOut,
+            amountInRaw: amountIn,
+            amountOutRaw: amountOut,
             assetIn: params.assetIn,
             assetOut: params.assetOut,
             price: this.mockProviderConfig.defaultPrice,
@@ -72,30 +80,45 @@ export class MockSwapProvider extends SwapProvider {
             },
         };
     }
-    createMockPrice(params) {
-        const amountIn = params.amountIn !== undefined
-            ? BigInt(Math.floor(params.amountIn * 10 ** params.assetIn.metadata.decimals))
-            : BigInt(10 ** params.assetIn.metadata.decimals);
-        const amountOut = (amountIn * 15n) / 10n;
+    createMockQuote(params) {
+        const now = Math.floor(Date.now() / 1000);
+        const deadline = params.deadline ?? now + 60;
+        const slippage = params.slippage ?? 0.005;
+        const amountIn = params.amountIn ?? 1.0;
+        const amountOut = amountIn * this.mockProviderConfig.defaultPrice;
+        const amountInRaw = BigInt(Math.floor(amountIn * 10 ** params.assetIn.metadata.decimals));
+        const amountOutRaw = BigInt(Math.floor(amountOut * 10 ** params.assetOut.metadata.decimals));
+        const amountOutMinRaw = (amountOutRaw * BigInt(Math.round((1 - slippage) * 10000))) / 10000n;
         return {
+            assetIn: params.assetIn,
+            assetOut: params.assetOut,
+            chainId: params.chainId,
+            amountIn,
+            amountInRaw,
+            amountOut,
+            amountOutRaw,
+            amountOutMin: amountOut * (1 - slippage),
+            amountOutMinRaw,
             price: this.mockProviderConfig.defaultPrice,
-            priceInverse: '0.666666',
-            amountIn: 1.0,
-            amountOut: 1.5,
-            amountInWei: amountIn,
-            amountOutWei: amountOut,
+            priceInverse: 1 / this.mockProviderConfig.defaultPrice,
             priceImpact: this.mockProviderConfig.defaultPriceImpact,
             route: {
                 path: [params.assetIn, params.assetOut],
-                pools: [
-                    {
-                        address: '0x1234',
-                        fee: 500,
-                        version: 'v4',
-                    },
-                ],
+                pools: [{ address: '0x1234', fee: 500, version: 'v4' }],
+            },
+            execution: {
+                swapCalldata: '0x1234',
+                routerAddress: '0x492e6456d9528771018deb9e87ef7750ef184104',
+                value: 0n,
             },
+            provider: this.mockProviderConfig.provider,
+            slippage,
+            deadline,
+            quotedAt: now,
+            expiresAt: deadline,
             gasEstimate: 150000n,
+            quotedRecipient: (params.recipient ??
+                '0x0000000000000000000000000000000000000001'),
         };
     }
     createMockMarket(params) {
@@ -117,7 +140,7 @@ export class MockSwapProvider extends SwapProvider {
                 },
             ],
             fee: 500,
-            provider: 'uniswap',
+            provider: this.mockProviderConfig.provider,
         };
     }
     createMockMarkets(_params) {

package/dist/swap/__mocks__/MockSwapProvider.js.map

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

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

@@ -1,55 +1,144 @@
 import type { Address } from 'viem';
 import type { SupportedChainId } from '../../constants/supportedChains.js';
+import type { SwapExecuteParamsResolved, SwapQuoteParamsResolved } from '../../ens/types.js';
 import type { ChainManager } from '../../services/ChainManager.js';
+import type { SwapSettings } from '../../types/actions.js';
 import type { Asset } from '../../types/asset.js';
-import type { GetSwapMarketParams, GetSwapMarketsParams, ResolvedSwapParams, SwapExecuteParams, SwapMarket, SwapMarketConfig, SwapPrice, SwapPriceParams, SwapProviderConfig, SwapTransaction } from '../../types/swap/index.js';
+import type { GetSwapMarketParams, GetSwapMarketsParams, ResolvedSwapParams, SwapMarket, SwapMarketConfig, SwapProviderConfig, SwapQuote, SwapTransaction, SwapTransactionData } from '../../types/swap/index.js';
 import type { TransactionData } from '../../types/transaction.js';
+/** Field used to distinguish a SwapQuote from raw SwapExecuteParams */
+export declare const QUOTE_DISCRIMINATOR: "quotedAt";
 /**
  * Abstract base class for swap providers.
  * Public methods handle validation and conversion,
  * protected abstract methods implement provider-specific logic.
+ *
+ * Settings are resolved with provider → global → hardcoded default precedence.
  */
 export declare abstract class SwapProvider<TConfig extends SwapProviderConfig = SwapProviderConfig> {
     protected readonly _config: TConfig;
+    protected readonly _settings: SwapSettings;
     protected readonly chainManager: ChainManager;
-    constructor(config: TConfig, chainManager: ChainManager);
+    constructor(config: TConfig, chainManager: ChainManager, settings?: SwapSettings);
     get config(): TConfig;
+    /** Resolved default slippage: provider → global → 0.005 */
     get defaultSlippage(): number;
+    /** Resolved max slippage: provider → global → 0.5 */
+    get maxSlippage(): number;
+    /** Resolved quote expiration in seconds: provider → global → 60 */
+    get quoteExpirationSeconds(): number;
+    /** Resolved Permit2 sub-approval expiration in seconds: provider → global → 30 days */
+    get permit2ExpirationSeconds(): number;
     /**
-     * Execute a token swap
-     * @param params - Swap parameters including assets, amounts, and chain
-     * @returns Swap transaction data ready for execution
+     * 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 Transaction data ready for wallet execution
+     */
+    execute(params: SwapExecuteParamsResolved | SwapQuote): Promise<SwapTransaction>;
+    /**
+     * Get a full swap quote with pre-built execution data.
+     * The returned SwapQuote can be passed directly to execute() to skip re-quoting.
+     * @param params - Quote parameters (assets, amounts, chain, slippage)
+     * @returns SwapQuote with pricing, amounts, and pre-encoded calldata
+     */
+    getQuote(params: SwapQuoteParamsResolved): Promise<SwapQuote>;
+    /**
+     * Get a specific swap market by ID.
+     * Validates the market is not blocklisted before returning.
+     * @param params - Market identifier (poolId + chainId)
+     * @returns Market information including assets and fee tier
+     * @throws If market is blocklisted
      */
-    execute(params: SwapExecuteParams): Promise<SwapTransaction>;
-    /** Get price quote for a swap */
-    getPrice(params: SwapPriceParams): Promise<SwapPrice>;
-    /** Get a specific swap market by ID */
     getMarket(params: GetSwapMarketParams): Promise<SwapMarket>;
-    /** Get available swap markets, optionally filtered by chainId or asset */
+    /**
+     * Get available swap markets, optionally filtered.
+     * Excludes blocklisted markets from results.
+     * @param params - Optional filters (chainId, asset)
+     * @returns Array of non-blocked markets from this provider
+     */
     getMarkets(params?: GetSwapMarketsParams): Promise<SwapMarket[]>;
+    /**
+     * Effective supported chain IDs.
+     * @description Intersection of the protocol's supported chains,
+     * the Actions SDK's known chains, and the developer's ActionsConfig.chains.
+     */
+    supportedChainIds(): SupportedChainId[];
     isChainSupported(chainId: SupportedChainId): boolean;
+    /**
+     * Check if this provider supports a given market (asset pair on chain).
+     * Returns true if the pair passes allowlist/blocklist checks.
+     */
+    isMarketSupported(assetIn: Asset, assetOut: Asset, chainId: SupportedChainId): boolean;
     protected validateMarketAllowed(assetIn: Asset, assetOut: Asset, chainId: SupportedChainId): void;
+    /**
+     * Resolve common quote parameters with provider defaults.
+     * @param params - Raw quote params from the user
+     * @returns Resolved slippage, deadline, recipient, amountInRaw, and current timestamp
+     */
+    protected resolveQuoteDefaults(params: SwapQuoteParamsResolved): {
+        slippage: number;
+        now: number;
+        deadline: number;
+        recipient: `0x${string}`;
+        amountInRaw: bigint;
+    };
+    /**
+     * Compute minimum output amount after slippage.
+     * @param amountOutRaw - Expected output as raw bigint
+     * @param slippage - Slippage tolerance as decimal (0.005 = 0.5%)
+     * @param assetOut - Output asset (for decimal conversion)
+     * @returns Raw and human-readable minimum output amounts
+     */
+    protected computeSlippageBounds(amountOutRaw: bigint, slippage: number, assetOut: Asset): {
+        amountOutMinRaw: bigint;
+        amountOutMin: number;
+    };
     protected resolveMarketConfig(assetIn: Asset, assetOut: Asset, chainId: SupportedChainId): SwapMarketConfig | undefined;
     /**
      * Build Permit2 approval transactions for an ERC20 swap input.
      * Skipped for native assets. Checks both ERC20→Permit2 and Permit2→spender allowances in parallel.
+     * Uses the resolved `permit2ExpirationSeconds` from provider → global → default.
      * @param params - Resolved swap params (wallet address, asset info, chain)
-     * @param requiredAmount - Amount in wei that must be approved
+     * @param requiredAmount - Amount as raw bigint that must be approved
      * @param permit2Address - Permit2 contract address
      * @param permit2Spender - The router/contract that Permit2 should approve (e.g. Universal Router)
-     * @param permit2ExpirySeconds - Optional custom expiry for the Permit2 approval
      */
-    protected buildPermit2Approvals(params: ResolvedSwapParams, requiredAmount: bigint, permit2Address: Address, permit2Spender: Address, permit2ExpirySeconds?: number): Promise<{
+    protected buildPermit2Approvals(params: ResolvedSwapParams, requiredAmount: bigint, permit2Address: Address, permit2Spender: Address): Promise<{
         tokenApproval: TransactionData | undefined;
         permit2Approval: TransactionData | undefined;
     }>;
-    private executeValidations;
+    /**
+     * Build a SwapTransaction from a quote by fetching approvals and wrapping the swap calldata.
+     * Used by both the quote-execute path and provider _execute implementations.
+     * @param quote - SwapQuote with recipient set for allowance checks
+     */
+    protected buildSwapTransactions(quote: SwapQuote): Promise<SwapTransaction>;
+    private executeFromQuote;
+    private validateSwapExecute;
+    private validateQuoteExpiration;
     private resolveParams;
+    /**
+     * Filter out markets whose asset pairs appear in the blocklist.
+     */
+    private filterBlockedMarkets;
     private findMatchingConfig;
     private containsPairByAddress;
-    abstract supportedChainIds(): SupportedChainId[];
+    /**
+     * Chain IDs supported by the underlying protocol.
+     * Each provider declares the chains its protocol is deployed on,
+     * without any SDK-level or developer-config filtering.
+     */
+    abstract protocolSupportedChainIds(): SupportedChainId[];
     protected abstract _execute(params: ResolvedSwapParams): Promise<SwapTransaction>;
-    protected abstract _getPrice(params: SwapPriceParams): Promise<SwapPrice>;
+    protected abstract _getQuote(params: SwapQuoteParamsResolved): Promise<SwapQuote>;
+    /**
+     * Build provider-specific approval transactions for a swap.
+     * Called by the base class during executeFromQuote with a validated recipient.
+     * @param quote - SwapQuote with recipient set to the real wallet address
+     * @returns Approval transactions needed before the swap (tokenApproval, permit2Approval)
+     */
+    protected abstract _buildApprovals(quote: SwapQuote): Promise<Omit<SwapTransactionData, 'swap'>>;
     protected abstract _getMarket(params: GetSwapMarketParams): Promise<SwapMarket>;
     protected abstract _getMarkets(params: GetSwapMarketsParams): Promise<SwapMarket[]>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"SwapProvider.d.ts","sourceRoot":"","sources":["../../../src/swap/core/SwapProvider.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,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AA2B7D;;;;GAIG;AACH,8BAAsB,YAAY,CAChC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IAEvD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACnC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;gBAEjC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY;IAKvD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAUlE,iCAAiC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAK3D,uCAAuC;IACjC,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKjE,0EAA0E;IACpE,UAAU,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO1E,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAQpD,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,KAAK,EACd,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,gBAAgB,GACxB,IAAI;IAgCP,SAAS,CAAC,mBAAmB,CAC3B,OAAO,EAAE,KAAK,EACd,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,GAAG,SAAS;IAU/B;;;;;;;;OAQG;cACa,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,OAAO,EACvB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC;QACT,aAAa,EAAE,eAAe,GAAG,SAAS,CAAA;QAC1C,eAAe,EAAE,eAAe,GAAG,SAAS,CAAA;KAC7C,CAAC;IAkDF,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,qBAAqB;IAmB7B,QAAQ,CAAC,iBAAiB,IAAI,gBAAgB,EAAE;IAEhD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CACzB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,eAAe,CAAC;IAE3B,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAEzE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAC3B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAEtB,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;CACzB"}
+{"version":3,"file":"SwapProvider.d.ts","sourceRoot":"","sources":["../../../src/swap/core/SwapProvider.ts"],"names":[],"mappings":"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"}