Testing Guide

How to run and write tests for the CIAF-LCM system

Quick Start

cd ui

# Install dependencies (if not already done)
npm install

# Run all tests
npm test

# Run tests in watch mode (recommended for development)
npm test:watch

# Run tests with coverage report
npm test:coverage

Test Structure

ui/lib/api/__tests__/
├── canonicalization.test.ts    # Hashing and canonicalization
├── signatures.test.ts          # Digital signatures
└── integration.test.ts         # Full workflows

Test Categories

1. Unit Tests

Canonicalization & Signature Tests

Canonicalization Tests

Deterministic JSON canonicalization

Key sorting and ordering

Nested object handling

Array preservation

Hash consistency across runs

Hash verification (timing-safe comparison)

Edge cases: empty objects, deep nesting, Unicode, large payloads

Signature Tests

Ed25519 key generation

RSA key generation

Signing and verification

Tamper detection

Invalid signature rejection

Wrong key rejection

Payload signing (canonicalization + signature)

Public key fingerprinting

2. Integration Tests

End-to-end workflow testing

Receipt Creation and Verification

Create receipt → Hash → Sign → Verify

Detect payload tampering

Vault Object Sealing

Seal vault object → Verify seal

Timestamp validation

Lineage Chains

Create predecessor → Create successor → Verify link

Hash referencing in lineage

Audit Pack Assembly

Assemble pack with multiple items

Verify pack hash

Verify all included items

Running Tests

All Tests

npm test

Output:

PASS  lib/api/__tests__/canonicalization.test.ts
  Canonicalization
    ✓ should produce deterministic output (3 ms)
    ✓ should sort object keys (2 ms)
    ✓ should handle nested objects (1 ms)
    ✓ should preserve array order (1 ms)
    ✓ should handle Unicode characters (2 ms)
    
PASS  lib/api/__tests__/signatures.test.ts
  Digital Signatures
    ✓ should generate Ed25519 key pair (45 ms)
    ✓ should sign and verify payload (12 ms)
    ✓ should detect tampering (8 ms)
    
Test Suites: 3 passed, 3 total
Tests:       24 passed, 24 total
Snapshots:   0 total
Time:        2.456 s

Watch Mode

Automatically re-run tests on file changes

npm test:watch

Coverage Report

npm test:coverage

Output:

---------------------------|---------|----------|---------|---------|
File                       | % Stmts | % Branch | % Funcs | % Lines |
---------------------------|---------|----------|---------|---------|
All files                  |   94.23 |    91.67 |   96.15 |   94.12 |
 canonicalization.ts       |   96.77 |    93.75 |  100.00 |   96.67 |
 signatures.ts             |   92.31 |    90.00 |   93.33 |   92.00 |
---------------------------|---------|----------|---------|---------|

Writing Tests

Test structure and best practices

import { describe, it, expect } from '@jest/globals'
import { canonicalizePayload, hashPayload, verifyHash } from '../canonicalization'

describe('Canonicalization', () => {
  it('should produce deterministic output', () => {
    const payload = { z: 1, a: 2, m: 3 }
    const canonical1 = canonicalizePayload(payload)
    const canonical2 = canonicalizePayload(payload)
    
    expect(canonical1).toBe(canonical2)
    expect(canonical1).toBe('{"a":2,"m":3,"z":1}')
  })

  it('should generate consistent hashes', () => {
    const payload = { model: 'gpt-4', version: '1.0' }
    const hash1 = hashPayload(payload)
    const hash2 = hashPayload(payload)
    
    expect(hash1).toBe(hash2)
    expect(hash1).toMatch(/^[a-f0-9]{64}$/) // SHA-256 hex
  })

  it('should verify hashes correctly', () => {
    const payload = { accuracy: 0.97 }
    const hash = hashPayload(payload)
    
    expect(verifyHash(payload, hash)).toBe(true)
    expect(verifyHash({ accuracy: 0.96 }, hash)).toBe(false)
  })
})

Testing Guide

How to run and write tests for the CIAF-LCM system

Quick Start

cd ui

# Install dependencies (if not already done)
npm install

# Run all tests
npm test

# Run tests in watch mode (recommended for development)
npm test:watch

# Run tests with coverage report
npm test:coverage

Test Structure

ui/lib/api/__tests__/
├── canonicalization.test.ts    # Hashing and canonicalization
├── signatures.test.ts          # Digital signatures
└── integration.test.ts         # Full workflows

Test Categories

1. Unit Tests

Canonicalization & Signature Tests

Canonicalization Tests

Deterministic JSON canonicalization

Key sorting and ordering

Nested object handling

Array preservation

Hash consistency across runs

Hash verification (timing-safe comparison)

Edge cases: empty objects, deep nesting, Unicode, large payloads

Signature Tests

Ed25519 key generation

RSA key generation

Signing and verification

Tamper detection

Invalid signature rejection

Wrong key rejection

Payload signing (canonicalization + signature)

Public key fingerprinting

2. Integration Tests

End-to-end workflow testing

Receipt Creation and Verification

Create receipt → Hash → Sign → Verify

Detect payload tampering

Vault Object Sealing

Seal vault object → Verify seal

Timestamp validation

Lineage Chains

Create predecessor → Create successor → Verify link

Hash referencing in lineage

Audit Pack Assembly

Assemble pack with multiple items

Verify pack hash

Verify all included items

Running Tests

All Tests

npm test

Output:

PASS  lib/api/__tests__/canonicalization.test.ts
  Canonicalization
    ✓ should produce deterministic output (3 ms)
    ✓ should sort object keys (2 ms)
    ✓ should handle nested objects (1 ms)
    ✓ should preserve array order (1 ms)
    ✓ should handle Unicode characters (2 ms)
    
PASS  lib/api/__tests__/signatures.test.ts
  Digital Signatures
    ✓ should generate Ed25519 key pair (45 ms)
    ✓ should sign and verify payload (12 ms)
    ✓ should detect tampering (8 ms)
    
Test Suites: 3 passed, 3 total
Tests:       24 passed, 24 total
Snapshots:   0 total
Time:        2.456 s

Watch Mode

Automatically re-run tests on file changes

npm test:watch

Coverage Report

npm test:coverage

Output:

---------------------------|---------|----------|---------|---------|
File                       | % Stmts | % Branch | % Funcs | % Lines |
---------------------------|---------|----------|---------|---------|
All files                  |   94.23 |    91.67 |   96.15 |   94.12 |
 canonicalization.ts       |   96.77 |    93.75 |  100.00 |   96.67 |
 signatures.ts             |   92.31 |    90.00 |   93.33 |   92.00 |
---------------------------|---------|----------|---------|---------|

Writing Tests

Test structure and best practices

import { describe, it, expect } from '@jest/globals'
import { canonicalizePayload, hashPayload, verifyHash } from '../canonicalization'

describe('Canonicalization', () => {
  it('should produce deterministic output', () => {
    const payload = { z: 1, a: 2, m: 3 }
    const canonical1 = canonicalizePayload(payload)
    const canonical2 = canonicalizePayload(payload)
    
    expect(canonical1).toBe(canonical2)
    expect(canonical1).toBe('{"a":2,"m":3,"z":1}')
  })

  it('should generate consistent hashes', () => {
    const payload = { model: 'gpt-4', version: '1.0' }
    const hash1 = hashPayload(payload)
    const hash2 = hashPayload(payload)
    
    expect(hash1).toBe(hash2)
    expect(hash1).toMatch(/^[a-f0-9]{64}$/) // SHA-256 hex
  })

  it('should verify hashes correctly', () => {
    const payload = { accuracy: 0.97 }
    const hash = hashPayload(payload)
    
    expect(verifyHash(payload, hash)).toBe(true)
    expect(verifyHash({ accuracy: 0.96 }, hash)).toBe(false)
  })
})