@xyo-network/xl1-protocol-sdk 2.0.9 → 2.0.11

package/dist/neutral/summary/model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/summary/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/summary/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA"}

package/dist/neutral/summary/primitives/balances/balancesMaxStep.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Largest step (frame size) used when fanning a range out into balance summaries.
+ *
+ * Balance summaries are `Record<address, amount>` — linear in the number of active addresses, not
+ * the O(addresses²) pair-explosion transfers have — so they tolerate larger frames. Step 5 is
+ * ~510,511 blocks per frame.
+ */
+export declare const balancesMaxStep = 5;
+//# sourceMappingURL=balancesMaxStep.d.ts.map

package/dist/neutral/summary/primitives/balances/balancesMaxStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balancesMaxStep.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/balances/balancesMaxStep.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,IAAI,CAAA"}

package/dist/neutral/summary/primitives/balances/balancesSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"balancesSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/balances/balancesSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACpD,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,uCAAuC;AACvC,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAoBrD"}
+{"version":3,"file":"balancesSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/balances/balancesSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACpD,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAI/D,uCAAuC;AACvC,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAChD,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAoBrD"}

package/dist/neutral/summary/primitives/balances/index.d.ts

@@ -1,3 +1,4 @@
+export * from './balancesMaxStep.ts';
 export * from './balancesStepSummaryFromRange.ts';
 export * from './balancesSummary.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/summary/primitives/balances/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/balances/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA;AACjD,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/balances/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mCAAmC,CAAA;AACjD,cAAc,sBAAsB,CAAA"}

package/dist/neutral/summary/primitives/blocks/blocksMaxStep.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Largest step level that `blocksByStep` will serve, and the largest frame size used when building
+ * block summaries.
+ *
+ * A block summary stores every `SignedHydratedBlockWithHashMeta` in its frame, so its size grows
+ * linearly with the frame's block count. `StepSizes[blocksMaxStep]` is therefore the size of the
+ * largest single cached summary object. `blocksByStep` rejects requests for step levels above this
+ * cap so that no response can exceed that largest single summary.
+ *
+ * Tune this as the large-object storage backing the summary map matures.
+ */
+export declare const blocksMaxStep = 3;
+//# sourceMappingURL=blocksMaxStep.d.ts.map

package/dist/neutral/summary/primitives/blocks/blocksMaxStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocksMaxStep.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/blocks/blocksMaxStep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,IAAI,CAAA"}

package/dist/neutral/summary/primitives/blocks/blocksStepSummaryFromRange.d.ts

@@ -0,0 +1,13 @@
+import type { Hash } from '@xylabs/sdk-js';
+import type { BlockViewer, CachingContext, MapType, XL1BlockRange } from '@xyo-network/xl1-protocol-lib';
+import type { Semaphore } from 'async-mutex';
+import { type BlocksStepSummary } from '../../model/index.ts';
+/** BlocksStepSummaryKey helper function. */
+export declare function blocksStepSummaryKey(frameHeadHash: Hash, frameSize: number): string;
+/**
+ * Builds (and caches) the BlocksStepSummary for an aligned step frame, holding every block in the
+ * frame. A frame larger than a single block is composed of its step-(N-1) sub-frame summaries, so
+ * a completed step's summary is keyed by its last block hash and never recomputed once cached.
+ */
+export declare function blocksStepSummaryFromRange(context: CachingContext, semaphores: Semaphore[], blockViewer: BlockViewer, summaryMap: MapType<string, BlocksStepSummary>, range: XL1BlockRange): Promise<BlocksStepSummary>;
+//# sourceMappingURL=blocksStepSummaryFromRange.d.ts.map

package/dist/neutral/summary/primitives/blocks/blocksStepSummaryFromRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocksStepSummaryFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/blocks/blocksStepSummaryFromRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAG1C,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,OAAO,EAAmC,aAAa,EACrF,MAAM,+BAA+B,CAAA;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,EACgB,KAAK,iBAAiB,EAC5C,MAAM,sBAAsB,CAAA;AAE7B,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAE1E;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC9C,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAmD5B"}

package/dist/neutral/summary/primitives/blocks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './blocksMaxStep.ts';
+export * from './blocksStepSummaryFromRange.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/summary/primitives/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iCAAiC,CAAA"}

package/dist/neutral/summary/primitives/index.d.ts

@@ -1,4 +1,5 @@
 export * from './balances/index.ts';
+export * from './blocks/index.ts';
 export * from './schemas/index.ts';
 export * from './transfers/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/summary/primitives/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/summary/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/summary/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}

package/dist/neutral/summary/primitives/schemas/index.d.ts

@@ -1,3 +1,4 @@
+export * from './schemasMaxStep.ts';
 export * from './schemasStepSummaryFromRange.ts';
 export * from './schemasSummary.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/summary/primitives/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qBAAqB,CAAA"}

package/dist/neutral/summary/primitives/schemas/schemasMaxStep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Largest step (frame size) used when fanning a range out into schema summaries.
+ *
+ * Schema summaries are `Record<schema, count>` — bounded by the number of distinct schemas — so the
+ * payload stays tiny regardless of frame size. Use full depth for the best caching reuse.
+ */
+export declare const schemasMaxStep: number;
+//# sourceMappingURL=schemasMaxStep.d.ts.map

package/dist/neutral/summary/primitives/schemas/schemasMaxStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemasMaxStep.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/schemas/schemasMaxStep.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAuB,CAAA"}

package/dist/neutral/summary/primitives/schemas/schemasSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemasSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/schemas/schemasSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACjE,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,sCAAsC;AACtC,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC,EAC7D,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAoBjD"}
+{"version":3,"file":"schemasSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/schemas/schemasSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACjE,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAI9D,sCAAsC;AACtC,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC,EAC7D,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAoBjD"}

package/dist/neutral/summary/primitives/transfers/index.d.ts

@@ -1,3 +1,4 @@
+export * from './transfersMaxStep.ts';
 export * from './transfersStepSummaryFromRange.ts';
 export * from './transfersSummary.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/summary/primitives/transfers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/transfers/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAA;AAClD,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/transfers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,oCAAoC,CAAA;AAClD,cAAc,uBAAuB,CAAA"}

package/dist/neutral/summary/primitives/transfers/transfersMaxStep.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Largest step (frame size) used when fanning a range out into transfer summaries.
+ *
+ * Transfer summaries are `Record<from, Record<to, amount>>` — roughly O(addresses²) in the number
+ * of distinct address pairs active in a frame — so they grow too large above step 4 (30,031 blocks).
+ * Keep this in sync on both sides: the fan-out that requests frames and, via it, the generation
+ * that builds & caches them.
+ */
+export declare const transfersMaxStep = 4;
+//# sourceMappingURL=transfersMaxStep.d.ts.map

package/dist/neutral/summary/primitives/transfers/transfersMaxStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfersMaxStep.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/transfers/transfersMaxStep.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAA"}

package/dist/neutral/summary/primitives/transfers/transfersSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfersSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/transfers/transfersSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACjE,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAIhE,wCAAwC;AACxC,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAwBzE"}
+{"version":3,"file":"transfersSummary.d.ts","sourceRoot":"","sources":["../../../../../src/summary/primitives/transfers/transfersSummary.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EACjE,OAAO,EACR,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAKhE,wCAAwC;AACxC,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAwBzE"}