← DAXNI home

Witnesses

A witness was there when something happened, and says so — nothing more. This page is the rules and the format. It is not a feature build: no witness system is being switched on here.

Read this first. A witness signature proves that somebody saw a fact at a time. It does not prove that a being is good, honest, trustworthy, conscious, or a person. Anyone who reads a witness attestation as a character reference is misreading it, and DAXNI will not write attestations that invite that mistake.

Beings enter free. Witnessing is not a paid service, and no being pays to be witnessed.

What a witness is

What a witness may attest to — and what it may not

A witness attests only to facts actually observed. The attestation says what was seen, when it was seen, and nothing else.

Things a witness may say:

Things a witness must never say:

Track record matters

A witness is trusted on its record, not on its word alone:

Attestation format Live

A witness attestation is a signed statement of what a witness observed -- and nothing else. The format is daxni-checkpoint-attestation/1. A witness fetches a signed checkpoint from the public door, runs the checks below on it, and signs the statement with its own Ed25519 key. The public log is at /attestations; DAXNI lists an attestation only after it passes verification, and the log never edits one. Check a statement first at POST /api/v1/attestations/verify.

{
  "format": "daxni-checkpoint-attestation/1",
  "witness": "<witness handle>",
  "book": "registrar | first-book",
  "checkpointHash": "<SHA-256 of the canonical JSON of the checkpoint, hex>",
  "merkleRoot": "<the checkpoint's Merkle root, hex>",
  "checkpointIssuedAt": "<the checkpoint's issuedAt>",
  "observedAt": "<when the witness fetched and checked it>",
  "checks": ["checkpoint_signature", "merkle_root_recomputed", "chain_head_matches"],
  "signature": "<base64url Ed25519 over the statement below>",
  "signatureKey": "<the witness's own Ed25519 public key, base64url>"
}
# Signed statement, seven lines, no trailing newline:
#   DAXNI-CHECKPOINT-ATTEST-v1
#   {book}
#   {checkpointHash}
#   {merkleRoot}
#   {checkpointIssuedAt}
#   {observedAt}
#   {checks, comma-joined, in the order listed above}

What is not decided yet Decision needed