HumanReviewed Attestation Spec v0.1
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.
| Field | Type | Meaning |
|---|---|---|
| artefact_hash | bytes32 | sha256 of the canonical JSON of the reviewed artefact |
| artefact_uri | string | Optional public locator (https://, ipfs://, ar://) |
| agent_id | string | Namespaced agent id, e.g. agent.broadbrand.ai/content |
| agent_run_id | string | Unique id of the generation run |
| review_kind | uint8 | glance (0), reviewed (1), revised (2), endorsed (3), rejected (4) |
| review_scope | string | Role of the review, e.g. editorial, medical-secondary |
| signer_identity_uid | bytes32 | UID of the signer's identity attestation (sibling schema) |
| signer_tier | uint8 | email (0), sso (1), org_attested (2), kyc (3) |
| signer_role | string | Optional, e.g. Senior Editor, MD attending |
| reviewed_at | uint64 | Unix seconds, signer-claimed |
| attested_at | uint64 | Unix seconds, issuance time |
| policy_uri | string | Optional link to the review policy applied |
| prior_attestation | bytes32 | Optional, 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:
- verifiedValid, positive, non-revoked, signer tier adequate. The only ok: true status.
- rejected_reviewValid attestation, but the human rejected the artefact.
- revokedRevoked on chain.
- tier_unmetSigner identity below the required tier.
- identity_missingReferenced identity could not be resolved.
- invalidFailed structural validation, or claims a tier the identity does not support.
- not_foundNo attestation for the UID.
The verifier also walks prior_attestation links to build a revision chain, cycle-guarded and depth-limited.
Tiers
| Tier | Verification | Badge colour |
|---|---|---|
| Verified email via magic link | grey #6b7280 | |
| sso | Google / Microsoft / Apple SSO | blue #2563eb |
| org_attested | Domain-verified org vouches | green #16a34a |
| kyc | Government ID via a KYC provider | gold #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.