@eth-optimism/actions-sdk 0.2.0 → 0.4.0

package/dist/utils/approve.test.js

@@ -0,0 +1,203 @@
+import { decodeFunctionData } from 'viem';
+import { describe, expect, it, vi } from 'vitest';
+import { buildApprovalTxIfNeeded, buildErc20ApprovalTx, buildPermit2ApprovalTx, buildTokenApprovalTx, checkPermit2Allowance, checkTokenAllowance, DEFAULT_PERMIT2_EXPIRY_SECONDS, getApprovalDeficit, } from './approve.js';
+const PERMIT2_ABI = [
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'token', type: 'address' },
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint160' },
+            { name: 'expiration', type: 'uint48' },
+        ],
+        outputs: [],
+    },
+];
+const TOKEN = '0x1111111111111111111111111111111111111111';
+const OWNER = '0x2222222222222222222222222222222222222222';
+const SPENDER = '0x3333333333333333333333333333333333333333';
+const PERMIT2 = '0x000000000022D473030F116dDEE9F6B43aC78BA3';
+describe('checkPermit2Allowance', () => {
+    it('returns parsed allowance data', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue([
+                1000000n, // amount (uint160)
+                1700000000, // expiration (uint48)
+                5, // nonce (uint48)
+            ]),
+        };
+        const result = await checkPermit2Allowance({
+            publicClient,
+            permit2Address: PERMIT2,
+            owner: OWNER,
+            token: TOKEN,
+            spender: SPENDER,
+        });
+        expect(result.amount).toBe(1000000n);
+        expect(result.expiration).toBe(1700000000);
+        expect(result.nonce).toBe(5);
+        expect(publicClient.readContract).toHaveBeenCalledWith(expect.objectContaining({
+            address: PERMIT2,
+            functionName: 'allowance',
+            args: [OWNER, TOKEN, SPENDER],
+        }));
+    });
+});
+describe('checkTokenAllowance', () => {
+    it('returns token allowance as bigint', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(500000n),
+        };
+        const result = await checkTokenAllowance({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+        });
+        expect(result).toBe(500000n);
+        expect(publicClient.readContract).toHaveBeenCalledWith(expect.objectContaining({
+            address: TOKEN,
+            functionName: 'allowance',
+            args: [OWNER, SPENDER],
+        }));
+    });
+});
+describe('buildTokenApprovalTx', () => {
+    it('builds max approval to Permit2', () => {
+        const tx = buildTokenApprovalTx(TOKEN, PERMIT2);
+        expect(tx.to).toBe(TOKEN);
+        expect(tx.value).toBe(0n);
+        expect(tx.data).toMatch(/^0x/);
+        // Should encode approve(permit2, maxUint256)
+        expect(tx.data.length).toBeGreaterThan(10);
+    });
+});
+describe('buildPermit2ApprovalTx', () => {
+    it('approves exact amount with default expiry', () => {
+        const before = Math.floor(Date.now() / 1000);
+        const amount = 100000000n;
+        const tx = buildPermit2ApprovalTx({
+            permit2Address: PERMIT2,
+            token: TOKEN,
+            spender: SPENDER,
+            amount,
+        });
+        expect(tx.to).toBe(PERMIT2);
+        expect(tx.value).toBe(0n);
+        const decoded = decodeFunctionData({ abi: PERMIT2_ABI, data: tx.data });
+        const [, , decodedAmount, expiration] = decoded.args;
+        expect(decodedAmount).toBe(amount);
+        expect(Number(expiration)).toBeGreaterThanOrEqual(before + DEFAULT_PERMIT2_EXPIRY_SECONDS);
+    });
+    it('uses custom expiry when provided', () => {
+        const before = Math.floor(Date.now() / 1000);
+        const customExpiry = 7 * 24 * 60 * 60; // 7 days
+        const tx = buildPermit2ApprovalTx({
+            permit2Address: PERMIT2,
+            token: TOKEN,
+            spender: SPENDER,
+            amount: 100000000n,
+            expirySeconds: customExpiry,
+        });
+        const decoded = decodeFunctionData({ abi: PERMIT2_ABI, data: tx.data });
+        const [, , , expiration] = decoded.args;
+        expect(Number(expiration)).toBeGreaterThanOrEqual(before + customExpiry);
+        expect(Number(expiration)).toBeLessThan(before + DEFAULT_PERMIT2_EXPIRY_SECONDS);
+    });
+});
+describe('buildErc20ApprovalTx', () => {
+    it('builds approval for exact amount', () => {
+        const tx = buildErc20ApprovalTx(TOKEN, SPENDER, 500000n);
+        expect(tx.to).toBe(TOKEN);
+        expect(tx.value).toBe(0n);
+        expect(tx.data).toMatch(/^0x/);
+    });
+});
+describe('getApprovalDeficit', () => {
+    it('returns 0n when allowance is sufficient', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(1000000n),
+        };
+        const deficit = await getApprovalDeficit({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(deficit).toBe(0n);
+    });
+    it('returns deficit when allowance is insufficient', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(300000n),
+        };
+        const deficit = await getApprovalDeficit({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(deficit).toBe(200000n);
+    });
+    it('returns full amount when allowance is zero', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(0n),
+        };
+        const deficit = await getApprovalDeficit({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(deficit).toBe(500000n);
+    });
+});
+describe('buildApprovalTxIfNeeded', () => {
+    it('returns undefined when allowance is sufficient', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(1000000n),
+        };
+        const tx = await buildApprovalTxIfNeeded({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(tx).toBeUndefined();
+    });
+    it('returns approval tx for the deficit only', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(300000n),
+        };
+        const tx = await buildApprovalTxIfNeeded({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(tx).toBeDefined();
+        expect(tx.to).toBe(TOKEN);
+        expect(tx.value).toBe(0n);
+    });
+    it('returns approval for full amount when allowance is zero', async () => {
+        const publicClient = {
+            readContract: vi.fn().mockResolvedValue(0n),
+        };
+        const tx = await buildApprovalTxIfNeeded({
+            publicClient,
+            token: TOKEN,
+            owner: OWNER,
+            spender: SPENDER,
+            amount: 500000n,
+        });
+        expect(tx).toBeDefined();
+        expect(tx.to).toBe(TOKEN);
+    });
+});
+//# sourceMappingURL=approve.test.js.map

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

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

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
@@ -36,4 +35,10 @@ export declare function isAssetSupportedOnChain(asset: Asset, chainId: Supported
  * @throws Error if asset is not supported on the chain or is a native asset
  */
 export declare function getAssetAddress(asset: Asset, chainId: SupportedChainId): Address;
+/**
+ * Get all non-native contract addresses for an asset across all chains, lowercased.
+ * @param asset - Asset to extract addresses from
+ * @returns Array of lowercased contract addresses
+ */
+export declare function getAllAssetAddresses(asset: Asset): string[];
 //# 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;;;;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"}
+{"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;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAO3D"}

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
@@ -61,4 +54,14 @@ export function getAssetAddress(asset, chainId) {
     }
     return address;
 }
+/**
+ * Get all non-native contract addresses for an asset across all chains, lowercased.
+ * @param asset - Asset to extract addresses from
+ * @returns Array of lowercased contract addresses
+ */
+export function getAllAssetAddresses(asset) {
+    return Object.values(asset.address)
+        .filter((addr) => addr !== undefined && addr !== 'native')
+        .map((addr) => addr.toLowerCase());
+}
 //# 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;;;;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"}
+{"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;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;SAChC,MAAM,CACL,CAAC,IAAI,EAAsD,EAAE,CAC3D,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,CAC1C;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AACtC,CAAC"}

package/dist/utils/assets.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { MockUSDCAsset, MockWETHAsset } from '../__mocks__/MockAssets.js';
-import { isAssetSupportedOnChain } from './assets.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,2BAA2B,CAAA;AACxE,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/validateAddresses.d.ts

@@ -0,0 +1,32 @@
+import type { Address } from 'viem';
+import type { SupportedChainId } from '../constants/supportedChains.js';
+import type { AssetsConfig, LendConfig, SwapConfig } from '../types/actions.js';
+type NamedAddresses = Record<string, Address>;
+/**
+ * Validates all values in an address map.
+ * Values may be a single Address or a record of named addresses.
+ * Collects all failures before throwing a single Error listing every invalid entry.
+ * @returns The original map reference if all addresses are valid.
+ * @throws Error listing all invalid addresses with their chain IDs and key names.
+ */
+export declare function validateAddressMap<M extends Partial<Record<number, Address | NamedAddresses>>>(map: M): M;
+/**
+ * Validates a Partial<Record<SupportedChainId, Address | 'native'>> asset address map.
+ * Skips entries where the value is 'native'.
+ * Collects all failures before throwing a single Error.
+ * @throws Error listing all invalid addresses with their chain IDs.
+ */
+export declare function validateAssetAddresses(map: Partial<Record<SupportedChainId, Address | 'native'>>): void;
+/**
+ * Validates all developer-supplied addresses in an ActionsConfig.
+ * Iterates all lend and swap providers generically, so new providers are covered automatically.
+ * Collects all failures before throwing a single Error.
+ * @throws Error listing all invalid addresses with their locations and chain IDs.
+ */
+export declare function validateConfigAddresses(config: {
+    lend?: LendConfig;
+    swap?: SwapConfig;
+    assets?: AssetsConfig;
+}): void;
+export {};
+//# sourceMappingURL=validateAddresses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateAddresses.d.ts","sourceRoot":"","sources":["../../src/utils/validateAddresses.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,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAK9E,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE7C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,EAC3D,GAAG,EAAE,CAAC,GAAG,CAAC,CA4BX;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,GACzD,IAAI,CAeN;AAyCD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,GAAG,IAAI,CA4BP"}

package/dist/utils/validateAddresses.js

@@ -0,0 +1,103 @@
+import { getAddress } from 'viem';
+/**
+ * Validates all values in an address map.
+ * Values may be a single Address or a record of named addresses.
+ * Collects all failures before throwing a single Error listing every invalid entry.
+ * @returns The original map reference if all addresses are valid.
+ * @throws Error listing all invalid addresses with their chain IDs and key names.
+ */
+export function validateAddressMap(map) {
+    const errors = [];
+    for (const [chainId, value] of Object.entries(map)) {
+        if (value === undefined)
+            continue;
+        if (typeof value === 'string') {
+            try {
+                getAddress(value);
+            }
+            catch {
+                errors.push(`  - [${chainId}]: ${value} (not a valid EVM address)`);
+            }
+        }
+        else {
+            for (const [key, addr] of Object.entries(value)) {
+                try {
+                    getAddress(addr);
+                }
+                catch {
+                    errors.push(`  - ${key}[${chainId}]: ${addr} (not a valid EVM address)`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Invalid addresses found:\n${errors.join('\n')}`);
+    }
+    return map;
+}
+/**
+ * Validates a Partial<Record<SupportedChainId, Address | 'native'>> asset address map.
+ * Skips entries where the value is 'native'.
+ * Collects all failures before throwing a single Error.
+ * @throws Error listing all invalid addresses with their chain IDs.
+ */
+export function validateAssetAddresses(map) {
+    const errors = [];
+    for (const [chainId, value] of Object.entries(map)) {
+        if (value === undefined || value === 'native')
+            continue;
+        try {
+            getAddress(value);
+        }
+        catch {
+            errors.push(`  - [${chainId}]: ${value} (not a valid EVM address)`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Invalid addresses found:\n${errors.join('\n')}`);
+    }
+}
+function assetAddresses(asset, path) {
+    return Object.entries(asset.address)
+        .filter(([, addr]) => addr !== 'native')
+        .map(([chainId, addr]) => ({
+        path: `${path}.address[${chainId}]`,
+        value: addr,
+    }));
+}
+function lendProviderAddresses(config, providerPath) {
+    return ['marketAllowlist', 'marketBlocklist'].flatMap((key) => (config[key] ?? []).flatMap((m, i) => [
+        { path: `${providerPath}.${key}[${i}].address`, value: m.address },
+        ...assetAddresses(m.asset, `${providerPath}.${key}[${i}].asset`),
+    ]));
+}
+function swapProviderAddresses(config, providerPath) {
+    return ['marketAllowlist', 'marketBlocklist'].flatMap((key) => (config[key] ?? []).flatMap((m, i) => m.assets.flatMap((asset, j) => assetAddresses(asset, `${providerPath}.${key}[${i}].assets[${j}]`))));
+}
+/**
+ * Validates all developer-supplied addresses in an ActionsConfig.
+ * Iterates all lend and swap providers generically, so new providers are covered automatically.
+ * Collects all failures before throwing a single Error.
+ * @throws Error listing all invalid addresses with their locations and chain IDs.
+ */
+export function validateConfigAddresses(config) {
+    const addresses = [
+        ...Object.entries(config.lend ?? {}).flatMap(([name, cfg]) => lendProviderAddresses(cfg, `lend.${name}`)),
+        ...Object.entries(config.swap ?? {}).flatMap(([name, cfg]) => swapProviderAddresses(cfg, `swap.${name}`)),
+        ...(config.assets?.allow ?? []).flatMap((a, i) => assetAddresses(a, `assets.allow[${i}]`)),
+        ...(config.assets?.block ?? []).flatMap((a, i) => assetAddresses(a, `assets.block[${i}]`)),
+    ];
+    const errors = addresses.flatMap(({ path, value }) => {
+        try {
+            getAddress(value);
+            return [];
+        }
+        catch {
+            return [`  - ${path}: ${value} (not a valid EVM address)`];
+        }
+    });
+    if (errors.length > 0) {
+        throw new Error(`Invalid addresses found:\n${errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=validateAddresses.js.map

package/dist/utils/validateAddresses.js.map

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

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

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

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

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