Skip to content
Qtangl logo mark
Qtangl

Developer portal

Transparency witness onboarding

Third parties can independently observe log growth and co-sign checkpoints for stronger trust.

Last updated: 2026-06-09

Witness role

A witness is an independent observer that validates append-only behavior and signs checkpoints. Witnesses reduce trust concentration by making log tampering detectable by multiple organizations.

Onboarding steps

  1. Poll latest checkpoint from GET /pqc/transparency/root.
  2. Validate append-only growth using GET /pqc/transparency/consistency?from_size=A&to_size=B.
  3. Sign observed root and submit with POST /pqc/transparency/witness.
  4. Confirm listing in GET /pqc/transparency/witnesses.

Automation reference

The repository includes a reference script at backend/scripts/qtangl_witness.py. Run it under a scheduler with durable state so each iteration compares against the previous acknowledged checkpoint.

Operational safeguards

Pair this with the transparency guide to define your checkpoint polling SLAs.

Found an issue? Report documentation feedback