Skip to content
VERASPEC
Repository
Registry 1 · snapshot 1

The VER Registry

A record that uses a token outside the sixteen the specification defines must name the snapshot that registers it. Seeding is not opening, and the distinction is the point.

4Value spaces32 entries
2026-08-25Snapshot datesnapshot 1
NamespaceValue spaceStatusEntries
provenance_actionprovenance.chain[].actionopen16
perceptual_algidentity.perceptual[].algseeded-closed2
source_classembeddings[].source.classseeded-closed8
segment_familymetadata.raw[].segmentseeded-closed6
Registry policy and governanceThe snapshot itself
record fragment
"provenance": {
"registry": {
"registry_version": "1",
"snapshot": 1,
"sha256": "f6306609bb82062f3e4eca77f98e20d8dcd394af2c94f381ed45a34b1478e629"
},
"chain": [ { "action": "normalize" } ]
}
provenance.chain[].action

provenance_action

Opened by VER 1.1 draft §2.3 (ADR-0004): provenance.chain[].action is a constrained string rather than an enum, and a bare token outside the sixteen this specification defines MUST be an active entry of the snapshot the Record names in provenance.registry. This is the only one of the four value spaces the 1.1 draft opens. The opening ships with §2.3, which does not ratify until ADR-0004's conditions C1-C5 are satisfied.

TokenStatusRegisteredTierDefinition
decodeactive1.0coreThe Asset was decoded to a pixel buffer.VER 1.1 draft §2.3
normalizeactive1.0coreCPNP-1 was executed, producing the Canonical Buffer.VER 1.1 draft §2.3
embedactive1.0coreOne or more vectors were computed.VER 1.1 draft §2.3
transcodeactive1.0coreThe Asset was re-encoded into another container or codec without geometric or tonal change.VER 1.1 draft §2.3
redactactive1.0coreMetadata was removed or replaced under 1.0 §7.5.VER 1.1 draft §2.3
importactive1.0coreThe Asset entered the Producer's custody.VER 1.1 draft §2.3
publishactive1.1specification-registeredThe Record, or a projection of it, was made available to parties outside the Producer.VER 1.1 draft §2.3
exportactive1.1specification-registeredA rendition of the Asset was written out for consumption elsewhere.VER 1.1 draft §2.3
composeactive1.1specification-registeredTwo or more Assets were combined into this one. Requires a `lineage` block (§3).VER 1.1 draft §2.3
upscaleactive1.1specification-registeredResolution was increased, by interpolation or by a model.VER 1.1 draft §2.3
cropactive1.1specification-registeredA sub-rectangle was selected.VER 1.1 draft §2.3
resizeactive1.1specification-registeredDimensions were changed without cropping.VER 1.1 draft §2.3
color_adjustactive1.1specification-registeredTonal or colour values were altered (grade, curve, white balance).VER 1.1 draft §2.3
denoiseactive1.1specification-registeredA noise-reduction operator was applied.VER 1.1 draft §2.3
generateactive1.1specification-registeredPixel content was produced by a model rather than captured or edited.VER 1.1 draft §2.3
signactive1.1specification-registeredA detached signature was computed over the Record and recorded in `provenance.signature` (E17). The event's `at` is the signing time and its `actor` is the signer.VER 1.1 draft §2.3, §2.3.3
identity.perceptual[].alg

perceptual_alg

Seeded, not opened. Draft §2.4 keeps identity.perceptual[].alg a closed two-value enum in the schema and states the intent to open alg and segment in the same revision that publishes the registry. Registering an algorithm here does not admit it into a Record: until that revision a new algorithm still requires a schema revision.

TokenStatusRegisteredDigest bitsInputParametersDefinition
pdq/1.0active1.0256The Canonical Buffer (§4), never the Asset bytes and never a re-decoded or resized intermediate other than the algorithm's own defined preprocessing.PDQ as published by Meta's ThreatExchange reference implementation, with that implementation's bit order, rendered as 64 lowercase hex characters.PDQ perceptual hash of the Canonical Buffer; a 256-bit digest carried as exactly 64 lowercase hexadecimal characters.VER 1.0 §5; VER 1.0.1 errata annex E22
phash-dct/64active1.064The Canonical Buffer (§4), never the Asset bytes and never a re-decoded or resized intermediate other than the algorithm's own defined preprocessing.the 64-bit DCT perceptual hash in the form produced by the `imagehash` reference implementation (32×32 luminance DCT, 8×8 low-frequency block, median threshold, row-major, most-significant-bit first), rendered as 16 lowercase hex characters.The 64-bit DCT perceptual hash of the Canonical Buffer, carried as exactly 16 lowercase hexadecimal characters.VER 1.0 §5; VER 1.0.1 errata annex E22
embeddings[].source.class

source_class

Seeded, not opened, with one condition beyond the other two spaces. Draft §2.4: source.class "additionally requires a grade assignment for each new class (E19) and MUST NOT be opened before the grade table is registry-backed." This snapshot carries the grade table — every entry below states its grade — which is the carriage half of that condition. The value space itself stays closed until the revision that opens it does so. Seeding is not opening.

TokenStatusRegisteredGradeDefinition
ocr_pixelsactive1.0AText recognized from the Asset's own pixels.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
caption_autoactive1.0A-A caption or description generated by a model from the Asset.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
caption_humanactive1.0BA caption or description written by a person about the Asset.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
alt_textactive1.0BThe alternative text published with the Asset by the page or platform that carried it.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
titleactive1.0BThe title published with the Asset.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
descriptionactive1.0BThe description published with the Asset.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
surrounding_textactive1.0CText adjacent to the Asset in the page or document that carried it.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
page_contextactive1.0CText describing the page or document that carried the Asset rather than the Asset itself.VER 1.0 §8; VER 1.0.1 errata annex E19 (grade)
metadata.raw[].segment

segment_family

Seeded, not opened. Draft §2.4 keeps metadata.raw[].segment a closed six-value enum in the schema; opening is deferred to the same revision that publishes the registry. Registering a family here does not admit it into a Record.

TokenStatusRegisteredAvailability keyDefinition
exifactive1.0exifExif metadata, as carried in the Asset's Exif segment.VER 1.0 §7.1; VER 1.0.1 errata annex E21
xmpactive1.0xmpAn XMP packet.VER 1.0 §7.1; VER 1.0.1 errata annex E21
iptc-iimactive1.0iptcIPTC IIM metadata, the legacy IIM record set.The availability key for this family is spelled iptc; the two spellings denote one family and a Consumer MUST treat them as equivalent (E21).VER 1.0 §7.1; VER 1.0.1 errata annex E21
iccactive1.0iccAn embedded ICC colour profile.VER 1.0 §7.1; VER 1.0.1 errata annex E21
c2paactive1.0c2paA C2PA manifest store.VER 1.0 §7.1; VER 1.0.1 errata annex E21
otheractive1.0nullA preserved metadata segment belonging to none of the five named families.VER 1.0 has no availability key for this family, so a preserved other segment carries no availability state under 1.0.x (E21); draft §10.3 adds the key at 1.1.VER 1.0 §7.1; VER 1.0.1 errata annex E21
Beside the registry

What a claim can be measured against

A tolerance is only a claim if there is a set to measure it against, and a cross-producer pixel hash is only a claim if two decoders were evaluated against the same corpus.