@eth-optimism/actions-sdk 0.3.0 → 0.4.0

package/dist/utils/{permit2.js → approve.js}

@@ -51,21 +51,12 @@ export async function checkPermit2Allowance(params) {
     };
 }
 /**
- * Build ERC20 token approval transaction to Permit2
+ * 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) {
-    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,
-    };
+    return buildErc20ApprovalTx(token, permit2Address, maxUint256);
 }
 /**
  * Build Permit2 approval transaction for a spender
@@ -97,4 +88,47 @@ export async function checkTokenAllowance(params) {
         args: [owner, spender],
     });
 }
-//# sourceMappingURL=permit2.js.map
+// ─────────────────────────────────────────────────────────────────────────────
+// 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":""}

package/dist/utils/{permit2.test.js → approve.test.js}

@@ -1,6 +1,6 @@
 import { decodeFunctionData } from 'viem';
 import { describe, expect, it, vi } from 'vitest';
-import { buildPermit2ApprovalTx, buildTokenApprovalTx, checkPermit2Allowance, checkTokenAllowance, DEFAULT_PERMIT2_EXPIRY_SECONDS, } from './permit2.js';
+import { buildApprovalTxIfNeeded, buildErc20ApprovalTx, buildPermit2ApprovalTx, buildTokenApprovalTx, checkPermit2Allowance, checkTokenAllowance, DEFAULT_PERMIT2_EXPIRY_SECONDS, getApprovalDeficit, } from './approve.js';
 const PERMIT2_ABI = [
     {
         name: 'approve',
@@ -107,4 +107,97 @@ describe('buildPermit2ApprovalTx', () => {
         expect(Number(expiration)).toBeLessThan(before + DEFAULT_PERMIT2_EXPIRY_SECONDS);
     });
 });
-//# sourceMappingURL=permit2.test.js.map
+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

@@ -35,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;;;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"}
+{"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

@@ -54,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;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"}
+{"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/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":""}