@xyo-network/chain-validation 1.7.8 → 1.7.10

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/chain-validation",
-  "version": "1.7.8",
+  "version": "1.7.10",
   "description": "XYO Layer One SDK Validation",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -23,45 +23,47 @@
   "exports": {
     ".": {
       "types": "./dist/neutral/index.d.ts",
+      "source": "./src/index.ts",
       "default": "./dist/neutral/index.mjs"
     },
     "./package.json": "./package.json"
   },
   "module": "./dist/neutral/index.mjs",
+  "source": "./src/index.ts",
   "types": "./dist/neutral/index.d.ts",
-  "scripts": {
-    "deploy": "echo Deploy not allowed!",
-    "deploy3": "echo Deploy3 not allowed!"
-  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "dependencies": {
     "@xylabs/arraybuffer": "^4.13.21",
     "@xylabs/hex": "^4.13.21",
     "@xylabs/typeof": "^4.13.21",
-    "@xyo-network/boundwitness-builder": "^4.1.5",
-    "@xyo-network/boundwitness-model": "^4.1.5",
-    "@xyo-network/boundwitness-validator": "^4.1.5",
-    "@xyo-network/chain-protocol": "^1.7.8",
-    "@xyo-network/chain-schema": "^1.7.8",
-    "@xyo-network/chain-utils": "^1.7.8",
-    "@xyo-network/payload-builder": "^4.1.5",
-    "@xyo-network/payload-model": "^4.1.5",
-    "@xyo-network/schema-payload-plugin": "^4.1.5",
-    "@xyo-network/xl1-protocol": "^1.7.5",
-    "@xyo-network/xl1-protocol-sdk": "^1.7.8",
+    "@xyo-network/boundwitness-builder": "^4.1.6",
+    "@xyo-network/boundwitness-model": "^4.1.6",
+    "@xyo-network/boundwitness-validator": "^4.1.6",
+    "@xyo-network/chain-protocol": "^1.7.10",
+    "@xyo-network/chain-schema": "^1.7.10",
+    "@xyo-network/chain-utils": "^1.7.10",
+    "@xyo-network/payload-builder": "^4.1.6",
+    "@xyo-network/payload-model": "^4.1.6",
+    "@xyo-network/schema-payload-plugin": "^4.1.6",
+    "@xyo-network/xl1-protocol": "^1.7.10",
+    "@xyo-network/xl1-protocol-sdk": "^1.7.10",
     "ajv": "^8.17.1"
   },
   "devDependencies": {
-    "@types/node": "^24.0.14",
+    "@types/node": "^24.0.15",
     "@xylabs/assert": "^4.13.21",
     "@xylabs/promise": "^4.13.21",
     "@xylabs/ts-scripts-yarn3": "^7.0.0",
     "@xylabs/tsconfig": "^7.0.0",
-    "@xyo-network/account": "^4.1.5",
-    "@xyo-network/account-model": "^4.1.5",
-    "@xyo-network/archivist-memory": "^4.1.5",
-    "@xyo-network/archivist-model": "^4.1.5",
-    "@xyo-network/wallet": "^4.1.5",
-    "@xyo-network/xl1-protocol-sdk": "^1.7.8",
+    "@xyo-network/account": "^4.1.6",
+    "@xyo-network/account-model": "^4.1.6",
+    "@xyo-network/archivist-memory": "^4.1.6",
+    "@xyo-network/archivist-model": "^4.1.6",
+    "@xyo-network/wallet": "^4.1.6",
+    "@xyo-network/xl1-protocol-sdk": "^1.7.10",
     "knip": "^5.62.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"

package/src/hydratedBlock/spec/validateHydratedBlock.spec.ts

@@ -0,0 +1,33 @@
+import { assertEx } from '@xylabs/assert'
+import { asAddress } from '@xylabs/hex'
+import type { AccountInstance } from '@xyo-network/account-model'
+import { createGenesisBlock } from '@xyo-network/chain-protocol'
+import { HDWallet } from '@xyo-network/wallet'
+import type { HydratedBlock } from '@xyo-network/xl1-protocol'
+import {
+  afterAll, beforeAll, describe, expect, it, vi,
+} from 'vitest'
+
+import { validateHydratedBlock } from '../validateHydratedBlock.ts'
+
+describe('validateHydratedBlock', () => {
+  const genesisBlockRewardAddress = assertEx(asAddress('1111111111111111111111111111111111111111'))
+  const genesisBlockRewardAmount = 1_000_000_000n
+  const mockTimestamp = 1_234_567_890_000
+  const nextContractAddress = assertEx(asAddress('ebcA0d7C02491f84597CE4BdA7a4D4dBE663f008'))
+  const phrase = 'plug garden dish upper ski silent off desert course one add lazy skill skate nurse'
+  let result: HydratedBlock
+  beforeAll(async () => {
+    vi.spyOn(Date, 'now').mockReturnValue(mockTimestamp)
+    const initialBlockProducer: AccountInstance = await HDWallet.fromPhrase(phrase)
+    result = await createGenesisBlock(initialBlockProducer, nextContractAddress, genesisBlockRewardAmount, genesisBlockRewardAddress)
+  })
+  afterAll(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('should validate genesis block', async () => {
+    const validation = await validateHydratedBlock(result, nextContractAddress)
+    expect(validation.length).toBe(0)
+  })
+})

package/src/transaction/validators/spec/TransactionDurationValidator.spec.ts

@@ -0,0 +1,49 @@
+import { Account } from '@xyo-network/account'
+import type { AccountInstance } from '@xyo-network/account-model'
+import { buildTransaction } from '@xyo-network/xl1-protocol-sdk'
+import {
+  beforeAll, describe, expect, it,
+} from 'vitest'
+
+import { TransactionDurationValidator } from '../TransactionDurationValidator.ts'
+
+describe('TransactionDurationValidator', () => {
+  const chain = 'a82920051db4fcbb804463440dd45e03f72442fd'
+  let signer: AccountInstance
+  beforeAll(async () => {
+    signer = await Account.random()
+  })
+  describe('with valid duration', () => {
+    it('should return no errors', async () => {
+      const hydratedTransaction = await buildTransaction(chain, [], [], signer, 0, 1000)
+      const errors = await TransactionDurationValidator(hydratedTransaction, chain)
+      expect(errors.length).toBe(0)
+    })
+  })
+  describe('with invalid', () => {
+    describe('nbf', () => {
+      it('should return error if nbf too low', async () => {
+        const hydratedTransaction = await buildTransaction(chain, [], [], signer, -1, 1000)
+        const errors = await TransactionDurationValidator(hydratedTransaction, chain)
+        expect(errors.length).toBeGreaterThan(0)
+      })
+    })
+    describe('exp', () => {
+      it('should return error if exp less than nbf', async () => {
+        const hydratedTransaction = await buildTransaction(chain, [], [], signer, 1, 0)
+        const errors = await TransactionDurationValidator(hydratedTransaction, chain)
+        expect(errors.length).toBeGreaterThan(0)
+      })
+      it('should return error if exp is equal to nbf', async () => {
+        const hydratedTransaction = await buildTransaction(chain, [], [], signer, 0, 0)
+        const errors = await TransactionDurationValidator(hydratedTransaction, chain)
+        expect(errors.length).toBeGreaterThan(0)
+      })
+      it('should return error if exp too high', async () => {
+        const hydratedTransaction = await buildTransaction(chain, [], [], signer, 0, Number.MAX_SAFE_INTEGER)
+        const errors = await TransactionDurationValidator(hydratedTransaction, chain)
+        expect(errors.length).toBeGreaterThan(0)
+      })
+    })
+  })
+})

package/src/transaction/validators/spec/TransactionElevationValidator.spec.ts

@@ -0,0 +1,39 @@
+import { Account } from '@xyo-network/account'
+import type { AccountInstance } from '@xyo-network/account-model'
+import { buildRandomTransaction } from '@xyo-network/chain-protocol'
+import type { HydratedTransaction, TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import { buildTransaction } from '@xyo-network/xl1-protocol-sdk'
+import {
+  beforeAll, describe, expect, it,
+} from 'vitest'
+
+import { TransactionElevationValidator } from '../TransactionElevationValidator.ts'
+
+describe('TransactionDurationValidator', () => {
+  const chain = 'a82920051db4fcbb804463440dd45e03f72442fd'
+  let signer: AccountInstance
+  beforeAll(async () => {
+    signer = await Account.random()
+  })
+  describe('should return no errors', () => {
+    it('if all script hash payloads are supplied', async () => {
+      const tx = await buildRandomTransaction(chain, [], signer)
+      const result = await TransactionElevationValidator(tx, chain)
+      expect(result.length).toBe(0)
+    })
+    it('when no payloads referenced in script hash', async () => {
+      const sample = await buildRandomTransaction(chain, [], signer)
+      const tx = await buildTransaction(chain, [], sample[1], signer, 1, 2)
+      const result = await TransactionElevationValidator(tx, chain)
+      expect(result.length).toBe(0)
+    })
+  })
+  describe('should return errors', () => {
+    it('if not all script hash payloads are supplied', async () => {
+      const [bw] = await buildRandomTransaction(chain, [], signer)
+      const tx = [bw, []] as HydratedTransaction<TransactionBoundWitness>
+      const result = await TransactionElevationValidator(tx, chain)
+      expect(result.length).toBe(1)
+    })
+  })
+})

package/src/transaction/validators/spec/TransactionFromValidator.spec.ts

@@ -0,0 +1,43 @@
+import { Account } from '@xyo-network/account'
+import type { AccountInstance } from '@xyo-network/account-model'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type { HydratedTransaction, TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import { buildTransaction } from '@xyo-network/xl1-protocol-sdk'
+import {
+  beforeAll,
+  beforeEach,
+  describe, expect, it,
+} from 'vitest'
+
+import { TransactionFromValidator } from '../TransactionFromValidator.ts'
+
+describe('TransactionFromValidator', () => {
+  const chain = 'a82920051db4fcbb804463440dd45e03f72442fd'
+  let signer: AccountInstance
+  beforeAll(async () => {
+    signer = await Account.random()
+  })
+  describe('with from empty', () => {
+    let hydratedTransaction: HydratedTransaction
+    beforeEach(async () => {
+      const transaction = await buildTransaction(chain, [], [], signer, 0, Number.MAX_SAFE_INTEGER)
+      const { from, ...tx } = transaction[0]
+      hydratedTransaction = [tx as WithStorageMeta<TransactionBoundWitness>, transaction[1]]
+    })
+    it('should return error', async () => {
+      const errors = await TransactionFromValidator(hydratedTransaction, chain)
+      expect(errors.length).toBeGreaterThan(0)
+    })
+  })
+  describe('with from not in addresses', () => {
+    let hydratedTransaction: HydratedTransaction
+    beforeEach(async () => {
+      const from = await Account.random()
+      hydratedTransaction = await buildTransaction(chain, [], [], signer, 0, Number.MAX_SAFE_INTEGER, from.address)
+    })
+    it('should return error', async () => {
+      const errors = await TransactionFromValidator(hydratedTransaction, chain)
+      expect(errors.length).toBeGreaterThan(0)
+    })
+  })
+})

package/src/transaction/validators/spec/TransactionGasValidator.spec.ts

@@ -0,0 +1,88 @@
+import { type Address, hexFromBigInt } from '@xylabs/hex'
+import { Account } from '@xyo-network/account'
+import { buildRandomTransaction } from '@xyo-network/chain-protocol'
+import type {
+  HydratedTransaction, TransactionBoundWitness, TransactionFeesHex,
+} from '@xyo-network/xl1-protocol'
+import {
+  beforeAll, beforeEach, describe, expect, it,
+} from 'vitest'
+
+import { TransactionGasValidator } from '../TransactionGasValidator.ts'
+
+describe('TransactionGasValidator', () => {
+  let chainId: Address
+  let transaction: HydratedTransaction
+
+  beforeAll(async () => {
+    chainId = (await Account.random()).address
+  })
+
+  beforeEach(async () => {
+    transaction = await buildRandomTransaction(chainId)
+  })
+
+  describe('with valid transaction', () => {
+    it('should return no errors for valid fees', async () => {
+      const result = await TransactionGasValidator(transaction, chainId)
+      expect(result).toEqual([])
+    })
+  })
+
+  describe('with invalid transaction', () => {
+    describe('fees', () => {
+      it('should return an error if fees are missing', async () => {
+        delete (transaction[0] as Partial<TransactionBoundWitness>).fees
+        const result = await TransactionGasValidator(transaction, chainId)
+        expect(result[0].message).toEqual('Missing fees')
+      })
+    })
+
+    describe('base', () => {
+      it('should return an error if fees.base is undefined', async () => {
+        delete (transaction[0].fees as Partial<TransactionFeesHex>)?.base
+        const result = await TransactionGasValidator(transaction, chainId)
+        expect(result[0].message).toEqual('fees.base must be defined and a valid number')
+      })
+      it('should return an error if fees.base is less than or equal to 0', async () => {
+        transaction[0].fees.base = hexFromBigInt(0n)
+        const result = await TransactionGasValidator(transaction, chainId)
+        expect(result.length).toEqual(1)
+      })
+    })
+
+    describe('gasLimit', () => {
+      it('should return an error if fees.gasLimit is undefined', async () => {
+        delete (transaction[0].fees as Partial<TransactionFeesHex>)?.gasLimit
+        const result = await TransactionGasValidator(transaction, chainId)
+        expect(result[0].message).toEqual('fees.gasLimit must be defined and a valid number')
+      })
+      it('should return an error if fees.gasLimit is less than or equal to 0', async () => {
+        transaction[0].fees.gasLimit = hexFromBigInt(0n)
+        const result = await TransactionGasValidator(transaction, chainId)
+        expect(result.length).toEqual(1)
+      })
+    })
+  })
+
+  describe('gasPrice', () => {
+    it('should return an error if fees.gasPrice is undefined', async () => {
+      delete (transaction[0].fees as Partial<TransactionFeesHex>)?.gasPrice
+      const result = await TransactionGasValidator(transaction, chainId)
+      expect(result[0].message).toEqual('fees.gasPrice must be defined and a valid number')
+    })
+    it('should return an error if fees.gasPrice is less than or equal to 0', async () => {
+      transaction[0].fees.gasPrice = hexFromBigInt(0n)
+      const result = await TransactionGasValidator(transaction, chainId)
+      expect(result.length).toEqual(1)
+    })
+  })
+
+  describe('priority', () => {
+    it('should return an error if fees.priority is undefined', async () => {
+      delete (transaction[0].fees as Partial<TransactionFeesHex>)?.priority
+      const result = await TransactionGasValidator(transaction, chainId)
+      expect(result[0].message).toEqual('fees.priority must be defined and a valid number')
+    })
+  })
+})

package/src/transaction/validators/spec/TransactionJsonSchemaValidator.spec.ts

@@ -0,0 +1,33 @@
+import { buildRandomTransaction } from '@xyo-network/chain-protocol'
+import type { HydratedTransaction } from '@xyo-network/xl1-protocol'
+import {
+  beforeEach, describe, expect, it,
+} from 'vitest'
+
+import { TransactionJsonSchemaValidator } from '../TransactionJsonSchemaValidator.ts'
+
+describe('TransactionJsonSchemaValidator', () => {
+  const chain = 'a82920051db4fcbb804463440dd45e03f72442fd'
+
+  describe('with valid transaction', () => {
+    let hydratedTransaction: HydratedTransaction
+    beforeEach(async () => {
+      hydratedTransaction = await buildRandomTransaction(chain)
+    })
+    it('should return no errors', async () => {
+      const errors = await TransactionJsonSchemaValidator(hydratedTransaction, chain)
+      expect(errors).toEqual([])
+    })
+  })
+  describe('with invalid transaction', () => {
+    let hydratedTransaction: HydratedTransaction
+    beforeEach(async () => {
+      hydratedTransaction = await buildRandomTransaction(chain)
+      hydratedTransaction[0].chain = 'invalid'
+    })
+    it('should return error', async () => {
+      const errors = await TransactionJsonSchemaValidator(hydratedTransaction, chain)
+      expect(errors.length).toBeGreaterThan(0)
+    })
+  })
+})

package/xy.config.ts

@@ -1,10 +0,0 @@
-import type { XyTsupConfig } from '@xylabs/ts-scripts-yarn3'
-const config: XyTsupConfig = {
-  compile: {
-    browser: {},
-    node: {},
-    neutral: { src: true },
-  },
-}
-
-export default config