@xyo-network/xl1-protocol-sdk 2.0.0 → 2.0.2

package/dist/neutral/block/hydrate/BoundWitnessHydrator.d.ts

@@ -1,7 +1,7 @@
 import type { Hash } from '@xylabs/sdk-js';
 import type { BoundWitness, Payload } from '@xyo-network/sdk-js';
 import { LRUCache } from 'lru-cache';
-import type { NamedDataLake } from '../../primitives/datalake/index.ts';
+import type { NamedDataLake, PayloadLocation } from '../../primitives/datalake/index.ts';
 import { PayloadLocator } from '../../primitives/datalake/index.ts';
 import type { HydrateFunction } from '../../utils/index.ts';
 /** Valid recursion depths for BoundWitness hydration. */
@@ -38,16 +38,33 @@ export declare class BoundWitnessHydrator<TBw extends BoundWitness, THydrated> {
      */
     constructor(params: BoundWitnessHydratorParams<TBw, THydrated>);
     hydrate(input: Hash | TBw, maxDepth?: HydrationDepth, minDepth?: HydrationDepth): Promise<THydrated>;
+    /**
+     * Like hydrateWithProvenance, but queries every datalake for every hash and returns the full
+     * list of sources per hash. Bypasses the single-source LRU caches so that a prior first-found
+     * cache hit cannot suppress discovery of additional sources.
+     */
+    hydrateWithAllProvenance(input: Hash | TBw, maxDepth?: HydrationDepth, minDepth?: HydrationDepth): Promise<[THydrated, Map<Hash, PayloadLocation[]>]>;
     hydrateWithProvenance(input: Hash | TBw, maxDepth?: HydrationDepth, minDepth?: HydrationDepth): Promise<[THydrated, Map<Hash, string>]>;
     /** Returns an adapter compatible with HydratedCache. The context arg is ignored. */
     toHydrateFunction(): HydrateFunction<THydrated>;
     tryHydrate(input: Hash | TBw, maxDepth?: HydrationDepth): Promise<THydrated | undefined>;
+    tryHydrateWithAllProvenance(input: Hash | TBw, maxDepth?: HydrationDepth): Promise<[THydrated, Map<Hash, PayloadLocation[]>] | undefined>;
     tryHydrateWithProvenance(input: Hash | TBw, maxDepth?: HydrationDepth): Promise<[THydrated, Map<Hash, string>] | undefined>;
     protected appendDirectPayloads(bw: TBw, sources: Map<Hash, string>, minDepth: HydrationDepth, orderedHashes: Set<Hash>, orderedPayloads: Payload[]): Promise<void>;
+    protected appendDirectPayloadsAll(bw: TBw, sources: Map<Hash, PayloadLocation[]>, minDepth: HydrationDepth, orderedHashes: Set<Hash>, orderedPayloads: Payload[]): Promise<void>;
     protected appendNestedPayloads(sources: Map<Hash, string>, minDepth: HydrationDepth, orderedHashes: Set<Hash>, orderedPayloads: Payload[]): Promise<void>;
+    protected appendNestedPayloadsAll(sources: Map<Hash, PayloadLocation[]>, minDepth: HydrationDepth, orderedHashes: Set<Hash>, orderedPayloads: Payload[]): Promise<void>;
     protected fetchByHash(hash: Hash, sources: Map<Hash, string>): Promise<Payload | undefined>;
     protected fetchByHashes(hashes: Hash[], sources: Map<Hash, string>): Promise<Map<Hash, Payload>>;
+    /**
+     * Exhaustive variant: bypasses both LRU caches and queries every datalake. The picked payload
+     * (locations[0].payload) is the first in registration order; the DataLakeViewer's content-addressed
+     * fetch guarantees all entries for a given hash are equivalent.
+     */
+    protected fetchByHashesAll(hashes: Hash[], sources: Map<Hash, PayloadLocation[]>): Promise<Map<Hash, Payload>>;
     protected hydrateInternal(input: Hash | TBw, maxDepth: HydrationDepth, minDepth: HydrationDepth): Promise<[THydrated, Map<Hash, string>]>;
+    protected hydrateInternalAll(input: Hash | TBw, maxDepth: HydrationDepth, minDepth: HydrationDepth): Promise<[THydrated, Map<Hash, PayloadLocation[]>]>;
     protected resolveBoundWitness(input: Hash | TBw, sources: Map<Hash, string>): Promise<TBw>;
+    protected resolveBoundWitnessAll(input: Hash | TBw, sources: Map<Hash, PayloadLocation[]>): Promise<TBw>;
 }
 //# sourceMappingURL=BoundWitnessHydrator.d.ts.map

package/dist/neutral/block/hydrate/BoundWitnessHydrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundWitnessHydrator.d.ts","sourceRoot":"","sources":["../../../../src/block/hydrate/BoundWitnessHydrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BoundWitnessHydrator.d.ts","sourceRoot":"","sources":["../../../../src/block/hydrate/BoundWitnessHydrator.ts"],"names":[],"mappings":"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"}

package/dist/neutral/block/primitives/frames/deepCalculateFramesFromRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepCalculateFramesFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/deepCalculateFramesFromRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAKlE,oDAAoD;AACpD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,SAAuB,GAAG,aAAa,EAAE,CAqBvH"}
+{"version":3,"file":"deepCalculateFramesFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/deepCalculateFramesFromRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAKlE,oDAAoD;AACpD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,SAAI,GAA6B,aAAa,EAAE,CAuB9H"}

package/dist/neutral/index.mjs

@@ -339,6 +339,14 @@ var BoundWitnessHydrator = class {
     const [hydrated] = await this.hydrateInternal(input, maxDepth, minDepth);
     return hydrated;
   }
+  /**
+   * Like hydrateWithProvenance, but queries every datalake for every hash and returns the full
+   * list of sources per hash. Bypasses the single-source LRU caches so that a prior first-found
+   * cache hit cannot suppress discovery of additional sources.
+   */
+  async hydrateWithAllProvenance(input, maxDepth = 1, minDepth = maxDepth) {
+    return await this.hydrateInternalAll(input, maxDepth, minDepth);
+  }
   async hydrateWithProvenance(input, maxDepth = 1, minDepth = maxDepth) {
     return await this.hydrateInternal(input, maxDepth, minDepth);
   }
@@ -353,6 +361,13 @@ var BoundWitnessHydrator = class {
       return void 0;
     }
   }
+  async tryHydrateWithAllProvenance(input, maxDepth = 1) {
+    try {
+      return await this.hydrateWithAllProvenance(input, maxDepth);
+    } catch {
+      return void 0;
+    }
+  }
   async tryHydrateWithProvenance(input, maxDepth = 1) {
     try {
       return await this.hydrateWithProvenance(input, maxDepth);
@@ -373,6 +388,19 @@ var BoundWitnessHydrator = class {
       orderedPayloads.push(p);
     }
   }
+  async appendDirectPayloadsAll(bw, sources, minDepth, orderedHashes, orderedPayloads) {
+    const fetched = await this.fetchByHashesAll(bw.payload_hashes, sources);
+    if (minDepth >= 1) {
+      const missing = bw.payload_hashes.filter((h) => !fetched.has(h));
+      assertEx4(missing.length === 0, () => `Unable to find all payloads for BoundWitness: missing ${missing.join(", ")}`);
+    }
+    for (const h of bw.payload_hashes) {
+      const p = fetched.get(h);
+      if (isUndefined3(p) || orderedHashes.has(h)) continue;
+      orderedHashes.add(h);
+      orderedPayloads.push(p);
+    }
+  }
   async appendNestedPayloads(sources, minDepth, orderedHashes, orderedPayloads) {
     const nestedHashes = [];
     for (const p of orderedPayloads) {
@@ -393,6 +421,26 @@ var BoundWitnessHydrator = class {
       orderedPayloads.push(p);
     }
   }
+  async appendNestedPayloadsAll(sources, minDepth, orderedHashes, orderedPayloads) {
+    const nestedHashes = [];
+    for (const p of orderedPayloads) {
+      if (!this.isNestedBoundWitness(p)) continue;
+      for (const h of p.payload_hashes) {
+        if (!orderedHashes.has(h)) nestedHashes.push(h);
+      }
+    }
+    const fetched = await this.fetchByHashesAll(nestedHashes, sources);
+    if (minDepth >= 2) {
+      const missing = nestedHashes.filter((h) => !fetched.has(h));
+      assertEx4(missing.length === 0, () => `Unable to find all nested payloads for BoundWitness: missing ${missing.join(", ")}`);
+    }
+    for (const h of nestedHashes) {
+      const p = fetched.get(h);
+      if (isUndefined3(p) || orderedHashes.has(h)) continue;
+      orderedHashes.add(h);
+      orderedPayloads.push(p);
+    }
+  }
   async fetchByHash(hash, sources) {
     const cached = this.payloadCache.get(hash);
     if (isDefined(cached)) {
@@ -430,6 +478,22 @@ var BoundWitnessHydrator = class {
     }
     return result;
   }
+  /**
+   * Exhaustive variant: bypasses both LRU caches and queries every datalake. The picked payload
+   * (locations[0].payload) is the first in registration order; the DataLakeViewer's content-addressed
+   * fetch guarantees all entries for a given hash are equivalent.
+   */
+  async fetchByHashesAll(hashes, sources) {
+    const result = /* @__PURE__ */ new Map();
+    if (hashes.length === 0) return result;
+    const located = await this.locator.findAll(hashes);
+    for (const [h, locations] of located) {
+      if (locations.length === 0) continue;
+      result.set(h, locations[0].payload);
+      sources.set(h, locations);
+    }
+    return result;
+  }
   async hydrateInternal(input, maxDepth, minDepth) {
     assertEx4(maxDepth >= 0 && maxDepth <= 2, () => `maxDepth must be 0, 1, or 2 (got ${maxDepth})`);
     assertEx4(minDepth >= 0 && minDepth <= 2, () => `minDepth must be 0, 1, or 2 (got ${minDepth})`);
@@ -447,6 +511,23 @@ var BoundWitnessHydrator = class {
     }
     return [this.asHydrated([bw, orderedPayloads], true), sources];
   }
+  async hydrateInternalAll(input, maxDepth, minDepth) {
+    assertEx4(maxDepth >= 0 && maxDepth <= 2, () => `maxDepth must be 0, 1, or 2 (got ${maxDepth})`);
+    assertEx4(minDepth >= 0 && minDepth <= 2, () => `minDepth must be 0, 1, or 2 (got ${minDepth})`);
+    assertEx4(maxDepth >= minDepth, () => `maxDepth (${maxDepth}) must be >= minDepth (${minDepth})`);
+    const sources = /* @__PURE__ */ new Map();
+    const bw = await this.resolveBoundWitnessAll(input, sources);
+    if (maxDepth === 0) {
+      return [this.asHydrated([bw, []], true), sources];
+    }
+    const orderedHashes = /* @__PURE__ */ new Set();
+    const orderedPayloads = [];
+    await this.appendDirectPayloadsAll(bw, sources, minDepth, orderedHashes, orderedPayloads);
+    if (maxDepth === 2) {
+      await this.appendNestedPayloadsAll(sources, minDepth, orderedHashes, orderedPayloads);
+    }
+    return [this.asHydrated([bw, orderedPayloads], true), sources];
+  }
   async resolveBoundWitness(input, sources) {
     if (typeof input === "string") {
       const fetched = assertEx4(
@@ -458,6 +539,18 @@ var BoundWitnessHydrator = class {
     const withMeta = "_hash" in input ? input : await PayloadBuilder2.addStorageMeta(input);
     return this.asBoundWitness(withMeta, true);
   }
+  async resolveBoundWitnessAll(input, sources) {
+    if (typeof input === "string") {
+      const fetched = await this.fetchByHashesAll([input], sources);
+      const payload = assertEx4(
+        fetched.get(input),
+        () => `BoundWitness ${input} not found in any datalake`
+      );
+      return this.asBoundWitness(payload, true);
+    }
+    const withMeta = "_hash" in input ? input : await PayloadBuilder2.addStorageMeta(input);
+    return this.asBoundWitness(withMeta, true);
+  }
 };
 
 // src/block/hydrate/createBlockHydrator.ts
@@ -780,11 +873,11 @@ function calculateFramesFromRange(range, step) {
 }
 
 // src/block/primitives/frames/deepCalculateFramesFromRange.ts
-import { StepSizes as StepSizes2 } from "@xyo-network/xl1-protocol-lib";
-function deepCalculateFramesFromRange(range, startingStep = StepSizes2.length - 1) {
+function deepCalculateFramesFromRange(range, startingStep = 5) {
   const fitted = [];
   let remaining = [range];
-  for (let step = startingStep; step >= 0; step--) {
+  const actualStartingStep = Math.min(startingStep, 5);
+  for (let step = actualStartingStep; step >= 0; step--) {
     const newRemaining = [];
     for (const range2 of remaining) {
       const [newFittedFrames, newRemainingFrames] = calculateFramesFromRange(range2, step);
@@ -1408,11 +1501,11 @@ import { AddressZod as AddressZod2 } from "@xylabs/sdk-js";
 import { globalRegistry as globalRegistry11, z as z15 } from "zod";
 
 // src/primitives/block/range/blockRangeSteps.ts
-import { asXL1BlockNumber as asXL1BlockNumber2, StepSizes as StepSizes3 } from "@xyo-network/xl1-protocol-lib";
+import { asXL1BlockNumber as asXL1BlockNumber2, StepSizes as StepSizes2 } from "@xyo-network/xl1-protocol-lib";
 function blockRangeSteps(range, steps) {
   const result = [];
   for (const step of steps) {
-    const stepSize2 = StepSizes3[step];
+    const stepSize2 = StepSizes2[step];
     const startOfFirstStepCandidate = range[0] - range[0] % stepSize2 + stepSize2;
     const startOfFirstStep = asXL1BlockNumber2(
       startOfFirstStepCandidate,
@@ -1525,7 +1618,7 @@ import { assertEx as assertEx9 } from "@xylabs/sdk-js";
 import {
   asXL1BlockRange as asXL1BlockRange2,
   isValidStep,
-  StepSizes as StepSizes4
+  StepSizes as StepSizes3
 } from "@xyo-network/xl1-protocol-lib";
 var stepRate = async (viewer, start, step, count = 1, timeUnit) => {
   const end = start + step * count;
@@ -1534,7 +1627,7 @@ var stepRate = async (viewer, start, step, count = 1, timeUnit) => {
 };
 var calculateStepSizeRate = async (viewer, start, stepIndex, count = 1, timeUnit) => {
   assertEx9(isValidStep(stepIndex), () => `Invalid step index: ${stepIndex}`);
-  const step = StepSizes4[stepIndex];
+  const step = StepSizes3[stepIndex];
   return await stepRate(viewer, start, step, count, timeUnit);
 };
 
@@ -1676,23 +1769,23 @@ function mergeTransfers(transfers) {
 }
 
 // src/primitives/step/stepBlockRange.ts
-import { asXL1BlockRange as asXL1BlockRange4, StepSizes as StepSizes5 } from "@xyo-network/xl1-protocol-lib";
+import { asXL1BlockRange as asXL1BlockRange4, StepSizes as StepSizes4 } from "@xyo-network/xl1-protocol-lib";
 function stepBlockRange({ block, step }) {
-  const stepSize2 = StepSizes5[step];
+  const stepSize2 = StepSizes4[step];
   const start = block - stepSize2;
   return asXL1BlockRange4([start, start + stepSize2 - 1], { name: "stepBlockRange" });
 }
 
 // src/primitives/step/stepTransferIndex.ts
 import { assertEx as assertEx12 } from "@xylabs/sdk-js";
-import { StepSizes as StepSizes6 } from "@xyo-network/xl1-protocol-lib";
+import { StepSizes as StepSizes5 } from "@xyo-network/xl1-protocol-lib";
 function stepTransferIndex(block, step) {
   let rewardTransferCount = 0;
   let rewardTransferIndex = -1;
-  for (let i = 3; i < StepSizes6.length; i++) {
-    const stepSize2 = StepSizes6[i];
+  for (let i = 3; i < StepSizes5.length; i++) {
+    const stepSize2 = StepSizes5[i];
     if (block % stepSize2 === 0) {
-      if (stepSize2 === StepSizes6[step]) {
+      if (stepSize2 === StepSizes5[step]) {
         rewardTransferIndex = rewardTransferCount;
       }
       rewardTransferCount++;
@@ -1704,9 +1797,9 @@ function stepTransferIndex(block, step) {
 
 // src/primitives/chain/step/stepRewardBlock.ts
 import { assertEx as assertEx13 } from "@xylabs/sdk-js";
-import { StepSizes as StepSizes7 } from "@xyo-network/xl1-protocol-lib";
+import { StepSizes as StepSizes6 } from "@xyo-network/xl1-protocol-lib";
 async function stepRewardBlock(context, blockViewer, { block, step }) {
-  assertEx13(block % StepSizes7[step] === 0, () => `Block must be the first block of the step [${StepSizes7[step]}], got ${block}`);
+  assertEx13(block % StepSizes6[step] === 0, () => `Block must be the first block of the step [${StepSizes6[step]}], got ${block}`);
   return assertEx13(await blockViewer.blockByNumber(block), () => `Could not find block for block number ${block}`);
 }
 
@@ -3516,7 +3609,7 @@ import {
   BlockViewerMoniker,
   isChainQualifiedHeadConfig as isChainQualifiedHeadConfig4,
   isChainQualifiedRangeConfig as isChainQualifiedRangeConfig4,
-  StepSizes as StepSizes11,
+  StepSizes as StepSizes10,
   TransferSchema as TransferSchema2
 } from "@xyo-network/xl1-protocol-lib";
 import { Semaphore } from "async-mutex";
@@ -3576,7 +3669,7 @@ var asTransfersStepSummaryWithStorageMeta = AsObjectFactory7.create(isTransfersS
 import { spanRootAsync as spanRootAsync2 } from "@xylabs/sdk-js";
 import { assertEx as assertEx26 } from "@xylabs/sdk-js";
 import { isAnyPayload as isAnyPayload3 } from "@xyo-network/sdk-js";
-import { asXL1BlockNumber as asXL1BlockNumber5, StepSizes as StepSizes8 } from "@xyo-network/xl1-protocol-lib";
+import { asXL1BlockNumber as asXL1BlockNumber5, StepSizes as StepSizes7 } from "@xyo-network/xl1-protocol-lib";
 async function balancesStepSummaryFromRange(context, semaphores, blockViewer, summaryMap, range) {
   const cacheKey = `${range[0]}|${range[1]}`;
   return await withContextCacheResponse(context, "balancesStepSummaryFromRange", cacheKey, async () => {
@@ -3597,8 +3690,8 @@ async function balancesStepSummaryFromRange(context, semaphores, blockViewer, su
           balances
         };
       }, { ...context, timeBudgetLimit: 500 }) : await spanRootAsync2(`balancesStepSummaryFromRange.frameSize>1[${key}]`, async () => {
-        const step = StepSizes8.indexOf(asXL1BlockNumber5(frameSize, true));
-        assertEx26(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes8.join(", ")}`);
+        const step = StepSizes7.indexOf(asXL1BlockNumber5(frameSize, true));
+        assertEx26(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes7.join(", ")}`);
         const summaryResult = await summaryMap.get(`${frameHead._hash}|${frameSize}`);
         if (isAnyPayload3(summaryResult)) {
           return summaryResult;
@@ -3683,7 +3776,7 @@ import {
   isHashMeta,
   PayloadBuilder as PayloadBuilder17
 } from "@xyo-network/sdk-js";
-import { StepSizes as StepSizes9 } from "@xyo-network/xl1-protocol-lib";
+import { StepSizes as StepSizes8 } from "@xyo-network/xl1-protocol-lib";
 async function schemasStepSummaryFromRange(context, semaphores, blockViewer, summaryMap, range) {
   const [frameHead] = assertEx28(await blockViewer.blockByNumber(range[1]), () => `Block not found for number: ${range[1]}`);
   const frameSize = range[1] - range[0] + 1;
@@ -3705,8 +3798,8 @@ async function schemasStepSummaryFromRange(context, semaphores, blockViewer, sum
       schemas
     });
   } else {
-    const step = StepSizes9.indexOf(frameSize);
-    assertEx28(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes9.join(", ")}`);
+    const step = StepSizes8.indexOf(frameSize);
+    assertEx28(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes8.join(", ")}`);
     const summaryResult = await summaryMap.get(`${frameHead._hash}|${frameSize}`);
     if (isAnyPayload4(summaryResult)) {
       result = summaryResult;
@@ -3777,7 +3870,7 @@ async function schemasSummary(context, semaphores, blockViewer, summaryMap, conf
 // src/summary/primitives/transfers/transfersStepSummaryFromRange.ts
 import { assertEx as assertEx30, spanRootAsync as spanRootAsync5 } from "@xylabs/sdk-js";
 import { isAnyPayload as isAnyPayload5 } from "@xyo-network/sdk-js";
-import { asXL1BlockNumber as asXL1BlockNumber6, StepSizes as StepSizes10 } from "@xyo-network/xl1-protocol-lib";
+import { asXL1BlockNumber as asXL1BlockNumber6, StepSizes as StepSizes9 } from "@xyo-network/xl1-protocol-lib";
 function transfersSummaryKey(frameHeadHash, frameSize) {
   return `${frameHeadHash}|${frameSize}`;
 }
@@ -3804,8 +3897,8 @@ async function transfersStepSummaryFromRange(context, semaphores, blockViewer, s
           transfers
         };
       } else {
-        const step = StepSizes10.indexOf(asXL1BlockNumber6(frameSize, true));
-        assertEx30(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes10.join(", ")}`);
+        const step = StepSizes9.indexOf(asXL1BlockNumber6(frameSize, true));
+        assertEx30(step !== -1, () => `Invalid step size: ${frameSize}. Must be one of ${StepSizes9.join(", ")}`);
         const key = transfersSummaryKey(frameHead._hash, frameSize);
         const summaryResult = await summaryMap.get(key);
         if (isAnyPayload5(summaryResult)) {
@@ -3896,9 +3989,9 @@ async function transfersSummary(context, semaphores, blockViewer, summaryMap, co
 // src/simple/accountBalance/SimpleAccountBalanceViewer.ts
 var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
   moniker = SimpleAccountBalanceViewer.defaultMoniker;
-  _balanceStepSemaphores = StepSizes11.map(() => new Semaphore(20));
+  _balanceStepSemaphores = StepSizes10.map(() => new Semaphore(20));
   _blockViewer;
-  _transferStepSemaphores = StepSizes11.map(() => new Semaphore(20));
+  _transferStepSemaphores = StepSizes10.map(() => new Semaphore(20));
   get balancesSummaryMap() {
     return this.params.balancesSummaryMap;
   }
@@ -4019,7 +4112,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
   }
   async distillTransferHistory(address, range, max = 50) {
     return await this.spanAsync("distillTransferHistory", async () => {
-      if (range[1] - range[0] <= StepSizes11[0] || max <= 1) {
+      if (range[1] - range[0] <= StepSizes10[0] || max <= 1) {
         return Array.from({ length: range[1] - range[0] + 1 }, (_, i) => range[1] - i).slice(0, max).map((n) => asXL1BlockNumber7(n, true));
       }
       const frames = deepCalculateFramesFromRange(asXL1BlockRange10(range, true));
@@ -4034,7 +4127,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
       });
       const resultBlockNumbers = /* @__PURE__ */ new Set();
       for (const [frame] of sortedTransferSummaryPairs) {
-        if (frame[1] - frame[0] + 1 > StepSizes11[0]) {
+        if (frame[1] - frame[0] + 1 > StepSizes10[0]) {
           const values = await this.distillTransferHistory(address, asXL1BlockRange10([frame[0], frame[1] - 1], true), max - resultBlockNumbers.size);
           for (const value of values) {
             resultBlockNumbers.add(value);