@xyo-network/xl1-protocol-sdk 1.26.11 → 1.26.13

package/src/primitives/chain/time/externalBlockNumberFromXL1BlockNumber.ts

@@ -1,32 +0,0 @@
-import { assertEx, isArray } from '@xylabs/sdk-js'
-import type {
-  BlockNumber, BlockViewer, CachingContext, XL1BlockNumber,
-} from '@xyo-network/xl1-protocol-lib'
-import {
-  asBlockNumber, asTimePayload, isTimePayload,
-} from '@xyo-network/xl1-protocol-lib'
-
-import { withContextCacheResponse } from '../../../ChainContextHelpers.ts'
-
-const functionName = 'externalBlockNumberFromXL1BlockNumber' as const
-
-/** ExternalBlockNumberFromXL1BlockNumber helper function. */
-export async function externalBlockNumberFromXL1BlockNumber(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  xl1BlockNumber: XL1BlockNumber,
-  externalTimeName: 'ethereum' | 'epoch',
-  externalGenesisTime?: BlockNumber,
-): Promise<BlockNumber> {
-  const cacheKey = `${xl1BlockNumber}-${externalTimeName}-${externalGenesisTime ?? 'default'}`
-  return await withContextCacheResponse(context, functionName, cacheKey, async () => {
-    const [, payloads = []] = await blockViewer.blockByNumber(xl1BlockNumber) ?? []
-    assertEx(isArray(payloads))
-    const timePayload = asTimePayload(payloads.find(isTimePayload))
-    // the default here is the block number we know where the xl1 chain started running (first external staking - 1)
-    return asBlockNumber(
-      timePayload?.[externalTimeName] ?? externalGenesisTime ?? 23_372_716,
-      { name: functionName },
-    ) // default is xl1 mainnet genesis time
-  })
-}

package/src/primitives/chain/time/externalBlockRangeFromStep.ts

@@ -1,21 +0,0 @@
-import type {
-  BlockRange, BlockViewer, CachingContext, StepIdentity,
-} from '@xyo-network/xl1-protocol-lib'
-
-import { toStepIdentityString } from '../../../block/index.ts'
-import { withContextCacheResponse } from '../../../ChainContextHelpers.ts'
-import { stepBlockRange } from '../../step/index.ts'
-import { externalBlockRangeFromXL1BlockRange } from './externalBlockRangeFromXL1BlockRange.ts'
-
-/** ExternalBlockRangeFromStep helper function. */
-export async function externalBlockRangeFromStep(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  stepIdentity: StepIdentity,
-): Promise<BlockRange> {
-  const cacheKey = toStepIdentityString(stepIdentity)
-  return await withContextCacheResponse(context, 'externalBlockRangeFromStep', cacheKey, async () => {
-    const xl1BlockRange = stepBlockRange(stepIdentity)
-    return await externalBlockRangeFromXL1BlockRange(context, blockViewer, xl1BlockRange)
-  })
-}

package/src/primitives/chain/time/externalBlockRangeFromXL1BlockRange.ts

@@ -1,17 +0,0 @@
-import type {
-  BlockRange, BlockViewer, CachingContext, XL1BlockRange,
-} from '@xyo-network/xl1-protocol-lib'
-
-import { externalBlockNumberFromXL1BlockNumber } from './externalBlockNumberFromXL1BlockNumber.ts'
-
-/** ExternalBlockRangeFromXL1BlockRange helper function. */
-export async function externalBlockRangeFromXL1BlockRange(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  xl1BlockRange: XL1BlockRange,
-  externalTimeName: 'ethereum' = 'ethereum',
-): Promise<BlockRange> {
-  const start = await externalBlockNumberFromXL1BlockNumber(context, blockViewer, xl1BlockRange[0], externalTimeName)
-  const end = await externalBlockNumberFromXL1BlockNumber(context, blockViewer, xl1BlockRange[1], externalTimeName)
-  return [start, end]
-}

package/src/primitives/chain/time/index.ts

@@ -1,3 +0,0 @@
-export * from './externalBlockNumberFromXL1BlockNumber.ts'
-export * from './externalBlockRangeFromStep.ts'
-export * from './externalBlockRangeFromXL1BlockRange.ts'

package/src/primitives/datalake/addDataLakePayloads.ts

@@ -1,18 +0,0 @@
-import type { Hash } from '@xylabs/sdk-js'
-import type { DataLakeViewer, HydratedBoundWitnessWithHashMeta } from '@xyo-network/xl1-protocol-lib'
-
-import { addDataLakePayloadsToPayloads } from './addDataLakePayloadsToPayloads.ts'
-
-/** AddDataLakePayloads helper function. */
-export async function addDataLakePayloads<T extends HydratedBoundWitnessWithHashMeta>(
-  [boundWitness, payloads]: T,
-  dataLakeViewer?: DataLakeViewer,
-): Promise<[T, Hash[]]> {
-  const [updatedPayloads, foundHashes] = await addDataLakePayloadsToPayloads(boundWitness.payload_hashes, payloads, dataLakeViewer)
-  return [
-    [
-      boundWitness,
-      updatedPayloads,
-    ] as T,
-    foundHashes]
-}

package/src/primitives/datalake/addDataLakePayloadsToPayloads.ts

@@ -1,24 +0,0 @@
-import type { Hash } from '@xylabs/sdk-js'
-import { isUndefined } from '@xylabs/sdk-js'
-import type { Payload, WithHashMeta } from '@xyo-network/sdk-js'
-import { isAnyPayload, PayloadBuilder } from '@xyo-network/sdk-js'
-import type { DataLakeViewer } from '@xyo-network/xl1-protocol-lib'
-
-/** AddDataLakePayloadsToPayloads helper function. */
-export async function addDataLakePayloadsToPayloads<T extends WithHashMeta<Payload>>(
-  hashes: Hash[],
-  payloads: T[],
-  dataLakeViewer?: DataLakeViewer,
-): Promise<[
-  /* Updated payloads with hash metadata */
-  T[],
-  /* Hashes of the newly added payloads */
-  Hash[],
-]> {
-  if (isUndefined(dataLakeViewer)) return [payloads, []]
-  const missingPayloadHashes = hashes.filter(hash => !payloads.some(p => p._hash === hash))
-  const payloadsFromDataLake = await PayloadBuilder.addHashMeta(
-    await PayloadBuilder.addHashMeta((await dataLakeViewer.get(missingPayloadHashes)).filter(isAnyPayload)),
-  )
-  return [[...payloads, ...payloadsFromDataLake] as T[], payloadsFromDataLake.map(p => p._hash)]
-}

package/src/primitives/datalake/index.ts

@@ -1,2 +0,0 @@
-export * from './addDataLakePayloads.ts'
-export * from './addDataLakePayloadsToPayloads.ts'

package/src/primitives/index.ts

@@ -1,13 +0,0 @@
-export * from './block/index.ts'
-export * from './chain/index.ts'
-export * from './datalake/index.ts'
-export * from './mapToMapType.ts'
-export * from './payload/index.ts'
-export * from './readPayloadMapFromStore.ts'
-export * from './rewardFromBlockNumber.ts'
-export * from './rewards/index.ts'
-export * from './stake/index.ts'
-export * from './state/index.ts'
-export * from './step/index.ts'
-export * from './transaction/index.ts'
-export * from './uncle/index.ts'

package/src/primitives/mapToMapType.ts

@@ -1,35 +0,0 @@
-import { isDefined } from '@xylabs/sdk-js'
-import type { SyncIterableMap } from '@xyo-network/xl1-protocol-lib'
-
-/** MapToMapType helper function. */
-export function mapToMapType<K extends {}, V extends {}>(map: Map<K, V> | SyncIterableMap<K, V>): SyncIterableMap<K, V> {
-  return {
-    get: (key: K) => map.get(key),
-    has: (key: K) => map.has(key),
-    set: (key: K, value: V) => {
-      map.set(key, value)
-    },
-    setMany: (entries: [K, V][]) => {
-      for (const [key, value] of entries) {
-        map.set(key, value)
-      }
-    },
-    delete: (key: K) => map.delete(key),
-    clear: () => map.clear(),
-    getMany: (keys: K[]) => {
-      const result: V[] = []
-      for (const key of keys) {
-        const value = map.get(key)
-        if (isDefined(value)) {
-          result.push(value)
-        }
-      }
-      return result
-    },
-    [Symbol.iterator]: function* (): Iterator<[K, V]> {
-      for (const entry of map) {
-        yield entry
-      }
-    },
-  }
-}

package/src/primitives/payload/index.ts

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

package/src/primitives/payload/mergeTransfers.ts

@@ -1,16 +0,0 @@
-import type { Address } from '@xylabs/sdk-js'
-import { hexToBigInt, toAddress } from '@xylabs/sdk-js'
-import type { Transfer } from '@xyo-network/xl1-protocol-lib'
-
-/** MergeTransfers helper function. */
-export function mergeTransfers(transfers: Transfer[]): Record<Address, Record<Address, bigint>> {
-  const result: Record<Address, Record<Address, bigint>> = {}
-  for (const transfer of transfers) {
-    result[transfer.from] = result[transfer.from] ?? {}
-    for (const [to, value] of Object.entries(transfer.transfers)) {
-      const typedTo = toAddress(to)
-      result[transfer.from][typedTo] = (result[transfer.from][typedTo] ?? 0n) + (hexToBigInt(value))
-    }
-  }
-  return result
-}

package/src/primitives/readPayloadMapFromStore.ts

@@ -1,58 +0,0 @@
-import type { Hash } from '@xylabs/sdk-js'
-import { isDefined } from '@xylabs/sdk-js'
-import type {
-  ReadArchivist, ReadWriteArchivist,
-  WithStorageMeta,
-} from '@xyo-network/sdk-js'
-import type { PayloadMap, PayloadMapRead } from '@xyo-network/xl1-protocol-lib'
-
-import { isReadArchivist, isReadWriteArchivist } from '../block/index.ts'
-
-/** ReadPayloadMapFromStore helper function. */
-export function readPayloadMapFromStore(store: ReadArchivist | PayloadMapRead): PayloadMapRead {
-  if (isReadArchivist(store)) {
-    return {
-      get: async (hash: Hash) => {
-        return (await store.get([hash]))[0]
-      },
-      getMany: async (hashes: Hash[]) => {
-        return (await store.get(hashes))
-      },
-      has: async (hash: Hash) => {
-        return isDefined((await store.get([hash]))[0])
-      },
-    }
-  }
-  return store
-}
-
-/** PayloadMapFromStore helper function. */
-export function payloadMapFromStore(store: ReadWriteArchivist | PayloadMap): PayloadMap {
-  if (isReadWriteArchivist(store)) {
-    return {
-      get: async (hash: Hash) => {
-        return (await store.get([hash]))[0]
-      },
-      getMany: async (hashes: Hash[]) => {
-        return (await store.get(hashes))
-      },
-      has: async (hash: Hash) => {
-        return isDefined((await store.get([hash]))[0])
-      },
-      clear: async () => {
-        return await store.clear()
-      },
-      delete: async (id: Hash) => {
-        await store.delete([id])
-        return true
-      },
-      set: async (_id: Hash, data: WithStorageMeta) => {
-        await store.insert([data])
-      },
-      setMany: async (entries: [Hash, WithStorageMeta][]) => {
-        await store.insert(entries.map(e => e[1]))
-      },
-    } satisfies PayloadMap<WithStorageMeta>
-  }
-  return store
-}

package/src/primitives/rewardFromBlockNumber.ts

@@ -1,19 +0,0 @@
-import {
-  asAttoXL1, XL1_REWARDS_BLOCKS_PER_STEP, XL1_REWARDS_CREATOR_REWARD,
-  XL1_REWARDS_MIN_BLOCK_REWARD, XL1_REWARDS_STARTING_REWARD, XL1_REWARDS_STEP_FACTOR_DENOMINATOR,
-  XL1_REWARDS_STEP_FACTOR_NUMERATOR, type XL1BlockNumber,
-} from '@xyo-network/xl1-protocol-lib'
-
-/** RewardFromBlockNumber helper function. */
-export function rewardFromBlockNumber(blockNumber: XL1BlockNumber) {
-  if (blockNumber === 0) {
-    return XL1_REWARDS_CREATOR_REWARD
-  }
-  const step = Math.floor((blockNumber + XL1_REWARDS_BLOCKS_PER_STEP) / XL1_REWARDS_BLOCKS_PER_STEP)
-  const stepExp = BigInt(step - 1)
-  const poweredNumerator = stepExp > 0 ? XL1_REWARDS_STEP_FACTOR_NUMERATOR ** stepExp : 1n
-  const poweredDenominator = stepExp > 0 ? XL1_REWARDS_STEP_FACTOR_DENOMINATOR ** stepExp : 1n
-  let reward = (XL1_REWARDS_STARTING_REWARD * poweredNumerator) / poweredDenominator
-  // eslint-disable-next-line unicorn/prefer-math-min-max
-  return asAttoXL1((reward < XL1_REWARDS_MIN_BLOCK_REWARD) ? XL1_REWARDS_MIN_BLOCK_REWARD : reward)
-}

package/src/primitives/rewards/index.ts

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

package/src/primitives/rewards/networkStakeStepRewardPositionWeight.ts

@@ -1,26 +0,0 @@
-import type {
-  BlockViewer, CachingContext, StakeEventsViewer, StepIdentity,
-} from '@xyo-network/xl1-protocol-lib'
-import { XYO_NETWORK_STAKING_ADDRESS } from '@xyo-network/xl1-protocol-lib'
-
-import { externalBlockRangeFromStep } from '../chain/index.ts'
-import { weightedStakeForRangeByPosition } from '../stake/index.ts'
-
-/** NetworkStakeStepRewardPositionWeight helper function. */
-export async function networkStakeStepRewardPositionWeight(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  stakeEventsViewer: StakeEventsViewer,
-  stepContext: StepIdentity,
-  position: number,
-): Promise<bigint> {
-  const result = await weightedStakeForRangeByPosition(
-    context,
-    blockViewer,
-    stakeEventsViewer,
-    await externalBlockRangeFromStep(context, blockViewer, stepContext),
-    XYO_NETWORK_STAKING_ADDRESS,
-    position,
-  )
-  return result
-}

package/src/primitives/stake/activeStakeAtTimeByAddress.ts

@@ -1,27 +0,0 @@
-import type { Address } from '@xylabs/sdk-js'
-import { isDefined } from '@xylabs/sdk-js'
-import type { StakeEventsViewer } from '@xyo-network/xl1-protocol-lib'
-
-import { mergedAddRemoveStakeEventsByStaker } from './mergedAddRemoveStakeEventsByStaker.ts'
-
-/** ActiveStakeAtTimeByAddress helper function. */
-export async function activeStakeAtTimeByAddress(
-  chain: StakeEventsViewer,
-  staked: Address,
-  time: number,
-  staker?: Address,
-): Promise<bigint> {
-  const stakeEvents = (await mergedAddRemoveStakeEventsByStaker(chain, [0, time], staked, staker)).toSorted((a, b) => a.time - b.time)
-  let result = 0n
-  for (const event of stakeEvents) {
-    if (event.time > time) break
-    if (event.args.staked !== staked) continue
-    if (isDefined(staker) && (event.args.staker !== staker)) continue
-    if (event.name === 'StakeAdded') {
-      result += event.args.amount
-    } else if (event.name === 'StakeRemoved') {
-      result -= event.args.amount
-    }
-  }
-  return result
-}

package/src/primitives/stake/activeStakeAtTimeByPosition.ts

@@ -1,25 +0,0 @@
-import { isUndefined } from '@xylabs/sdk-js'
-import type { StakeEventsViewer } from '@xyo-network/xl1-protocol-lib'
-
-import { mergedAddRemoveStakeEventsByPosition } from './mergedAddRemoveStakeEventsByPosition.ts'
-
-/** ActiveStakeAtTimeByPosition helper function. */
-export async function activeStakeAtTimeByPosition(
-  chainStakeEvents: StakeEventsViewer,
-  externalTime: number,
-  position?: number,
-): Promise<bigint> {
-  const stakeEvents = (await mergedAddRemoveStakeEventsByPosition(chainStakeEvents, [0, externalTime], position)).toSorted((a, b) => a.time - b.time)
-  let result = 0n
-  for (const event of stakeEvents) {
-    if (event.time > externalTime) break
-    if (isUndefined(position) || position === Number(event.args.id)) {
-      if (event.name === 'StakeAdded') {
-        result += event.args.amount
-      } else if (event.name === 'StakeRemoved') {
-        result -= event.args.amount
-      }
-    }
-  }
-  return result
-}

package/src/primitives/stake/allStakersForRange.ts

@@ -1,32 +0,0 @@
-import {
-  type Address,
-  toAddress,
-} from '@xylabs/sdk-js'
-import type { StakeEventsViewer } from '@xyo-network/xl1-protocol-lib'
-
-import { mergedAddRemoveStakeEventsByStaker } from './mergedAddRemoveStakeEventsByStaker.ts'
-
-/** AllStakersForRange helper function. */
-export async function allStakersForRange(
-  chain: StakeEventsViewer,
-  externalRange: [number, number],
-  staked: Address,
-): Promise<Record<Address, bigint>> {
-  const mergedEvents = await mergedAddRemoveStakeEventsByStaker(chain, [0, externalRange[1]], staked)
-  const resultWithZeros: Record<Address, bigint> = {}
-  for (const event of mergedEvents) {
-    const staker = toAddress(event.args.staker)
-    resultWithZeros[staker] = resultWithZeros[staker] ?? 0n
-    if (event.name === 'StakeAdded') {
-      resultWithZeros[staker] += event.args.amount
-    } else if (event.name === 'StakeRemoved') {
-      resultWithZeros[staker] -= event.args.amount
-    }
-  }
-  const nonZero = Object.entries(resultWithZeros).filter(([, amount]) => amount > 0n).map(([address]) => address)
-  const result: Record<Address, bigint> = {}
-  for (const address of nonZero) {
-    result[toAddress(address)] = resultWithZeros[toAddress(address)]
-  }
-  return result
-}

package/src/primitives/stake/allStakersForStep.ts

@@ -1,24 +0,0 @@
-import { type Address } from '@xylabs/sdk-js'
-import type {
-  BlockViewer, CachingContext, StakeEventsViewer, StepIdentity,
-} from '@xyo-network/xl1-protocol-lib'
-
-import { externalBlockRangeFromXL1BlockRange } from '../chain/index.ts'
-import { stepBlockRange } from '../step/index.ts'
-import { allStakersForRange } from './allStakersForRange.ts'
-
-/** AllStakersForStep helper function. */
-export async function allStakersForStep(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  stakeEventsViewer: StakeEventsViewer,
-  stepContext: StepIdentity,
-  staked: Address,
-): Promise<Record<Address, bigint>> {
-  const xl1BlockRange = stepBlockRange(stepContext)
-  return await allStakersForRange(
-    stakeEventsViewer,
-    await externalBlockRangeFromXL1BlockRange(context, blockViewer, xl1BlockRange),
-    staked,
-  )
-}

package/src/primitives/stake/index.ts

@@ -1,6 +0,0 @@
-export * from './activeStakeAtTimeByAddress.ts'
-export * from './activeStakeAtTimeByPosition.ts'
-export * from './allStakersForRange.ts'
-export * from './allStakersForStep.ts'
-export * from './mergedAddRemoveStakeEventsByPosition.ts'
-export * from './weightedStakeForRangeByPosition.ts'

package/src/primitives/stake/mergedAddRemoveStakeEventsByPosition.ts

@@ -1,15 +0,0 @@
-import type { StakeEvent, StakeEventsViewer } from '@xyo-network/xl1-protocol-lib'
-
-/** MergedAddRemoveStakeEventsByPosition helper function. */
-export async function mergedAddRemoveStakeEventsByPosition(
-  chainEvents: StakeEventsViewer,
-  range: [number, number],
-  position?: number,
-): Promise<(StakeEvent<'StakeAdded'> | StakeEvent<'StakeRemoved'>)[]> {
-  const [addedEvents, removedEvents] = await Promise.all([
-    chainEvents.stakeEvents(range, { name: 'StakeAdded', args: { id: position } }),
-    chainEvents.stakeEvents(range, { name: 'StakeRemoved', args: { id: position } }),
-  ])
-  const result = [...addedEvents, ...removedEvents].toSorted((a, b) => a.time - b.time)
-  return result
-}

package/src/primitives/stake/mergedAddRemoveStakeEventsByStaker.ts

@@ -1,17 +0,0 @@
-import type { Address } from '@xylabs/sdk-js'
-import type { StakeEvent, StakeEventsViewer } from '@xyo-network/xl1-protocol-lib'
-
-/** MergedAddRemoveStakeEventsByStaker helper function. */
-export async function mergedAddRemoveStakeEventsByStaker(
-  chainEvents: StakeEventsViewer,
-  range: [number, number],
-  staked: Address,
-  staker?: Address,
-): Promise<(StakeEvent<'StakeAdded'> | StakeEvent<'StakeRemoved'>)[]> {
-  const [addedEvents, removedEvents] = await Promise.all([
-    chainEvents.stakeEvents(range, { name: 'StakeAdded', args: { staked, staker } }),
-    chainEvents.stakeEvents(range, { name: 'StakeRemoved', args: { staked, staker } }),
-  ])
-  const result = [...addedEvents, ...removedEvents].toSorted((a, b) => a.time - b.time)
-  return result
-}

package/src/primitives/stake/weightedStakeForRangeByPosition.ts

@@ -1,69 +0,0 @@
-import type { Address } from '@xylabs/sdk-js'
-import { isDefined } from '@xylabs/sdk-js'
-import type {
-  BlockRange,
-  BlockViewer,
-  CachingContext,
-  StakeEventsViewer,
-} from '@xyo-network/xl1-protocol-lib'
-import { asBlockNumber } from '@xyo-network/xl1-protocol-lib'
-
-import { withContextCacheResponse } from '../../ChainContextHelpers.ts'
-import { mergedAddRemoveStakeEventsByPosition } from './mergedAddRemoveStakeEventsByPosition.ts'
-
-/** WeightedStakeForRangeByPosition helper function. */
-export async function weightedStakeForRangeByPosition(
-  context: CachingContext,
-  blockViewer: BlockViewer,
-  stakeEventsViewer: StakeEventsViewer,
-  externalRange: BlockRange, // first to last block of step
-  staked?: Address,
-  positionId?: number,
-): Promise<bigint> {
-  const cacheKey = isDefined(positionId) ? `${externalRange[0]}-${externalRange[1]}-${positionId}` : `${externalRange[0]}-${externalRange[1]}-all`
-  return await withContextCacheResponse(context, 'weightedStakeForRangeByPosition', cacheKey, async () => {
-    let weightedStakeSum = 0n
-    if (isDefined(positionId)) {
-      const mergedEvents = (await mergedAddRemoveStakeEventsByPosition(
-        stakeEventsViewer,
-        [0, externalRange[1]],
-        positionId,
-      )).toSorted((a, b) => a.time - b.time)
-      let currentTime = externalRange[0]
-      let currentStake = 0n // await activeStakeAtTimeByPosition(chainEvents, pos.staked, currentTime - 1, position)
-
-      // if not staking the desired address, return 0n
-      if (isDefined(staked) && mergedEvents.at(0)?.args.staked !== staked) {
-        return 0n
-      }
-
-      for (const event of mergedEvents) {
-        if (event.time > currentTime) {
-          // Add the weighted stake for the period between the range start or previous event and this event
-          weightedStakeSum += currentStake * BigInt(event.time - currentTime)
-        }
-        if (event.name === 'StakeAdded') {
-          currentStake += event.args.amount
-        } else if (event.name === 'StakeRemoved') {
-          currentStake -= event.args.amount
-        }
-        // seems that sometimes we get multiple remove events, so ensure stake doesn't go negative
-        currentStake = currentStake < 0n ? 0n : currentStake
-        currentTime = asBlockNumber(event.time, { name: 'weightedStakeForRangeByPosition' })
-        if (currentTime > externalRange[1]) {
-          break
-        }
-      }
-      if (externalRange[1] > currentTime) {
-        // Add the weighted stake for the period between the last event and the end of the range
-        weightedStakeSum += currentStake * BigInt(externalRange[1] - currentTime)
-      }
-    } else {
-      const positionCount = await stakeEventsViewer.positionCount([0, externalRange[1]])
-      for (let pos = 0; pos < positionCount; pos++) {
-        weightedStakeSum += await weightedStakeForRangeByPosition(context, blockViewer, stakeEventsViewer, externalRange, staked, pos)
-      }
-    }
-    return weightedStakeSum
-  })
-}

package/src/primitives/state/findMostRecentBlock.ts

@@ -1,44 +0,0 @@
-import type {
-  NextOptions, Payload, ReadArchivist,
-  Sequence, WithStorageMeta,
-} from '@xyo-network/sdk-js'
-import type { SignedBlockBoundWitnessWithHashMeta } from '@xyo-network/xl1-protocol-lib'
-import { isSignedBlockBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol-lib'
-
-// TODO: Use some smart value relative to DEFAULT_BLOCK_SIZE
-// to ensure we're likely to find it in a single request
-// without bringing back too much data
-const DEFAULT_NEXT_OPTIONS: NextOptions = { limit: 50 }
-
-/**
- * Iterates an archivist to find the most recent block
- * @param chainArchivist The archivist to iterate over for the most recent chain block
- * @param nextOptions The options to use when iterating the archivist
- * @param maxIterations The max number of iterations to perform when finding the most recent block
- * @returns The most recent block found in the archivist or undefined if no blocks are found
- */
-export const findMostRecentBlock = async (
-  chainArchivist: ReadArchivist,
-  nextOptions: NextOptions = DEFAULT_NEXT_OPTIONS,
-  maxIterations = Number.POSITIVE_INFINITY,
-): Promise<SignedBlockBoundWitnessWithHashMeta | undefined> => {
-  let mostRecentBlock: SignedBlockBoundWitnessWithHashMeta | undefined
-  let cursor: Sequence | undefined
-  let batch: WithStorageMeta<Payload>[]
-  let iterations = 0
-  do {
-    batch = await chainArchivist.next({
-      ...nextOptions, order: 'desc', cursor,
-    })
-    const blocks = batch.filter(isSignedBlockBoundWitnessWithStorageMeta)
-    const last = blocks?.at(0)
-    if (last) {
-      mostRecentBlock = last
-      break
-    } else {
-      cursor = batch.at(-1)?._sequence
-    }
-    iterations = iterations + 1
-  } while (batch.length > 0 && iterations < maxIterations)
-  return mostRecentBlock
-}

package/src/primitives/state/hydratedBlockByNumber.ts

@@ -1,25 +0,0 @@
-import { assertEx, spanAsync } from '@xylabs/sdk-js'
-import type {
-  ChainContextRead,
-  HydratedBlockWithHashMeta, XL1BlockNumber,
-} from '@xyo-network/xl1-protocol-lib'
-
-import { blockFromBlockNumber, hydrateBlock } from '../../block/index.ts'
-import { withContextCacheResponse } from '../../ChainContextHelpers.ts'
-
-/** HydratedBlockByNumber helper function. */
-export async function hydratedBlockByNumber(context: ChainContextRead, blockNumber: XL1BlockNumber): Promise<HydratedBlockWithHashMeta | null> {
-  return await spanAsync('hydratedBlockByNumber', async () => {
-    if (blockNumber < 0) throw new Error(`Block number ${blockNumber} is less than 0`)
-    if (blockNumber > Number.MAX_SAFE_INTEGER) throw new Error(`Block number ${blockNumber} is greater than the maximum safe integer`)
-    if (blockNumber % 1 !== 0) throw new Error(`Block number ${blockNumber} is not an integer`)
-    const cacheKey = `${blockNumber}`
-    return await withContextCacheResponse(context, 'hydratedBlockByNumber', cacheKey, async () => {
-      const block = assertEx(
-        await blockFromBlockNumber(context, blockNumber),
-        () => `Could not find block for block number ${blockNumber}`,
-      )
-      return await hydrateBlock(context, block._hash)
-    }, { max: 20_000 })
-  }, { ...context, timeBudgetLimit: 500 })
-}

package/src/primitives/state/index.ts

@@ -1,2 +0,0 @@
-export * from './findMostRecentBlock.ts'
-export * from './hydratedBlockByNumber.ts'

package/src/primitives/step/completedStepRewardAddress.ts

@@ -1,10 +0,0 @@
-import { type Address, toAddress } from '@xylabs/sdk-js'
-import { type StepIdentity, StepSizes } from '@xyo-network/xl1-protocol-lib'
-import { keccak256 } from 'ethers'
-
-/** CompletedStepRewardAddress helper function. */
-export function completedStepRewardAddress({ block, step }: StepIdentity): Address {
-  const resolvedStepSize = step < StepSizes.length ? StepSizes[step] : step
-  const addressKey = new TextEncoder().encode(`${block}|${resolvedStepSize}`)
-  return toAddress(keccak256(addressKey).slice(-40), { prefix: false })
-}

package/src/primitives/step/derivedReceiveAddress.ts

@@ -1,9 +0,0 @@
-import { type Address, toAddress } from '@xylabs/sdk-js'
-import { isDefined } from '@xylabs/sdk-js'
-import { keccak256 } from 'ethers'
-
-/** DerivedReceiveAddress helper function. */
-export function derivedReceiveAddress(address: Address, scope?: string): Address {
-  const addressKey = new TextEncoder().encode(isDefined(scope) ? `${scope}|${address}` : address)
-  return toAddress(keccak256(addressKey).slice(-40), { prefix: false })
-}

package/src/primitives/step/index.ts

@@ -1,4 +0,0 @@
-export * from './completedStepRewardAddress.ts'
-export * from './derivedReceiveAddress.ts'
-export * from './stepBlockRange.ts'
-export * from './stepTransferIndex.ts'

package/src/primitives/step/stepBlockRange.ts

@@ -1,9 +0,0 @@
-import type { StepIdentity, XL1BlockRange } from '@xyo-network/xl1-protocol-lib'
-import { asXL1BlockRange, StepSizes } from '@xyo-network/xl1-protocol-lib'
-
-/** StepBlockRange helper function. */
-export function stepBlockRange({ block, step }: StepIdentity): XL1BlockRange {
-  const stepSize = StepSizes[step]
-  const start = block - stepSize
-  return asXL1BlockRange([start, start + stepSize - 1], { name: 'stepBlockRange' })
-}