Conformant verifiers and issuers.
Anyone may reimplement the standard. This page defines what an implementation has to do before it can call itself conformant. Requirement keywords follow RFC 2119: MUST, MUST NOT, SHOULD.
A conformant verifier
A verifier takes an attestation UID and produces a verdict. Its defining property is independence: the verdict is a pure function of chain state and the spec.
- MUSTReproduce the seven-status verdict table (verified, rejected_review, revoked, tier_unmet, identity_missing, invalid, not_found) from chain state and the spec alone. No issuer backend may be consulted, and a verdict must not depend on any private data.
- MUSTEnforce tier integrity: resolve the signer identity attestation and return invalid for any attestation that claims a signer tier stronger than the identity supports.
- MUSTWalk revision chains cycle-safe: follow prior_attestation links with cycle detection and a depth limit, and terminate on malformed or self-referential chains.
A conformant issuer
An issuer creates attestations. Its defining property is honesty about identity and content: it binds reviews to exact artefacts and never overstates who signed.
- MUSTHash artefacts canonically per the spec: artefact_hash is the sha256 of the artefact's canonical JSON, with keys sorted at every level, undefined dropped, and non-finite numbers rejected.
- MUST NOTClaim a signer tier above the identity's. The signer_tier field may never exceed the tier established by the referenced SignerIdentity attestation.
- SHOULDPublish policy URIs. When a review applies a policy or compliance-pack clause, policy_uri should reference it at a stable public URL so third parties can re-check conformance.
Reference implementations
The reference implementation is MIT-licensed TypeScript. Publication to the public npm registry is in progress; the package names below are the canonical ones.
@humanreviewed/spec
Types, the review-kind and signer-tier taxonomies, and canonical hashing (canonicalize, hashArtefact). The machine-readable half of the specification.
@humanreviewed/verifier
The reference verifier. Produces the seven-status verdict table, enforces tier integrity, and walks revision chains cycle-safe. Conformance means matching its verdicts.
@humanreviewed/eas-reader
An AttestationReader that resolves attestations from EAS on Base. Swap in any reader with the same interface to verify against your own node or indexer.