@eth-optimism/actions-sdk 0.1.0 → 0.3.0

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

@@ -0,0 +1,238 @@
+import type { Address } from 'viem';
+import type { SupportedChainId } from '../../constants/supportedChains.js';
+import type { SwapProvider } from '../../swap/core/SwapProvider.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';
+/**
+ * Map of available swap providers keyed by provider name
+ */
+export type SwapProviders = {
+    uniswap?: SwapProvider<SwapProviderConfig>;
+};
+/**
+ * Swap provider configuration
+ * @description Configuration for a single swap provider (mirrors LendProviderConfig pattern)
+ */
+export interface SwapProviderConfig {
+    /** Default slippage tolerance (e.g., 0.005 for 0.5%) */
+    defaultSlippage?: number;
+    /** Maximum allowed slippage (e.g., 0.5 for 50%). Defaults to 0.5. */
+    maxSlippage?: 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;
+}
+/**
+ * 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 in wei.
+ * Passed to provider _execute() implementations.
+ */
+export interface ResolvedSwapParams {
+    amountInWei?: bigint;
+    amountOutWei?: 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;
+}
+/**
+ * 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 in wei */
+    amountInWei: bigint;
+    /** Expected output amount in wei */
+    amountOutWei: 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 in wei */
+    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 in wei */
+    amountInWei: bigint;
+    /** Output amount in wei (expected) */
+    amountOutWei: bigint;
+    /** Input asset */
+    assetIn: Asset;
+    /** Output asset */
+    assetOut: Asset;
+    /** Execution price */
+    price: string;
+    /** 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 in wei */
+    amountInWei: bigint;
+    /** Actual output amount in wei */
+    amountOutWei: bigint;
+    /** Input asset */
+    assetIn: Asset;
+    /** Output asset */
+    assetOut: Asset;
+    /** Execution price as human-readable string */
+    price: string;
+    /** 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: 'uniswap';
+}
+//# 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/assets.d.ts

@@ -2,12 +2,11 @@ import type { Address } from 'viem';
 import type { SupportedChainId } from '../constants/supportedChains.js';
 import type { Asset } from '../types/asset.js';
 /**
- * Parse human-readable amount to wei/smallest unit
- * @param amount - Human-readable amount (e.g. 1.5)
- * @param decimals - Token decimals
- * @returns Amount in smallest unit (wei equivalent)
+ * Parse human-readable amount to wei using an asset's decimals.
+ * Returns undefined when amount is undefined.
  */
-export declare function parseAssetAmount(amount: number, decimals: number): bigint;
+export declare function parseAssetAmount(asset: Asset, amount: number): bigint;
+export declare function parseAssetAmount(asset: Asset, amount: number | undefined): bigint | undefined;
 /**
  * Convert wei/smallest unit back to human-readable amount
  * @param amount - Amount in smallest unit
@@ -15,6 +14,12 @@ export declare function parseAssetAmount(amount: number, decimals: number): bigi
  * @returns Human-readable amount as number
  */
 export declare function formatAssetAmount(amount: bigint, decimals: number): number;
+/**
+ * Check if asset is a native asset (e.g. ETH)
+ * @param asset - Asset definition
+ * @returns Whether the asset is native
+ */
+export declare function isNativeAsset(asset: Asset): boolean;
 /**
  * Check if asset is supported on a specific chain
  * @param asset - Asset definition
@@ -27,7 +32,7 @@ export declare function isAssetSupportedOnChain(asset: Asset, chainId: Supported
  * @param asset - Asset definition
  * @param chainId - Chain ID
  * @returns Asset address on the specified chain
- * @throws Error if asset is not supported on the chain
+ * @throws Error if asset is not supported on the chain or is a native asset
  */
 export declare function getAssetAddress(asset: Asset, chainId: SupportedChainId): Address;
 //# sourceMappingURL=assets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/utils/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAQT"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/utils/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;AACtE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAAA;AASrB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAaT"}

package/dist/utils/assets.js

@@ -1,15 +1,8 @@
 import { parseUnits } from 'viem';
-/**
- * Parse human-readable amount to wei/smallest unit
- * @param amount - Human-readable amount (e.g. 1.5)
- * @param decimals - Token decimals
- * @returns Amount in smallest unit (wei equivalent)
- */
-export function parseAssetAmount(amount, decimals) {
-    // Convert number to string with proper precision
-    const amountStr = amount.toString();
-    // Use viem's parseUnits for proper decimal handling
-    return parseUnits(amountStr, decimals);
+export function parseAssetAmount(asset, amount) {
+    if (amount === undefined)
+        return undefined;
+    return parseUnits(amount.toString(), asset.metadata.decimals);
 }
 /**
  * Convert wei/smallest unit back to human-readable amount
@@ -27,6 +20,14 @@ export function formatAssetAmount(amount, decimals) {
     const result = `${wholePart}.${fractionalStr}`;
     return parseFloat(result);
 }
+/**
+ * Check if asset is a native asset (e.g. ETH)
+ * @param asset - Asset definition
+ * @returns Whether the asset is native
+ */
+export function isNativeAsset(asset) {
+    return asset.type === 'native';
+}
 /**
  * Check if asset is supported on a specific chain
  * @param asset - Asset definition
@@ -41,13 +42,16 @@ export function isAssetSupportedOnChain(asset, chainId) {
  * @param asset - Asset definition
  * @param chainId - Chain ID
  * @returns Asset address on the specified chain
- * @throws Error if asset is not supported on the chain
+ * @throws Error if asset is not supported on the chain or is a native asset
  */
 export function getAssetAddress(asset, chainId) {
     const address = asset.address[chainId];
     if (!address) {
         throw new Error(`Asset ${asset.metadata.symbol} is not supported on chain ${chainId}`);
     }
+    if (address === 'native') {
+        throw new Error(`Asset ${asset.metadata.symbol} is a native asset and has no contract address.`);
+    }
     return address;
 }
 //# sourceMappingURL=assets.js.map

package/dist/utils/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/utils/assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAKjC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAgB;IAC/D,iDAAiD;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAEnC,oDAAoD;IACpD,OAAO,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,oCAAoC;IACpC,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;IAClC,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAA;IAEvC,+CAA+C;IAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,GAAG,SAAS,IAAI,aAAa,EAAE,CAAA;IAE9C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAY,EACZ,OAAyB;IAEzB,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,OAAyB;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,QAAQ,CAAC,MAAM,8BAA8B,OAAO,EAAE,CACtE,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/utils/assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAcjC,MAAM,UAAU,gBAAgB,CAC9B,KAAY,EACZ,MAA0B;IAE1B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,oCAAoC;IACpC,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;IAClC,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAA;IAEvC,+CAA+C;IAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,GAAG,SAAS,IAAI,aAAa,EAAE,CAAA;IAE9C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAY,EACZ,OAAyB;IAEzB,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,OAAyB;IAEzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,QAAQ,CAAC,MAAM,8BAA8B,OAAO,EAAE,CACtE,CAAA;IACH,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,QAAQ,CAAC,MAAM,iDAAiD,CAChF,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/utils/assets.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
-import { MockUSDCAsset, MockWETHAsset } from '../test/MockAssets.js';
-import { isAssetSupportedOnChain } from './assets.js';
+import { MockUSDCAsset, MockWETHAsset } from '../__mocks__/MockAssets.js';
+import { isAssetSupportedOnChain, parseAssetAmount } from './assets.js';
 describe('Asset Utilities', () => {
     describe('isAssetSupportedOnChain', () => {
         it('should return true for asset on supported chain', () => {
@@ -20,5 +20,17 @@ describe('Asset Utilities', () => {
             expect(MockWETHAsset.type).toBe('erc20');
         });
     });
+    describe('parseAssetAmount', () => {
+        it('converts human-readable amount to wei using asset decimals', () => {
+            expect(parseAssetAmount(MockUSDCAsset, 100)).toBe(100000000n);
+            expect(parseAssetAmount(MockWETHAsset, 1)).toBe(1000000000000000000n);
+        });
+        it('returns undefined when amount is undefined', () => {
+            expect(parseAssetAmount(MockUSDCAsset, undefined)).toBeUndefined();
+        });
+        it('handles fractional amounts', () => {
+            expect(parseAssetAmount(MockUSDCAsset, 0.5)).toBe(500000n);
+        });
+    });
 });
 //# sourceMappingURL=assets.test.js.map

package/dist/utils/assets.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.test.js","sourceRoot":"","sources":["../../src/utils/assets.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC/C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"assets.test.js","sourceRoot":"","sources":["../../src/utils/assets.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE7E,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC/C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC7D,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACvE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;QACpE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Seconds per year for APY calculations (365 days)
+ */
+export declare const SECONDS_PER_YEAR = 31536000n;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAA"}

package/dist/utils/constants.js

@@ -0,0 +1,5 @@
+/**
+ * Seconds per year for APY calculations (365 days)
+ */
+export const SECONDS_PER_YEAR = 31536000n;
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA"}

package/dist/utils/permit2.d.ts

@@ -0,0 +1,46 @@
+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
+ */
+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>;
+//# sourceMappingURL=permit2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.d.ts","sourceRoot":"","sources":["../../src/utils/permit2.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;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,OAAO,GACtB,eAAe,CAcjB;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"}

package/dist/utils/permit2.js

@@ -0,0 +1,100 @@
+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
+ */
+export function buildTokenApprovalTx(token, permit2Address) {
+    const data = encodeFunctionData({
+        abi: erc20Abi,
+        functionName: 'approve',
+        // ERC20 -> Permit2: maxUint256 is the Uniswap-canonical pattern.
+        // Permit2 is immutable with no owner — spending is scoped by its own allowance system.
+        args: [permit2Address, maxUint256],
+    });
+    return {
+        to: token,
+        data,
+        value: 0n,
+    };
+}
+/**
+ * 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],
+    });
+}
+//# sourceMappingURL=permit2.js.map

package/dist/utils/permit2.js.map

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

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

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

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

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