@eth-optimism/actions-sdk 0.2.0 → 0.4.0

package/dist/types/swap/base.d.ts

@@ -0,0 +1,338 @@
+import type { Address, Hex } from 'viem';
+import type { SupportedChainId } from '../../constants/supportedChains.js';
+import type { SwapProviderName } from '../actions.js';
+import type { Asset } from '../asset.js';
+import type { TransactionData } from '../transaction.js';
+import type { BatchTransactionReturnType, TransactionReturnType } from '../../wallet/core/wallets/abstract/types/index.js';
+export { SwapProvider } from '../../swap/core/SwapProvider.js';
+export { ActionsSwapNamespace } from '../../swap/namespaces/ActionsSwapNamespace.js';
+export { WalletSwapNamespace } from '../../swap/namespaces/WalletSwapNamespace.js';
+export type { SwapProviders } from '../providers.js';
+/**
+ * Per-provider swap configuration.
+ * Provider-level values override the shared SwapGlobalConfig defaults.
+ */
+export interface SwapProviderConfig {
+    /** Slippage tolerance override for this provider (e.g., 0.005 for 0.5%) */
+    defaultSlippage?: number;
+    /** Maximum allowed slippage override for this provider (e.g., 0.5 for 50%) */
+    maxSlippage?: number;
+    /** Quote expiration override for this provider, in seconds from now */
+    quoteExpirationSeconds?: number;
+    /** Allowlist of swap markets (optional - defaults to all supported assets) */
+    marketAllowlist?: SwapMarketConfig[];
+    /** Blocklist of swap markets to exclude */
+    marketBlocklist?: SwapMarketConfig[];
+}
+/**
+ * Swap market filter
+ * @description Define allowed/blocked trading markets by assets.
+ * 2 assets = one explicit pair. 3+ = all pairs between them.
+ */
+export interface SwapMarketConfig {
+    /** 2 assets = one explicit pair. 3+ = all pairs between them. */
+    assets: [Asset, Asset, ...Asset[]];
+    /** Restrict to a specific chain. Omit = all configured chains. */
+    chainId?: SupportedChainId;
+}
+/**
+ * Swap market identifier
+ * @description Unique identifier for a swap market (mirrors LendMarketId pattern)
+ */
+export type SwapMarketId = {
+    /** Pool identifier (keccak256 hash of PoolKey) */
+    poolId: string;
+    /** Chain ID where this market exists */
+    chainId: SupportedChainId;
+};
+/**
+ * Parameters for getting a specific swap market
+ */
+export type GetSwapMarketParams = SwapMarketId;
+/**
+ * Parameters for getting swap markets
+ */
+export interface GetSwapMarketsParams {
+    /** Filter by chain ID */
+    chainId?: SupportedChainId;
+    /** Filter by asset (returns markets containing this asset) */
+    asset?: Asset;
+}
+/**
+ * Parameters for a wallet swap — what the developer passes.
+ * Exactly one of amountIn or amountOut must be provided.
+ */
+export interface WalletSwapParams {
+    /** Amount of input token (human-readable). For exact-in swaps. Mutually exclusive with amountOut. */
+    amountIn?: number;
+    /** Amount of output token (human-readable). For exact-out swaps. Mutually exclusive with amountIn. */
+    amountOut?: number;
+    /** Token to sell */
+    assetIn: Asset;
+    /** Token to buy */
+    assetOut: Asset;
+    /** Chain to execute swap on */
+    chainId: SupportedChainId;
+    /** Slippage tolerance override (e.g., 0.01 for 1%). Overrides provider and config defaults. */
+    slippage?: number;
+    /** Transaction deadline as Unix timestamp. Defaults to now + 1 minute. */
+    deadline?: number;
+    /** Recipient address. Defaults to wallet address. */
+    recipient?: Address;
+    /** Explicitly select a swap provider. Overrides routing config. */
+    provider?: SwapProviderName;
+}
+/**
+ * Full swap execute parameters including wallet address.
+ * walletAddress is auto-injected by the wallet namespace.
+ */
+export interface SwapExecuteParams extends WalletSwapParams {
+    walletAddress: Address;
+}
+/**
+ * Fully resolved swap parameters with defaults applied and amounts as raw bigint.
+ * Passed to provider _execute() implementations.
+ */
+export interface ResolvedSwapParams {
+    amountInRaw?: bigint;
+    amountOutRaw?: bigint;
+    assetIn: Asset;
+    assetOut: Asset;
+    slippage: number;
+    deadline: number;
+    recipient: Address;
+    walletAddress: Address;
+    chainId: SupportedChainId;
+}
+/**
+ * Parameters for getting a swap price quote
+ * @description Specify either amountIn (for exact-in) or amountOut (for exact-out),
+ * not both. Amounts should be human-readable numbers (e.g., 100 for 100 USDC).
+ */
+export interface SwapPriceParams {
+    /** Token to get price for (required) */
+    assetIn: Asset;
+    /** Token to price against. Defaults to USDC if not provided. */
+    assetOut?: Asset;
+    /** Amount of input token (human-readable). Defaults to 1 unit. For exact-in quotes. */
+    amountIn?: number;
+    /** Amount of output token (human-readable). For exact-out quotes. */
+    amountOut?: number;
+    /** Chain to get price on */
+    chainId: SupportedChainId;
+    /** Explicitly select a swap provider. Overrides routing config. */
+    provider?: SwapProviderName;
+}
+/**
+ * Parameters for getting a swap quote with pre-built execution data.
+ */
+export interface SwapQuoteParams {
+    /** Token to sell */
+    assetIn: Asset;
+    /** Token to buy (required) */
+    assetOut: Asset;
+    /** Amount of input token (human-readable). Mutually exclusive with amountOut. */
+    amountIn?: number;
+    /** Amount of output token (human-readable). Mutually exclusive with amountIn. */
+    amountOut?: number;
+    /** Chain to execute swap on */
+    chainId: SupportedChainId;
+    /** Slippage tolerance baked into the quote */
+    slippage?: number;
+    /** Transaction deadline as Unix timestamp */
+    deadline?: number;
+    /** Recipient address */
+    recipient?: Address;
+    /** Explicitly select a swap provider */
+    provider?: SwapProviderName;
+}
+/**
+ * Pre-built execution data from a quote, ready to submit on-chain.
+ */
+export interface SwapQuoteExecution {
+    /** Encoded swap calldata */
+    swapCalldata: Hex;
+    /** Router/contract to send the swap transaction to */
+    routerAddress: Address;
+    /** Native ETH value for ETH-in swaps, else 0n */
+    value: bigint;
+    /** Opaque provider-specific context (e.g. stable flag, factory address) */
+    providerContext?: Record<string, unknown>;
+}
+/**
+ * A complete swap quote: pricing, amounts, and pre-built execution data.
+ * Pass to execute() to skip re-quoting.
+ *
+ * **Precision note:** `Raw` fields (bigint) are the on-chain source of truth.
+ * Number fields (`amountIn`, `amountOut`, `price`, etc.) are display approximations
+ * derived via `formatUnits` → `parseFloat`. For tokens with many significant digits,
+ * numbers may lose precision. Use `Raw` fields for any math that matters.
+ */
+export interface SwapQuote {
+    /** Token being sold */
+    assetIn: Asset;
+    /** Token being bought */
+    assetOut: Asset;
+    /** Chain to execute on */
+    chainId: SupportedChainId;
+    /** Human-readable input amount (display only — use amountInRaw for precision) */
+    amountIn: number;
+    /** Input amount as raw bigint (native decimals). Source of truth. */
+    amountInRaw: bigint;
+    /** Human-readable expected output (display only — use amountOutRaw for precision) */
+    amountOut: number;
+    /** Expected output as raw bigint. Source of truth. */
+    amountOutRaw: bigint;
+    /** Human-readable minimum output after slippage (display only) */
+    amountOutMin: number;
+    /** Minimum output as raw bigint after slippage. Source of truth for on-chain execution. */
+    amountOutMinRaw: bigint;
+    /** Exchange rate: amountOut / amountIn. Display approximation. */
+    price: number;
+    /** Inverse exchange rate: amountIn / amountOut. Display approximation. */
+    priceInverse: number;
+    /** Price impact as decimal (0.03 = 3%) */
+    priceImpact: number;
+    /** Route taken for the swap */
+    route: SwapRoute;
+    /** Pre-built transaction data. Pass quote to execute() to use. */
+    execution: SwapQuoteExecution;
+    /** Provider that generated this quote */
+    provider: SwapProviderName;
+    /** Slippage tolerance applied to this quote */
+    slippage: number;
+    /** Transaction deadline (Unix seconds) */
+    deadline: number;
+    /** When the quote was generated (Unix seconds) */
+    quotedAt: number;
+    /** When the quote expires (Unix seconds) */
+    expiresAt: number;
+    /** Estimated gas cost as raw bigint (native decimals) */
+    gasEstimate?: bigint;
+    /**
+     * Wallet address that will execute this quote.
+     * Set by WalletSwapNamespace before execution — not available on price-only quotes.
+     * Used to check existing on-chain allowances and skip redundant approvals.
+     */
+    recipient?: Address;
+    /**
+     * The recipient address baked into execution.swapCalldata at quote time.
+     * If recipient differs from quotedRecipient at execute time, calldata is re-encoded
+     * with the correct recipient to prevent tokens from being sent to the wrong address.
+     */
+    quotedRecipient: Address;
+}
+/**
+ * Market information for a swap hop
+ */
+export interface SwapMarketInfo {
+    /** Market address or identifier */
+    address: Address;
+    /** Fee tier in pips */
+    fee: number;
+    /** Protocol version used (v2, v3, v4) */
+    version: 'v2' | 'v3' | 'v4';
+}
+/**
+ * Swap route information
+ */
+export interface SwapRoute {
+    /** Ordered list of assets in the route path */
+    path: Asset[];
+    /** Market information for each hop */
+    pools: SwapMarketInfo[];
+}
+/**
+ * Swap price quote response
+ */
+export interface SwapPrice {
+    /** Exchange rate as human-readable string (e.g., "3245.50") */
+    price: string;
+    /** Inverse exchange rate */
+    priceInverse: string;
+    /** Human-readable input amount */
+    amountIn: number;
+    /** Human-readable output amount */
+    amountOut: number;
+    /** Input amount as raw bigint (native decimals) */
+    amountInRaw: bigint;
+    /** Expected output amount as raw bigint (native decimals) */
+    amountOutRaw: bigint;
+    /** Price impact as decimal (0.03 = 3%). Derived from pool mid-price vs execution price. */
+    priceImpact: number;
+    /** Route taken for the swap */
+    route: SwapRoute;
+    /** Estimated gas cost as raw bigint (native decimals) */
+    gasEstimate?: bigint;
+}
+/**
+ * Transaction data for swap execution
+ */
+export interface SwapTransactionData {
+    /** Permit2 approval transaction (if needed) */
+    permit2Approval?: TransactionData;
+    /** Token approval to Permit2 (if needed) */
+    tokenApproval?: TransactionData;
+    /** Main swap transaction */
+    swap: TransactionData;
+}
+/**
+ * Swap transaction result
+ */
+export interface SwapTransaction {
+    /** Human-readable input amount */
+    amountIn: number;
+    /** Human-readable output amount */
+    amountOut: number;
+    /** Input amount as raw bigint (native decimals) */
+    amountInRaw: bigint;
+    /** Output amount as raw bigint (native decimals) (expected) */
+    amountOutRaw: bigint;
+    /** Input asset */
+    assetIn: Asset;
+    /** Output asset */
+    assetOut: Asset;
+    /** Exchange rate: amountOut / amountIn */
+    price: number;
+    /** Price impact as decimal (0.03 = 3%) */
+    priceImpact: number;
+    /** Transaction data for execution */
+    transactionData: SwapTransactionData;
+}
+/**
+ * Swap execution receipt
+ */
+export interface SwapReceipt {
+    /** Transaction receipt(s) */
+    receipt: TransactionReturnType | BatchTransactionReturnType;
+    /** Human-readable input amount */
+    amountIn: number;
+    /** Human-readable output amount */
+    amountOut: number;
+    /** Actual input amount as raw bigint (native decimals) */
+    amountInRaw: bigint;
+    /** Actual output amount as raw bigint (native decimals) */
+    amountOutRaw: bigint;
+    /** Input asset */
+    assetIn: Asset;
+    /** Output asset */
+    assetOut: Asset;
+    /** Exchange rate: amountOut / amountIn */
+    price: number;
+    /** Price impact as decimal (0.03 = 3%) */
+    priceImpact: number;
+}
+/**
+ * Swap market information
+ */
+export interface SwapMarket {
+    /** Market identifier (contains poolId and chainId) */
+    marketId: SwapMarketId;
+    /** Token pair in the market */
+    assets: [Asset, Asset];
+    /** Fee tier in pips (500 = 0.05%) */
+    fee: number;
+    /** Provider name */
+    provider: SwapProviderName;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/swap/base.d.ts.map

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

package/dist/types/swap/base.js

@@ -0,0 +1,4 @@
+export { SwapProvider } from '../../swap/core/SwapProvider.js';
+export { ActionsSwapNamespace } from '../../swap/namespaces/ActionsSwapNamespace.js';
+export { WalletSwapNamespace } from '../../swap/namespaces/WalletSwapNamespace.js';
+//# sourceMappingURL=base.js.map

package/dist/types/swap/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/types/swap/base.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA"}

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

@@ -0,0 +1,2 @@
+export * from './base.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/swap/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/types/swap/index.js

@@ -0,0 +1,2 @@
+export * from './base.js';
+//# sourceMappingURL=index.js.map

package/dist/types/swap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/swap/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/types/transaction.d.ts

@@ -0,0 +1,14 @@
+import type { Address, Hex } from 'viem';
+/**
+ * Transaction data for execution
+ * @description Raw transaction data for wallet execution
+ */
+export interface TransactionData {
+    /** Target contract address */
+    to: Address;
+    /** Encoded function call data */
+    data: Hex;
+    /** ETH value to send */
+    value: bigint;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/types/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAExC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,iCAAiC;IACjC,IAAI,EAAE,GAAG,CAAA;IACT,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/types/transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction.js.map

package/dist/types/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/types/transaction.ts"],"names":[],"mappings":""}

package/dist/utils/approve.d.ts

@@ -0,0 +1,82 @@
+import type { Address, PublicClient } from 'viem';
+import type { TransactionData } from '../types/transaction.js';
+/** Default Permit2 approval expiry: 30 days in seconds */
+export declare const DEFAULT_PERMIT2_EXPIRY_SECONDS: number;
+/**
+ * Permit2 allowance info
+ */
+export interface Permit2Allowance {
+    amount: bigint;
+    expiration: number;
+    nonce: number;
+}
+/**
+ * Check Permit2 allowance for a token/spender pair
+ */
+export declare function checkPermit2Allowance(params: {
+    publicClient: PublicClient;
+    permit2Address: Address;
+    owner: Address;
+    token: Address;
+    spender: Address;
+}): Promise<Permit2Allowance>;
+/**
+ * Build ERC20 token approval transaction to Permit2.
+ * Uses maxUint256 — the Uniswap-canonical pattern.
+ * Permit2 is immutable with no owner; spending is scoped by its own allowance system.
+ */
+export declare function buildTokenApprovalTx(token: Address, permit2Address: Address): TransactionData;
+/**
+ * Build Permit2 approval transaction for a spender
+ */
+export declare function buildPermit2ApprovalTx(params: {
+    permit2Address: Address;
+    token: Address;
+    spender: Address;
+    amount: bigint;
+    expirySeconds?: number;
+}): TransactionData;
+/**
+ * Check ERC20 token allowance
+ */
+export declare function checkTokenAllowance(params: {
+    publicClient: PublicClient;
+    token: Address;
+    owner: Address;
+    spender: Address;
+}): Promise<bigint>;
+/**
+ * Build an ERC20 approve transaction.
+ * @param token - ERC20 token address
+ * @param spender - Address to approve
+ * @param amount - Amount to approve
+ * @returns Transaction data for the approval
+ */
+export declare function buildErc20ApprovalTx(token: Address, spender: Address, amount: bigint): TransactionData;
+/**
+ * Compute how much additional ERC20 approval is needed.
+ * Returns 0n if current allowance is sufficient.
+ * @param params - Token, owner, spender, required amount, and public client
+ * @returns The deficit (required - current), or 0n if already sufficient
+ */
+export declare function getApprovalDeficit(params: {
+    publicClient: PublicClient;
+    token: Address;
+    owner: Address;
+    spender: Address;
+    amount: bigint;
+}): Promise<bigint>;
+/**
+ * Build an ERC20 approval transaction only if needed, approving only the deficit.
+ * Checks the current on-chain allowance, returns undefined if already sufficient.
+ * @param params - Token, owner, spender, required amount, and public client
+ * @returns Approval transaction for the deficit amount, or undefined if allowance is sufficient
+ */
+export declare function buildApprovalTxIfNeeded(params: {
+    publicClient: PublicClient;
+    token: Address;
+    owner: Address;
+    spender: Address;
+    amount: bigint;
+}): Promise<TransactionData | undefined>;
+//# sourceMappingURL=approve.d.ts.map

package/dist/utils/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../src/utils/approve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,0DAA0D;AAC1D,eAAO,MAAM,8BAA8B,QAAoB,CAAA;AAmC/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,YAAY,EAAE,YAAY,CAAA;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,OAAO,GACtB,eAAe,CAEjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,cAAc,EAAE,OAAO,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,eAAe,CAiBlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,YAAY,EAAE,YAAY,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CASlB;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,eAAe,CAUjB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,YAAY,EAAE,YAAY,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,YAAY,EAAE,YAAY,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAKvC"}

package/dist/utils/approve.js

@@ -0,0 +1,134 @@
+import { encodeFunctionData, erc20Abi, maxUint256 } from 'viem';
+/** Default Permit2 approval expiry: 30 days in seconds */
+export const DEFAULT_PERMIT2_EXPIRY_SECONDS = 30 * 24 * 60 * 60;
+/**
+ * Permit2 ABI (subset for approvals)
+ */
+const PERMIT2_ABI = [
+    {
+        name: 'allowance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'token', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [
+            { name: 'amount', type: 'uint160' },
+            { name: 'expiration', type: 'uint48' },
+            { name: 'nonce', type: 'uint48' },
+        ],
+    },
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint160' },
+            { name: 'expiration', type: 'uint48' },
+        ],
+        outputs: [],
+    },
+];
+/**
+ * Check Permit2 allowance for a token/spender pair
+ */
+export async function checkPermit2Allowance(params) {
+    const { publicClient, permit2Address, owner, token, spender } = params;
+    const result = await publicClient.readContract({
+        address: permit2Address,
+        abi: PERMIT2_ABI,
+        functionName: 'allowance',
+        args: [owner, token, spender],
+    });
+    return {
+        amount: BigInt(result[0]),
+        expiration: Number(result[1]),
+        nonce: Number(result[2]),
+    };
+}
+/**
+ * Build ERC20 token approval transaction to Permit2.
+ * Uses maxUint256 — the Uniswap-canonical pattern.
+ * Permit2 is immutable with no owner; spending is scoped by its own allowance system.
+ */
+export function buildTokenApprovalTx(token, permit2Address) {
+    return buildErc20ApprovalTx(token, permit2Address, maxUint256);
+}
+/**
+ * Build Permit2 approval transaction for a spender
+ */
+export function buildPermit2ApprovalTx(params) {
+    const { permit2Address, token, spender, amount } = params;
+    const expiration = Math.floor(Date.now() / 1000) +
+        (params.expirySeconds ?? DEFAULT_PERMIT2_EXPIRY_SECONDS);
+    const data = encodeFunctionData({
+        abi: PERMIT2_ABI,
+        functionName: 'approve',
+        args: [token, spender, amount, expiration],
+    });
+    return {
+        to: permit2Address,
+        data,
+        value: 0n,
+    };
+}
+/**
+ * Check ERC20 token allowance
+ */
+export async function checkTokenAllowance(params) {
+    const { publicClient, token, owner, spender } = params;
+    return publicClient.readContract({
+        address: token,
+        abi: erc20Abi,
+        functionName: 'allowance',
+        args: [owner, spender],
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Generic ERC20 approval utilities
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Build an ERC20 approve transaction.
+ * @param token - ERC20 token address
+ * @param spender - Address to approve
+ * @param amount - Amount to approve
+ * @returns Transaction data for the approval
+ */
+export function buildErc20ApprovalTx(token, spender, amount) {
+    return {
+        to: token,
+        data: encodeFunctionData({
+            abi: erc20Abi,
+            functionName: 'approve',
+            args: [spender, amount],
+        }),
+        value: 0n,
+    };
+}
+/**
+ * Compute how much additional ERC20 approval is needed.
+ * Returns 0n if current allowance is sufficient.
+ * @param params - Token, owner, spender, required amount, and public client
+ * @returns The deficit (required - current), or 0n if already sufficient
+ */
+export async function getApprovalDeficit(params) {
+    const current = await checkTokenAllowance(params);
+    return current >= params.amount ? 0n : params.amount - current;
+}
+/**
+ * Build an ERC20 approval transaction only if needed, approving only the deficit.
+ * Checks the current on-chain allowance, returns undefined if already sufficient.
+ * @param params - Token, owner, spender, required amount, and public client
+ * @returns Approval transaction for the deficit amount, or undefined if allowance is sufficient
+ */
+export async function buildApprovalTxIfNeeded(params) {
+    const deficit = await getApprovalDeficit(params);
+    return deficit > 0n
+        ? buildErc20ApprovalTx(params.token, params.spender, deficit)
+        : undefined;
+}
+//# sourceMappingURL=approve.js.map

package/dist/utils/approve.js.map

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

package/dist/utils/approve.test.d.ts

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

package/dist/utils/approve.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.test.d.ts","sourceRoot":"","sources":["../../src/utils/approve.test.ts"],"names":[],"mappings":""}