HumanReviewed.org
Specification

HumanReviewed Attestation Spec v0.1

v0.1 current version All versions

The open standard for attesting that a named human reviewed an AI-agent artefact. It is implemented in @humanreviewed/spec and verified by @humanreviewed/verifier. Anyone may reimplement either against EAS on Base; this document and those two packages are the reference.

The attestation

A HumanReviewed attestation is an EAS attestation conforming to the HumanInLoopAttestation schema. Field order and types are part of the schema UID and are frozen once registered on mainnet.

FieldTypeMeaning
artefact_hashbytes32sha256 of the canonical JSON of the reviewed artefact
artefact_uristringOptional public locator (https://, ipfs://, ar://)
agent_idstringNamespaced agent id, e.g. agent.broadbrand.ai/content
agent_run_idstringUnique id of the generation run
review_kinduint8glance (0), reviewed (1), revised (2), endorsed (3), rejected (4)
review_scopestringRole of the review, e.g. editorial, medical-secondary
signer_identity_uidbytes32UID of the signer's identity attestation (sibling schema)
signer_tieruint8email (0), sso (1), org_attested (2), kyc (3)
signer_rolestringOptional, e.g. Senior Editor, MD attending
reviewed_atuint64Unix seconds, signer-claimed
attested_atuint64Unix seconds, issuance time
policy_uristringOptional link to the review policy applied
prior_attestationbytes32Optional, links a revision to its predecessor

Identity is a separate attestation (the SignerIdentity schema), so a signer is verified once and reused across many artefacts.

Canonical hashing

artefact_hash = sha256(canonicalJSON(artefact)). Canonical JSON sorts object keys lexicographically at every level, drops undefined properties, and rejects non-finite numbers. Two parties hashing the same logical artefact get the same hash, which is what lets a verifier confirm a badge belongs to the content in front of them. See canonicalize and hashArtefact in @humanreviewed/spec.

Verification

Given a UID, the reference verifier resolves the attestation and its signer identity through an AttestationReader and returns one of:

The verifier also walks prior_attestation links to build a revision chain, cycle-guarded and depth-limited.

Tiers

TierVerificationBadge colour
emailVerified email via magic linkgrey #6b7280
ssoGoogle / Microsoft / Apple SSOblue #2563eb
org_attestedDomain-verified org vouchesgreen #16a34a
kycGovernment ID via a KYC providergold #d4af37

A verifier may require a minimum tier; an attestation may never claim a tier stronger than its identity supports.

The load-bearing property

The verify result depends only on chain state and this spec, never on the issuer’s backend. Anyone can reproduce a verdict by reading EAS on Base directly. That is what makes HumanReviewed a standard rather than a vendor lock-in.