@xyo-network/xl1-protocol-sdk 1.16.26 → 1.17.1

package/src/simple/chain/SimpleChainViewer.ts

@@ -0,0 +1,25 @@
+import {
+  type Address, asHex, Promisable,
+} from '@xylabs/sdk-js'
+import {
+  AbstractCreatable,
+  creatable, CreatableParams,
+} from '@xylabs/sdk-js'
+import { ChainId } from '@xyo-network/xl1-protocol'
+
+import { ChainViewer } from '../../viewers/index.ts'
+
+export interface SimpleChainParams extends CreatableParams {
+  chainId: Address
+}
+
+@creatable()
+export class SimpleChainViewer extends AbstractCreatable<SimpleChainParams> implements ChainViewer {
+  static override async paramsHandler(params?: Partial<SimpleChainParams>) {
+    return ({ ...await super.paramsHandler(params), chainId: asHex(params?.chainId, () => 'chainId not set') }) as SimpleChainParams
+  }
+
+  chainId(): Promisable<ChainId> {
+    return this.params.chainId
+  }
+}

package/src/simple/chain/index.ts

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

package/src/simple/gateway/SimpleXyoGatewayRunner.ts

@@ -43,7 +43,7 @@ export class SimpleXyoGatewayRunner implements XyoGatewayRunner {
   }
 
   get dataLakes(): DataLakeRunner[] {
-    throw new Error('Method not implemented.')
+    throw new Error('Method [dataLakes] not implemented.')
   }
 
   get signerInstance(): XyoSigner {

package/src/simple/index.ts

@@ -1,8 +1,11 @@
 export * from './accountBalance/index.ts'
+export * from './block/index.ts'
+export * from './blockReward/index.ts'
 export * from './chainStake/index.ts'
 export * from './client/index.ts'
 export * from './datalake/index.ts'
 export * from './gateway/index.ts'
+export * from './mempool/index.ts'
 export * from './network/index.ts'
 export * from './permissions/index.ts'
 export * from './runner/index.ts'

package/src/simple/mempool/SimpleMempoolRunner.ts

@@ -0,0 +1,47 @@
+import {
+  AbstractCreatable, creatable, CreatableParams, type Hash,
+} from '@xylabs/sdk-js'
+import type { ArchivistInstance } from '@xyo-network/archivist-model'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { type SignedHydratedBlock, type SignedHydratedTransaction } from '@xyo-network/xl1-protocol'
+
+import { hydratedBlockToPayloadBundle, hydratedTransactionToPayloadBundle } from '../../model/index.ts'
+import type { MempoolRunner } from '../../runners/index.ts'
+
+export interface SimpleMempoolRunnerParams extends CreatableParams {
+  pendingBlocksArchivist: ArchivistInstance
+  pendingTransactionsArchivist: ArchivistInstance
+}
+
+@creatable()
+export class SimpleMempoolRunner extends AbstractCreatable<SimpleMempoolRunnerParams> implements MempoolRunner {
+  protected get pendingBlocksArchivist() {
+    return this.params.pendingBlocksArchivist
+  }
+
+  protected get pendingTransactionsArchivist() {
+    return this.params.pendingTransactionsArchivist
+  }
+
+  async submitBlocks(blocks: SignedHydratedBlock[]): Promise<Hash[]> {
+    const bundles = await Promise.all(blocks.map(async ([bw, payloads]) => {
+      return hydratedBlockToPayloadBundle([
+        await PayloadBuilder.addHashMeta(bw),
+        await PayloadBuilder.addHashMeta(payloads),
+      ])
+    }))
+    const inserted = await this.pendingBlocksArchivist.insert(bundles)
+    return inserted.map(p => p._hash)
+  }
+
+  async submitTransactions(transactions: SignedHydratedTransaction[]): Promise<Hash[]> {
+    const bundles = await Promise.all(transactions.map(async ([tx, payloads]) => {
+      return hydratedTransactionToPayloadBundle([
+        await PayloadBuilder.addHashMeta(tx),
+        await PayloadBuilder.addHashMeta(payloads),
+      ])
+    }))
+    const inserted = await this.pendingBlocksArchivist.insert(bundles)
+    return inserted.map(p => p._hash)
+  }
+}

package/src/simple/mempool/SimpleMempoolViewer.ts

@@ -1,34 +1,60 @@
 import {
+  AbstractCreatable,
+  creatable,
+  CreatableParams,
   exists, isDefined, isHash,
 } from '@xylabs/sdk-js'
 import type { ArchivistInstance } from '@xyo-network/archivist-model'
 import {
   isHashMeta, isPayloadBundle, type Sequence,
 } from '@xyo-network/payload-model'
-import type { SignedHydratedTransactionWithHashMeta } from '@xyo-network/xl1-protocol'
+import type { SignedHydratedBlockWithHashMeta, SignedHydratedTransactionWithHashMeta } from '@xyo-network/xl1-protocol'
 
-import { bundledPayloadToHydratedTransaction } from '../../model/index.ts'
+import { bundledPayloadToHydratedBlock, bundledPayloadToHydratedTransaction } from '../../model/index.ts'
 import type {
   MempoolViewer,
   PendingTransactionsOptions,
 } from '../../viewers/index.ts'
 
-export class SimpleMempoolViewer implements MempoolViewer {
-  protected readonly archivist: ArchivistInstance
+export interface SimpleMempoolViewerParams extends CreatableParams {
+  pendingBlocksArchivist: ArchivistInstance
+  pendingTransactionsArchivist: ArchivistInstance
+}
+
+@creatable()
+export class SimpleMempoolViewer extends AbstractCreatable<SimpleMempoolViewerParams> implements MempoolViewer {
+  protected get pendingBlocksArchivist() {
+    return this.params.pendingBlocksArchivist
+  }
 
-  constructor(archivist: ArchivistInstance) {
-    this.archivist = archivist
+  protected get pendingTransactionsArchivist() {
+    return this.params.pendingTransactionsArchivist
+  }
+
+  async pendingBlocks({ cursor: providedCursor }: PendingTransactionsOptions = {}): Promise<SignedHydratedBlockWithHashMeta[]> {
+    let cursor: Sequence | undefined = undefined
+    if (isHash(providedCursor)) {
+      const [p] = await this.pendingBlocksArchivist.get([providedCursor])
+      if (isDefined(p)) {
+        cursor = p._sequence
+      }
+    }
+    const bundles = await this.pendingBlocksArchivist.next({
+      order: 'asc', limit: 100, cursor,
+    })
+    const filteredBundles = bundles.filter(isPayloadBundle).filter(isHashMeta)
+    return (await Promise.all(filteredBundles.map(async bundle => await bundledPayloadToHydratedBlock(bundle)))).filter(exists)
   }
 
   async pendingTransactions({ cursor: providedCursor }: PendingTransactionsOptions = {}): Promise<SignedHydratedTransactionWithHashMeta[]> {
     let cursor: Sequence | undefined = undefined
     if (isHash(providedCursor)) {
-      const [p] = await this.archivist.get([providedCursor])
+      const [p] = await this.pendingTransactionsArchivist.get([providedCursor])
       if (isDefined(p)) {
         cursor = p._sequence
       }
     }
-    const bundles = await this.archivist.next({
+    const bundles = await this.pendingTransactionsArchivist.next({
       order: 'asc', limit: 100, cursor,
     })
     const filteredBundles = bundles.filter(isPayloadBundle).filter(isHashMeta)

package/src/simple/mempool/index.ts

@@ -1 +1,2 @@
+export * from './SimpleMempoolRunner.ts'
 export * from './SimpleMempoolViewer.ts'

package/src/simple/timesync/SimpleTimeSyncViewer.ts

@@ -88,6 +88,6 @@ export class SimpleTimeSyncViewer implements TimeSyncViewer {
   }
 
   currentTimePayload(): Promisable<TimePayload> {
-    throw new Error('Method not implemented.')
+    throw new Error('Method [currentTimePayload] not implemented.')
   }
 }

package/src/summary/index.ts

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

package/src/{payloads/summary → summary/model}/index.ts

@@ -1,4 +1,5 @@
 export * from './BalancesStepSummary.ts'
 export * from './SchemasStepSummary.ts'
 export * from './StepSummary.ts'
+export * from './summary.ts'
 export * from './TransfersSummary.ts'

package/src/{model → summary/model}/summary.ts

@@ -1,10 +1,11 @@
 import type { Payload } from '@xyo-network/payload-model'
 import type { Semaphore } from 'async-mutex'
 
-import type { MapTypeRead, MapTypeWrite } from '../map/index.ts'
-import type { SchemasStepSummary } from '../payloads/index.ts'
-import type { BalancesStepSummary, TransfersStepSummary } from '../payloads/summary/index.ts'
-import type { BaseContext, ChainContextRead } from './index.ts'
+import type { MapTypeRead, MapTypeWrite } from '../../map/index.ts'
+import type { BaseContext, ChainContextRead } from '../../model/index.ts'
+import type {
+  BalancesStepSummary, SchemasStepSummary, TransfersStepSummary,
+} from './index.ts'
 
 export interface ChainSummaryContextBase<TPayload extends Payload,
   T extends (MapTypeRead<string, TPayload> | MapTypeWrite<string, TPayload>)> extends BaseContext {

package/src/{primitives/summary → summary/primitives}/balances/balancesStepSummaryFromRange.ts

@@ -11,12 +11,13 @@ import {
   deepCalculateFramesFromRange, hashFromBlockNumber,
   hydrateBlock,
 } from '../../../block/index.ts'
-import type { BalanceStepSummaryContext } from '../../../model/index.ts'
-import type { BalancesStepSummary } from '../../../payloads/index.ts'
-import { BalancesStepSummarySchema, netBalancesForPayloads } from '../../../payloads/index.ts'
+import { netBalancesForPayloads } from '../../../payloads/index.ts'
 import {
   parseSignedBigInt, type SignedBigInt, toSignedBigInt,
 } from '../../../SignedBigInt.ts'
+import {
+  type BalancesStepSummary, BalancesStepSummarySchema, type BalanceStepSummaryContext,
+} from '../../model/index.ts'
 
 export async function balancesStepSummaryFromRange(
   context: BalanceStepSummaryContext,

package/src/{primitives/summary → summary/primitives}/balances/balancesSummary.ts

@@ -6,30 +6,31 @@ import {
 } from '@xyo-network/xl1-protocol'
 
 import { deepCalculateFramesFromRange } from '../../../block/index.ts'
-import type { BalanceStepSummaryContext } from '../../../model/index.ts'
+import type { Qualified } from '../../../model/index.ts'
 import { parseSignedBigInt } from '../../../SignedBigInt.ts'
+import type { BalanceStepSummaryContext } from '../../model/index.ts'
 import { balancesStepSummaryFromRange } from './balancesStepSummaryFromRange.ts'
 
 export async function balancesSummary(
   context: BalanceStepSummaryContext,
-): Promise<Partial<Record<Address, bigint>>> {
+): Promise<Qualified<Record<Address, bigint>>> {
   return await spanRootAsync('balancesSummary', async () => {
     const [headHash] = await context.head()
     const headResult = await context.store.chainMap.get(headHash)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `Head block not found for hash: ${headHash}`)
-    const rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0)
+    const rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0, true)
     const ranges = deepCalculateFramesFromRange(asXL1BlockRange(
       [rangeStart, headBoundWitness.block],
       { name: 'balancesSummary' },
     ))
     const summaries = await Promise.all(ranges.map(range => balancesStepSummaryFromRange(context, range)))
-    const balances: Partial<Record<Address, bigint>> = {}
+    const balances: Record<Address, bigint> = {}
     for (let summary of summaries) {
       for (const [address, balance] of Object.entries(summary.balances)) {
         const validAddress = asAddress(address, () => `Invalid address: ${address}`)
         balances[validAddress] = (balances[validAddress] ?? 0n) + parseSignedBigInt(balance)
       }
     }
-    return balances
+    return [balances, [rangeStart, headBoundWitness.block], headHash]
   })
 }

package/src/{primitives/summary → summary/primitives}/schemas/schemasStepSummaryFromRange.ts

@@ -12,9 +12,9 @@ import {
   deepCalculateFramesFromRange, hashFromBlockNumber,
   hydrateBlock,
 } from '../../../block/index.ts'
-import type { SchemasStepSummaryContext } from '../../../model/index.ts'
-import type { SchemasStepSummary } from '../../../payloads/index.ts'
-import { SchemasStepSummarySchema } from '../../../payloads/index.ts'
+import {
+  type SchemasStepSummary, type SchemasStepSummaryContext, SchemasStepSummarySchema,
+} from '../../model/index.ts'
 
 export async function schemasStepSummaryFromRange(
   context: SchemasStepSummaryContext,

package/src/{primitives/summary → summary/primitives}/schemas/schemasSummary.ts

@@ -6,28 +6,29 @@ import {
 } from '@xyo-network/xl1-protocol'
 
 import { deepCalculateFramesFromRange } from '../../../block/index.ts'
-import type { SchemasStepSummaryContext } from '../../../model/index.ts'
+import type { Qualified } from '../../../model/index.ts'
+import type { SchemasStepSummaryContext } from '../../model/index.ts'
 import { schemasStepSummaryFromRange } from './schemasStepSummaryFromRange.ts'
 
 export async function schemasSummary(
   context: SchemasStepSummaryContext,
-): Promise<Partial<Record<Schema, number>>> {
+): Promise<Qualified<Record<Schema, number>>> {
   return await spanRootAsync('schemasSummary', async () => {
     const [headHash] = await context.head()
     const headResult = await context.store.chainMap.get(headHash)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `Head block not found for hash: ${headHash}`)
-    const rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0)
+    const rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0, true)
     const ranges = deepCalculateFramesFromRange(asXL1BlockRange(
       [rangeStart, headBoundWitness.block],
       { name: 'schemasSummary' },
     ))
     const summaries = await Promise.all(ranges.map(range => schemasStepSummaryFromRange(context, range)))
-    const schemas: Partial<Record<Schema, number>> = {}
+    const results: Record<Schema, number> = {}
     for (let summary of summaries) {
       for (const [schema, count] of Object.entries(summary.schemas)) {
-        schemas[schema] = (schemas[schema] ?? 0) + count
+        results[schema] = (results[schema] ?? 0) + count
       }
     }
-    return schemas
+    return [results, [rangeStart, headBoundWitness.block], headHash]
   })
 }

package/src/{primitives/summary → summary/primitives}/transfers/transfersStepSummaryFromRange.ts

@@ -10,12 +10,13 @@ import { StepSizes } from '@xyo-network/xl1-protocol'
 import {
   deepCalculateFramesFromRange, hashFromBlockNumber, hydrateBlock,
 } from '../../../block/index.ts'
-import type { TransfersStepSummaryContext } from '../../../model/index.ts'
-import type { TransfersStepSummary } from '../../../payloads/index.ts'
-import { netTransfersForPayloads, TransfersStepSummarySchema } from '../../../payloads/index.ts'
+import { netTransfersForPayloads } from '../../../payloads/index.ts'
 import {
   parseSignedBigInt, type SignedBigInt, toSignedBigInt,
 } from '../../../SignedBigInt.ts'
+import {
+  type TransfersStepSummary, type TransfersStepSummaryContext, TransfersStepSummarySchema,
+} from '../../model/index.ts'
 import { transfersSummaryKey } from './transfersSummary.ts'
 
 export async function transfersStepSummaryFromRange(

package/src/{primitives/summary → summary/primitives}/transfers/transfersSummary.ts

@@ -6,25 +6,26 @@ import {
 } from '@xyo-network/xl1-protocol'
 
 import { deepCalculateFramesFromRange } from '../../../block/index.ts'
-import type { TransfersStepSummaryContext } from '../../../model/index.ts'
+import type { Qualified } from '../../../model/index.ts'
 import { parseSignedBigInt } from '../../../SignedBigInt.ts'
+import type { TransfersStepSummaryContext } from '../../index.ts'
 import { transfersStepSummaryFromRange } from './transfersStepSummaryFromRange.ts'
 
 // the summary of amount of rewards claimed from the step reward pool by addresses
 export async function transfersSummary(
   transferContext: TransfersStepSummaryContext,
-): Promise<Partial<Record<Address, Partial<Record<Address, bigint>>>>> {
+): Promise<Qualified<Record<Address, Record<Address, bigint>>>> {
   return await spanRootAsync('transferSummary', async () => {
     const [headHash] = await transferContext.head()
     const headResult = await transferContext.store.chainMap.get(headHash)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `Head block not found for hash: ${transferContext.head}`)
-    const rangeStart = asXL1BlockNumber(isDefined(transferContext.windowSize) ? Math.max(headBoundWitness.block - transferContext.windowSize + 1, 0) : 0)
+    const rangeStart = asXL1BlockNumber(isDefined(transferContext.windowSize) ? Math.max(headBoundWitness.block - transferContext.windowSize + 1, 0) : 0, true)
     const ranges = deepCalculateFramesFromRange(asXL1BlockRange(
       [rangeStart, headBoundWitness.block],
       { name: 'transfersSummary' },
     ))
     const summaries = await Promise.all(ranges.map(range => transfersStepSummaryFromRange(transferContext, range)))
-    const transfers: Partial<Record<Address, Partial<Record<Address, bigint>>>> = {}
+    const transfers: Record<Address, Record<Address, bigint>> = {}
     for (let summary of summaries) {
       for (const [from, toMap] of Object.entries(summary.transfers)) {
         const validFrom = asAddress(from, () => `Invalid address: ${from}`)
@@ -35,7 +36,7 @@ export async function transfersSummary(
         }
       }
     }
-    return transfers
+    return [transfers, [rangeStart, headBoundWitness.block], headHash]
   })
 }
 

package/src/utils/HydratedCache.ts

@@ -0,0 +1,38 @@
+import type { Hash } from '@xylabs/sdk-js'
+import type { Payload, WithStorageMeta } from '@xyo-network/payload-model'
+import { LRUCache } from 'lru-cache'
+
+import type { PayloadMapRead } from '../model/index.ts'
+
+export type HydrateFunction<T> = (
+  context: { chainMap: PayloadMapRead<WithStorageMeta<Payload>> },
+  hash: Hash,
+) => Promise<T | undefined>
+
+export class HydratedCache<T extends {}> {
+  protected readonly cache: LRUCache<Hash, T>
+  protected readonly chainMap: PayloadMapRead<WithStorageMeta<Payload>>
+  protected readonly hydrateFunction: HydrateFunction<T>
+
+  constructor(
+    chainMap: PayloadMapRead<WithStorageMeta<Payload>>,
+    hydrateFunction: HydrateFunction<T>,
+    maxSize: number = 200,
+  ) {
+    this.chainMap = chainMap
+    this.hydrateFunction = hydrateFunction
+    this.cache = new LRUCache<Hash, T>({ max: maxSize })
+  }
+
+  async get(hash: Hash): Promise<T | null> {
+    const existing = this.cache.get(hash)
+    if (existing !== undefined) return existing
+    const block = (await this.hydrateFunction({ chainMap: this.chainMap }, hash)) ?? null
+    if (block !== null) this.cache.set(hash, block)
+    return block
+  }
+
+  has(hash: Hash): boolean {
+    return this.cache.has(hash)
+  }
+}

package/src/utils/index.ts

@@ -1 +1,2 @@
+export * from './HydratedCache.ts'
 export * from './isZodError.ts'

package/src/viewers/AccountBalance.ts

@@ -10,6 +10,8 @@ import {
 import { BlockBoundWitnessZod, TransactionBoundWitnessZod } from '@xyo-network/xl1-protocol'
 import z from 'zod'
 
+import type { Qualified } from '../model/index.ts'
+
 export const AccountBalanceHistoryItemZod = z.tuple([
   WithHashMetaZod(BlockBoundWitnessZod),
   WithHashMetaZod(TransactionBoundWitnessZod).nullable(),
@@ -19,11 +21,16 @@ export const AccountBalanceHistoryItemZod = z.tuple([
 export type AccountBalanceHistoryItem = z.infer<typeof AccountBalanceHistoryItemZod>
 
 export interface AccountBalanceViewerMethods {
-  accountsBalances(address: Address[], headOrRange?: Hash | XL1BlockRange): Promisable<Partial<Record<Address, AttoXL1>>>
-  accountsBalancesHistory(address: Address[], headOrRange?: Hash | XL1BlockRange): Promisable<Partial<Record<Address, AccountBalanceHistoryItem[]>>>
+  qualifiedAccountBalanceHistories(
+    address: Address[],
+    headOrRange?: Hash | XL1BlockRange
+  ): Promisable<Qualified<Record<Address, AccountBalanceHistoryItem[]>>>
+  qualifiedAccountBalances(address: Address[], headOrRange?: Hash | XL1BlockRange): Promisable<Qualified<Record<Address, AttoXL1>>>
 }
 
 export interface AccountBalanceViewer extends AccountBalanceViewerMethods {
   accountBalance(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<AttoXL1>
+  accountBalanceHistories(address: Address[], headOrRange?: Hash | XL1BlockRange): Promisable<Record<Address, AccountBalanceHistoryItem[]>>
   accountBalanceHistory(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<AccountBalanceHistoryItem[]>
+  accountBalances(address: Address[], headOrRange?: Hash | XL1BlockRange): Promisable<Record<Address, AttoXL1>>
 }

package/src/viewers/Block.ts

@@ -1,14 +1,18 @@
 import type { Hash, Promisable } from '@xylabs/sdk-js'
+import type { Payload, WithHashMeta } from '@xyo-network/payload-model'
 import type { SignedHydratedBlockWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol'
 
-export interface BlockViewierMethods {
-  blockByHash(hash: Hash): Promisable<SignedHydratedBlockWithHashMeta | null>
-  blockByNumber(block: XL1BlockNumber): Promisable<SignedHydratedBlockWithHashMeta | null>
+export interface BlockViewerMethods {
   blocksByHash(hash: Hash, limit?: number): Promisable<SignedHydratedBlockWithHashMeta[]>
-
+  blocksByNumber(block: XL1BlockNumber, limit?: number): Promisable<SignedHydratedBlockWithHashMeta[]>
   currentBlock(): Promisable<SignedHydratedBlockWithHashMeta>
+  payloadsByHash(hashes: Hash[]): Promisable<WithHashMeta<Payload>[]>
+}
+
+export interface BlockViewer extends BlockViewerMethods {
+  blockByHash(hash: Hash): Promisable<SignedHydratedBlockWithHashMeta | null>
+  blockByNumber(block: XL1BlockNumber): Promisable<SignedHydratedBlockWithHashMeta | null>
   currentBlockHash(): Promisable<Hash>
   currentBlockNumber(): Promisable<XL1BlockNumber>
+  payloadByHash(hash: Hash): Promisable<WithHashMeta<Payload> | null>
 }
-
-export interface BlockViewer extends BlockViewierMethods {}

package/src/viewers/BlockReward.ts

@@ -0,0 +1,9 @@
+import type { Promisable } from '@xylabs/sdk-js'
+import type { AttoXL1, XL1BlockNumber } from '@xyo-network/xl1-protocol'
+
+export interface BlockRewardViewerMethods {
+  // The amount of xl1 to send to the producer from the block reward
+  allowedRewardForBlock(block: XL1BlockNumber): Promisable<AttoXL1>
+}
+
+export interface BlockRewardViewer extends BlockRewardViewerMethods {}

package/src/viewers/Chain.ts

@@ -4,3 +4,5 @@ import type { ChainId } from '@xyo-network/xl1-protocol'
 export interface ChainViewerMethods {
   chainId(): Promisable<ChainId>
 }
+
+export interface ChainViewer extends ChainViewerMethods {}

package/src/viewers/ChainStakeViewer.ts

@@ -0,0 +1,7 @@
+import type { ChainViewer } from './Chain.ts'
+import type { ChainContractViewer } from './ChainContract.ts'
+import type { StakeTotalsViewer } from './StakeTotals.ts'
+
+export interface ChainStakeViewer extends ChainContractViewer, StakeTotalsViewer, ChainViewer {
+
+}

package/src/viewers/Mempool.ts

@@ -1,5 +1,5 @@
 import { HashZod } from '@xylabs/sdk-js'
-import type { SignedHydratedTransactionWithHashMeta } from '@xyo-network/xl1-protocol'
+import type { SignedHydratedBlockWithHashMeta, SignedHydratedTransactionWithHashMeta } from '@xyo-network/xl1-protocol'
 import { XL1BlockRangeZod } from '@xyo-network/xl1-protocol'
 import z from 'zod'
 
@@ -11,7 +11,16 @@ export const PendingTransactionsOptionsZod = z.object({
 
 export type PendingTransactionsOptions = z.infer<typeof PendingTransactionsOptionsZod>
 
+export const PendingBlocksOptionsZod = z.object({
+  cursor: HashZod.optional(),
+  limit: z.number().int().positive().optional(),
+  window: XL1BlockRangeZod.optional(),
+})
+
+export type PendingBlocksOptions = z.infer<typeof PendingBlocksOptionsZod>
+
 export interface MempoolViewerMethods {
+  pendingBlocks(options?: PendingBlocksOptions): Promise<SignedHydratedBlockWithHashMeta[]>
   pendingTransactions(options?: PendingTransactionsOptions): Promise<SignedHydratedTransactionWithHashMeta[]>
 }
 

package/src/viewers/StakeIntent.ts

@@ -0,0 +1,14 @@
+import type {
+  Address, Hash, Promisable,
+} from '@xylabs/sdk-js'
+import type { ChainStakeIntent, XL1BlockRange } from '@xyo-network/xl1-protocol'
+
+import type { Qualified } from '../model/index.ts'
+
+export interface StakeIntentViewerMethods {
+  qualifiedIntentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<Qualified<ChainStakeIntent | null>>
+}
+
+export interface StakeIntentViewer extends StakeIntentViewerMethods {
+  intentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<ChainStakeIntent | null>
+}

package/src/{provider/viewer → viewers}/StepViewer.ts

@@ -1,8 +1,8 @@
 import type { Address, Promisable } from '@xylabs/sdk-js'
 import type { PositionId, StepIdentity } from '@xyo-network/xl1-protocol'
 
-import type { Position } from '../../model/index.ts'
-import type { NetworkStakeStepRewardsViewer } from './NetworkStake/index.ts'
+import type { Position } from '../model/index.ts'
+import type { NetworkStakeStepRewardsViewer } from '../provider/index.ts'
 
 export interface PagedPositionsOptions {
   cursor?: PositionId

package/src/viewers/index.ts

@@ -1,7 +1,9 @@
 export * from './AccountBalance.ts'
 export * from './Block.ts'
+export * from './BlockReward.ts'
 export * from './Chain.ts'
 export * from './ChainContract.ts'
+export * from './ChainStakeViewer.ts'
 export * from './Fork.ts'
 export * from './Mempool.ts'
 export * from './NetworkStakeStepReward.ts'
@@ -9,6 +11,7 @@ export * from './Stake.ts'
 export * from './StakeEvents.ts'
 export * from './StakeTotals.ts'
 export * from './StepStake.ts'
+export * from './StepViewer.ts'
 export * from './TimeSync.ts'
 export * from './Transaction.ts'
 export * from './TransferBalance.ts'

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

@@ -1 +0,0 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/model/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,uBAAuB,CAAC,QAAQ,SAAS,OAAO,EAC/D,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,SAAQ,WAAW;IAC/F,cAAc,EAAE,SAAS,EAAE,CAAA;IAC3B,UAAU,EAAE,CAAC,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,OAAO,CAAE,SAAQ,uBAAuB,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB;CAAG;AAE3I,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,OAAO,CAAE,SAAQ,uBAAuB,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB;CAAG;AAE7I,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,IAAI,uBAAuB,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAA;AAE7G,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB,CAAC,mBAAmB,CAAC;CAAG;AAEtG,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB,CAAC,mBAAmB,CAAC;CAAG;AAE9F,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB,CAAC,oBAAoB,CAAC;CAAG;AAEzG,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB,CAAC,oBAAoB,CAAC;CAAG;AAEjG,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB,CAAC,kBAAkB,CAAC;CAAG;AAErG,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB,CAAC,kBAAkB,CAAC;CAAG"}

package/dist/neutral/payloads/summary/BalancesStepSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BalancesStepSummary.d.ts","sourceRoot":"","sources":["../../../../src/payloads/summary/BalancesStepSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,yBAAyB,EAAE,MAA4C,CAAA;AACpF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;CACxC,EAAE,yBAAyB,CAAC,CAAA;AAE7B;;GAEG;AACH,eAAO,MAAM,qBAAqB,kDAAwE,CAAA;AAC1G,eAAO,MAAM,qBAAqB,8DAAqE,CAAA;AAEvG;;GAEG;AACH,eAAO,MAAM,oCAAoC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAAe,CAAC,mBAAmB,CAEjH,CAAA;AACD,eAAO,MAAM,oCAAoC,+EAAqG,CAAA"}

package/dist/neutral/payloads/summary/SchemasStepSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SchemasStepSummary.d.ts","sourceRoot":"","sources":["../../../../src/payloads/summary/SchemasStepSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,wBAAwB,EAAE,MAA2C,CAAA;AAClF,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,EAAE,wBAAwB,CAAC,CAAA;AAE5B;;GAEG;AACH,eAAO,MAAM,oBAAoB,iDAAsE,CAAA;AACvG,eAAO,MAAM,oBAAoB,6DAAmE,CAAA;AAEpG;;GAEG;AACH,eAAO,MAAM,mCAAmC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAAe,CAAC,kBAAkB,CAE/G,CAAA;AACD,eAAO,MAAM,mCAAmC,8EAAmG,CAAA"}

package/dist/neutral/payloads/summary/StepSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StepSummary.d.ts","sourceRoot":"","sources":["../../../../src/payloads/summary/StepSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAEjE,eAAO,MAAM,iBAAiB,EAAE,MAAmC,CAAA;AACnE,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA;AAExD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,WAAW,CAAC,iBAAiB,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EACzE,OAAO,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,OAAO,CAAC,iBAAiB,SAAS,IAAI,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,EAC1I,OAAO,SAAS,IAAI,GAAG,iBAAiB,GAAG,OAAO,CAAC,CAAA"}

package/dist/neutral/payloads/summary/TransfersSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransfersSummary.d.ts","sourceRoot":"","sources":["../../../../src/payloads/summary/TransfersSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,0BAA0B,EAAE,MAA4C,CAAA;AACrF,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAA;CAC1D,EAAE,0BAA0B,CAAC,CAAA;AAE9B;;GAEG;AACH,eAAO,MAAM,sBAAsB,mDAA0E,CAAA;AAC7G,eAAO,MAAM,sBAAsB,+DAAuE,CAAA;AAE1G;;GAEG;AACH,eAAO,MAAM,qCAAqC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAAe,CAAC,oBAAoB,CAEnH,CAAA;AACD,eAAO,MAAM,qCAAqC,gFACsD,CAAA"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"balancesStepSummaryFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/primitives/summary/balances/balancesStepSummaryFromRange.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAO9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAMrE,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CA+D/C"}

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

@@ -1,4 +0,0 @@
-import type { Address } from '@xylabs/sdk-js';
-import type { BalanceStepSummaryContext } from '../../../model/index.ts';
-export declare function balancesSummary(context: BalanceStepSummaryContext): Promise<Partial<Record<Address, bigint>>>;
-//# sourceMappingURL=balancesSummary.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"balancesSummary.d.ts","sourceRoot":"","sources":["../../../../../src/primitives/summary/balances/balancesSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAQ7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAIxE,wBAAsB,eAAe,CACnC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAoB3C"}

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"schemasStepSummaryFromRange.d.ts","sourceRoot":"","sources":["../../../../../src/primitives/summary/schemas/schemasStepSummaryFromRange.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACF,YAAY,EACrB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAO9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAGpE,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CA6D3C"}