@xyo-network/xl1-protocol-sdk 1.15.7 → 1.15.9

package/dist/neutral/model/ChainContext/ChainStakeContext.d.ts

@@ -1,9 +1,11 @@
 import type { ChainIdentity } from '../ChainIdentity.ts';
 import type { ChainStakeRead, ChainStakeWrite } from '../ChainStake/index.ts';
+import type { StakeEventsRead } from '../StakeEvents.ts';
 export interface ChainStakeContextWrite extends ChainIdentity {
     stake: ChainStakeWrite;
 }
 export interface ChainStakeContextRead extends ChainIdentity {
+    events: StakeEventsRead;
     stake: ChainStakeRead;
 }
 export type ChainStakeContext = ChainStakeContextRead & ChainStakeContextWrite;

package/dist/neutral/model/ChainContext/ChainStakeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainStakeContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainStakeContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7E,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,KAAK,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"ChainStakeContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainStakeContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}

package/dist/neutral/multipliers.d.ts

@@ -0,0 +1,5 @@
+import type { XL1RangeMultipliers } from '@xyo-network/xl1-protocol';
+export declare const XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_REWARDS: import("@xyo-network/xl1-protocol").AttoXL1;
+export declare const XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_BONUS_REWARDS: import("@xyo-network/xl1-protocol").AttoXL1;
+export declare const RewardMultipliers: XL1RangeMultipliers;
+//# sourceMappingURL=multipliers.d.ts.map

package/dist/neutral/multipliers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipliers.d.ts","sourceRoot":"","sources":["../../src/multipliers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAStF,eAAO,MAAM,gDAAgD,6CAAgD,CAAA;AAC7G,eAAO,MAAM,sDAAsD,6CAA8C,CAAA;AAEjH,eAAO,MAAM,iBAAiB,EAAE,mBAG/B,CAAA"}

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

@@ -1,3 +1,4 @@
+import type { XL1BlockNumber } from '@xyo-network/xl1-protocol';
 import type { ChainContextRead } from '../../model/index.ts';
-export declare function xl1BlockNumberToEthBlockNumber(context: ChainContextRead, xl1BlockNumber: number): Promise<number>;
+export declare function xl1BlockNumberToEthBlockNumber(context: ChainContextRead, xl1BlockNumber: XL1BlockNumber): Promise<number>;
 //# sourceMappingURL=xl1BlockNumberToEthBlockNumber.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"xl1BlockNumberToEthBlockNumber.d.ts","sourceRoot":"","sources":["../../../../src/time/primitives/xl1BlockNumberToEthBlockNumber.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvH"}
+{"version":3,"file":"xl1BlockNumberToEthBlockNumber.d.ts","sourceRoot":"","sources":["../../../../src/time/primitives/xl1BlockNumberToEthBlockNumber.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAK/H"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.15.7",
+  "version": "1.15.9",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -55,17 +55,17 @@
     "@xyo-network/typechain": "~4.0.10",
     "@xyo-network/wallet": "~5.1.6",
     "@xyo-network/wallet-model": "~5.1.6",
-    "@xyo-network/xl1-protocol": "~1.12.69",
+    "@xyo-network/xl1-protocol": "~1.12.78",
     "async-mutex": "~0.5.0",
     "zod": "~4.1.12"
   },
   "devDependencies": {
-    "@types/node": "~24.7.2",
+    "@types/node": "~24.8.1",
     "@xylabs/ts-scripts-yarn3": "~7.1.8",
     "@xylabs/tsconfig": "~7.1.8",
     "@xyo-network/account": "~5.1.6",
     "@xyo-network/boundwitness-validator": "~5.1.6",
-    "eslint": "^9.37.0",
+    "eslint": "^9.38.0",
     "typescript": "~5.9.3",
     "vitest": "~3.2.4"
   },

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

@@ -4,6 +4,7 @@ import { type Address } from '@xylabs/hex'
 import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type { WithStorageMeta } from '@xyo-network/payload-model'
 import { isAnyPayload } from '@xyo-network/payload-model'
+import type { XL1BlockRange } from '@xyo-network/xl1-protocol'
 import { StepSizes } from '@xyo-network/xl1-protocol'
 
 import { netBalancesForPayloads } from '../../../payload/index.ts'
@@ -11,7 +12,6 @@ import {
   parseSignedBigInt, type SignedBigInt, toSignedBigInt,
 } 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'
@@ -19,7 +19,7 @@ import { type BalancesStepSummary, BalancesStepSummarySchema } from '../payloads
 
 export async function balancesStepSummaryFromRange(
   context: BalanceStepSummaryContext,
-  range: BlockNumberRange,
+  range: XL1BlockRange,
 ): Promise<WithStorageMeta<BalancesStepSummary>> {
   // console.log(`balanceStepSummaryFromRange: head=${head}, range=${range[0]}-${range[1]}`)
   const frameHeadHash = await hashFromBlockNumber(context, range[1])

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

@@ -2,7 +2,7 @@ import type { Address } from '@xylabs/hex'
 import { asAddress } from '@xylabs/hex'
 import { spanRootAsync } from '@xylabs/telemetry'
 import { isDefined } from '@xylabs/typeof'
-import { asBlockBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+import { asBlockBoundWitnessWithStorageMeta, asXL1BlockNumber } from '@xyo-network/xl1-protocol'
 
 import { parseSignedBigInt } from '../../../SignedBigInt.ts'
 import { deepCalculateFramesFromRange } from '../frames/index.ts'
@@ -16,8 +16,8 @@ export async function balancesSummary(
     const head = await context.head()
     const headResult = await context.store.chainMap.get(head)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `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 rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0)
+    const ranges = deepCalculateFramesFromRange([rangeStart, asXL1BlockNumber(headBoundWitness.block)])
     const summaries = await Promise.all(ranges.map(range => balancesStepSummaryFromRange(context, range)))
     const balances: Partial<Record<Address, bigint>> = {}
     for (let summary of summaries) {

package/src/block/primitives/blockFromBlockNumber.ts

@@ -1,15 +1,18 @@
 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 type { BlockBoundWitness, XL1BlockNumber } from '@xyo-network/xl1-protocol'
 import { asBlockBoundWitnessWithStorageMeta, StepSizes } from '@xyo-network/xl1-protocol'
 
 import type { ChainContextRead } from '../../model/index.ts'
 
-export async function blockFromBlockNumber(context: ChainContextRead, blockNumber: number): Promise<WithStorageMeta<BlockBoundWitness>> {
+export async function blockFromBlockNumber(context: ChainContextRead, blockNumber: XL1BlockNumber): Promise<WithStorageMeta<BlockBoundWitness>> {
   const head = await context.head()
   const result = await context.store.chainMap.get(head)
   let currentBlock = asBlockBoundWitnessWithStorageMeta(result, () => `Head block not found for hash: ${head}`, { required: true })
+  if (currentBlock.block < blockNumber) {
+    throw new Error(`Error: Block number ${blockNumber} is greater than head ${currentBlock.block}.`)
+  }
   while (currentBlock.block > blockNumber) {
     let jumpHash: Hash | null = currentBlock.previous
     let jumpBlockNumber = currentBlock.block - 1

package/src/block/primitives/frames/calculateFramesFromRange.ts

@@ -1,28 +1,27 @@
-import { stepSize } from '@xyo-network/xl1-protocol'
+import type { XL1BlockRange } from '@xyo-network/xl1-protocol'
+import { asXL1BlockNumber, stepSize } from '@xyo-network/xl1-protocol'
 
-import type { BlockNumberRange } from './BlockNumberRange.ts'
-
-export function calculateFramesFromRange(range: BlockNumberRange, step: number): [
+export function calculateFramesFromRange(range: XL1BlockRange, step: number): [
   // ranges of fitted frames
-  BlockNumberRange[],
+  XL1BlockRange[],
   // ranges of remaining blocks
-  BlockNumberRange[]] {
+  XL1BlockRange[]] {
   const size = stepSize(step)
   let start = (Math.trunc(range[0] / size)) * size
-  const fitted: BlockNumberRange[] = []
-  const remaining: BlockNumberRange[] = []
+  const fitted: XL1BlockRange[] = []
+  const remaining: XL1BlockRange[] = []
 
   // if the start is not aligned with the range, add a remaining block
   if (start !== range[0]) {
     start += size
-    remaining.push([range[0], Math.min(start - 1, range[1])])
+    remaining.push([range[0], asXL1BlockNumber(Math.min(start - 1, range[1]))])
   }
 
   for (let i = start; i <= range[1]; i += size) {
     if ((i + size - 1) <= range[1]) {
-      fitted.push([i, Math.min(i + size - 1, range[1])])
+      fitted.push([asXL1BlockNumber(i), asXL1BlockNumber(Math.min(i + size - 1, range[1]))])
     } else {
-      remaining.push([i, range[1]])
+      remaining.push([asXL1BlockNumber(i), range[1]])
     }
   }
   return [fitted, remaining]

package/src/block/primitives/frames/deepCalculateFramesFromRange.ts

@@ -1,14 +1,14 @@
+import type { XL1BlockRange } from '@xyo-network/xl1-protocol'
 import { StepSizes } from '@xyo-network/xl1-protocol'
 
-import type { BlockNumberRange } from './BlockNumberRange.ts'
 import { calculateFramesFromRange } from './calculateFramesFromRange.ts'
 
-export function deepCalculateFramesFromRange(range: BlockNumberRange, startingStep = StepSizes.length - 1): BlockNumberRange[] {
-  const fitted: BlockNumberRange[] = []
-  let remaining: BlockNumberRange[] = [range]
+export function deepCalculateFramesFromRange(range: XL1BlockRange, startingStep = StepSizes.length - 1): XL1BlockRange[] {
+  const fitted: XL1BlockRange[] = []
+  let remaining: XL1BlockRange[] = [range]
 
   for (let step = startingStep; step >= 0; step--) {
-    const newRemaining: BlockNumberRange[] = []
+    const newRemaining: XL1BlockRange[] = []
     for (const range of remaining) {
       const [newFittedFrames, newRemainingFrames] = calculateFramesFromRange(range, step)
       fitted.push(...newFittedFrames)

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

@@ -1,3 +1,2 @@
-export * from './BlockNumberRange.ts'
 export * from './calculateFramesFromRange.ts'
 export * from './deepCalculateFramesFromRange.ts'

package/src/block/primitives/frames/spec/calculateFramesFromRange.spec.ts

@@ -1,4 +1,7 @@
-import { stepSize } from '@xyo-network/xl1-protocol'
+import type { XL1BlockRange } from '@xyo-network/xl1-protocol'
+import {
+  asXL1BlockNumber, stepSize, XL1_BLOCK_NUMBER_ZERO,
+} from '@xyo-network/xl1-protocol'
 import {
   describe, expect, it,
 } from 'vitest'
@@ -8,7 +11,7 @@ import { calculateFramesFromRange } from '../calculateFramesFromRange.ts'
 describe('calculateFramesFromRange', () => {
   it('handles range aligned with step size', () => {
     const step = 1 // 105
-    const range: [number, number] = [0, stepSize(step) - 1]
+    const range: XL1BlockRange = [XL1_BLOCK_NUMBER_ZERO, asXL1BlockNumber(stepSize(step) - 1)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([[0, 30]])
@@ -17,7 +20,7 @@ describe('calculateFramesFromRange', () => {
 
   it('handles range starting at step boundary but incomplete', () => {
     const step = 1
-    const range: [number, number] = [stepSize(step), stepSize(step) + 1]
+    const range: XL1BlockRange = [asXL1BlockNumber(stepSize(step)), asXL1BlockNumber(stepSize(step) + 1)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([])
@@ -28,7 +31,7 @@ describe('calculateFramesFromRange', () => {
     const step = 1
     const multiplier = 2
     const additional = 1
-    const range: [number, number] = [stepSize(step), (stepSize(step) + additional) * multiplier]
+    const range: XL1BlockRange = [asXL1BlockNumber(stepSize(step)), asXL1BlockNumber((stepSize(step) + additional) * multiplier)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([[31, 61]])
@@ -39,7 +42,7 @@ describe('calculateFramesFromRange', () => {
     const step = 5
     const multiplier = 2
     const additional = 17
-    const range: [number, number] = [stepSize(step), (stepSize(step) + additional) * multiplier]
+    const range: XL1BlockRange = [asXL1BlockNumber(stepSize(step)), asXL1BlockNumber((stepSize(step) + additional) * multiplier)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([[510_511, 1_021_021]])
@@ -50,7 +53,7 @@ describe('calculateFramesFromRange', () => {
     const step = 1
     const multiplier = 2
     const additional = 1
-    const range: [number, number] = [stepSize(step) - additional, (stepSize(step) + additional) * multiplier]
+    const range: XL1BlockRange = [asXL1BlockNumber(stepSize(step) - additional), asXL1BlockNumber((stepSize(step) + additional) * multiplier)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([[31, 61]])
@@ -61,7 +64,7 @@ describe('calculateFramesFromRange', () => {
     const step = 5
     const multiplier = 2
     const additional = 17
-    const range: [number, number] = [stepSize(step) - additional, (stepSize(step) + additional) * multiplier]
+    const range: XL1BlockRange = [asXL1BlockNumber(stepSize(step) - additional), asXL1BlockNumber((stepSize(step) + additional) * multiplier)]
     const [fitted, remaining] = calculateFramesFromRange(range, step)
 
     expect(fitted).toEqual([[510_511, 1_021_021]])

package/src/block/primitives/frames/spec/deepCalculateFramesFromRange.spec.ts

@@ -1,13 +1,13 @@
+import { asXL1BlockRange } from '@xyo-network/xl1-protocol'
 import {
   describe, expect, it,
 } from 'vitest'
 
-import type { BlockNumberRange } from '../BlockNumberRange.ts'
 import { deepCalculateFramesFromRange } from '../deepCalculateFramesFromRange.ts'
 
 describe('deepCalculateFramesFromRange', () => {
   it('calculates frames for a simple range with one step level', () => {
-    const range: BlockNumberRange = [0, 9]
+    const range = asXL1BlockRange([0, 9])
     const result = deepCalculateFramesFromRange(range)
 
     // With step 0 (size 10), this should fit in one frame
@@ -15,7 +15,7 @@ describe('deepCalculateFramesFromRange', () => {
   })
 
   it('calculates frames for a range spanning multiple step sizes', () => {
-    const range: BlockNumberRange = [0, 250]
+    const range = asXL1BlockRange([0, 250])
     const result = deepCalculateFramesFromRange(range)
 
     expect(result).toContainEqual([0, 210])
@@ -25,49 +25,49 @@ describe('deepCalculateFramesFromRange', () => {
   })
 
   it('calculates frames for range with multiple step levels - [0, 1500]', () => {
-    const range: BlockNumberRange = [0, 1500]
+    const range = asXL1BlockRange([0, 1500])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(19)
   })
 
   it('calculates frames for range with multiple step levels - [0, 3000]', () => {
-    const range: BlockNumberRange = [0, 3000]
+    const range = asXL1BlockRange([0, 3000])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(31)
   })
 
   it('calculates frames for range with multiple step levels = [45, 1599]', () => {
-    const range: BlockNumberRange = [45, 1599]
+    const range = asXL1BlockRange([45, 1599])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(43)
   })
 
   it('calculates frames for range with multiple step levels = [45, 3333]', () => {
-    const range: BlockNumberRange = [45, 3333]
+    const range = asXL1BlockRange([45, 3333])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(85)
   })
 
   it('calculates frames for range with multiple step levels - [23_145, 230_102_040]', () => {
-    const range: BlockNumberRange = [23_145, 230_102_040]
+    const range = asXL1BlockRange([23_145, 230_102_040])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(742)
   })
 
   it('calculates frames for range with multiple step levels - [23_145, 34_548_554_394]', () => {
-    const range: BlockNumberRange = [23_145, 34_548_554_394]
+    const range = asXL1BlockRange([23_145, 34_548_554_394])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(1468)
   })
 
   it('calculates frames for range with multiple step levels - [23_145, 4_598_734_539_845]', () => {
-    const range: BlockNumberRange = [23_145, 4_598_734_539_845]
+    const range = asXL1BlockRange([23_145, 4_598_734_539_845])
     const result = deepCalculateFramesFromRange(range)
     expect(result).toMatchSnapshot(result)
     expect(result.length).toEqual(2445)

package/src/block/primitives/hashFromBlockNumber.ts

@@ -1,8 +1,9 @@
 import { type Hash } from '@xylabs/hex'
+import type { XL1BlockNumber } from '@xyo-network/xl1-protocol'
 
 import type { ChainContextRead } from '../../model/index.ts'
 import { blockFromBlockNumber } from './blockFromBlockNumber.ts'
 
-export async function hashFromBlockNumber(context: ChainContextRead, blockNumber: number): Promise<Hash> {
+export async function hashFromBlockNumber(context: ChainContextRead, blockNumber: XL1BlockNumber): Promise<Hash> {
   return (await blockFromBlockNumber(context, blockNumber))._hash
 }

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

@@ -4,6 +4,7 @@ import { type Address } from '@xylabs/hex'
 import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type { WithStorageMeta } from '@xyo-network/payload-model'
 import { isAnyPayload } from '@xyo-network/payload-model'
+import type { XL1BlockRange } from '@xyo-network/xl1-protocol'
 import { StepSizes } from '@xyo-network/xl1-protocol'
 
 import { netTransfersForPayloads } from '../../../payload/index.ts'
@@ -11,14 +12,14 @@ import {
   parseSignedBigInt, type SignedBigInt, toSignedBigInt,
 } from '../../../SignedBigInt.ts'
 import { hydrateBlock } from '../../hydrate/index.ts'
-import { type BlockNumberRange, deepCalculateFramesFromRange } from '../frames/index.ts'
+import { deepCalculateFramesFromRange } from '../frames/index.ts'
 import { hashFromBlockNumber } from '../hashFromBlockNumber.ts'
 import type { TransfersStepSummaryContext } from '../model.ts'
 import { type TransfersStepSummary, TransfersStepSummarySchema } from '../payloads/index.ts'
 
 export async function transfersStepSummaryFromRange(
   context: TransfersStepSummaryContext,
-  range: BlockNumberRange,
+  range: XL1BlockRange,
 ): Promise<WithStorageMeta<TransfersStepSummary>> {
   // console.log(`transfersStepSummaryFromRange: head=${head}, range=${range[0]}-${range[1]}`)
   const frameHeadHash = await hashFromBlockNumber(context, range[1])

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

@@ -2,7 +2,7 @@ import type { Address } from '@xylabs/hex'
 import { asAddress } from '@xylabs/hex'
 import { spanRootAsync } from '@xylabs/telemetry'
 import { isDefined } from '@xylabs/typeof'
-import { asBlockBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
+import { asBlockBoundWitnessWithStorageMeta, asXL1BlockNumber } from '@xyo-network/xl1-protocol'
 
 import { parseSignedBigInt } from '../../../SignedBigInt.ts'
 import { deepCalculateFramesFromRange } from '../frames/index.ts'
@@ -17,8 +17,8 @@ export async function transfersSummary(
     const head = await context.head()
     const headResult = await context.store.chainMap.get(head)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `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 rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0)
+    const ranges = deepCalculateFramesFromRange([rangeStart, asXL1BlockNumber(headBoundWitness.block)])
     const summaries = await Promise.all(ranges.map(range => transfersStepSummaryFromRange(context, range)))
     const transfers: Partial<Record<Address, Partial<Record<Address, bigint>>>> = {}
     for (let summary of summaries) {

package/src/constants.ts

@@ -0,0 +1,2 @@
+export const XL1_NETWORK_STAKING_GENESIS_PERIOD_END_EPOCH = 1_760_572_800 as const
+export const XL1_NETWORK_STAKING_GENESIS_PERIOD_END_XL1_BLOCK = 107_496 as const

package/src/index.ts

@@ -2,12 +2,13 @@ export * from './block/index.ts'
 export * from './ChainServiceCollection.ts'
 export * from './ChainServiceCollectionV2.ts'
 export * from './config/index.ts'
+export * from './constants.ts'
 export * from './instances/index.ts'
 export * from './map/index.ts'
 export * from './model/index.ts'
+export * from './multipliers.ts'
 export * from './payload/index.ts'
 export * from './SignedBigInt.ts'
-export * from './steps/index.ts'
 export * from './time/index.ts'
 export * from './transaction/index.ts'
 export * from './validation/index.ts'

package/src/model/ChainContext/ChainStakeContext.ts

@@ -1,11 +1,13 @@
 import type { ChainIdentity } from '../ChainIdentity.ts'
 import type { ChainStakeRead, ChainStakeWrite } from '../ChainStake/index.ts'
+import type { StakeEventsRead } from '../StakeEvents.ts'
 
 export interface ChainStakeContextWrite extends ChainIdentity {
   stake: ChainStakeWrite
 }
 
 export interface ChainStakeContextRead extends ChainIdentity {
+  events: StakeEventsRead
   stake: ChainStakeRead
 }
 

package/src/multipliers.ts

@@ -0,0 +1,16 @@
+import type { XL1BlockRangeKey, XL1RangeMultipliers } from '@xyo-network/xl1-protocol'
+import {
+  asAttoXL1,
+  asXL1,
+  XL1Amount,
+} from '@xyo-network/xl1-protocol'
+
+import { XL1_NETWORK_STAKING_GENESIS_PERIOD_END_XL1_BLOCK } from './constants.ts'
+
+export const XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_REWARDS = asAttoXL1(1_105_508_843_867_301_885_042_548n)
+export const XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_BONUS_REWARDS = XL1Amount.fromXL1(asXL1(100_000_000n)).atto
+
+export const RewardMultipliers: XL1RangeMultipliers = {
+  [`0|${XL1_NETWORK_STAKING_GENESIS_PERIOD_END_XL1_BLOCK}` as XL1BlockRangeKey]:
+      [XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_BONUS_REWARDS, XL1_NETWORK_STAKING_GENESIS_PERIOD_TOTAL_REWARDS],
+}

package/src/time/primitives/xl1BlockNumberToEthBlockNumber.ts

@@ -1,10 +1,11 @@
 import { assertEx } from '@xylabs/assert'
+import type { XL1BlockNumber } from '@xyo-network/xl1-protocol'
 import { asTimePayload, TimeSchema } from '@xyo-network/xl1-protocol'
 
 import { hashFromBlockNumber, hydrateBlock } from '../../block/index.ts'
 import type { ChainContextRead } from '../../model/index.ts'
 
-export async function xl1BlockNumberToEthBlockNumber(context: ChainContextRead, xl1BlockNumber: number): Promise<number> {
+export async function xl1BlockNumberToEthBlockNumber(context: ChainContextRead, xl1BlockNumber: XL1BlockNumber): Promise<number> {
   const blockHash = await hashFromBlockNumber(context, xl1BlockNumber)
   const hydratedBlock = await hydrateBlock(context.store, blockHash)
   const timePayload = asTimePayload(hydratedBlock[1].find(p => p.schema === TimeSchema), { required: true })

package/dist/neutral/block/primitives/frames/BlockNumberRange.d.ts

@@ -1,2 +0,0 @@
-export type BlockNumberRange = [number, number];
-//# sourceMappingURL=BlockNumberRange.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"BlockNumberRange.d.ts","sourceRoot":"","sources":["../../../../../src/block/primitives/frames/BlockNumberRange.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA"}

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

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

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"addressStakeWeight.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/addressStakeWeight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,gBAAgB,EAC/B,MAAM,EAAE,OAAO,EACf,EAAE,EAAE,OAAO,EACX,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

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

@@ -1,3 +0,0 @@
-import type { Address } from '@xylabs/hex';
-export declare function claimedRewards(_address: Address): bigint;
-//# sourceMappingURL=claimedRewards.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"claimedRewards.d.ts","sourceRoot":"","sources":["../../../../src/steps/primitives/claimedRewards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,UAE/C"}

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

@@ -1,7 +0,0 @@
-export * from './addressStakeWeight.ts';
-export * from './claimedRewards.ts';
-export * from './stakersAsOfBlock.ts';
-export * from './startingStakes.ts';
-export * from './totalStakeWeight.ts';
-export * from './unclaimedRewards.ts';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA"}

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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,QAAQ,EAAE,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAEtE"}

package/src/block/primitives/frames/BlockNumberRange.ts

@@ -1 +0,0 @@
-export type BlockNumberRange = [number, number]

package/src/steps/index.ts

@@ -1 +0,0 @@
-export * from './primitives/index.ts'