@xyo-network/chain-services 1.11.0 → 1.12.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/chain-services",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "XYO Layer One SDK Services",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -37,48 +37,48 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "~1.9.0",
-    "@xylabs/array": "~5.0.3",
-    "@xylabs/assert": "~5.0.3",
-    "@xylabs/creatable": "~5.0.3",
-    "@xylabs/decimal-precision": "~5.0.3",
-    "@xylabs/events": "~5.0.3",
-    "@xylabs/exists": "~5.0.3",
-    "@xylabs/forget": "~5.0.3",
-    "@xylabs/hex": "~5.0.3",
-    "@xylabs/promise": "~5.0.3",
-    "@xylabs/telemetry": "~5.0.3",
-    "@xylabs/typeof": "~5.0.3",
-    "@xyo-network/account-model": "~5.0.2",
-    "@xyo-network/archivist-memory": "~5.0.2",
-    "@xyo-network/archivist-model": "~5.0.2",
-    "@xyo-network/boundwitness-model": "~5.0.2",
-    "@xyo-network/boundwitness-validator": "~5.0.2",
-    "@xyo-network/boundwitness-wrapper": "~5.0.2",
-    "@xyo-network/chain-analyze": "~1.11.0",
-    "@xyo-network/chain-modules": "~1.11.0",
-    "@xyo-network/chain-protocol": "~1.11.0",
-    "@xyo-network/chain-utils": "~1.11.0",
-    "@xyo-network/payload-builder": "~5.0.2",
-    "@xyo-network/payload-model": "~5.0.2",
+    "@xylabs/array": "~5.0.8",
+    "@xylabs/assert": "~5.0.8",
+    "@xylabs/creatable": "~5.0.8",
+    "@xylabs/decimal-precision": "~5.0.8",
+    "@xylabs/events": "~5.0.8",
+    "@xylabs/exists": "~5.0.8",
+    "@xylabs/forget": "~5.0.8",
+    "@xylabs/hex": "~5.0.8",
+    "@xylabs/promise": "~5.0.8",
+    "@xylabs/telemetry": "~5.0.8",
+    "@xylabs/typeof": "~5.0.8",
+    "@xyo-network/account-model": "~5.0.5",
+    "@xyo-network/archivist-memory": "~5.0.5",
+    "@xyo-network/archivist-model": "~5.0.5",
+    "@xyo-network/boundwitness-model": "~5.0.5",
+    "@xyo-network/boundwitness-validator": "~5.0.5",
+    "@xyo-network/boundwitness-wrapper": "~5.0.5",
+    "@xyo-network/chain-analyze": "~1.12.1",
+    "@xyo-network/chain-modules": "~1.12.1",
+    "@xyo-network/chain-protocol": "~1.12.1",
+    "@xyo-network/chain-utils": "~1.12.1",
+    "@xyo-network/payload-builder": "~5.0.5",
+    "@xyo-network/payload-model": "~5.0.5",
     "@xyo-network/typechain": "~4.0.0",
-    "@xyo-network/xl1-protocol": "~1.10.3",
-    "@xyo-network/xl1-protocol-sdk": "~1.11.0",
-    "@xyo-network/xl1-validation": "~1.11.0",
-    "@xyo-network/xl1-wrappers": "~1.11.0",
+    "@xyo-network/xl1-protocol": "~1.10.13",
+    "@xyo-network/xl1-protocol-sdk": "~1.12.1",
+    "@xyo-network/xl1-validation": "~1.12.1",
+    "@xyo-network/xl1-wrappers": "~1.12.1",
     "async-mutex": "~0.5.0",
     "ethers": "6.15.0",
     "lru-cache": "~11.1.0"
   },
   "devDependencies": {
-    "@types/node": "~24.2.0",
-    "@xylabs/delay": "~5.0.3",
-    "@xylabs/ts-scripts-yarn3": "~7.1.0",
-    "@xylabs/tsconfig": "~7.1.0",
-    "@xylabs/vitest-extended": "~5.0.3",
-    "@xyo-network/account": "~5.0.2",
-    "@xyo-network/account-model": "~5.0.2",
-    "@xyo-network/chain-validation": "~1.11.0",
-    "@xyo-network/wallet": "~5.0.2",
+    "@types/node": "~24.2.1",
+    "@xylabs/delay": "~5.0.8",
+    "@xylabs/ts-scripts-yarn3": "~7.1.2",
+    "@xylabs/tsconfig": "~7.1.2",
+    "@xylabs/vitest-extended": "~5.0.8",
+    "@xyo-network/account": "~5.0.5",
+    "@xyo-network/account-model": "~5.0.5",
+    "@xyo-network/chain-validation": "~1.12.1",
+    "@xyo-network/wallet": "~5.0.5",
     "tslib": "~2.8.1",
     "typescript": "~5.9.2",
     "vitest": "~3.2.4",

package/src/AccountBalance/BaseAccountBalanceService.ts

@@ -26,7 +26,8 @@ export class BaseAccountBalanceService extends BaseService<BaseAccountBalanceSer
     })
     const result: Record<Address, AttoXL1> = {}
     for (const addr of address) {
-      result[addr] = AttoXL1(summary[addr] ?? 0n)
+      const summaryBalance = summary[addr] ?? 0n
+      result[addr] = AttoXL1(summaryBalance < 0n ? 0n : summaryBalance)
     }
     return result
   }

package/src/BlockProducer/spec/BaseBlockProducerService.spec.ts

@@ -4,7 +4,7 @@ import { filterAs } from '@xylabs/array'
 import { assertEx } from '@xylabs/assert'
 import type { CreatableName } from '@xylabs/creatable'
 import { delay } from '@xylabs/delay'
-import type { Address, Hex } from '@xylabs/hex'
+import type { Address } from '@xylabs/hex'
 import {
   asAddress, hexToBigInt, ZERO_HASH,
 } from '@xylabs/hex'
@@ -19,7 +19,7 @@ import {
 } from '@xyo-network/payload-model'
 import { HDWallet } from '@xyo-network/wallet'
 import type {
-  BlockBoundWitness, BlockRewardService, ElectionService,
+  BlockBoundWitness, BlockRewardService, Chain, ElectionService,
   HydratedBlock,
   HydratedBlockStateValidationFunctionV2,
   StakeIntentService,
@@ -175,7 +175,7 @@ describe('XyoBlockProducer', () => {
           let rejectBlock = true
           const validateHydratedBlockState: HydratedBlockStateValidationFunctionV2 = async (
             hydratedBlock: HydratedBlock,
-            chainId: Hex,
+            chainId: Chain,
           ) => {
             return rejectBlock ? [await Promise.resolve(new HydratedBlockStateValidationError(ZERO_HASH, chainId, hydratedBlock, 'Invalid block'))] : []
           }

package/src/BlockProducer/spec/generateTransactionTransfer.spec.ts

@@ -9,7 +9,7 @@ import { isDefined } from '@xylabs/typeof'
 import type { Sequence, WithStorageMeta } from '@xyo-network/payload-model'
 import { XYO_ZERO_ADDRESS } from '@xyo-network/xl1-protocol'
 import {
-  defaultTransactionFees, type HydratedTransaction, type Transfer,
+  defaultTransactionFees, type SignedHydratedTransactionWithStorageMeta, type Transfer,
 } from '@xyo-network/xl1-protocol'
 import {
   describe, expect, it,
@@ -18,7 +18,7 @@ import {
 import { generateTransactionFeeTransfers } from '../generateTransactionFeeTransfers.ts'
 
 describe('generateTransactionTransfers', () => {
-  const testCases: HydratedTransaction[][] = [
+  const testCases: SignedHydratedTransactionWithStorageMeta[][] = [
     [
       [
         {

package/src/ChainBlockNumberIteration/model/BlockNumberIteration.ts

@@ -1,7 +1,7 @@
 import type { Promisable } from '@xylabs/promise'
-import type { BlockBoundWitness, HydratedTransaction } from '@xyo-network/xl1-protocol'
+import type { BlockBoundWitness, SignedHydratedTransactionWithStorageMeta } from '@xyo-network/xl1-protocol'
 
 export interface BlockNumberIteration {
   validatePendingBlock(block: BlockBoundWitness): Promisable<Error[]>
-  validatePendingTransaction(tx: HydratedTransaction): Promise<boolean>
+  validatePendingTransaction(tx: SignedHydratedTransactionWithStorageMeta): Promise<boolean>
 }

package/src/ChainValidator/XyoValidator.ts

@@ -1,15 +1,15 @@
 import { assertEx } from '@xylabs/assert'
 import { creatable } from '@xylabs/creatable'
-import { Address } from '@xylabs/hex'
 import { Promisable } from '@xylabs/promise'
 import { AccountInstance } from '@xyo-network/account-model'
 import { ArchivistInstance, ReadArchivist } from '@xyo-network/archivist-model'
 import {
   BlockBoundWitness,
   BlockRewardService,
+  Chain,
   ElectionService,
   HydratedBlockStateValidationFunctionV2,
-  HydratedTransaction,
+  SignedHydratedTransactionWithStorageMeta,
   StakeIntentService,
 } from '@xyo-network/xl1-protocol'
 
@@ -20,7 +20,7 @@ import { Validator } from './model/index.ts'
 export interface XyoValidatorParams extends BaseServiceParams {
   account: AccountInstance
   chainArchivist: ReadArchivist
-  chainId: Address
+  chainId: Chain
   electionService: ElectionService
   pendingBundledTransactionsArchivist: ArchivistInstance
   rewardService: BlockRewardService
@@ -63,7 +63,7 @@ export class XyoValidator<TParams extends XyoValidatorParams = XyoValidatorParam
   }
 
   // TODO: Move to validator and inherit this class from validator
-  async validatePendingTransaction(hydratedTransaction: HydratedTransaction): Promise<boolean> {
+  async validatePendingTransaction(hydratedTransaction: SignedHydratedTransactionWithStorageMeta): Promise<boolean> {
     const [tx] = hydratedTransaction
     // Ensure not confirmed already (replay attack)
     if ((await this.chainArchivist.get([tx._hash])).length > 0) return false

package/src/ChainValidator/model/Validator.ts

@@ -1,7 +1,7 @@
 import type { Promisable } from '@xylabs/promise'
-import type { BlockBoundWitness, HydratedTransaction } from '@xyo-network/xl1-protocol'
+import type { BlockBoundWitness, SignedHydratedTransactionWithStorageMeta } from '@xyo-network/xl1-protocol'
 
 export interface Validator {
   validatePendingBlock(block: BlockBoundWitness): Promisable<Error[]>
-  validatePendingTransaction(tx: HydratedTransaction): Promise<boolean>
+  validatePendingTransaction(tx: SignedHydratedTransactionWithStorageMeta): Promise<boolean>
 }

package/src/PendingTransactions/BasePendingTransactions.ts

@@ -4,7 +4,7 @@ import { assertEx } from '@xylabs/assert'
 import { creatable } from '@xylabs/creatable'
 import { exists } from '@xylabs/exists'
 import { forget } from '@xylabs/forget'
-import { Address, Hash } from '@xylabs/hex'
+import { Hash } from '@xylabs/hex'
 import { isDefined, isUndefined } from '@xylabs/typeof'
 import { MemoryArchivist } from '@xyo-network/archivist-memory'
 import { ArchivistInstance } from '@xyo-network/archivist-model'
@@ -13,7 +13,8 @@ import {
   Payload, PayloadBundle, Sequence, WithStorageMeta,
 } from '@xyo-network/payload-model'
 import {
-  asBlockBoundWitnessWithHashStorageMeta, HydratedTransaction, isTransactionBoundWitnessWithStorageMeta, PendingTransactionsService,
+  asBlockBoundWitnessWithHashStorageMeta, Chain, isTransactionBoundWitnessWithStorageMeta, PendingTransactionsService,
+  SignedHydratedTransactionWithStorageMeta,
 } from '@xyo-network/xl1-protocol'
 import { TransactionJsonSchemaValidator, validateTransaction } from '@xyo-network/xl1-validation'
 import { Mutex } from 'async-mutex'
@@ -25,7 +26,7 @@ import { hydratedTransactionToPayloadBundle } from './hydratedTransactionToPaylo
 
 export interface BasePendingTransactionsServiceParams extends BaseServiceParams {
   chainArchivist?: ArchivistInstance
-  chainId?: Address
+  chainId?: Chain
   pendingBundledTransactionsArchivist?: ArchivistInstance
   rejectedTransactionsArchivist?: ArchivistInstance
 }
@@ -134,7 +135,7 @@ export class BasePendingTransactionsService extends BaseService<BasePendingTrans
     })
   }
 
-  async getPendingTransactions(head: Hash, limit: number): Promise<HydratedTransaction[]> {
+  async getPendingTransactions(head: Hash, limit: number): Promise<SignedHydratedTransactionWithStorageMeta[]> {
     return await this.spanAsync('getPendingTransactions', async () => {
     // Acquires an exclusive mutex to ensure no race conditions while accessing pending transactions.
       return await this._updateCuratedPendingTransactionsArchivistMutex.runExclusive(async () => {
@@ -144,7 +145,7 @@ export class BasePendingTransactionsService extends BaseService<BasePendingTrans
 
         await this.pruneCuratedPendingTransactionsArchivist(lastHead._hash)
 
-        const foundPendingTransactions: HydratedTransaction[] = []
+        const foundPendingTransactions: SignedHydratedTransactionWithStorageMeta[] = []
         let cursor: Sequence | undefined
 
         // Continue fetching until the desired number of transactions is reached.
@@ -333,7 +334,7 @@ export class BasePendingTransactionsService extends BaseService<BasePendingTrans
  * @returns True if the transaction is expired for the given block, false otherwise.
  */
 const isTransactionExpired = (block: number) =>
-  ([txBw]: HydratedTransaction): boolean =>
+  ([txBw]: SignedHydratedTransactionWithStorageMeta): boolean =>
     txBw.exp < block
 
 /**
@@ -342,5 +343,5 @@ const isTransactionExpired = (block: number) =>
  * @returns True if the transaction is active for the given block, false otherwise.
  */
 const isTransactionActive = (block: number) =>
-  ([txBw]: HydratedTransaction): boolean =>
+  ([txBw]: SignedHydratedTransactionWithStorageMeta): boolean =>
     txBw.nbf <= block && txBw.exp >= block

package/src/PendingTransactions/bundledPayloadToHydratedTransaction.ts

@@ -1,11 +1,11 @@
 import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type { PayloadBundle, WithStorageMeta } from '@xyo-network/payload-model'
-import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
+import type { SignedHydratedTransactionWithStorageMeta } from '@xyo-network/xl1-protocol'
 import { asTransactionBoundWitnessWithStorageMeta } from '@xyo-network/xl1-protocol'
 
 export const bundledPayloadToHydratedTransaction = async (
   payload: WithStorageMeta<PayloadBundle>,
-): Promise<HydratedTransaction | undefined> => {
+): Promise<SignedHydratedTransactionWithStorageMeta | undefined> => {
   const withStorageMeta = await PayloadBuilder.addStorageMeta(payload.payloads)
   const tx = asTransactionBoundWitnessWithStorageMeta(withStorageMeta.find(p => p._hash === payload.root))
   if (tx) {

package/src/PendingTransactions/hydratedTransactionToPayloadBundle.ts

@@ -2,15 +2,15 @@ import type { Hash } from '@xylabs/hex'
 import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type { PayloadBundle } from '@xyo-network/payload-model'
 import { PayloadBundleSchema } from '@xyo-network/payload-model'
-import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
+import type { SignedHydratedTransactionWithStorageMeta } from '@xyo-network/xl1-protocol'
 import { flattenHydratedTransaction } from '@xyo-network/xl1-protocol-sdk'
 
-export const hydratedTransactionToPayloadBundle = (transaction: HydratedTransaction): PayloadBundle => {
+export const hydratedTransactionToPayloadBundle = (transaction: SignedHydratedTransactionWithStorageMeta): PayloadBundle => {
   const root = transaction[0]._hash
   return bundle(root, transaction)
 }
 
-const bundle = (root: Hash, transaction: HydratedTransaction) => {
+const bundle = (root: Hash, transaction: SignedHydratedTransactionWithStorageMeta) => {
   const payloads = flattenHydratedTransaction(transaction).flatMap(p => PayloadBuilder.omitStorageMeta(p))
   return new PayloadBuilder<PayloadBundle>({ schema: PayloadBundleSchema })
     .fields({ payloads, root })

package/src/PendingTransactions/spec/BasePendingTransactions.spec.ts

@@ -14,7 +14,8 @@ import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type { WithStorageMeta } from '@xyo-network/payload-model'
 import type {
   BlockBoundWitness, HashPayload,
-  HydratedBlock, HydratedTransaction,
+  HydratedBlock,
+  SignedHydratedTransactionWithStorageMeta,
 } from '@xyo-network/xl1-protocol'
 import { HashSchema } from '@xyo-network/xl1-protocol'
 import {
@@ -64,7 +65,7 @@ describe('BasePendingTransactionsService', () => {
   })
 
   describe('with pending transactions', () => {
-    let newTransactions: HydratedTransaction[] = []
+    let newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
     beforeEach(async () => {
       for (let index = 0; index < 5; index++) {
         const tx = await buildRandomTransaction(TestChainId)
@@ -88,8 +89,8 @@ describe('BasePendingTransactionsService', () => {
   })
 
   describe('with pending and finalized transactions', () => {
-    let finalizedTransactions: HydratedTransaction[] = []
-    let newTransactions: HydratedTransaction[] = []
+    let finalizedTransactions: SignedHydratedTransactionWithStorageMeta[] = []
+    let newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
     beforeEach(async () => {
       for (let index = 0; index < 5; index++) {
         const tx = await buildRandomTransaction(TestChainId)
@@ -118,7 +119,7 @@ describe('BasePendingTransactionsService', () => {
       .build()
     beforeEach(async () => {})
     it('when unique should allow transactions', async () => {
-      let newTransactions: HydratedTransaction[] = []
+      let newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
       // NOTE: Cast to Account to allow loadPreviousHash to be called
       const signer = await Account.random()
       const transaction1 = await buildTransaction(TestChainId, [hashPayload], [], signer, 0, 100)
@@ -133,7 +134,7 @@ describe('BasePendingTransactionsService', () => {
       expect(result.length).toEqual(newTransactions.length)
     })
     it('when non-unique should filter duplicate transactions', async () => {
-      let newTransactions: HydratedTransaction[] = []
+      let newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
       const previousHash = 'bb27dd470ccf91665d573a16b4f652a47b8a24686d1b44c189c1fa826cd3fef5'
       // NOTE: Cast to Account to allow loadPreviousHash to be called
       const signer = await Account.random() as Account
@@ -154,7 +155,7 @@ describe('BasePendingTransactionsService', () => {
 
   describe('with expiring transactions', () => {
     const insertTransaction = async (nbf: number, exp: number) => {
-      const newTransactions: HydratedTransaction[] = []
+      const newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
       const signer = await Account.random()
       const hashPayload = new PayloadBuilder<HashPayload>({ schema: HashSchema })
         .fields({ hash: head._hash })
@@ -237,8 +238,8 @@ describe('BasePendingTransactionsService', () => {
   })
 
   describe('with pending and rejected transactions', () => {
-    let rejectedTransactions: HydratedTransaction[] = []
-    let newTransactions: HydratedTransaction[] = []
+    let rejectedTransactions: SignedHydratedTransactionWithStorageMeta[] = []
+    let newTransactions: SignedHydratedTransactionWithStorageMeta[] = []
     beforeEach(async () => {
       for (let index = 0; index < 5; index++) {
         const tx = await buildRandomTransaction(TestChainId)
@@ -263,7 +264,7 @@ describe('BasePendingTransactionsService', () => {
   describe('with invalid transactions in mempool', () => {
     beforeEach(async () => {
       const incorrectChainId = assertEx(asAddress('1234567890abcdef1234567890abcdef12345678'))
-      const invalidTransactions: HydratedTransaction[] = [await buildRandomTransaction(incorrectChainId)]
+      const invalidTransactions: SignedHydratedTransactionWithStorageMeta[] = [await buildRandomTransaction(incorrectChainId)]
       const pending = invalidTransactions.map(hydratedTransactionToPayloadBundle)
       await pendingBundledTransactionsArchivist.insert(pending)
     })