@xyo-network/xl1-protocol-sdk 1.26.4 → 1.26.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.26.4",
+  "version": "1.26.6",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -48,8 +48,8 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~1.26.4",
-    "@xyo-network/xl1-schema": "~1.26.4",
+    "@xyo-network/xl1-protocol-lib": "~1.26.6",
+    "@xyo-network/xl1-schema": "~1.26.6",
     "async-mutex": "~0.5.0",
     "cosmiconfig": "^9.0.1",
     "lru-cache": "^11.2.7"
@@ -57,19 +57,20 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@types/node": "^25.5.0",
-    "@xylabs/sdk-js": "^5.0.87",
-    "@xylabs/ts-scripts-yarn3": "~7.4.27",
-    "@xylabs/tsconfig": "~7.4.27",
-    "@xylabs/vitest-extended": "~5.0.87",
-    "@xyo-network/sdk-js": "^5.3.16",
-    "@xyo-network/xl1-network-model": "~1.26.4",
+    "@xylabs/sdk-js": "^5.0.90",
+    "@xylabs/ts-scripts-common": "~7.5.6",
+    "@xylabs/ts-scripts-yarn3": "~7.5.6",
+    "@xylabs/tsconfig": "~7.5.6",
+    "@xylabs/vitest-extended": "~5.0.90",
+    "@xyo-network/sdk-js": "^5.3.17",
+    "@xyo-network/xl1-network-model": "~1.26.6",
     "axios": "^1.13.6",
     "ethers": "^6.16.0",
     "ky": "^1.14.3",
     "mongodb": "~7.1.1",
     "tslib": "^2.8.1",
     "typescript": "~5.9.3",
-    "vitest": "~4.1.1",
+    "vitest": "~4.1.2",
     "zod": "~4.3.6"
   },
   "peerDependencies": {

package/src/payloads/netBalancesForPayloads.ts

@@ -3,10 +3,11 @@ import {
 } from '@xylabs/sdk-js'
 import { span } from '@xylabs/sdk-js'
 import type { Payload } from '@xyo-network/sdk-js'
+import type { BaseContext } from '@xyo-network/xl1-protocol-lib'
 import { isTransfer } from '@xyo-network/xl1-protocol-lib'
 
 /** netBalancesForPayloads constant. */
-export const netBalancesForPayloads = (payloads: Payload[]) => {
+export const netBalancesForPayloads = (context: BaseContext, payloads: Payload[]) => {
   return span('netBalancesForPayloads', () => {
     const balances: Record<Address, bigint> = {}
     for (const payload of payloads) {
@@ -19,5 +20,5 @@ export const netBalancesForPayloads = (payloads: Payload[]) => {
       }
     }
     return balances
-  })
+  }, context.traceProvider)
 }

package/src/payloads/netSchemasForPayloads.ts

@@ -3,10 +3,11 @@ import {
 } from '@xylabs/sdk-js'
 import { span } from '@xylabs/sdk-js'
 import type { Payload } from '@xyo-network/sdk-js'
+import type { BaseContext } from '@xyo-network/xl1-protocol-lib'
 import { isTransfer } from '@xyo-network/xl1-protocol-lib'
 
 /** netSchemasForPayloads constant. */
-export const netSchemasForPayloads = (payloads: Payload[]) => {
+export const netSchemasForPayloads = (context: BaseContext, payloads: Payload[]) => {
   return span('netSchemasForPayloads', () => {
     const balances: Record<Address, bigint> = {}
     for (const payload of payloads) {
@@ -19,5 +20,5 @@ export const netSchemasForPayloads = (payloads: Payload[]) => {
       }
     }
     return balances
-  })
+  }, context.traceProvider)
 }

package/src/payloads/netTransfersForPayloads.ts

@@ -3,11 +3,12 @@ import {
 } from '@xylabs/sdk-js'
 import { span } from '@xylabs/sdk-js'
 import type { Payload } from '@xyo-network/sdk-js'
+import type { BaseContext } from '@xyo-network/xl1-protocol-lib'
 import { isTransfer } from '@xyo-network/xl1-protocol-lib'
 
 // the net transfer amounts for the specified accounts only
 /** NetTransfersForPayloads helper function. */
-export function netTransfersForPayloads(payloads: Payload[]): Record<Address, Record<Address, bigint>> {
+export function netTransfersForPayloads(context: BaseContext, payloads: Payload[]): Record<Address, Record<Address, bigint>> {
   return span('netTransfersForPayloads', () => {
     const transfers: Record<Address, Record<Address, bigint>> = {}
     for (const payload of payloads) {
@@ -22,5 +23,5 @@ export function netTransfersForPayloads(payloads: Payload[]): Record<Address, Re
       }
     }
     return transfers
-  })
+  }, context.traceProvider)
 }

package/src/primitives/chain/step/stepRewardTotal.ts

@@ -29,7 +29,7 @@ export async function stepRewardTotal(context: CachingContext, blockViewer: Bloc
       () => `No step transfer found for step ${step} at block ${block} (${blockBw._hash})`,
     )
     const rewards = assertEx(
-      netTransfersForPayloads([stepTransfer])[XYO_STEP_REWARD_ADDRESS],
+      netTransfersForPayloads(context, [stepTransfer])[XYO_STEP_REWARD_ADDRESS],
       () => `No rewards found for step reward address ${XYO_STEP_REWARD_ADDRESS} at block ${block} (${blockBw._hash})`,
     )
     const sortedTransfers = (Object.entries(rewards)).toSorted(([,a], [,b]) => a > b ? -1 : a < b ? 1 : 0)

package/src/simple/block/SimpleBlockViewer.ts

@@ -95,13 +95,11 @@ export class SimpleBlockViewer extends AbstractCreatableProvider<SimpleBlockView
 
   async blockByNumber(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null> {
     return await this.spanAsync('blockByNumber', async () => {
-      const [head] = await this.currentBlock()
-      if (isUndefined(head)) {
+      const chainContext = await this.getChainContextRead()
+      if (isUndefined(chainContext.head)) {
         return null
       }
-      const block = asSignedHydratedBlockWithHashMeta(await hydratedBlockByNumber(await this.getChainContextRead(), blockNumber)) ?? null
-      const [result] = block ? await addDataLakePayloads(block, this.dataLakeViewer) : [null, []]
-      return result
+      return await this.blockByNumberWithContext(chainContext, blockNumber)
     }, { ...this.context, timeBudgetLimit: 100 })
   }
 
@@ -125,13 +123,17 @@ export class SimpleBlockViewer extends AbstractCreatableProvider<SimpleBlockView
     return await this.spanAsync('blocksByNumber', async () => {
       assertEx(limit > 0, () => 'limit must be greater than 0')
       assertEx(limit <= 100, () => 'limit must be less than 100')
+      const chainContext = await this.getChainContextRead()
+      if (isUndefined(chainContext.head)) {
+        return []
+      }
       const blocks: SignedHydratedBlockWithHashMeta[] = []
-      let current = await this.blockByNumber(blockNumber)
+      let current = await this.blockByNumberWithContext(chainContext, blockNumber)
       while (current && blocks.length < limit) {
         blocks.push(current)
         if (current[0].block === 0) break
         const previousNumber = asXL1BlockNumber(current[0].block - 1, true)
-        current = await this.blockByNumber(previousNumber)
+        current = await this.blockByNumberWithContext(chainContext, previousNumber)
       }
       return blocks.map(b => asSignedHydratedBlockWithHashMeta(b, true))
     }, this.context)
@@ -217,4 +219,13 @@ export class SimpleBlockViewer extends AbstractCreatableProvider<SimpleBlockView
       head: (await this.finalizationViewer.head())[0],
     }
   }
+
+  private async blockByNumberWithContext(
+    chainContext: ChainContextRead,
+    blockNumber: XL1BlockNumber,
+  ): Promise<SignedHydratedBlockWithHashMeta | null> {
+    const block = asSignedHydratedBlockWithHashMeta(await hydratedBlockByNumber(chainContext, blockNumber)) ?? null
+    const [result] = block ? await addDataLakePayloads(block, this.dataLakeViewer) : [null, []]
+    return result
+  }
 }

package/src/simple/mempool/SimpleMempoolRunner.ts

@@ -18,6 +18,8 @@ import {
   isHydratedBlockWithHashMeta, isHydratedTransactionWithHashMeta, isSignedHydratedBlockWithHashMeta, isSignedHydratedTransactionWithHashMeta, MempoolPruneOptions, MempoolRunner,
   MempoolRunnerMoniker, type MempoolViewer, type SignedHydratedBlock, SignedHydratedBlockWithHashMeta, type SignedHydratedTransaction,
   SignedHydratedTransactionWithHashMeta,
+  TransactionValidationViewer,
+  TransactionValidationViewerMoniker,
 } from '@xyo-network/xl1-protocol-lib'
 import { Mutex } from 'async-mutex'
 
@@ -48,13 +50,14 @@ export interface SimpleMempoolRunnerParams extends CreatableProviderParams {
 @creatableProvider()
 export class SimpleMempoolRunner extends AbstractCreatableProvider<SimpleMempoolRunnerParams> implements MempoolRunner {
   static readonly defaultMoniker = MempoolRunnerMoniker
-  static readonly dependencies = [FinalizationViewerMoniker, BlockValidationViewerMoniker, ChainContractViewerMoniker]
+  static readonly dependencies = [FinalizationViewerMoniker, BlockValidationViewerMoniker, TransactionValidationViewerMoniker, ChainContractViewerMoniker]
   static readonly monikers = [MempoolRunnerMoniker]
   moniker = SimpleMempoolRunner.defaultMoniker
 
   protected _blockValidationViewer!: BlockValidationViewer
   protected _chainContractViewer!: ChainContractViewer
   protected _finalizationViewer!: FinalizationViewer
+  protected _transactionValidationViewer!: TransactionValidationViewer
 
   private _syncMutex = new Mutex()
   private _syncTimerId: ReturnType<typeof setInterval> | null = null
@@ -95,6 +98,10 @@ export class SimpleMempoolRunner extends AbstractCreatableProvider<SimpleMempool
     return this.params.syncLimit ?? DEFAULT_SYNC_LIMIT
   }
 
+  protected get transactionValidationViewer() {
+    return this._transactionValidationViewer!
+  }
+
   static override async paramsHandler(params?: Partial<SimpleMempoolRunnerParams>): Promise<SimpleMempoolRunnerParams> {
     return {
       ...await super.paramsHandler(params),
@@ -108,6 +115,7 @@ export class SimpleMempoolRunner extends AbstractCreatableProvider<SimpleMempool
     this._blockValidationViewer = await this.locator.getInstance<BlockValidationViewer>(BlockValidationViewerMoniker)
     this._chainContractViewer = await this.locator.getInstance<ChainContractViewer>(ChainContractViewerMoniker)
     this._finalizationViewer = await this.locator.getInstance<FinalizationViewer>(FinalizationViewerMoniker)
+    this._transactionValidationViewer = await this.locator.getInstance<TransactionValidationViewer>(TransactionValidationViewerMoniker)
   }
 
   async prunePendingBlocks({
@@ -137,7 +145,7 @@ export class SimpleMempoolRunner extends AbstractCreatableProvider<SimpleMempool
         remainingBlockMap.length === remainingBlocks.length,
         () => `remainingBlockMap length should match remainingBlocks length [${remainingBlockMap.length}/${remainingBlocks.length}]`,
       )
-      const validationResults = await this.blockValidationViewer.validateBlocks(remainingBlocks, { value: true, state: false })
+      const validationResults = await this.blockValidationViewer.validateBlocks(remainingBlocks, { value: true, state: true })
       for (const [i, r] of validationResults.entries()) {
         const validated = isHydratedBlockWithHashMeta(r)
         if (!validated) {
@@ -196,7 +204,7 @@ export class SimpleMempoolRunner extends AbstractCreatableProvider<SimpleMempool
         () => `remainingTransactionMap length should match remainingTransactions length [${remainingTransactionMap.length}/${remainingTransactions.length}]`,
       )
 
-      const validationResults = remainingTransactions.map(t => t) // Skip full validation for now, just use simple checks
+      const validationResults = await this.transactionValidationViewer.validateTransactions(remainingTransactions, { value: true, state: true })
       for (const [i, r] of validationResults.entries()) {
         const validated = isHydratedTransactionWithHashMeta(r)
         if (!validated) {

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

@@ -37,7 +37,7 @@ export async function balancesStepSummaryFromRange(
         ? await spanRootAsync(`balancesStepSummaryFromRange.frameSize=1[${key}]`, async () => {
             const [,payloads] = assertEx(await blockViewer.blockByNumber(range[0]), () => `Block not found for number: ${range[0]}`)
             const balances: Record<Address, SignedBigInt> = {}
-            for (const [address, balance] of Object.entries(netBalancesForPayloads(payloads))) {
+            for (const [address, balance] of Object.entries(netBalancesForPayloads(context, payloads))) {
               balances[address as Address] = toSignedBigInt(balance)
             }
             return {

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

@@ -42,7 +42,7 @@ export async function transfersStepSummaryFromRange(
       if (frameSize === 1) {
         const [, payloads] = assertEx(await blockViewer.blockByNumber(range[0]), () => `Block not found for number: ${range[0]}`)
         const transfers: Record<Address, Record<Address, SignedBigInt>> = {}
-        for (const [from, toMap] of Object.entries(netTransfersForPayloads(payloads))) {
+        for (const [from, toMap] of Object.entries(netTransfersForPayloads(context, payloads))) {
           transfers[from as Address] = transfers[from as Address] ?? {}
           for (const [to, amount] of Object.entries(toMap)) {
             transfers[from as Address][to as Address] = toSignedBigInt(amount)