@eulerxyz/euler-v2-sdk 0.2.7-beta → 0.2.9-beta

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

@@ -1,14 +1,33 @@
 import { type Address, type PublicClient, type StateOverride } from "viem";
+import { type SlotHints } from "./slotHints.js";
+export type GetBalanceOverridesOptions = {
+    /**
+     * Caller-supplied on-chain balances. When a token's balance here meets the
+     * required amount, the per-call `balanceOf` RPC is skipped and no override
+     * is emitted.
+     */
+    walletBalances?: Record<Address, bigint>;
+    /**
+     * Caller-supplied slot hints. When `balanceSlotIndex` is present for a
+     * token, the slot is computed cryptographically; access-list discovery is
+     * skipped. Missing entries fall back to `fetchErc20SlotHints` (sequential
+     * probing) before finally falling back to access-list discovery.
+     */
+    slotHints?: SlotHints;
+};
 /**
  * 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.
+ * Resolution order, per token:
+ *  1. Use caller-supplied wallet balance when sufficient → no work.
+ *  2. Read `balanceOf` on-chain; skip if sufficient.
+ *  3. Use caller-supplied `balanceSlotIndex` → compute slot cryptographically.
+ *  4. Use cached probed slot index (`fetchErc20SlotHints` cache) → same.
+ *  5. Probe sequentially via `fetchErc20SlotHints` (small N `eth_call`s).
+ *  6. Fall back to legacy `eth_createAccessList` discovery + per-slot probe.
  *
- * @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]
+ * Steps 3–5 are dramatically cheaper than (6) and work for the vast majority
+ * of ERC20 layouts. Step 6 remains as a safety net for exotic packed storage.
  */
-export declare function getBalanceOverrides(client: PublicClient, account: Address, tokens: [Address, bigint][]): Promise<StateOverride>;
+export declare function getBalanceOverrides(client: PublicClient, account: Address, tokens: [Address, bigint][], options?: GetBalanceOverridesOptions): Promise<StateOverride>;
 //# sourceMappingURL=balanceOverrides.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"balanceOverrides.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/balanceOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EAEZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAIlB,MAAM,MAAM,CAAC;AA6Dd;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GACzB,OAAO,CAAC,aAAa,CAAC,CAiGxB"}
+{"version":3,"file":"balanceOverrides.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/balanceOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EAEZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAIlB,MAAM,MAAM,CAAC;AAGd,OAAO,EAIN,KAAK,SAAS,EACd,MAAM,gBAAgB,CAAC;AA2DxB,MAAM,MAAM,0BAA0B,GAAG;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAC3B,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,aAAa,CAAC,CAyJxB"}

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

@@ -1,6 +1,7 @@
 import { erc20Abi, getAddress, numberToHex, } from "viem";
 import { encodeFunctionData } from "viem/utils";
 import { getAccessedSlots } from "./accessList.js";
+import { computeBalanceSlot, fetchErc20SlotHints, getCachedSlotHints, } from "./slotHints.js";
 const balanceSlotCache = new Map();
 // wM token requires special storage layout handling
 const WM_CONTRACT = "0x437cc33344a0B27A429f795ff6B469C72698B291";
@@ -51,23 +52,40 @@ function findIndexOfLargest(arr) {
 /**
  * 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.
+ * Resolution order, per token:
+ *  1. Use caller-supplied wallet balance when sufficient → no work.
+ *  2. Read `balanceOf` on-chain; skip if sufficient.
+ *  3. Use caller-supplied `balanceSlotIndex` → compute slot cryptographically.
+ *  4. Use cached probed slot index (`fetchErc20SlotHints` cache) → same.
+ *  5. Probe sequentially via `fetchErc20SlotHints` (small N `eth_call`s).
+ *  6. Fall back to legacy `eth_createAccessList` discovery + per-slot probe.
  *
- * @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]
+ * Steps 3–5 are dramatically cheaper than (6) and work for the vast majority
+ * of ERC20 layouts. Step 6 remains as a safety net for exotic packed storage.
  */
-export async function getBalanceOverrides(client, account, tokens) {
+export async function getBalanceOverrides(client, account, tokens, options = {}) {
     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
+    const { walletBalances, slotHints } = options;
+    // Determine which tokens still need work after applying caller-supplied
+    // balances. Tokens with `walletBalances[token] >= requiredAmount` need
+    // nothing at all.
+    const remaining = [];
+    for (const [token, requiredAmount] of tokens) {
+        const supplied = walletBalances?.[getAddress(token)];
+        if (supplied !== undefined && supplied >= requiredAmount)
+            continue;
+        remaining.push([token, requiredAmount]);
+    }
+    if (remaining.length === 0)
+        return [];
+    // Batch-read current balances for the remaining set (those without a
+    // caller-supplied sufficient balance).
+    const currentBalances = await Promise.all(remaining.map(([token]) => client
         .readContract({
         abi: erc20Abi,
         address: token,
@@ -75,13 +93,26 @@ export async function getBalanceOverrides(client, account, tokens) {
         args: [account],
     })
         .catch(() => 0n)));
-    for (const [i, [token, requiredAmount]] of tokens.entries()) {
+    for (const [i, [token, requiredAmount]] of remaining.entries()) {
         const currentBalance = currentBalances[i] ?? 0n;
         if (currentBalance >= requiredAmount)
             continue;
-        const cacheKey = `${chainId}:${account}:${token}`;
+        const tokenAddr = getAddress(token);
         const valueHex = numberToHex(requiredAmount, { size: 32 });
-        // Check cache first
+        // Fast path: caller hint → cryptographic slot computation, no RPC.
+        const callerHintIdx = slotHints?.[tokenAddr]?.balanceSlotIndex;
+        if (callerHintIdx !== undefined && !shouldSkipCaching(token)) {
+            const slot = computeBalanceSlot(account, callerHintIdx);
+            stateOverride.push({
+                address: tokenAddr,
+                stateDiff: [{ slot, value: valueHex }],
+            });
+            continue;
+        }
+        // Per-account slot cache (legacy: keyed by chainId:owner:token, useful
+        // when discovery was done via access-list against this account
+        // directly).
+        const cacheKey = `${chainId}:${account}:${token}`;
         const cached = balanceSlotCache.get(cacheKey);
         if (cached && !shouldSkipCaching(token)) {
             stateOverride.push({
@@ -90,7 +121,35 @@ export async function getBalanceOverrides(client, account, tokens) {
             });
             continue;
         }
-        // Use eth_createAccessList to find candidate storage slots
+        // Token-keyed cache from `fetchErc20SlotHints` (owner-agnostic).
+        const probed = getCachedSlotHints(chainId, tokenAddr);
+        if (probed?.balanceSlotIndex !== undefined && !shouldSkipCaching(token)) {
+            const slot = computeBalanceSlot(account, probed.balanceSlotIndex);
+            stateOverride.push({
+                address: tokenAddr,
+                stateDiff: [{ slot, value: valueHex }],
+            });
+            continue;
+        }
+        // Sequential probing via fetchErc20SlotHints (cheap, owner-agnostic).
+        try {
+            const fresh = await fetchErc20SlotHints(client, tokenAddr, {
+                skipAllowance: true,
+            });
+            if (fresh.balanceSlotIndex !== undefined && !shouldSkipCaching(token)) {
+                const slot = computeBalanceSlot(account, fresh.balanceSlotIndex);
+                stateOverride.push({
+                    address: tokenAddr,
+                    stateDiff: [{ slot, value: valueHex }],
+                });
+                continue;
+            }
+        }
+        catch (e) {
+            // fall through to legacy access-list discovery
+        }
+        // Legacy fallback: eth_createAccessList-based discovery. Only reached
+        // for exotic storage layouts where the small-integer slot probe failed.
         try {
             const accessedSlots = await getAccessedSlots(client, {
                 data: encodeFunctionData({

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

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

@@ -1,10 +1,48 @@
 import { type Address, type PublicClient, type StateOverride } from "viem";
 import type { TransactionPlan } from "../../services/executionService/executionServiceTypes.js";
+import type { SlotHints } from "./slotHints.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;
+    /**
+     * Skip ERC20 balance overrides entirely. Use when the caller has already
+     * validated that the account holds sufficient funds (e.g. UI form validation).
+     * No `balanceOf` reads, no slot probing — only allowance overrides + native
+     * balance + Permit2 deterministic overrides are emitted.
+     */
+    noBalanceOverride?: boolean;
+    /**
+     * Skip ERC20 allowance overrides entirely (the Permit2 deterministic
+     * overrides are still emitted because they cost no RPC). Use when the
+     * caller knows the account has already approved the relevant spenders.
+     */
+    noAllowanceOverride?: boolean;
+    /**
+     * Caller-supplied wallet snapshot. Lets the SDK skip per-call `balanceOf`
+     * and `allowance` reads when the supplied values already cover the
+     * requirement.
+     *
+     *  - `balances[token]`: when ≥ the plan's required amount, no override
+     *    is emitted and no `balanceOf` RPC fires.
+     *  - `allowances[token:spender]`: when `maxUint256`, no override is emitted
+     *    and no `allowance` RPC fires.
+     */
+    wallet?: {
+        balances?: Record<Address, bigint>;
+        allowances?: Record<`${Address}:${Address}`, bigint>;
+    };
+    /**
+     * Caller-supplied storage slot hints. When the `balanceSlotIndex` or
+     * `allowanceSlotIndex` is present for a token, the SDK computes the slot
+     * cryptographically and bypasses access-list discovery. Missing entries
+     * fall through to the SDK's own probing + final access-list fallback.
+     *
+     * Pre-fetch with `fetchErc20SlotHints` (exported from this module) to
+     * amortise discovery across many simulate/estimate calls.
+     */
+    slotHints?: SlotHints;
 };
 /**
  * Generate all state overrides needed to simulate a TransactionPlan

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

@@ -1 +1 @@
-{"version":3,"file":"getStateOverrides.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/getStateOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAKhG,MAAM,MAAM,2BAA2B,GAAG;IACzC,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,cAAc,EAAE,OAAO,CAAC;CACxB,CAAC;AAsDF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,aAAa,CAAC,CAsBxB"}
+{"version":3,"file":"getStateOverrides.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/getStateOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAIhG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,2BAA2B,GAAG;IACzC,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,IAAI,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;KACrD,CAAC;IACF;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAsDF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,aAAa,CAAC,CAuCxB"}

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

@@ -67,12 +67,22 @@ function extractApprovalRequirements(plan, account) {
  * ```
  */
 export async function deriveStateOverrides(client, plan, account, options) {
-    const { nativeBalance = parseEther("1000"), permit2Address } = options;
-    const balanceTokens = extractBalanceRequirements(plan, account);
+    const { nativeBalance = parseEther("1000"), permit2Address, noBalanceOverride = false, noAllowanceOverride = false, wallet, slotHints, } = options;
+    const balanceTokens = noBalanceOverride
+        ? []
+        : extractBalanceRequirements(plan, account);
     const approvalPairs = extractApprovalRequirements(plan, account);
     const [balanceOverrides, approvalOverrides] = await Promise.all([
-        getBalanceOverrides(client, account, balanceTokens),
-        getApprovalOverrides(client, account, approvalPairs, permit2Address),
+        getBalanceOverrides(client, account, balanceTokens, {
+            walletBalances: wallet?.balances,
+            slotHints,
+        }),
+        noAllowanceOverride
+            ? Promise.resolve([])
+            : getApprovalOverrides(client, account, approvalPairs, permit2Address, {
+                walletAllowances: wallet?.allowances,
+                slotHints,
+            }),
     ]);
     const allOverrides = [];
     // Native balance override

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

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

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

@@ -1,5 +1,6 @@
 export { deriveStateOverrides, type DeriveStateOverridesOptions, } from "./getStateOverrides.js";
-export { getBalanceOverrides } from "./balanceOverrides.js";
-export { getApprovalOverrides, computePermit2StateDiff, } from "./approvalOverrides.js";
+export { getBalanceOverrides, type GetBalanceOverridesOptions, } from "./balanceOverrides.js";
+export { getApprovalOverrides, computePermit2StateDiff, type GetApprovalOverridesOptions, } from "./approvalOverrides.js";
 export { mergeStateOverrides } from "./mergeStateOverrides.js";
+export { fetchErc20SlotHints, fetchErc20SlotHintsBatch, computeBalanceSlot, computeAllowanceSlot, primeSlotHintsCache, getCachedSlotHints, type Erc20SlotHints, type SlotHints, type FetchSlotHintsOptions, } from "./slotHints.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/utils/stateOverrides/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,KAAK,2BAA2B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,uBAAuB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,KAAK,2BAA2B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,2BAA2B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACN,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,qBAAqB,GAC1B,MAAM,gBAAgB,CAAC"}

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

@@ -1,5 +1,6 @@
 export { deriveStateOverrides, } from "./getStateOverrides.js";
-export { getBalanceOverrides } from "./balanceOverrides.js";
+export { getBalanceOverrides, } from "./balanceOverrides.js";
 export { getApprovalOverrides, computePermit2StateDiff, } from "./approvalOverrides.js";
 export { mergeStateOverrides } from "./mergeStateOverrides.js";
+export { fetchErc20SlotHints, fetchErc20SlotHintsBatch, computeBalanceSlot, computeAllowanceSlot, primeSlotHintsCache, getCachedSlotHints, } from "./slotHints.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,GAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,uBAAuB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,GAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,mBAAmB,GAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,oBAAoB,EACpB,uBAAuB,GAEvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACN,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GAIlB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,78 @@
+import { type Address, type Hex, type PublicClient, toHex } from "viem";
+/**
+ * Discovered storage-slot indices for a single ERC20 token. Slot indices are
+ * the small-integer base index used in the contract's `mapping(address =>
+ * uint256) balances` / `mapping(address => mapping(address => uint256))
+ * allowances` declaration. They are owner-/spender-agnostic — the concrete
+ * storage slot is then derived cryptographically.
+ *
+ * Cache and reuse these across calls: they don't change for a deployed token.
+ */
+export type Erc20SlotHints = {
+    /** Slot index for the `balances` mapping (base storage slot). */
+    balanceSlotIndex?: bigint;
+    /** Slot index for the `allowance` mapping (outer base storage slot). */
+    allowanceSlotIndex?: bigint;
+};
+export type SlotHints = Record<Address, Erc20SlotHints>;
+export type FetchSlotHintsOptions = {
+    /** When `true`, do not probe for the balance slot. */
+    skipBalance?: boolean;
+    /** When `true`, do not probe for the allowance slot. */
+    skipAllowance?: boolean;
+    /** Spender for allowance probing. Defaults to the Permit2 address. */
+    allowanceSpender?: Address;
+    /** Max sequential base slot to scan (0..N). Defaults to 20. */
+    maxSequentialSlot?: number;
+    /** Extra non-sequential slot indices to try (e.g. known anomalies). */
+    extraSlotCandidates?: bigint[];
+};
+/**
+ * Compute the storage slot of `balances[owner]` in a Solidity-style
+ * `mapping(address => uint256)` at base slot `slotIndex`.
+ */
+export declare function computeBalanceSlot(owner: Address, slotIndex: bigint): Hex;
+/**
+ * Compute the storage slot of `allowance[owner][spender]` in a Solidity-style
+ * `mapping(address => mapping(address => uint256))` at base slot `slotIndex`.
+ */
+export declare function computeAllowanceSlot(owner: Address, spender: Address, slotIndex: bigint): Hex;
+/**
+ * Probe a single ERC20 token to discover its `balances` and `allowance` slot
+ * indices, by overriding sequential base-slot candidates and reading the
+ * value back.
+ *
+ * Strategy is intentionally simpler than `eth_createAccessList`-based
+ * discovery: most ERC20 layouts (OpenZeppelin, Solady, custom) use a small
+ * integer base slot. Sequential probing from 0 hits the answer in 1–3 RPC
+ * calls; access-list discovery costs an `eth_createAccessList` + per-candidate
+ * probe and isn't supported by all proxies.
+ *
+ * Results are cached module-scope by `chainId:token` (slot indices are
+ * owner-/spender-agnostic and immutable for a deployed token), so subsequent
+ * calls for the same token short-circuit to a Map lookup.
+ *
+ * @example
+ * ```ts
+ * const hints = await fetchErc20SlotHints(client, token, {
+ *   allowanceSpender: permit2Address,
+ * })
+ * // → { balanceSlotIndex: 0n, allowanceSlotIndex: 1n }
+ * ```
+ */
+export declare function fetchErc20SlotHints(client: PublicClient, token: Address, options?: FetchSlotHintsOptions): Promise<Erc20SlotHints>;
+/**
+ * Convenience batch wrapper for `fetchErc20SlotHints` over many tokens.
+ * Caller-side parallelism is preserved (one `Promise.all` over the inputs);
+ * the per-token cache means repeats are free.
+ */
+export declare function fetchErc20SlotHintsBatch(client: PublicClient, tokens: Address[], options?: FetchSlotHintsOptions): Promise<SlotHints>;
+/**
+ * Helper for callers who want to pre-seed the slot-hints cache from their own
+ * persistence layer (e.g. localStorage).
+ */
+export declare function primeSlotHintsCache(chainId: number, hints: Record<Address, Erc20SlotHints>): void;
+/** Helper used by deriveStateOverrides to look up a hint without re-probing. */
+export declare function getCachedSlotHints(chainId: number, token: Address): Erc20SlotHints | undefined;
+export { toHex };
+//# sourceMappingURL=slotHints.d.ts.map

package/dist/src/utils/stateOverrides/slotHints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotHints.d.ts","sourceRoot":"","sources":["../../../../src/utils/stateOverrides/slotHints.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,YAAY,EAQjB,KAAK,EACL,MAAM,MAAM,CAAC;AAId;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AAExD,MAAM,MAAM,qBAAqB,GAAG;IACnC,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wDAAwD;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAUF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAIzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GACf,GAAG,CAUL;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,qBAA0B,GACjC,OAAO,CAAC,cAAc,CAAC,CAoGzB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,GAAE,qBAA0B,GACjC,OAAO,CAAC,SAAS,CAAC,CASpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,QAKtC;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACZ,cAAc,GAAG,SAAS,CAE5B;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

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

@@ -0,0 +1,152 @@
+import { encodePacked, erc20Abi, getAddress, hexToBigInt, keccak256, maxUint256, numberToHex, toHex, } from "viem";
+const DEFAULT_MAX_SEQUENTIAL = 20;
+const DEFAULT_EXTRA_CANDIDATES = [];
+const slotHintsCache = new Map();
+const probeAddress = (chainId, token) => `${chainId}:${getAddress(token)}`;
+/**
+ * Compute the storage slot of `balances[owner]` in a Solidity-style
+ * `mapping(address => uint256)` at base slot `slotIndex`.
+ */
+export function computeBalanceSlot(owner, slotIndex) {
+    return keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(owner), slotIndex]));
+}
+/**
+ * Compute the storage slot of `allowance[owner][spender]` in a Solidity-style
+ * `mapping(address => mapping(address => uint256))` at base slot `slotIndex`.
+ */
+export function computeAllowanceSlot(owner, spender, slotIndex) {
+    const baseSlot = keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(owner), slotIndex]));
+    return keccak256(encodePacked(["uint256", "uint256"], [hexToBigInt(spender), hexToBigInt(baseSlot)]));
+}
+/**
+ * Probe a single ERC20 token to discover its `balances` and `allowance` slot
+ * indices, by overriding sequential base-slot candidates and reading the
+ * value back.
+ *
+ * Strategy is intentionally simpler than `eth_createAccessList`-based
+ * discovery: most ERC20 layouts (OpenZeppelin, Solady, custom) use a small
+ * integer base slot. Sequential probing from 0 hits the answer in 1–3 RPC
+ * calls; access-list discovery costs an `eth_createAccessList` + per-candidate
+ * probe and isn't supported by all proxies.
+ *
+ * Results are cached module-scope by `chainId:token` (slot indices are
+ * owner-/spender-agnostic and immutable for a deployed token), so subsequent
+ * calls for the same token short-circuit to a Map lookup.
+ *
+ * @example
+ * ```ts
+ * const hints = await fetchErc20SlotHints(client, token, {
+ *   allowanceSpender: permit2Address,
+ * })
+ * // → { balanceSlotIndex: 0n, allowanceSlotIndex: 1n }
+ * ```
+ */
+export async function fetchErc20SlotHints(client, token, options = {}) {
+    const chainId = client.chain?.id;
+    if (!chainId)
+        throw new Error("Client must have a chain configured");
+    const cacheKey = probeAddress(chainId, token);
+    const cached = slotHintsCache.get(cacheKey);
+    if (cached) {
+        const stillNeedsBalance = !options.skipBalance && cached.balanceSlotIndex === undefined;
+        const stillNeedsAllowance = !options.skipAllowance && cached.allowanceSlotIndex === undefined;
+        if (!stillNeedsBalance && !stillNeedsAllowance) {
+            return cached;
+        }
+    }
+    const max = options.maxSequentialSlot ?? DEFAULT_MAX_SEQUENTIAL;
+    const extras = options.extraSlotCandidates ?? DEFAULT_EXTRA_CANDIDATES;
+    const candidates = [];
+    for (let i = 0; i <= max; i++)
+        candidates.push(BigInt(i));
+    for (const idx of extras)
+        candidates.push(idx);
+    const probeOwner = "0x1111111111111111111111111111111111111111";
+    const probeSpender = options.allowanceSpender ??
+        "0x2222222222222222222222222222222222222222";
+    const valueHex = numberToHex(maxUint256, { size: 32 });
+    const findSlotIndex = async (computeSlot, read) => {
+        for (const idx of candidates) {
+            try {
+                const slot = computeSlot(idx);
+                const value = await read(idx, slot);
+                if (value === maxUint256)
+                    return idx;
+            }
+            catch {
+                // candidate didn't decode; try next
+            }
+        }
+        return undefined;
+    };
+    const balancePromise = options.skipBalance || cached?.balanceSlotIndex !== undefined
+        ? Promise.resolve(cached?.balanceSlotIndex)
+        : findSlotIndex((idx) => computeBalanceSlot(probeOwner, idx), (_idx, slot) => client
+            .readContract({
+            abi: erc20Abi,
+            address: token,
+            functionName: "balanceOf",
+            args: [probeOwner],
+            stateOverride: [
+                {
+                    address: token,
+                    stateDiff: [{ slot, value: valueHex }],
+                },
+            ],
+        })
+            .catch(() => 0n));
+    const allowancePromise = options.skipAllowance || cached?.allowanceSlotIndex !== undefined
+        ? Promise.resolve(cached?.allowanceSlotIndex)
+        : findSlotIndex((idx) => computeAllowanceSlot(probeOwner, probeSpender, idx), (_idx, slot) => client
+            .readContract({
+            abi: erc20Abi,
+            address: token,
+            functionName: "allowance",
+            args: [probeOwner, probeSpender],
+            stateOverride: [
+                {
+                    address: token,
+                    stateDiff: [{ slot, value: valueHex }],
+                },
+            ],
+        })
+            .catch(() => 0n));
+    const [balanceSlotIndex, allowanceSlotIndex] = await Promise.all([
+        balancePromise,
+        allowancePromise,
+    ]);
+    const hints = {
+        balanceSlotIndex,
+        allowanceSlotIndex,
+    };
+    slotHintsCache.set(cacheKey, hints);
+    return hints;
+}
+/**
+ * Convenience batch wrapper for `fetchErc20SlotHints` over many tokens.
+ * Caller-side parallelism is preserved (one `Promise.all` over the inputs);
+ * the per-token cache means repeats are free.
+ */
+export async function fetchErc20SlotHintsBatch(client, tokens, options = {}) {
+    const result = {};
+    await Promise.all(tokens.map(async (rawToken) => {
+        const token = getAddress(rawToken);
+        result[token] = await fetchErc20SlotHints(client, token, options);
+    }));
+    return result;
+}
+/**
+ * Helper for callers who want to pre-seed the slot-hints cache from their own
+ * persistence layer (e.g. localStorage).
+ */
+export function primeSlotHintsCache(chainId, hints) {
+    for (const [token, h] of Object.entries(hints)) {
+        slotHintsCache.set(probeAddress(chainId, token), h);
+    }
+}
+/** Helper used by deriveStateOverrides to look up a hint without re-probing. */
+export function getCachedSlotHints(chainId, token) {
+    return slotHintsCache.get(probeAddress(chainId, token));
+}
+export { toHex };
+//# sourceMappingURL=slotHints.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eulerxyz/euler-v2-sdk",
-  "version": "0.2.7-beta",
+  "version": "0.2.9-beta",
   "description": "SDK for interacting with Euler V2 Lending Platform",
   "repository": {
     "type": "git",