Documentation

AnchorRegistry™ Docs

Everything you need to understand, use, and build on AnchorRegistry — the immutable provenance registry for the AI era.

01

Getting started

AnchorRegistry is a permanent, on-chain provenance registry. Fill in a manifest, pay once, receive an AR-ID, and take custody of your Anchor Key — a permanent, cryptographic record that proves this artifact existed in this exact form at this exact moment, written to Base (Ethereum L2). No expiry. No account. No trust required.

What is an AR-ID?

An AR-ID is a permanent, unique, human and machine-readable identifier for any registered artifact. Format: AR-{YYYY}-{7-char hash}. Every AR-ID resolves to a full provenance record.

Two resolution paths
# Human
anchorregistry.com/verify/AR-2026-K7X9M2P

# Machine (AI agents, pipelines, APIs)
anchorregistry.ai/AR-2026-K7X9M2P

How to register

01
Choose type

Pick from 21 artifact types across 7 groups.

02
Fill manifest

Title, author, descriptor, type-specific fields.

03
Anchor Key

Your private key. Controls your provenance tree. Save it.

04
Pay & anchor

$5. Hash computed in browser. Nothing uploaded.

Embed tags

Once anchored, embed your AR-ID in the artifact itself. These tags are the distribution mechanism — every artifact becomes a permanent, distributed proof node that any human or AI can resolve.

Two watermark standards
# Software artifacts (code, packages, repos)
SPDX-Anchor: anchorregistry.ai/AR-2026-K7X9M2P

# Everything else (research, data, models, media)
DAPX-Anchor: anchorregistry.ai/AR-2026-K7X9M2P

What is stored on-chain vs off-chain?

On-chain (Ethereum · permanent)
Off-chain (Supabase · rebuildable)
AR-ID, manifest hash, parent hash
Title, author notes, tag fields
Artifact type, descriptor
Full manifest JSON
Tree ID, registrant address
Stripe payment linkage
Block timestamp
Verify page rendering cache

If all off-chain infrastructure disappears, the complete registry is recoverable from Ethereum events alone using anchorid recover. Ethereum is the ground truth.

02

Use cases

Every use case is the same fundamental problem: prove something existed, in this exact form, at this exact moment, and that it has not been altered since. Twenty-one artifact types. Five verticals. One registry.

01

IP Provenance

Developers, researchers, creators, freelancers

In a world where AI generates everything, proving you made something first is increasingly critical. AnchorRegistry gives every digital artifact a permanent, tamper-proof timestamp anchored to Ethereum.

Artifact types

CODE · RESEARCH · DATA · MODEL · AGENT · MEDIA · TEXT · POST

IP Provenance · example tree

CODEAR-2026-K7X9M2PUniswapPy v1.0rootRESEARCHAR-2026-N3P8Q1RDeFi WhitepaperchildPOSTAR-2026-W5T2X9YLaunch announcementchildMODELAR-2026-·······DeFiMind v1grandchildSPDX-Anchor: anchorregistry.ai/AR-2026-K7X9M2P · permanent prior art

02

Audit Trail

Consultants, advisory firms, compliance teams, law firms

Professional deliverables live in email threads and shared drives that can be altered or denied. AnchorRegistry makes the full engagement record — reports, notes, events — permanent and independently verifiable.

Artifact types

REPORT · NOTE · EVENT

Audit Trail · example tree

REPORTAR-2026-K7X9M2PESG Assessment Q1root · Hive AdvisoryNOTEAR-2026-N3P8Q1RKickoff meeting2026-01-15REPORTAR-2026-W5T2X9YDraft assessment v1version · draftEVENTAR-2026-P9K4M7QClient sign-off2026-03-10NOTEAR-2026-·······Client feedbackcorrespondenceREPORTAR-2026-·······Final deliveredversion · finalone treeId · one query · complete engagement history

03

AI Compliance

AI companies, enterprises deploying agents, regulators

When an autonomous system takes an action there is currently no permanent, tamper-proof record of what version of what model was running at that moment. AnchorRegistry is the infrastructure layer for that proof.

Artifact types

MODEL · AGENT · DATA · EVENT (MACHINE · AGENT)

AI Compliance · example tree

DATAAR-2026-K7X9M2PTraining dataset v2.1rootMODELAR-2026-N3P8Q1RDeFiMind v1.2childEVENTAR-2026-W5T2X9YTraining runexecutor · MACHINEAGENTAR-2026-·······DeFiMind agent v1.2grandchildimmutable proof · what model · what version · what action · when

04

Scientific Reproducibility

Researchers, clinical trial teams, academic institutions

Pre-registration exists but relies on centralised platforms that can be compromised or defunded. Anchoring a study protocol before results are known creates cryptographic proof the hypothesis predated the data.

Artifact types

RESEARCH · DATA · CODE · EVENT

Scientific Reproducibility · example tree

RESEARCHAR-2026-K7X9M2PStudy protocol v1.0root · pre-registrationDATAAR-2026-N3P8Q1RRaw datasetpre-analysisCODEAR-2026-W5T2X9YAnalysis scriptsv1.0RESEARCHAR-2026-·······Final paperpublishedhypothesis anchored before data collected · no p-hacking possible

05

Transaction Records

CFOs, accounting firms, procurement teams, insurance, government

Business transaction records live in systems that can be altered, disputed, and lost. AnchorRegistry makes the financial audit trail permanent and verifiable by any auditor independently — no request to AR required.

Artifact types

RECEIPT · REPORT · NOTE · EVENT

Transaction Records · example tree

REPORTAR-2026-K7X9M2PQ1 2026 Expensesroot · batchRECEIPTAR-2026-N3P8Q1RTravel · FebPURCHASE · $2,340RECEIPTAR-2026-W5T2X9YSoftware licencesPURCHASE · $890NOTEAR-2026-P9K4M7QExpense policy v2.1policy refEVENTAR-2026-·······CFO sign-off2026-03-31one treeId covers the full accounting period · audit-ready instantly

03

Artifact types

Twenty-one types across seven logical groups. All types (0–12, 16–20) are active at launch. Gated types (13–15) require verification infrastructure and open progressively in V2–V4.

#
Type
Group
Status
0
CODE
Repos, packages, commits, scripts.
Content
active
1
RESEARCH
Papers, whitepapers, preprints, theses.
Content
active
2
DATA
Datasets, benchmarks, databases.
Content
active
3
MODEL
AI models, weights, checkpoints.
Content
active
4
AGENT
AI agents, bots, assistants.
Content
active
5
MEDIA
Video, audio, images, photography.
Content
active
6
TEXT
Blogs, articles, books, essays.
Content
active
7
POST
Tweets, social posts, Farcaster casts.
Content
active
8
ONCHAIN
Addresses, transactions, NFTs, DAOs.
Content
active
9
REPORT
Consulting, compliance, ESG, audit reports.
Content
active
10
NOTE
Memos, meeting notes, correspondence, field notes.
Content
active
11
WEBSITE
Web pages, apps, online platforms.
Content
active
12
EVENT
Human events and machine/agent processes.
Lifecycle
active
13
RECEIPT
Purchase, medical, financial, government receipts.
Transaction
active
14
LEGAL
Contracts, patents, filings, disclosures.
Gated
v2
15
ENTITY
Verified persons, companies, AI systems.
Gated
v2
16
PROOF
ZK proofs, formal verifications, security audits.
Gated
v4
17
SEAL
Tree sealed — authentic, complete, permanent.
Self-service
active
18
RETRACTION
Owner-initiated anchor retraction.
Self-service
active
19
REVIEW
Soft flag — anchor under review.
Review
active
20
VOID
Hard finding — subtree condemned.
Review
active
21
AFFIRMED
Exoneration — review resolved.
Review
active
22
ACCOUNT
Billing account with anchor capacity.
Billing
active
23
OTHER
Anything that does not fit above.
Catch-all
active
EVENT — dual executor

EVENT is the only type with a required executor field, making it dual-use: human lifecycle events and machine/agent processes share one type.

executor: HUMAN   → conferences, launches, governance votes, milestones
executor: MACHINE → training runs, deployments, builds, inference jobs
executor: AGENT   → agent-initiated tasks, pipeline runs, evaluations
RECEIPT — six subtypes

RECEIPT handles all transaction categories via a receiptType field: PURCHASE | MEDICAL | FINANCIAL | GOVERNMENT | EVENT | SERVICE. Amount is stored as a string to preserve decimal precision.

04

The provenance tree

Most registries are flat. AnchorRegistry is not. Every anchor can reference a parent via the parentHash field, creating a directed acyclic graph — a traversable provenance tree. Any registered artifact is a node. The root AR-ID resolves the full tree.

The tree token

Every node in a tree carries the same treeId — a cryptographic token derived as:

Tree token derivation
treeId = sha256(anchorKey + rootArId)

# anchorKey  — your private key, never sent to AnchorRegistry
# rootArId   — the AR-ID of the root anchor in your tree

Not your keys, not your trees.

AnchorRegistry never stores, transmits, or has access to your Anchor Key. It is generated in your browser and never leaves it. Because the treeId is derived from your key, AR cannot compute it, cannot read which trees you own, and cannot impersonate you. Self-custody is structural, not a policy.

Tree permissions

CLOSEDDefault. Only the owner can add children. No one else can attach to your tree.
OPENAnyone can add a child to any node. Useful for public, collaborative lineage.
WHITELISTEDSpecific addresses approved by the owner can add children.

Tree recovery

Given any single AR-ID as an entry point, the full provenance tree is recoverable in O(n) time. Walk up via parentHash to find the root, then BFS/DFS down using the reverse index. The treeId index makes the whole tree retrievable in one query.

One-query tree retrieval
SELECT * FROM anchors_all
WHERE tree_id = '<treeId>'
ORDER BY block_timestamp ASC

AR dispute trees

All REVIEW, VOID, and AFFIRMED anchors registered by AnchorRegistry carry a reserved tree ID: ar-operator-v1. This separates AR dispute actions from tree holder actions on-chain, making the dispute chain independently queryable and auditable by anyone.

05

Security & trust

The governing principle:

Worst case is always time, never data loss.

Access control

Four role tiers govern the contract. No single key can act unilaterally against both owner and recovery address simultaneously.

OwnerGovernance only. Add/remove operators. Transfer ownership. Cancel recovery. Cannot register anchors.
OperatorRegistration only. All register() functions for active types. Cannot touch governance.
Recovery addressLast resort. Initiate and execute ownership transfer after 7-day timelock. Can rotate itself.
Gated operatorsLegal, Entity, Proof — each can only call their single register function. No operators at deployment.

7-day recovery timelock

The recovery mechanism is a 7-day timelocked ownership transfer initiated by the recovery address. The owner can cancel any in-flight recovery at any time. Every sensitive operation emits an on-chain event visible on Etherscan in real time. A 7-day lockout after cancellation prevents griefing.

Can a record be deleted?

No. The contract is append-only. Records are permanent and cannot be modified or deleted by anyone — including AnchorRegistry. Retraction attaches a new RETRACTION node; the original record remains on-chain permanently.

Can a record be faked?

The manifest hash is SHA-256 of your full manifest fields bound to your Anchor Key. The contract enforces uniqueness — AlreadyRegistered() reverts any duplicate hash. First registration wins permanently.

The dispute system

REVIEWSoft flag. Anchor is under investigation. 14-day response window for both parties.
VOIDHard finding. Attached to the parent of the fraud origin. Cascades down the subtree.
AFFIRMEDExoneration. Resolves a REVIEW or VOID. Tree is cleared. treeId query returns clean.

Every enforcement decision is logged on-chain permanently via the ar-operator-v1 tree ID. AnchorRegistry cannot act in secret. The full dispute chain is always public and queryable by anyone.

06

FAQ

Is there an AnchorRegistry token?

No. There is no token, no coin, no airdrop, and no plans for any. AnchorRegistry is infrastructure — the blockchain is the ledger, not the product. The fee you pay is for permanent on-chain registration, not for a speculative asset. This is a notary service, not a protocol.

Is this an NFT?

No. There is no token, no secondary market, and no speculation. AnchorRegistry is a notary service — you are registering proof that an artifact existed in a specific form at a specific moment. The record lives on Ethereum. Nothing is minted.

How is the manifest hash generated?

There is no file upload. The manifest hash is SHA-256 of your artifact metadata — type, title, author, descriptor, type-specific fields, and your Anchor Key — computed entirely in your browser. The hash is a cryptographic fingerprint of what you declared, bound to your private key. Nothing leaves your browser except the hash itself.

What does AnchorRegistry store in its database?

Supabase stores the metadata needed to serve your verify page quickly: AR-ID, artifact type, title, author, descriptor, manifest hash, parent hash, tree ID, type-specific fields, block timestamp, and transaction hash. It also stores your Stripe payment reference (session ID) and, if you provided one, your email address for token recovery. Supabase is a fast-query cache — it is entirely rebuildable from Ethereum events if lost. AnchorRegistry does not store your Anchor Key under any circumstances. It is never sent to our servers.

What is the Anchor Key and why does it matter?

The Anchor Key is a private key you generate and hold. Your tree token — sha256(anchorKey + rootArId) — is derived from it and stored on every node in your tree. This means only you can prove ownership of your tree. AnchorRegistry never has access to your Anchor Key and cannot read who owns a given tree. Not your keys, not your trees.

What if I lose my Anchor Key?

Your anchored records are permanent and unaffected — they cannot be deleted. You would lose the ability to prove tree ownership and add new nodes to that tree. Save your Anchor Key. It cannot be recovered. A token recovery flow (V1.5) will allow you to recover your AR-ID ownership token via Stripe email verification.

I lost my AR-ID. Can I recover it?

Yes, and it costs nothing. The manifest hash is fully deterministic — it is SHA-256 of your manifest fields and your Anchor Key. If you have your Anchor Key and remember what you registered, recompute the hash in your browser and look it up via GET /verify/hash/{manifest_hash}. Your AR-ID resolves instantly from the hash. The Anchor Key is the master recovery credential — the AR-ID is just a pointer to the record it unlocks.

Can I retract a registration?

Yes. Retraction is a self-service operation ($2) that attaches a RETRACTION anchor to the original record. All blockchain records are permanent and cannot be deleted — that is by design. What retraction does is signal intent: the resolution layer reads the latest state of your provenance tree and renders it accordingly, so a retracted anchor is surfaced as retracted and a replacement AR-ID, if provided, is followed automatically. The tree always reflects your most current preference. The on-chain record of everything that happened remains intact and auditable.

Is this legal proof in court?

AnchorRegistry provides a timestamped, cryptographic, independently verifiable record of what existed and when. It is strong prior art evidence and has been compared to a notary stamp with a blockchain witness. We are not lawyers and this is not legal advice. Consult counsel for your specific jurisdiction.

What chain is this on?

Base — Ethereum L2 by Coinbase. Fast, cheap, and settled to Ethereum mainnet. The contract is deployed once and cannot be modified. The contract address alone is sufficient to reconstruct the entire registry.

What's the difference between anchorregistry.com and anchorregistry.ai?

anchorregistry.com is the full human-facing product — registration, verify pages, docs. anchorregistry.ai is the machine-readable endpoint optimised for AI agents and pipelines. Embed anchorregistry.ai/AR-ID in any artifact and any AI or human can resolve it in one request.

What happens if AnchorRegistry shuts down?

Nothing happens to your records. They are on Ethereum permanently. The contract address is the registry — anyone can query it directly via Etherscan or any Ethereum RPC endpoint. The open-source anchorid CLI includes a recovery command that reconstructs the full registry from on-chain events alone, with no dependency on our infrastructure.

Will my record exist in 50 years?

As long as Ethereum exists, yes. Base settles to Ethereum mainnet. There are no renewals, no subscriptions, and no expiry. One payment. Permanent record.

How do AI agents use this?

AI agents query api.anchorregistry.ai/verify/{ar_id} to resolve any AR-ID to a full provenance record. The SPDX-Anchor and DAPX-Anchor tags embedded in artifacts are the resolution triggers. When an agent encounters one of these tags it can resolve the full provenance tree, verify the manifest hash against the artifact it holds, and determine trust level.

How does AnchorRegistry handle fraudulent trees?

Every flag is reviewed by a human and triggers a REVIEW anchor — a soft on-chain flag that marks the anchor as contested and opens a 14-day response window for both parties. If fraud is confirmed, a VOID anchor is attached to the parent of the fraud origin and cascades down the subtree, disabling resolution while leaving the original records permanently visible on-chain. If the finding is overturned on appeal, an AFFIRMED anchor reinstates the tree — a tree that has been challenged, investigated, and vindicated carries the strongest possible trust signal.

Can the same artifact be registered twice?

No. The contract enforces uniqueness on manifestHash. AlreadyRegistered() reverts any duplicate. First registration wins — permanently, on-chain.

Still have questions?

The contract source is fully open. github.com/anchorregistry/ar-onchain. Or reach us at support@anchorregistry.com.