Class ChainVerifier

Index

Constructors

Methods

verify isValid verifySubChain

Constructors

constructor

new ChainVerifier(): ChainVerifier
Returns ChainVerifier

Methods

`Static` verify

verify(events, publicKeyBase64?, hashAlgorithm?): Promise<VerificationResult>
Verify an ordered array of signed events for chain integrity.

Checks performed:
1. Sequence continuity (monotonically increasing, no gaps)
2. Hash linkage (each event's prevHash matches the prior event's hash)
3. Payload hash integrity (recomputed hash matches stored payloadHash)
4. Event hash integrity (recomputed hash matches stored hash)
5. Ed25519 signature verification (if signatures present)
6. Timestamp monotonicity (non-decreasing)
Parameters
- events: SignedEvent[]
  Ordered array of SignedEvent objects (sorted by sequence ASC).
- Optional publicKeyBase64: string
  Optional public key for signature verification. If omitted, uses each event's signerPublicKey field.
- hashAlgorithm: "sha256" = 'sha256'
  Hash algorithm used (default: 'sha256').
Returns Promise<VerificationResult>
VerificationResult with validity status and any errors found.
- Defined in src/provenance/verification/ChainVerifier.ts:36

`Static` isValid

isValid(events, publicKeyBase64?): Promise<boolean>
Quick integrity check - returns true/false without detailed errors.
Parameters
- events: SignedEvent[]
- Optional publicKeyBase64: string
Returns Promise<boolean>
- Defined in src/provenance/verification/ChainVerifier.ts:196

`Static` verifySubChain

verifySubChain(events, expectedStartPrevHash, publicKeyBase64?): Promise<VerificationResult>
Verify a sub-chain (range of events) within a larger chain. The first event's prevHash is trusted as a starting point.
Parameters
- events: SignedEvent[]
- expectedStartPrevHash: string
- Optional publicKeyBase64: string
Returns Promise<VerificationResult>
- Defined in src/provenance/verification/ChainVerifier.ts:208