@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/utils/parsing.js

@@ -0,0 +1,199 @@
+import { formatUnits, getAddress } from "viem";
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export function parseBigIntField(value, params) {
+    try {
+        if (typeof value !== "string")
+            throw new Error("invalid bigint input");
+        return BigInt(value);
+    }
+    catch {
+        params.errors.push({
+            code: "DEFAULT_APPLIED",
+            severity: "warning",
+            message: `Failed to parse bigint at ${params.path}; defaulted to 0.`,
+            paths: [params.path],
+            entityId: params.entityId,
+            source: params.source,
+            originalValue: value,
+            normalizedValue: "0",
+        });
+        return 0n;
+    }
+}
+export function parseRatio1e4(value, params) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed))
+        return parsed / 1e4;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Failed to parse ratio at ${params.path}; defaulted to 0.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: 0,
+    });
+    return 0;
+}
+export function parseAddressField(value, params) {
+    if (value) {
+        try {
+            return getAddress(value);
+        }
+        catch {
+            // handled below
+        }
+    }
+    const fallback = params.fallback ?? ZERO_ADDRESS;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Missing or invalid address at ${params.path}; defaulted to ${params.fallbackLabel ?? "zero address"}.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: fallback,
+    });
+    return fallback;
+}
+export function parseAddressArrayField(value, params) {
+    if (!Array.isArray(value)) {
+        params.errors.push({
+            code: "DEFAULT_APPLIED",
+            severity: "warning",
+            message: `Missing address array at ${params.path}; defaulted to empty array.`,
+            paths: [params.path],
+            entityId: params.entityId,
+            source: params.source,
+            originalValue: value,
+            normalizedValue: [],
+        });
+        return [];
+    }
+    return value.map((entry, index) => parseAddressField(entry, {
+        ...params,
+        path: `${params.path}[${index}]`,
+    }));
+}
+export function parseStringField(value, params) {
+    const fallback = params.fallback ?? "";
+    if (typeof value === "string")
+        return value;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Missing string at ${params.path}; defaulted to ${JSON.stringify(fallback)}.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: fallback,
+    });
+    return fallback;
+}
+export function parseNumberField(value, params) {
+    const fallback = params.fallback ?? 0;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Missing or invalid number at ${params.path}; defaulted to ${fallback}.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: fallback,
+    });
+    return fallback;
+}
+export function parseBooleanField(value, params) {
+    const fallback = params.fallback ?? false;
+    if (typeof value === "boolean")
+        return value;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Missing boolean at ${params.path}; defaulted to ${fallback}.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: fallback,
+    });
+    return fallback;
+}
+export function parseDaysToLiquidation(value, params) {
+    if (value === "Infinity" || value === "MoreThanAYear")
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Failed to parse daysToLiquidation at ${params.path}; defaulted to Infinity.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: String(value),
+        normalizedValue: "Infinity",
+    });
+    return "Infinity";
+}
+export function parseTimestampField(value, params) {
+    if (!value) {
+        params.errors.push({
+            code: "DEFAULT_APPLIED",
+            severity: "warning",
+            message: `Missing timestamp at ${params.path}; defaulted to 0.`,
+            paths: [params.path],
+            entityId: params.entityId,
+            source: params.source,
+            normalizedValue: 0,
+        });
+        return 0;
+    }
+    const parsed = Date.parse(value);
+    if (Number.isFinite(parsed))
+        return Math.floor(parsed / 1000);
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Failed to parse timestamp at ${params.path}; defaulted to 0.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: 0,
+    });
+    return 0;
+}
+export function parsePerformanceFee(value, params) {
+    try {
+        const parsed = Number(formatUnits(BigInt(value ?? "0"), 18));
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    catch {
+        // handled below
+    }
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: `Failed to parse performance fee at ${params.path}; defaulted to 0.`,
+        paths: [params.path],
+        entityId: params.entityId,
+        source: params.source,
+        originalValue: value,
+        normalizedValue: 0,
+    });
+    return 0;
+}
+//# sourceMappingURL=parsing.js.map

package/dist/src/utils/parsing.js.map

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

package/dist/src/utils/queryNames.d.ts

@@ -0,0 +1,28 @@
+import type { ABIService } from "../services/abiService/abiService.js";
+import type { AccountOnchainAdapter } from "../services/accountService/adapters/accountOnchainAdapter/accountOnchainAdapter.js";
+import type { AccountVaultsSubgraphAdapter } from "../services/accountService/adapters/accountOnchainAdapter/accountVaultsSubgraphAdapter.js";
+import type { AccountV3Adapter } from "../services/accountService/adapters/accountV3Adapter/accountV3Adapter.js";
+import type { DeploymentService } from "../services/deploymentService/deploymentService.js";
+import type { EulerLabelsURLAdapter } from "../services/eulerLabelsService/eulerLabelsService.js";
+import type { IntrinsicApyV3Adapter } from "../services/intrinsicApyService/adapters/intrinsicApyV3Adapter/index.js";
+import type { OracleAdapterService } from "../services/oracleAdapterService/oracleAdapterService.js";
+import type { PricingBackendClient } from "../services/priceService/backendClient.js";
+import type { PriceService } from "../services/priceService/priceService.js";
+import type { RewardsDirectAdapter } from "../services/rewardsService/adapters/rewardsDirectAdapter/index.js";
+import type { RewardsV3Adapter } from "../services/rewardsService/adapters/rewardsV3Adapter/index.js";
+import type { RewardsService } from "../services/rewardsService/rewardsService.js";
+import type { SwapService } from "../services/swapService/swapService.js";
+import type { TokenlistService } from "../services/tokenlistService/tokenlistService.js";
+import type { WalletOnchainAdapter } from "../services/walletService/adapters/walletOnchainAdapter.js";
+import type { EVaultOnchainAdapter } from "../services/vaults/eVaultService/adapters/eVaultOnchainAdapter/eVaultOnchainAdapter.js";
+import type { EVaultV3Adapter } from "../services/vaults/eVaultService/adapters/eVaultV3Adapter/eVaultV3Adapter.js";
+import type { EulerEarnOnchainAdapter } from "../services/vaults/eulerEarnService/adapters/eulerEarnOnchainAdapter.js";
+import type { EulerEarnV3Adapter } from "../services/vaults/eulerEarnService/adapters/eulerEarnV3Adapter.js";
+import type { SecuritizeVaultOnchainAdapter } from "../services/vaults/securitizeVaultService/adapters/securitizeVaultOnchainAdapter.js";
+import type { VaultTypeSubgraphAdapter } from "../services/vaults/vaultMetaService/adapters/VaultTypeSubgraphAdapter.js";
+import type { VaultTypeV3Adapter } from "../services/vaults/vaultMetaService/adapters/VaultTypeV3Adapter.js";
+import type { BatchSimulationAdapter } from "../plugins/batchSimulation.js";
+import type { KeyringPluginAdapter } from "../plugins/keyring/keyringPlugin.js";
+import type { PythPluginAdapter } from "../plugins/pyth/pythPlugin.js";
+export type QueryMethodName<T> = Extract<keyof T, `query${string}`>;
+export type EulerSDKQueryName = QueryMethodName<ABIService> | QueryMethodName<AccountOnchainAdapter> | QueryMethodName<AccountVaultsSubgraphAdapter> | QueryMethodName<AccountV3Adapter> | QueryMethodName<typeof DeploymentService> | QueryMethodName<EulerLabelsURLAdapter> | QueryMethodName<IntrinsicApyV3Adapter> | QueryMethodName<OracleAdapterService> | QueryMethodName<PricingBackendClient> | QueryMethodName<PriceService> | QueryMethodName<RewardsDirectAdapter> | QueryMethodName<RewardsV3Adapter> | QueryMethodName<RewardsService> | QueryMethodName<SwapService> | QueryMethodName<TokenlistService> | QueryMethodName<WalletOnchainAdapter> | QueryMethodName<EVaultOnchainAdapter> | QueryMethodName<EVaultV3Adapter> | QueryMethodName<EulerEarnOnchainAdapter> | QueryMethodName<EulerEarnV3Adapter> | QueryMethodName<SecuritizeVaultOnchainAdapter> | QueryMethodName<VaultTypeSubgraphAdapter> | QueryMethodName<VaultTypeV3Adapter> | QueryMethodName<BatchSimulationAdapter> | QueryMethodName<KeyringPluginAdapter> | QueryMethodName<PythPluginAdapter>;

package/dist/src/utils/queryNames.js

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

package/dist/src/utils/queryNames.js.map

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

package/dist/src/utils/stateOverrides/accessList.d.ts

@@ -0,0 +1,14 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+type CallParams = {
+    data: Hex;
+    to: Address;
+    from?: Address;
+};
+/**
+ * Discover storage slots accessed by a call using eth_createAccessList.
+ * Works on all nodes including Anvil (unlike debug_traceCall with prestateTracer).
+ *
+ * @returns Map from contract address to list of storage slots accessed
+ */
+export declare function getAccessedSlots(client: PublicClient, params: CallParams): Promise<Map<Address, Hex[]>>;
+export {};

package/dist/src/utils/stateOverrides/accessList.js

@@ -0,0 +1,24 @@
+import { getAddress } from "viem";
+/**
+ * Discover storage slots accessed by a call using eth_createAccessList.
+ * Works on all nodes including Anvil (unlike debug_traceCall with prestateTracer).
+ *
+ * @returns Map from contract address to list of storage slots accessed
+ */
+export async function getAccessedSlots(client, params) {
+    const tx = {
+        to: params.to,
+        data: params.data,
+        ...(params.from ? { from: params.from } : {}),
+    };
+    const result = (await client.request({
+        method: "eth_createAccessList",
+        params: [tx, "latest"],
+    }));
+    const map = new Map();
+    for (const entry of result.accessList || []) {
+        map.set(getAddress(entry.address), (entry.storageKeys || []));
+    }
+    return map;
+}
+//# sourceMappingURL=accessList.js.map

package/dist/src/utils/stateOverrides/accessList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessList.js","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/accessList.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,UAAU,EAAE,MAAM,MAAM,CAAC;AAQ7E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAoB,EACpB,MAAkB;IAElB,MAAM,EAAE,GAAG;QACV,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,MAAM,EAAE,sBAA6B;QACrC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAQ;KAC7B,CAAC,CAAQ,CAAC;IAEX,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC7C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAU,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/src/utils/stateOverrides/approvalOverrides.d.ts

@@ -0,0 +1,20 @@
+import { type Address, type PublicClient, type StateMapping, type StateOverride } from "viem";
+/**
+ * Compute Permit2 allowance storage slots for the given approvals.
+ *
+ * Permit2 uses: mapping(owner => mapping(token => mapping(spender => PackedAllowance)))
+ * Storage slot 1 is the base slot for the allowance mapping.
+ */
+export declare function computePermit2StateDiff(account: Address, approvals: [Address, Address][]): StateMapping;
+/**
+ * Generate state overrides for ERC20 approvals and Permit2 allowances.
+ *
+ * 1. Computes Permit2 storage slots deterministically (keccak256 mapping layout)
+ * 2. Traces actual ERC20 approve() calls to discover approval storage slots
+ *
+ * @param client - viem PublicClient (must support eth_createAccessList and eth_call with state overrides)
+ * @param account - token owner address
+ * @param approvals - array of [assetAddress, spenderAddress] pairs
+ * @param permit2Address - Permit2 contract address
+ */
+export declare function getApprovalOverrides(client: PublicClient, account: Address, approvals: [Address, Address][], permit2Address: Address): Promise<StateOverride>;

package/dist/src/utils/stateOverrides/approvalOverrides.js

@@ -0,0 +1,111 @@
+import { erc20Abi, encodePacked, getAddress, hexToBigInt, keccak256, maxUint256, toHex, } from "viem";
+import { encodeFunctionData } from "viem/utils";
+import { getAccessedSlots } from "./accessList.js";
+/**
+ * Compute Permit2 allowance storage slots for the given approvals.
+ *
+ * Permit2 uses: mapping(owner => mapping(token => mapping(spender => PackedAllowance)))
+ * Storage slot 1 is the base slot for the allowance mapping.
+ */
+export function computePermit2StateDiff(account, approvals) {
+    const stateDiff = [];
+    const seen = new Set();
+    for (const [asset, spender] of approvals) {
+        // Permit2 allowance mapping: mapping(address owner => mapping(address token => mapping(address spender => PackedAllowance)))
+        // Slot 1 is the base mapping slot
+        const baseSlot = keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(account), 1n]));
+        const assetSlot = keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(asset), hexToBigInt(baseSlot)]));
+        const spenderSlot = keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(spender), hexToBigInt(assetSlot)]));
+        if (!seen.has(spenderSlot)) {
+            seen.add(spenderSlot);
+            stateDiff.push({ slot: spenderSlot, value: toHex(maxUint256) });
+        }
+    }
+    return stateDiff;
+}
+/**
+ * Discover ERC20 allowance storage slots using eth_createAccessList,
+ * then create overrides that set them to maxUint256.
+ *
+ * Traces allowance(account, permit2) to find candidate slots, then
+ * tests each by overriding and re-reading to verify.
+ */
+async function discoverAllowanceSlots(client, account, assets, permit2) {
+    const stateOverride = [];
+    const valueHex = toHex(maxUint256, { size: 32 });
+    for (const asset of assets) {
+        try {
+            const accessedSlots = await getAccessedSlots(client, {
+                data: encodeFunctionData({
+                    abi: erc20Abi,
+                    functionName: "allowance",
+                    args: [account, permit2],
+                }),
+                to: asset,
+            });
+            const tokenSlots = accessedSlots.get(getAddress(asset));
+            if (!tokenSlots || tokenSlots.length === 0)
+                continue;
+            // Test each candidate: override slot with maxUint256, read allowance, verify
+            const testResults = await Promise.all(tokenSlots.map((slot) => client
+                .readContract({
+                abi: erc20Abi,
+                address: asset,
+                functionName: "allowance",
+                args: [account, permit2],
+                stateOverride: [
+                    {
+                        address: asset,
+                        stateDiff: [{ slot, value: valueHex }],
+                    },
+                ],
+            })
+                .catch(() => 0n)));
+            const stateDiff = [];
+            for (let i = 0; i < tokenSlots.length; i++) {
+                if (testResults[i] === maxUint256) {
+                    stateDiff.push({ slot: tokenSlots[i], value: valueHex });
+                }
+            }
+            if (stateDiff.length > 0) {
+                stateOverride.push({ address: asset, stateDiff });
+            }
+        }
+        catch (e) {
+            console.warn(`[approvalOverrides] slot discovery failed for ${asset}:`, e);
+        }
+    }
+    return stateOverride;
+}
+/**
+ * Generate state overrides for ERC20 approvals and Permit2 allowances.
+ *
+ * 1. Computes Permit2 storage slots deterministically (keccak256 mapping layout)
+ * 2. Traces actual ERC20 approve() calls to discover approval storage slots
+ *
+ * @param client - viem PublicClient (must support eth_createAccessList and eth_call with state overrides)
+ * @param account - token owner address
+ * @param approvals - array of [assetAddress, spenderAddress] pairs
+ * @param permit2Address - Permit2 contract address
+ */
+export async function getApprovalOverrides(client, account, approvals, permit2Address) {
+    if (approvals.length === 0)
+        return [];
+    const stateOverride = [];
+    // 1. Permit2 allowance overrides (deterministic slot computation)
+    const permit2StateDiff = computePermit2StateDiff(account, approvals);
+    if (permit2StateDiff.length > 0) {
+        stateOverride.push({
+            address: permit2Address,
+            stateDiff: permit2StateDiff,
+        });
+    }
+    // 2. ERC20 approval overrides (discovered via eth_createAccessList)
+    const uniqueAssets = [
+        ...new Set(approvals.map(([asset]) => getAddress(asset))),
+    ];
+    const allowanceOverrides = await discoverAllowanceSlots(client, account, uniqueAssets, permit2Address);
+    stateOverride.push(...allowanceOverrides);
+    return stateOverride;
+}
+//# sourceMappingURL=approvalOverrides.js.map

package/dist/src/utils/stateOverrides/approvalOverrides.js.map

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

package/dist/src/utils/stateOverrides/balanceOverrides.d.ts

@@ -0,0 +1,13 @@
+import { type Address, type PublicClient, type StateOverride } from "viem";
+/**
+ * Generate state overrides that give `account` sufficient ERC20 balances.
+ *
+ * For each token where the on-chain balance is below the requested amount,
+ * uses eth_createAccessList to discover the balanceOf storage slot, then builds
+ * a stateDiff that sets that slot to the desired value.
+ *
+ * @param client - viem PublicClient (must support eth_createAccessList and eth_call with state overrides)
+ * @param account - address whose balance to override
+ * @param tokens - array of [tokenAddress, requiredAmount]
+ */
+export declare function getBalanceOverrides(client: PublicClient, account: Address, tokens: [Address, bigint][]): Promise<StateOverride>;

package/dist/src/utils/stateOverrides/balanceOverrides.js

@@ -0,0 +1,145 @@
+import { erc20Abi, getAddress, numberToHex, } from "viem";
+import { encodeFunctionData } from "viem/utils";
+import { getAccessedSlots } from "./accessList.js";
+const balanceSlotCache = new Map();
+// wM token requires special storage layout handling
+const WM_CONTRACT = "0x437cc33344a0B27A429f795ff6B469C72698B291";
+function shouldSkipCaching(token) {
+    return getAddress(token) === getAddress(WM_CONTRACT);
+}
+function applySpecialCasing(stateOverride) {
+    const result = [];
+    for (const override of stateOverride) {
+        if (getAddress(override.address) === getAddress(WM_CONTRACT) &&
+            override.stateDiff) {
+            // wM token: shift values left by 8 bits and write to adjacent slot
+            const newStateDiff = override.stateDiff.flatMap((diff) => {
+                const shiftedValue = `0x${(BigInt(diff.value) << 8n)
+                    .toString(16)
+                    .padStart(64, "0")}`;
+                return [
+                    { slot: diff.slot, value: shiftedValue },
+                    {
+                        slot: `0x${(BigInt(diff.slot) + 1n)
+                            .toString(16)
+                            .padStart(64, "0")}`,
+                        value: shiftedValue,
+                    },
+                ];
+            });
+            result.push({ ...override, stateDiff: newStateDiff });
+        }
+        else {
+            result.push(override);
+        }
+    }
+    return result;
+}
+function findIndexOfLargest(arr) {
+    if (arr.length === 0)
+        return -1;
+    let maxIndex = 0;
+    let maxValue = arr[0];
+    for (let i = 1; i < arr.length; i++) {
+        if (arr[i] > maxValue) {
+            maxValue = arr[i];
+            maxIndex = i;
+        }
+    }
+    return maxIndex;
+}
+/**
+ * Generate state overrides that give `account` sufficient ERC20 balances.
+ *
+ * For each token where the on-chain balance is below the requested amount,
+ * uses eth_createAccessList to discover the balanceOf storage slot, then builds
+ * a stateDiff that sets that slot to the desired value.
+ *
+ * @param client - viem PublicClient (must support eth_createAccessList and eth_call with state overrides)
+ * @param account - address whose balance to override
+ * @param tokens - array of [tokenAddress, requiredAmount]
+ */
+export async function getBalanceOverrides(client, account, tokens) {
+    if (tokens.length === 0)
+        return [];
+    const chainId = client.chain?.id;
+    if (!chainId)
+        throw new Error("Client must have a chain configured");
+    const stateOverride = [];
+    // Batch-read current balances
+    const currentBalances = await Promise.all(tokens.map(([token]) => client
+        .readContract({
+        abi: erc20Abi,
+        address: token,
+        functionName: "balanceOf",
+        args: [account],
+    })
+        .catch(() => 0n)));
+    for (const [i, [token, requiredAmount]] of tokens.entries()) {
+        const currentBalance = currentBalances[i] ?? 0n;
+        if (currentBalance >= requiredAmount)
+            continue;
+        const cacheKey = `${chainId}:${account}:${token}`;
+        const valueHex = numberToHex(requiredAmount, { size: 32 });
+        // Check cache first
+        const cached = balanceSlotCache.get(cacheKey);
+        if (cached && !shouldSkipCaching(token)) {
+            stateOverride.push({
+                address: cached.address,
+                stateDiff: [{ slot: cached.slot, value: valueHex }],
+            });
+            continue;
+        }
+        // Use eth_createAccessList to find candidate storage slots
+        try {
+            const accessedSlots = await getAccessedSlots(client, {
+                data: encodeFunctionData({
+                    abi: erc20Abi,
+                    functionName: "balanceOf",
+                    args: [account],
+                }),
+                to: token,
+            });
+            const tokenSlots = accessedSlots.get(getAddress(token));
+            if (!tokenSlots || tokenSlots.length === 0)
+                continue;
+            const candidateSlots = tokenSlots.map((slot) => ({
+                address: getAddress(token),
+                slot,
+            }));
+            if (candidateSlots.length === 0)
+                continue;
+            // Test each candidate: override slot → read balanceOf → pick best
+            const testBalances = await Promise.all(candidateSlots.map((slot) => client
+                .readContract({
+                abi: erc20Abi,
+                address: token,
+                functionName: "balanceOf",
+                args: [account],
+                stateOverride: [
+                    {
+                        address: slot.address,
+                        stateDiff: [{ slot: slot.slot, value: valueHex }],
+                    },
+                ],
+            })
+                .catch(() => 0n)));
+            const bestIdx = findIndexOfLargest(testBalances);
+            const bestSlot = candidateSlots[bestIdx];
+            if (bestSlot) {
+                stateOverride.push({
+                    address: bestSlot.address,
+                    stateDiff: [{ slot: bestSlot.slot, value: valueHex }],
+                });
+                if (!shouldSkipCaching(token)) {
+                    balanceSlotCache.set(cacheKey, bestSlot);
+                }
+            }
+        }
+        catch (e) {
+            console.warn(`[balanceOverrides] slot discovery failed for ${token}:`, e);
+        }
+    }
+    return applySpecialCasing(stateOverride);
+}
+//# sourceMappingURL=balanceOverrides.js.map

package/dist/src/utils/stateOverrides/balanceOverrides.js.map

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

package/dist/src/utils/stateOverrides/getStateOverrides.d.ts

@@ -0,0 +1,31 @@
+import { type Address, type PublicClient, type StateOverride } from "viem";
+import type { TransactionPlan } from "../../services/executionService/executionServiceTypes.js";
+export type DeriveStateOverridesOptions = {
+    /** Override the native (ETH) balance. Defaults to 1000 ETH. Set to 0n to skip. */
+    nativeBalance?: bigint;
+    /** Permit2 contract address. Required for approval overrides. */
+    permit2Address: Address;
+};
+/**
+ * Generate all state overrides needed to simulate a TransactionPlan
+ * for an account that may not have sufficient tokens or approvals.
+ *
+ * Combines:
+ * - Native balance override (ETH)
+ * - ERC20 balance overrides (via storage slot discovery)
+ * - ERC20 approval + Permit2 allowance overrides
+ *
+ * @param client - viem PublicClient (must support eth_createAccessList and eth_call with state overrides)
+ * @param plan - TransactionPlan from the SDK's execution service
+ * @param account - the connected wallet address
+ * @param options - Permit2 address and optional native balance override
+ *
+ * @example
+ * ```ts
+ * const plan = sdk.executionService.planDeposit({ ... })
+ * const permit2 = sdk.deploymentService.getDeployment(chainId).addresses.coreAddrs.permit2
+ * const overrides = await deriveStateOverrides(client, plan, account, { permit2Address: permit2 })
+ * // Use overrides with simulateContract or eth_call
+ * ```
+ */
+export declare function deriveStateOverrides(client: PublicClient, plan: TransactionPlan, account: Address, options: DeriveStateOverridesOptions): Promise<StateOverride>;