@xyo-network/xl1-schema 1.7.16

package/src/StorageMeta.spec.ts

@@ -0,0 +1,64 @@
+import { Ajv } from 'ajv'
+import {
+  describe, expect, test,
+} from 'vitest'
+
+import { StorageMetaJsonSchema } from './StorageMeta.ts'
+
+const ajv = new Ajv()
+
+describe('StorageMetaJsonSchema', () => {
+  test('should have the correct $id', () => {
+    expect(StorageMetaJsonSchema.$id).toBe('https://schemas.xyo.network/2.0/storage-meta')
+  })
+
+  test('should validate a valid storage meta payload', () => {
+    const validate = ajv.compile(StorageMetaJsonSchema)
+    const validPayload = {
+      _sequence: 'a1b2c3d4',
+      _hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      _dataHash: 'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+    }
+    const result = validate(validPayload)
+    expect(result).toBe(true)
+  })
+
+  test('should invalidate a payload with missing required fields', () => {
+    const validate = ajv.compile(StorageMetaJsonSchema)
+    const invalidPayload = {
+      _sequence: 'a1b2c3d4',
+      _hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid _sequence pattern', () => {
+    const validate = ajv.compile(StorageMetaJsonSchema)
+    const invalidPayload = {
+      _sequence: 'invalid-sequence',
+      _hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      _dataHash: 'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid _hash pattern', () => {
+    const validate = ajv.compile(StorageMetaJsonSchema)
+    const invalidPayload = {
+      _sequence: 'a1b2c3d4',
+      _hash: 'invalid-hash',
+      _dataHash: 'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid _dataHash pattern', () => {
+    const validate = ajv.compile(StorageMetaJsonSchema)
+    const invalidPayload = {
+      _sequence: 'a1b2c3d4',
+      _hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      _dataHash: 'invalid-data-hash',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+})

package/src/StorageMeta.ts

@@ -0,0 +1,14 @@
+import type { StorageMeta } from '@xyo-network/payload-model'
+import { HashRegEx, HexRegEx } from '@xyo-network/payload-wrapper'
+import type { JSONSchemaType } from 'ajv'
+
+export const StorageMetaJsonSchema: JSONSchemaType<StorageMeta> = {
+  $id: 'https://schemas.xyo.network/2.0/storage-meta',
+  properties: {
+    _sequence: { type: 'string', pattern: HexRegEx },
+    _hash: { type: 'string', pattern: HashRegEx },
+    _dataHash: { type: 'string', pattern: HashRegEx },
+  },
+  required: ['_sequence', '_hash', '_dataHash'],
+  type: 'object',
+} as const

package/src/boundwitness/BlockBoundWitness.spec.ts

@@ -0,0 +1,229 @@
+import { BoundWitnessSchema } from '@xyo-network/boundwitness-model'
+import { Ajv } from 'ajv'
+import {
+  describe, expect, test,
+} from 'vitest'
+
+import { BlockBoundWitnessJsonSchema } from './BlockBoundWitness.ts'
+
+const ajv = new Ajv()
+
+describe('BlockBoundWitnessJsonSchema', () => {
+  test('should have the correct $id', () => {
+    expect(BlockBoundWitnessJsonSchema.$id).toBe('https://schemas.xyo.network/2.0/block')
+  })
+
+  test('should validate a valid BlockBoundWitness payload', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const validPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: [],
+      payload_schemas: [],
+      previous_hashes: [],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+        'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: BoundWitnessSchema,
+    }
+    const result = validate(validPayload)
+    expect(validate.errors).toBe(null)
+    expect(result).toBe(true)
+  })
+
+  test('should validate a valid BlockBoundWitness payload with payload_hashes, payload_schemas, and previous_hashes', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const validPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      payload_schemas: ['valid.schema'],
+      previous_hashes: [
+        'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+      ],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: BoundWitnessSchema,
+    }
+    const result = validate(validPayload)
+    expect(validate.errors).toBe(null)
+    expect(result).toBe(true)
+  })
+
+  test('should invalidate a payload with missing required fields', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid chain pattern', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      payload_hashes: [],
+      payload_schemas: [],
+      previous_hashes: [],
+      block: 1,
+      chain: 'invalid-chain',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      step_hashes: ['a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'],
+      $epoch: 1_234_567_890,
+      schema: 'BoundWitnessSchema',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid chain pattern (0x prefix)', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      payload_hashes: [],
+      payload_schemas: [],
+      previous_hashes: [],
+      block: 1,
+      chain: '0x1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      step_hashes: ['a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2'],
+      $epoch: 1_234_567_890,
+      schema: 'BoundWitnessSchema',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid step_hashes pattern', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      payload_hashes: [],
+      payload_schemas: [],
+      previous_hashes: [],
+      block: 1,
+      chain: '0x1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      step_hashes: ['invalid-hash'],
+      $epoch: 1_234_567_890,
+      schema: 'BoundWitnessSchema',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid schema pattern', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      payload_hashes: [],
+      payload_schemas: [],
+      previous_hashes: [],
+      block: 1,
+      chain: '0x1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: 'InvalidSchema',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid payload_hashes', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: ['invalid-hash'],
+      payload_schemas: ['valid.schema'],
+      previous_hashes: [
+        'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+      ],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: BoundWitnessSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid payload_schemas', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      payload_schemas: ['InvalidSchema'],
+      previous_hashes: [
+        'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+      ],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: BoundWitnessSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid previous_hashes', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      payload_schemas: ['valid.schema'],
+      previous_hashes: ['invalid-hash'],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 1_234_567_890,
+      schema: BoundWitnessSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid $epoch', () => {
+    const validate = ajv.compile(BlockBoundWitnessJsonSchema)
+    const invalidPayload = {
+      addresses: [],
+      block: 1,
+      chain: '1234567890abcdef1234567890abcdef12345678',
+      previous: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      payload_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      payload_schemas: ['valid.schema'],
+      previous_hashes: [
+        'b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2',
+      ],
+      step_hashes: [
+        'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      ],
+      $epoch: 'invalid-epoch', // Invalid $epoch
+      schema: BoundWitnessSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+})

package/src/boundwitness/BlockBoundWitness.ts

@@ -0,0 +1,32 @@
+import { BoundWitnessSchema } from '@xyo-network/boundwitness-model'
+import { boundWitnessJsonSchema, boundWitnessProperties } from '@xyo-network/boundwitness-wrapper'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { AddressRegEx, HashRegEx } from '@xyo-network/payload-wrapper'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { BlockBoundWitness } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+export const BlockBoundWitnessJsonSchema: JSONSchemaType<BlockBoundWitness> = {
+  ...boundWitnessJsonSchema,
+  $id: 'https://schemas.xyo.network/2.0/block',
+  properties: {
+    ...boundWitnessProperties,
+    block: { type: 'integer' },
+    chain: { type: 'string', pattern: AddressRegEx },
+    previous: {
+      type: 'string', pattern: HashRegEx, nullable: true,
+    },
+    step_hashes: {
+      items: { type: 'string', pattern: HashRegEx },
+      type: 'array',
+    },
+    $epoch: { type: 'integer' },
+    schema: { type: 'string', pattern: BoundWitnessSchema },
+  },
+  required: [...boundWitnessJsonSchema.required, 'block', 'chain', 'step_hashes', 'previous', '$epoch'],
+  type: 'object',
+} as const
+
+export const BlockBoundWitnessSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: BlockBoundWitnessJsonSchema }).build()

package/src/boundwitness/BlockBoundWitnessWithStorageMeta.ts

@@ -0,0 +1,26 @@
+import { BoundWitnessSchema } from '@xyo-network/boundwitness-model'
+import { boundWitnessJsonSchema, boundWitnessProperties } from '@xyo-network/boundwitness-wrapper'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import type { WithStorageMeta } from '@xyo-network/payload-model'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { BlockBoundWitness } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+import { StorageMetaJsonSchema } from '../StorageMeta.ts'
+import { BlockBoundWitnessJsonSchema } from './BlockBoundWitness.ts'
+
+export const BlockBoundWitnessWithStorageMetaJsonSchema: JSONSchemaType<WithStorageMeta<BlockBoundWitness>> = {
+  $id: 'https://schemas.xyo.network/2.0/block-with-storage-meta',
+  properties: {
+    ...boundWitnessProperties,
+    ...BlockBoundWitnessJsonSchema.properties,
+    ...StorageMetaJsonSchema.properties,
+    schema: { type: 'string', pattern: BoundWitnessSchema },
+  },
+  required: [...new Set([...boundWitnessJsonSchema.required, ...BlockBoundWitnessJsonSchema.required, ...StorageMetaJsonSchema.required])],
+  type: 'object',
+} as const
+
+export const BlockBoundWitnessWithStorageMetaSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: BlockBoundWitnessWithStorageMetaJsonSchema }).build()

package/src/boundwitness/TransactionBoundWitness.ts

@@ -0,0 +1,41 @@
+import { BoundWitnessSchema } from '@xyo-network/boundwitness-model'
+import { boundWitnessJsonSchema } from '@xyo-network/boundwitness-wrapper'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { AddressRegEx, Uint256RegEx } from '@xyo-network/payload-wrapper'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+import { ExecutableJsonSchema } from '../Executable.ts'
+
+export const TransactionBoundWitnessJsonSchema: JSONSchemaType<TransactionBoundWitness> = {
+  ...boundWitnessJsonSchema,
+  $id: 'https://schemas.xyo.network/2.0/transaction',
+  additionalProperties: false,
+  properties: {
+    ...boundWitnessJsonSchema.properties,
+    ...ExecutableJsonSchema.properties,
+    chain: { type: 'string', pattern: AddressRegEx },
+    fees: {
+      type: 'object',
+      properties: {
+        base: { type: 'string', pattern: Uint256RegEx },
+        gasLimit: { type: 'string', pattern: Uint256RegEx },
+        gasPrice: { type: 'string', pattern: Uint256RegEx },
+        priority: { type: 'string', pattern: Uint256RegEx },
+      },
+      required: ['base'],
+      additionalProperties: false,
+    },
+    from: { type: 'string', pattern: AddressRegEx },
+    nbf: { type: 'integer' },
+    exp: { type: 'integer' },
+    schema: { type: 'string', pattern: BoundWitnessSchema },
+  },
+  required: [...boundWitnessJsonSchema.required, 'chain', 'fees', 'nbf', 'exp'],
+  type: 'object',
+} as const
+
+export const TransactionBoundWitnessSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: TransactionBoundWitnessJsonSchema }).build()

package/src/boundwitness/TransactionBoundWitnessWithStorageMeta.ts

@@ -0,0 +1,30 @@
+import { BoundWitnessSchema } from '@xyo-network/boundwitness-model'
+import { boundWitnessJsonSchema } from '@xyo-network/boundwitness-wrapper'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { AddressRegEx, Uint256RegEx } from '@xyo-network/payload-wrapper'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { TransactionBoundWitness } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+import { StorageMetaJsonSchema } from '../StorageMeta.ts'
+
+export const TransactionBoundWitnessWithStorageMetaJsonSchema: JSONSchemaType<TransactionBoundWitness> = {
+  ...boundWitnessJsonSchema,
+  $id: 'https://schemas.xyo.network/2.0/transaction-with-storage-meta',
+  additionalProperties: false,
+  properties: {
+    ...boundWitnessJsonSchema.properties,
+    ...StorageMetaJsonSchema.properties,
+    chain: { type: 'string', pattern: AddressRegEx },
+    gas: { type: 'string', pattern: Uint256RegEx },
+    nbf: { type: 'integer' },
+    exp: { type: 'integer' },
+    schema: { type: 'string', pattern: BoundWitnessSchema },
+  },
+  required: [...boundWitnessJsonSchema.required, ...StorageMetaJsonSchema.required, 'chain', 'gas', 'nbf', 'exp'],
+  type: 'object',
+} as const
+
+export const TransactionBoundWitnessWithStorageMetaSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: TransactionBoundWitnessWithStorageMetaJsonSchema }).build()

package/src/boundwitness/index.ts

@@ -0,0 +1,4 @@
+export * from './BlockBoundWitness.ts'
+export * from './BlockBoundWitnessWithStorageMeta.ts'
+export * from './TransactionBoundWitness.ts'
+export * from './TransactionBoundWitnessWithStorageMeta.ts'

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './boundwitness/index.ts'
+export * from './Executable.ts'
+export * from './payload/index.ts'
+export * from './StorageMeta.ts'

package/src/payload/ChainStakeIntent.spec.ts

@@ -0,0 +1,81 @@
+import { Account } from '@xyo-network/account'
+import { ChainStakeIntentSchema } from '@xyo-network/xl1-protocol'
+import { Ajv } from 'ajv'
+import {
+  describe, expect, test,
+} from 'vitest'
+
+import { ChainStakeIntentPayloadJsonSchema } from './ChainStakeIntent.ts'
+
+const ajv = new Ajv()
+
+describe('ChainStakeIntentPayloadJsonSchema', () => {
+  test('should have the correct $id', () => {
+    expect(ChainStakeIntentPayloadJsonSchema.$id).toBe('https://schemas.xyo.network/2.0/payload/chain-stake-intent')
+  })
+
+  test('should define the correct properties', () => {
+    const properties = ChainStakeIntentPayloadJsonSchema.properties
+    expect(properties).toHaveProperty('from')
+    expect(properties).toHaveProperty('intent')
+    expect(properties).toHaveProperty('schema')
+  })
+
+  test('should include required fields', () => {
+    expect(ChainStakeIntentPayloadJsonSchema.required).toContain('intent')
+  })
+
+  test('should have type "object"', () => {
+    expect(ChainStakeIntentPayloadJsonSchema.type).toBe('object')
+  })
+
+  test('should validate a valid payload', async () => {
+    const fromAddress = (await Account.random()).address
+    const validate = ajv.compile(ChainStakeIntentPayloadJsonSchema)
+    const validPayload = {
+      from: fromAddress,
+      intent: 'producer',
+      schema: ChainStakeIntentSchema,
+    }
+    const result = validate(validPayload)
+    expect(result).toBe(true)
+  })
+
+  test('should invalidate a payload with an invalid "from" address', () => {
+    const validate = ajv.compile(ChainStakeIntentPayloadJsonSchema)
+    const invalidPayload = {
+      from: 'invalid-address',
+      intent: 'producer',
+      schema: ChainStakeIntentSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with an invalid "intent"', async () => {
+    const fromAddress = (await Account.random()).address
+    const validate = ajv.compile(ChainStakeIntentPayloadJsonSchema)
+    const invalidPayload = {
+      from: fromAddress,
+      intent: 'invalid-intent',
+      schema: ChainStakeIntentSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with an invalid "schema"', async () => {
+    const fromAddress = (await Account.random()).address
+    const validate = ajv.compile(ChainStakeIntentPayloadJsonSchema)
+    const invalidPayload = {
+      from: fromAddress,
+      intent: 'producer',
+      schema: 'invalid-schema',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload missing required fields', () => {
+    const validate = ajv.compile(ChainStakeIntentPayloadJsonSchema)
+    const invalidPayload = { from: 'valid-address' }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+})

package/src/payload/ChainStakeIntent.ts

@@ -0,0 +1,24 @@
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { AddressRegEx, payloadJsonSchema } from '@xyo-network/payload-wrapper'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { ChainStakeIntent } from '@xyo-network/xl1-protocol'
+import { ChainStakeIntentSchema } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+export const ChainStakeIntentPayloadJsonSchema: JSONSchemaType<ChainStakeIntent> = {
+  ...payloadJsonSchema,
+  $id: 'https://schemas.xyo.network/2.0/payload/chain-stake-intent',
+  additionalProperties: false,
+  properties: {
+    ...payloadJsonSchema.properties,
+    from: { type: 'string', pattern: AddressRegEx },
+    intent: { type: 'string', enum: ['producer'] },
+    schema: { type: 'string', pattern: ChainStakeIntentSchema },
+  },
+  required: [...payloadJsonSchema.required, 'intent'],
+  type: 'object',
+}
+
+export const ChainStakeIntentPayloadJsonSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: ChainStakeIntentPayloadJsonSchema }).build()

package/src/payload/HashPayload.spec.ts

@@ -0,0 +1,74 @@
+import { HashSchema } from '@xyo-network/xl1-protocol'
+import { Ajv } from 'ajv'
+import {
+  describe, expect, test,
+} from 'vitest'
+
+import { HashPayloadJsonSchema } from './HashPayload.ts'
+
+const ajv = new Ajv()
+
+describe('HashPayloadJsonSchema', () => {
+  test('should have the correct $id', () => {
+    expect(HashPayloadJsonSchema.$id).toBe('https://schemas.xyo.network/2.0/payload/hash')
+  })
+
+  test('should define the correct properties', () => {
+    const properties = HashPayloadJsonSchema.properties
+    expect(properties).toHaveProperty('hash')
+    expect(properties).toHaveProperty('schema')
+  })
+
+  test('should include required fields', () => {
+    expect(HashPayloadJsonSchema.required).toContain('hash')
+  })
+
+  test('should have type "object"', () => {
+    expect(HashPayloadJsonSchema.type).toBe('object')
+  })
+
+  test('should validate a valid payload', () => {
+    const validate = ajv.compile(HashPayloadJsonSchema)
+    const validPayload = {
+      hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2',
+      schema: HashSchema,
+    }
+    const result = validate(validPayload)
+    expect(result).toBe(true)
+  })
+
+  test('should invalidate a payload with missing required fields', () => {
+    const validate = ajv.compile(HashPayloadJsonSchema)
+    const invalidPayload = { schema: HashSchema }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with invalid hash pattern', () => {
+    const validate = ajv.compile(HashPayloadJsonSchema)
+    const invalidPayload = {
+      hash: 'invalid-hash!',
+      schema: HashSchema,
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with additional properties', () => {
+    const validate = ajv.compile(HashPayloadJsonSchema)
+    const invalidPayload = {
+      hash: 'abc123',
+      schema: HashSchema,
+      extraField: 'not-allowed',
+    }
+    expect(validate(invalidPayload)).toBe(false)
+  })
+
+  test('should invalidate a payload with an invalid schema', () => {
+    const validate = ajv.compile(HashPayloadJsonSchema)
+    const invalidPayload = {
+      hash: 'a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2', // Valid 32-byte hash
+      schema: 'InvalidSchema', // Invalid schema
+    }
+    const result = validate(invalidPayload)
+    expect(result).toBe(false)
+  })
+})

package/src/payload/HashPayload.ts

@@ -0,0 +1,23 @@
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import { HashRegEx, payloadJsonSchema } from '@xyo-network/payload-wrapper'
+import type { SchemaPayload } from '@xyo-network/schema-payload-plugin'
+import { SchemaSchema } from '@xyo-network/schema-payload-plugin'
+import type { HashPayload } from '@xyo-network/xl1-protocol'
+import { HashSchema } from '@xyo-network/xl1-protocol'
+import type { JSONSchemaType } from 'ajv'
+
+export const HashPayloadJsonSchema: JSONSchemaType<HashPayload> = {
+  ...payloadJsonSchema,
+  $id: 'https://schemas.xyo.network/2.0/payload/hash',
+  additionalProperties: false,
+  properties: {
+    ...payloadJsonSchema.properties,
+    hash: { type: 'string', pattern: HashRegEx },
+    schema: { type: 'string', pattern: HashSchema },
+  },
+  required: [...payloadJsonSchema.required, 'hash'],
+  type: 'object',
+}
+
+export const HashPayloadJsonSchemaPayload = new PayloadBuilder<SchemaPayload>({ schema: SchemaSchema })
+  .fields({ definition: HashPayloadJsonSchema }).build()