@xyo-network/xl1-protocol-sdk 1.14.3 → 1.15.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oCAAoC,CAAA;AAClD,cAAc,kCAAkC,CAAA;AAChD,cAAc,uCAAuC,CAAA;AACrD,cAAc,2CAA2C,CAAA;AACzD,cAAc,yCAAyC,CAAA;AACvD,cAAc,oCAAoC,CAAA;AAClD,cAAc,2CAA2C,CAAA;AACzD,cAAc,kDAAkD,CAAA;AAChE,cAAc,uCAAuC,CAAA;AACrD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA"}

package/dist/neutral/steps/primitives/networkStakeStepAddressReward.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepAddressReward(address: Address, step: number, block: number): Promisable<Record<Address, bigint>>;
+//# sourceMappingURL=networkStakeStepAddressReward.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepAddressReward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepAddressReward.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepAddressReward.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAEhI"}

package/dist/neutral/steps/primitives/networkStakeStepPoolRewardShares.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepPoolRewardShares(step: number, block: number): Promisable<Record<Address, bigint>>;
+//# sourceMappingURL=networkStakeStepPoolRewardShares.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepPoolRewardShares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepPoolRewardShares.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepPoolRewardShares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAEjH"}

package/dist/neutral/steps/primitives/networkStakeStepPoolRewards.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepPoolRewards(step: number, block: number): Promisable<Record<Address, bigint>>;
+//# sourceMappingURL=networkStakeStepPoolRewards.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepPoolRewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepPoolRewards.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepPoolRewards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAE5G"}

package/dist/neutral/steps/primitives/networkStakeStepRewardAddressHistory.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardAddressHistory(address: Address): Promisable<Record<Address, bigint>>;
+//# sourceMappingURL=networkStakeStepRewardAddressHistory.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardAddressHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardAddressHistory.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardAddressHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAE1G"}

package/dist/neutral/steps/primitives/networkStakeStepRewardAddressShare.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardAddressShare(address: Address, step: number, block: number): Promisable<[bigint, bigint]>;
+//# sourceMappingURL=networkStakeStepRewardAddressShare.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardAddressShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardAddressShare.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardAddressShare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE9H"}

package/dist/neutral/steps/primitives/networkStakeStepRewardForStep.d.ts

@@ -0,0 +1,3 @@
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardForStep(step: number): Promisable<bigint>;
+//# sourceMappingURL=networkStakeStepRewardForStep.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardForStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardForStep.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardForStep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAE9E"}

package/dist/neutral/steps/primitives/networkStakeStepRewardPositionWeight.d.ts

@@ -0,0 +1,3 @@
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardPositionWeight(position: bigint, step: number): Promisable<number>;
+//# sourceMappingURL=networkStakeStepRewardPositionWeight.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardPositionWeight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardPositionWeight.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardPositionWeight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAEvG"}

package/dist/neutral/steps/primitives/networkStakeStepRewardPotentialPositionLoss.d.ts

@@ -0,0 +1,3 @@
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardPotentialPositionLoss(position: bigint, step: number): Promisable<bigint>;
+//# sourceMappingURL=networkStakeStepRewardPotentialPositionLoss.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardPotentialPositionLoss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardPotentialPositionLoss.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardPotentialPositionLoss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,2CAA2C,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAE9G"}

package/dist/neutral/steps/primitives/networkStakeStepRewardRandomizer.d.ts

@@ -0,0 +1,3 @@
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardRandomizer(step: number, block: number): Promisable<bigint>;
+//# sourceMappingURL=networkStakeStepRewardRandomizer.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardRandomizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardRandomizer.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardRandomizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAEhG"}

package/dist/neutral/steps/primitives/networkStakeStepRewardWeightForAddress.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function networkStakeStepRewardWeightForAddress(address: Address, step: number): Promisable<bigint>;
+//# sourceMappingURL=networkStakeStepRewardWeightForAddress.d.ts.map

package/dist/neutral/steps/primitives/networkStakeStepRewardWeightForAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStakeStepRewardWeightForAddress.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/networkStakeStepRewardWeightForAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAEzG"}

package/dist/neutral/steps/primitives/stakersAsOfBlock.d.ts

@@ -0,0 +1,4 @@
+import { type Address } from '@xylabs/hex';
+import type { AddressStakingV2 } from '@xyo-network/typechain';
+export declare function stakersAsOfBlock(stakeContract: AddressStakingV2, staked: Address, ethBlock: number): Promise<Address[]>;
+//# sourceMappingURL=stakersAsOfBlock.d.ts.map

package/dist/neutral/steps/primitives/stakersAsOfBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stakersAsOfBlock.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/stakersAsOfBlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAM9D,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAU7H"}

package/dist/neutral/steps/primitives/startingStakes.d.ts

@@ -0,0 +1,4 @@
+import { type Address } from '@xylabs/hex';
+import type { AddressStakingV2 } from '@xyo-network/typechain';
+export declare function startingStakes(stakeContract: AddressStakingV2, staked: Address, ethBlock: number): Promise<Record<Address, bigint>>;
+//# sourceMappingURL=startingStakes.d.ts.map

package/dist/neutral/steps/primitives/startingStakes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startingStakes.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/startingStakes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,wBAAsB,cAAc,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAyBzI"}

package/dist/neutral/steps/primitives/totalStakeWeight.d.ts

@@ -0,0 +1,4 @@
+import { type Address } from '@xylabs/hex';
+import type { AddressStakingV2 } from '@xyo-network/typechain';
+export declare function totalStakeWeight(stakeContract: AddressStakingV2, staked: Address, startEthBlock: number, endEthBlock: number): Promise<bigint>;
+//# sourceMappingURL=totalStakeWeight.d.ts.map

package/dist/neutral/steps/primitives/totalStakeWeight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"totalStakeWeight.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/totalStakeWeight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAK9D,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BpJ"}

package/dist/neutral/steps/primitives/unclaimedRewards.d.ts

@@ -0,0 +1,4 @@
+import type { Address } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/promise';
+export declare function unclaimedRewards(address: Address): Promisable<bigint>;
+//# sourceMappingURL=unclaimedRewards.d.ts.map

package/dist/neutral/steps/primitives/unclaimedRewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unclaimedRewards.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/unclaimedRewards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAErE"}

package/dist/neutral/time/index.d.ts

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

package/dist/neutral/time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/time/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/time/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAA"}

package/dist/neutral/time/primitives/xl1BlockNumberToEthBlockNumber.d.ts

@@ -0,0 +1,3 @@
+import { type ChainContext } from '../../block/index.ts';
+export declare function xl1BlockNumberToEthBlockNumber(context: ChainContext, xl1BlockNumber: number): Promise<number>;
+//# sourceMappingURL=xl1BlockNumberToEthBlockNumber.d.ts.map

package/dist/neutral/time/primitives/xl1BlockNumberToEthBlockNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xl1BlockNumberToEthBlockNumber.d.ts","sourceRoot":"","sources":["../../../../src/time/primitives/xl1BlockNumberToEthBlockNumber.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAE7B,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnH"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.14.3",
+  "version": "1.15.0",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -52,18 +52,19 @@
     "@xyo-network/boundwitness-model": "~5.1.2",
     "@xyo-network/payload-builder": "~5.1.2",
     "@xyo-network/payload-model": "~5.1.2",
+    "@xyo-network/typechain": "^4.0.8",
     "@xyo-network/wallet": "~5.1.2",
     "@xyo-network/wallet-model": "~5.1.2",
-    "@xyo-network/xl1-protocol": "~1.12.22",
-    "zod": "~4.1.5"
+    "@xyo-network/xl1-protocol": "~1.12.32",
+    "zod": "~4.1.8"
   },
   "devDependencies": {
-    "@types/node": "~24.3.1",
+    "@types/node": "~24.4.0",
     "@xylabs/ts-scripts-yarn3": "~7.1.7",
     "@xylabs/tsconfig": "~7.1.7",
     "@xyo-network/account": "~5.1.2",
     "@xyo-network/boundwitness-validator": "~5.1.2",
-    "eslint": "^9.34.0",
+    "eslint": "^9.35.0",
     "typescript": "~5.9.2",
     "vitest": "~3.2.4"
   },

package/src/block/hydrate/allHashesPresent.ts

@@ -0,0 +1,7 @@
+import type { Hash } from '@xylabs/hex'
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+
+export function allHashesPresent(hashes: Hash[], payloads: WithStorageMeta<Payload>[]): boolean {
+  const payloadHashes = new Set(payloads.map(p => p._hash))
+  return hashes.every(hash => payloadHashes.has(hash))
+}

package/src/block/hydrate/blockPayloadsFromHydratedBlock.ts

@@ -0,0 +1,11 @@
+import { assertEx } from '@xylabs/assert'
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+import { isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+
+export const blockPayloadsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<Payload>[] => {
+  return block[0].payload_hashes.map(hash => assertEx(
+    block[1].find(p => p._hash === hash),
+    () => `missing payload ${hash}`,
+  )).filter(x => !isTransactionBoundWitnessWithStorageMeta(x))
+}

package/src/block/hydrate/flattenHydratedBlock.ts

@@ -0,0 +1,7 @@
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+
+export const flattenHydratedBlock = (hydratedBlock: HydratedBlock): WithStorageMeta<Payload>[] => {
+  const [blk, blkPayloads] = hydratedBlock
+  return [...blkPayloads, blk]
+}

package/src/block/hydrate/flattenHydratedBlocks.ts

@@ -0,0 +1,7 @@
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+
+import { flattenHydratedBlock } from './flattenHydratedBlock.ts'
+
+export const flattenHydratedBlocks = (hydratedBlocks: HydratedBlock[]): WithStorageMeta<Payload>[] =>
+  hydratedBlocks.flatMap(blk => flattenHydratedBlock(blk))

package/src/block/hydrate/hydrateBlock.ts

@@ -0,0 +1,38 @@
+import { assertEx } from '@xylabs/assert'
+import type { Hash } from '@xylabs/hex'
+import type { ReadArchivist } from '@xyo-network/archivist-model'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+import { isBlockBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+
+import { allHashesPresent } from './allHashesPresent.ts'
+
+export const hydrateBlock = async (
+  archivist: ReadArchivist,
+  hash: Hash,
+  maxDepth: number = 1,
+  minDepth = maxDepth,
+): Promise<HydratedBlock> => {
+  assertEx(maxDepth >= 0, () => 'maxDepth must be greater than or equal to 0')
+  assertEx(minDepth >= 0, () => 'minDepth must be greater than or equal to 0')
+  assertEx(maxDepth >= minDepth, () => 'maxDepth must be greater than or equal to minDepth')
+  const bw = assertEx(
+    (await archivist.get([hash])).find(isBlockBoundWitnessWithStorageMeta),
+    () => `block ${hash} not found`,
+  )
+  if (maxDepth === 0) return [bw, []]
+  const blkPayloads = await archivist.get(bw.payload_hashes)
+  if (minDepth === 1) assertEx(allHashesPresent(bw.payload_hashes, blkPayloads), () => `Unable to find all payloads for block ${hash}`)
+  if (maxDepth === 1) return [bw, blkPayloads]
+  const transactions = blkPayloads.filter(isTransactionBoundWitnessWithStorageMeta)
+  const transactionsPayloadHashes = transactions.flatMap(tx => tx.payload_hashes)
+  const transactionsPayloads = await archivist.get(transactionsPayloadHashes)
+  assertEx(allHashesPresent(transactionsPayloadHashes, transactionsPayloads), () => `Unable to find all payloads for transactions in block ${hash}`)
+  const allPayloadsHashes = new Set([...blkPayloads, ...transactionsPayloads].flatMap(p => p._hash))
+  const allPayloads = await archivist.get([...allPayloadsHashes])
+  const allPayloadsFiltered = allPayloads.filter(p => allPayloadsHashes.has(p._hash))
+  if (maxDepth === 2) assertEx(allHashesPresent(
+    [...allPayloadsHashes],
+    allPayloadsFiltered,
+  ), () => `Unable to find all payloads for transactions in block ${hash}`)
+  return [bw, allPayloadsFiltered]
+}

package/src/block/hydrate/index.ts

@@ -0,0 +1,7 @@
+export * from './allHashesPresent.ts'
+export * from './blockPayloadsFromHydratedBlock.ts'
+export * from './flattenHydratedBlock.ts'
+export * from './flattenHydratedBlocks.ts'
+export * from './hydrateBlock.ts'
+export * from './transactionsFromHydratedBlock.ts'
+export * from './tryHydrateBlock.ts'

package/src/block/hydrate/transactionsFromHydratedBlock.ts

@@ -0,0 +1,8 @@
+import { filterAs } from '@xylabs/array'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedBlock, TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import { asTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+
+export const transactionsFromHydratedBlock = (block: HydratedBlock): WithStorageMeta<TransactionBoundWitness>[] => {
+  return filterAs(block[1], asTransactionBoundWitnessWithStorageMeta)
+}

package/src/block/hydrate/tryHydrateBlock.ts

@@ -0,0 +1,25 @@
+import { assertEx } from '@xylabs/assert'
+import type { Hash } from '@xylabs/hex'
+import type { ReadArchivist } from '@xyo-network/archivist-model'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+import { isBlockBoundWitnessWithStorageMeta, isTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+
+export const tryHydrateBlock = async (
+  archivist: ReadArchivist,
+  hash: Hash,
+  maxDepth: number = 1,
+): Promise<HydratedBlock | undefined> => {
+  assertEx(maxDepth >= 0, () => 'maxDepth must be greater than or equal to 0')
+  const bw = (await archivist.get([hash])).find(isBlockBoundWitnessWithStorageMeta)
+  if (!bw) return undefined
+  if (maxDepth === 0) return [bw, []]
+  const blkPayloads = await archivist.get(bw.payload_hashes)
+  if (maxDepth === 1) return [bw, blkPayloads]
+  const transactions = blkPayloads.filter(isTransactionBoundWitnessWithStorageMeta)
+  const transactionsPayloadHashes = transactions.flatMap(tx => tx.payload_hashes)
+  const transactionsPayloads = await archivist.get(transactionsPayloadHashes)
+  const allPayloadsHashes = new Set([...blkPayloads, ...transactionsPayloads].flatMap(p => p._hash))
+  const allPayloads = await archivist.get([...allPayloadsHashes])
+  const allPayloadsFiltered = allPayloads.filter(p => allPayloadsHashes.has(p._hash))
+  return [bw, allPayloadsFiltered]
+}

package/src/block/index.ts

@@ -1,2 +1,2 @@
-export * from './hydrateBlock.ts'
+export * from './hydrate/index.ts'
 export * from './primitives/index.ts'

package/src/block/primitives/{balanceStepSummaryFromRange.ts → balances/balancesStepSummaryFromRange.ts}

@@ -5,18 +5,18 @@ import type { WithStorageMeta } from '@xyo-network/payload-model'
 import { isAnyPayload } from '@xyo-network/payload-model'
 import { StepSizes } from '@xyo-network/xl1-protocol'
 
-import { netBalancesForPayloads } from '../../payload/index.ts'
+import { netBalancesForPayloads } from '../../../payload/index.ts'
 import {
   parseSignedBigInt, type SignedBigInt, toSignedBigInt,
-} from '../../SignedBigInt.ts'
-import { hydrateBlock } from '../hydrateBlock.ts'
-import type { BlockNumberRange } from './frames/index.ts'
-import { deepCalculateFramesFromRange } from './frames/index.ts'
-import { hashFromBlockNumber } from './hashFromBlockNumber.ts'
-import type { BalanceStepSummaryContext } from './model.ts'
-import { type BalancesStepSummary, BalancesStepSummarySchema } from './payloads.ts'
+} from '../../../SignedBigInt.ts'
+import { hydrateBlock } from '../../hydrate/index.ts'
+import type { BlockNumberRange } from '../frames/index.ts'
+import { deepCalculateFramesFromRange } from '../frames/index.ts'
+import { hashFromBlockNumber } from '../hashFromBlockNumber.ts'
+import type { BalanceStepSummaryContext } from '../model.ts'
+import { type BalancesStepSummary, BalancesStepSummarySchema } from '../payloads/index.ts'
 
-export async function balanceStepSummaryFromRange(
+export async function balancesStepSummaryFromRange(
   context: BalanceStepSummaryContext,
   range: BlockNumberRange,
 ): Promise<WithStorageMeta<BalancesStepSummary>> {
@@ -47,7 +47,7 @@ export async function balanceStepSummaryFromRange(
     } else {
     // We do not have it, so lets build it
       const subRanges = deepCalculateFramesFromRange(range, step - 1)
-      const promises = subRanges.map(subRange => balanceStepSummaryFromRange(
+      const promises = subRanges.map(subRange => balancesStepSummaryFromRange(
         context,
         subRange,
       ))

package/src/block/primitives/{balanceSummary.ts → balances/balancesSummary.ts}

@@ -4,12 +4,12 @@ import { spanRootAsync } from '@xylabs/telemetry'
 import { isDefined } from '@xylabs/typeof'
 import { asBlockBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
 
-import { parseSignedBigInt } from '../../SignedBigInt.ts'
-import { balanceStepSummaryFromRange } from './balanceStepSummaryFromRange.ts'
-import { deepCalculateFramesFromRange } from './frames/index.ts'
-import type { BalanceStepSummaryContext } from './model.ts'
+import { parseSignedBigInt } from '../../../SignedBigInt.ts'
+import { deepCalculateFramesFromRange } from '../frames/index.ts'
+import type { BalanceStepSummaryContext } from '../model.ts'
+import { balancesStepSummaryFromRange } from './balancesStepSummaryFromRange.ts'
 
-export async function balanceSummary(
+export async function balancesSummary(
   context: BalanceStepSummaryContext,
 ): Promise<Partial<Record<Address, bigint>>> {
   return await spanRootAsync('balanceSummary', async () => {
@@ -17,7 +17,7 @@ export async function balanceSummary(
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult.at(0), () => `Head block not found for hash: ${context.head}`, { required: true })
     const rangeStart = isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0
     const ranges = deepCalculateFramesFromRange([rangeStart, headBoundWitness.block])
-    const summaries = await Promise.all(ranges.map(range => balanceStepSummaryFromRange(context, range)))
+    const summaries = await Promise.all(ranges.map(range => balancesStepSummaryFromRange(context, range)))
     const balances: Partial<Record<Address, bigint>> = {}
     for (let summary of summaries) {
       for (const [address, balance] of Object.entries(summary.balances)) {

package/src/block/primitives/balances/index.ts

@@ -0,0 +1,2 @@
+export * from './balancesStepSummaryFromRange.ts'
+export * from './balancesSummary.ts'

package/src/block/primitives/blockFromBlockNumber.ts

@@ -0,0 +1,33 @@
+import { asHash, type Hash } from '@xylabs/hex'
+import { toSafeJsonString } from '@xylabs/object'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type { BlockBoundWitness } from '@xyo-network/xl1-protocol'
+import { asBlockBoundWitnessWithStorageMeta, StepSizes } from '@xyo-network/xl1-protocol'
+
+import type { ChainContext } from './model.ts'
+
+export async function blockFromBlockNumber(context: ChainContext, blockNumber: number): Promise<WithStorageMeta<BlockBoundWitness>> {
+  const result = await context.chainArchivist.get([context.head])
+  let currentBlock = asBlockBoundWitnessWithStorageMeta(result.at(0), () => `Head block not found for hash: ${context.head}`, { required: true })
+  while (currentBlock.block > blockNumber) {
+    let jumpHash: Hash | null = currentBlock.previous
+    let jumpBlockNumber = currentBlock.block - 1
+    for (const [step, stepSize] of StepSizes.entries()) {
+      const possibleJumpBlockNumber = currentBlock.block - stepSize
+      if (possibleJumpBlockNumber >= blockNumber && possibleJumpBlockNumber <= jumpBlockNumber) {
+        jumpBlockNumber = possibleJumpBlockNumber
+        jumpHash = asHash(currentBlock.step_hashes.at(step), () => `Step hash not found for step ${step} in block ${currentBlock.block}`)
+      }
+    }
+    const [newBlock] = await context.chainArchivist.get([
+      asHash(jumpHash, () => `Jump hash not found for block number [${blockNumber}]: ${jumpBlockNumber} ${toSafeJsonString(currentBlock, 10)}`)])
+    currentBlock = asBlockBoundWitnessWithStorageMeta(newBlock, () => `Block not found for hash: ${jumpHash}`, { required: true })
+    if (currentBlock.block === blockNumber) {
+      break
+    }
+    if (currentBlock.block < blockNumber) {
+      throw new Error(`Block number ${blockNumber} is not a valid step block number for block ${context.head}.`)
+    }
+  }
+  return currentBlock
+}

package/src/block/primitives/hashFromBlockNumber.ts

@@ -1,31 +1,8 @@
-import { asHash, type Hash } from '@xylabs/hex'
-import { toSafeJsonString } from '@xylabs/object'
-import { asBlockBoundWitnessWithStorageMeta, StepSizes } from '@xyo-network/xl1-protocol'
+import { type Hash } from '@xylabs/hex'
 
+import { blockFromBlockNumber } from './blockFromBlockNumber.ts'
 import type { ChainContext } from './model.ts'
 
 export async function hashFromBlockNumber(context: ChainContext, blockNumber: number): Promise<Hash> {
-  const result = await context.chainArchivist.get([context.head])
-  let currentBlock = asBlockBoundWitnessWithStorageMeta(result.at(0), () => `Head block not found for hash: ${context.head}`, { required: true })
-  while (currentBlock.block > blockNumber) {
-    let jumpHash: Hash | null = currentBlock.previous
-    let jumpBlockNumber = currentBlock.block - 1
-    for (const [step, stepSize] of StepSizes.entries()) {
-      const possibleJumpBlockNumber = currentBlock.block - stepSize
-      if (possibleJumpBlockNumber >= blockNumber && possibleJumpBlockNumber <= jumpBlockNumber) {
-        jumpBlockNumber = possibleJumpBlockNumber
-        jumpHash = asHash(currentBlock.step_hashes.at(step), () => `Step hash not found for step ${step} in block ${currentBlock.block}`)
-      }
-    }
-    const [newBlock] = await context.chainArchivist.get([
-      asHash(jumpHash, () => `Jump hash not found for block number [${blockNumber}]: ${jumpBlockNumber} ${toSafeJsonString(currentBlock, 10)}`)])
-    currentBlock = asBlockBoundWitnessWithStorageMeta(newBlock, () => `Block not found for hash: ${jumpHash}`, { required: true })
-    if (currentBlock.block === blockNumber) {
-      break
-    }
-    if (currentBlock.block < blockNumber) {
-      throw new Error(`Block number ${blockNumber} is not a valid step block number for block ${context.head}.`)
-    }
-  }
-  return currentBlock._hash
+  return (await blockFromBlockNumber(context, blockNumber))._hash
 }

package/src/block/primitives/index.ts

@@ -1,6 +1,7 @@
-export * from './balanceStepSummaryFromRange.ts'
-export * from './balanceSummary.ts'
+export * from './balances/index.ts'
+export * from './blockFromBlockNumber.ts'
 export * from './frames/index.ts'
 export * from './hashFromBlockNumber.ts'
 export * from './model.ts'
-export * from './payloads.ts'
+export * from './payloads/index.ts'
+export * from './transfers/index.ts'

package/src/block/primitives/model.ts

@@ -1,9 +1,9 @@
-import type { Hash } from '@xylabs/hex'
+import type { Address, Hash } from '@xylabs/hex'
 import type { ReadArchivist } from '@xyo-network/archivist-model'
 import type { Payload } from '@xyo-network/payload-model'
 import type { PayloadRepository } from '@xyo-network/xl1-protocol'
 
-import type { BalancesStepSummary } from './payloads.ts'
+import type { BalancesStepSummary, TransfersStepSummary } from './payloads/index.ts'
 
 export interface ChainContext {
   chainArchivist: ReadArchivist
@@ -16,3 +16,8 @@ export interface ChainSummaryContext<T extends Payload> extends ChainContext {
 }
 
 export interface BalanceStepSummaryContext extends ChainSummaryContext<BalancesStepSummary> {}
+
+export interface TransfersStepSummaryContext extends ChainSummaryContext<TransfersStepSummary> {
+  /* The address that the transfers to/from are being summarized */
+  account: Address
+}

package/src/block/primitives/{payloads.ts → payloads/BalancesStepSummary.ts}

@@ -1,29 +1,10 @@
-import type { Address, Hash } from '@xylabs/hex'
-import type { EmptyObject } from '@xylabs/object'
+import type { Address } from '@xylabs/hex'
 import { AsObjectFactory } from '@xylabs/object'
-import type {
-  Payload, Schema, WithStorageMeta,
-} from '@xyo-network/payload-model'
+import type { Schema, WithStorageMeta } from '@xyo-network/payload-model'
 import { isPayloadOfSchemaType, isStorageMeta } from '@xyo-network/payload-model'
 
-import type { SignedBigInt } from '../../SignedBigInt.ts'
-
-export const StepSummarySchema: Schema = 'network.xyo.step.summary'
-export type StepSummarySchema = typeof StepSummarySchema
-
-export interface StepSummaryFields {
-  hash: Hash // the stepHash - the hash of the last block in the step frame
-  stepSize: number // the stepSize in blocks
-}
-
-export interface ChainWindow {
-  depth: number // number of blocks the window covers, including the head
-  head: Hash // the head of the chain
-}
-
-export type StepSummary<TAdditionalFields extends EmptyObject | void = void,
-  TSchema extends Schema | void = void> = Payload<TAdditionalFields extends void ? StepSummaryFields : TAdditionalFields & StepSummaryFields,
-    TSchema extends void ? StepSummarySchema : TSchema>
+import type { SignedBigInt } from '../../../SignedBigInt.ts'
+import type { StepSummary } from './StepSummary.ts'
 
 export const BalancesStepSummarySchema: Schema = 'network.xyo.step.summary.balances'
 export type BalancesStepSummarySchema = typeof BalancesStepSummarySchema

package/src/block/primitives/payloads/ChainWindow.ts

@@ -0,0 +1,6 @@
+import type { Hash } from '@xylabs/hex'
+
+export interface ChainWindow {
+  depth: number // number of blocks the window covers, including the head
+  head: Hash // the head of the chain
+}

package/src/block/primitives/payloads/StepSummary.ts

@@ -0,0 +1,15 @@
+import type { Hash } from '@xylabs/hex'
+import type { EmptyObject } from '@xylabs/object'
+import type { Payload, Schema } from '@xyo-network/payload-model'
+
+export const StepSummarySchema: Schema = 'network.xyo.step.summary'
+export type StepSummarySchema = typeof StepSummarySchema
+
+export interface StepSummaryFields {
+  hash: Hash // the stepHash - the hash of the last block in the step frame
+  stepSize: number // the stepSize in blocks
+}
+
+export type StepSummary<TAdditionalFields extends EmptyObject | void = void,
+  TSchema extends Schema | void = void> = Payload<TAdditionalFields extends void ? StepSummaryFields : TAdditionalFields & StepSummaryFields,
+    TSchema extends void ? StepSummarySchema : TSchema>

package/src/block/primitives/payloads/TransfersSummary.ts

@@ -0,0 +1,30 @@
+import type { Address } from '@xylabs/hex'
+import { AsObjectFactory } from '@xylabs/object'
+import type { Schema, WithStorageMeta } from '@xyo-network/payload-model'
+import { isPayloadOfSchemaType, isStorageMeta } from '@xyo-network/payload-model'
+
+import type { SignedBigInt } from '../../../SignedBigInt.ts'
+import type { StepSummary } from './StepSummary.ts'
+
+export const TransfersStepSummarySchema: Schema = 'network.xyo.step.summary.transfer'
+export type TransfersStepSummarySchema = typeof TransfersStepSummarySchema
+
+export type TransfersStepSummary = StepSummary<{
+  account: Address
+  transfers: Record<Address, SignedBigInt>
+}, TransfersStepSummarySchema>
+
+/**
+ * Identity function for determining if an object is an TransfersStepSummary
+ */
+export const isTransfersStepSummary = isPayloadOfSchemaType<TransfersStepSummary>(TransfersStepSummarySchema)
+export const asTransfersStepSummary = AsObjectFactory.create<TransfersStepSummary>(isTransfersStepSummary)
+
+/**
+ * Identity function for determining if an object is an TransfersStepSummary with Storage Meta
+ */
+export const isTransfersStepSummaryWithStorageMeta = (value: unknown): value is WithStorageMeta<TransfersStepSummary> => {
+  return isTransfersStepSummary(value) && isStorageMeta(value)
+}
+export const asTransfersStepSummaryWithStorageMeta
+  = AsObjectFactory.create<WithStorageMeta<TransfersStepSummary>>(isTransfersStepSummaryWithStorageMeta)

package/src/block/primitives/payloads/index.ts

@@ -0,0 +1,4 @@
+export * from './BalancesStepSummary.ts'
+export * from './ChainWindow.ts'
+export * from './StepSummary.ts'
+export * from './TransfersSummary.ts'

package/src/block/primitives/transfers/index.ts

@@ -0,0 +1,2 @@
+export * from './transfersStepSummaryFromRange.ts'
+export * from './transfersSummary.ts'