Content Credentials JSON (crJSON) File Format Specification
This work is licensed under a Creative Commons Attribution 4.0 International License.
1. Scope
This document describes a JSON serialization for Content Credentials (aka a C2PA manifest store) known as the Content Credentials JSON format (abbreviated crJSON). Its purpose is to provide a JSON-based representation of a C2PA manifest store with associated validation results for profile evaluation, interoperability testing, and validation reporting. This JSON representation is not intended to be a canonical source of cryptographic truth, or a general purpose machine readable Content Credentials format, but rather a derived view over C2PA data that is useful for export and interoperability purposes. It is not intended to be used as an input format for C2PA data, and it is not intended to be a lossless representation of all C2PA data. It is simply a specific JSON-LD serialization of information contained in a C2PA manifest store and its associated validation results.
2. Relationship to the Content Credentials Technical Specification
crJSON does not replace C2PA claims, JUMBF, or COSE structures. Instead, it is a derived JSON view over C2PA data, and not independently verifiable.
C2PA Asset/Manifest Store
-> Manifest extraction
-> Validation
-> crJSON transformation
|- @context
|- manifests[]
| |- label
| |- assertions{...}
| |- claim or claim.v2 (one required)
| |- signature (required)
| |- validationResults (required)
| |- ingredientDeltas (optional)
|- jsonGenerator
3. Serialization Requirements
3.1. Root Object
A crJSON document shall be a JSON-LD object.
The following top-level properties are used:
| Property | Presence | Description |
|---|---|---|
|
REQUIRED |
JSON-LD context. Schema allows object or array of URI strings. |
|
REQUIRED |
Array of manifest objects. Each item conforms to the manifest definition (required: label, assertions, signature, validationResults; one of claim or claim.v2). |
|
REQUIRED |
Information about the creation of the crJSON object itself, including the creator and time of creation. |
3.2. @context
crJSON uses a standard JSON-LD serialisation, and therefore shall contain a JSON-LD standard @context field whose value shall be either an object or an array listing terms (also known as namespaces) that are used in the crJSON. In the case of an object, the terms shall be listed as key-value pairs, where the key is the term name and the value is the URI of the term. As described in clause 4.1.2 of JSON-LD, the @vocab key can be used for the default vocabulary, as shown in Example of an object-based JSON-LD @context field. In the case of an array, only the URI is required since it shall apply to all terms not otherwise identified by a specific term, as shown in Example of an array-based JSON-LD @context field.
@context field{
"@context": {
"@vocab": "https://c2pa.org/crjson/",
"extras": "https://c2pa.org/crjson/extras/",
}
}
@context field{
"@context": [
"https://c2pa.org/crjson/"
]
}
Since crJSON may contain values that are specific to a given workflow, it is important that each one of these terms shall be defined in the @context field. This allows the crJSON document to be self-describing and non-conflicting ensuring that any consumer of the crJSON can understand the meaning of each term.
Since a @context element can appear inside of any object in JSON-LD, it is possible to have custom values, and their associated @context elements in multiple places throughout a single JSON-LD document, where the terms are localized to that specific object.
3.3. jsonGenerator
The jsonGenerator field is an object that contains information about the tool that generated the crJSON document. It shall contain the following fields:
-
name(required): the name of the tool that generated the crJSON document -
version(required): the version of the tool that generated the crJSON document, in SemVer 2.0 format
3.4. Manifests
A C2PA Manifest consists of, at least, a set of Assertions, Claims, and Claim Signatures that are bound together into a single entity. For all C2PA Manifests present in the C2PA Manifest Store, they shall be present in the manifests array. The order of the Manifests in the array shall match the reverse order that they are found in the Manifest Store, so that the active manifest is always first (i.e., manifests[0]). The manifests array shall be empty when the asset contains no C2PA Manifest Store.
Each manifest object shall include the following properties (per schema: required label, isUpdateManifest, isCompressedManifest, assertions, signature; exactly one of claim or claim.v2):
-
label(manifest label/URN) -
isUpdateManifest(true if update manifest) -
isCompressedManifest(true if compressed manifest) -
assertions(object keyed by assertion label) -
claim(v1, per C2PAclaim-map) orclaim.v2(v2, per C2PAclaim-map-v2) -
signature(signature and credential details object) -
validationResults(optional per-manifest validation status code groups) -
ingredientDeltas(optional per-manifest ingredient validation deltas)
The label field’s value is a string that identifies the C2PA Manifest using the label of its JUMBF box, such as urn:c2pa:2702fc84-a1ae-44d1-9825-dd86311e980b.
The isUpdateManifest field’s value is a boolean that is true if the manifest is an update manifest, and false if it is a standard manifest.
The isCompressedManifest field’s value is a boolean that is true if the manifest was compressed in the manifest store.
The manifest object does not allow additional properties (schema additionalProperties: false).
3.5. Claims
3.5.1. General
A Claim shall be serialised in the same manner as a CBOR serialised assertion. It shall be named based on the label of the claim box (e.g., claim or claim.v2). An example is found in A JSON-LD serialised claim.
"claim.v2": {
"dc:title": "MIPAMS test image",
"instanceID": "uuid:7b57930e-2f23-47fc-affe-0400d70b738d",
"claim_generator": "MIPAMS GENERATOR 0.1",
"alg": "SHA-256",
"signature": "self#jumbf=c2pa.signature",
"created_assertions": [
{
"url": "self#jumbf=c2pa.assertions/c2pa.actions.v2",
"hash": "APqpWkPm91k98DD03sIQ+uYGspG+bxdy0c7+FMu8puU="
},
{
"url": "self#jumbf=c2pa.assertions/c2pa.hash.data",
"hash": "A8wNdhjiIyOOkGg8+GkJRSYJALG6orPQJRQKMFtq/rc="
}
],
"gathered_assertions": [],
"redacted_assertions": []
},
3.5.2. claim.v2 (v2 claim)
claim.v2 conforms to the C2PA CDDL claim-map-v2. Required properties:
-
instanceID— uniquely identifies a specific version of an asset -
claim_generator_info— single generator-info map (object with e.g.name,version, optionalicon,operating_system,specVersion) -
signature— JUMBF URI reference to the signature of this claim (e.g.self#jumbf=/c2pa/{label}/c2pa.signature) -
created_assertions— array of one or more hashed URI maps; each entry hasurl,hash, and optionallyalg -
gathered_assertions— array of zero or more hashed URI maps (same structure as created_assertions); set to an empty array if it’s missing in the source -
redacted_assertions— array of zero or more JUMBF URI strings (references to redacted ingredient manifest assertions); set to an empty array if it’s missing in the source
Optional properties:
-
dc:title— name of the asset -
alg— cryptographic hash algorithm for data hash assertions (e.g.SHA-256) -
alg_soft— algorithm for soft binding assertions -
specVersion— specification version (SemVer) -
metadata— (DEPRECATED) additional information
All hash values in hashed URI maps shall be Base64 strings with b64' prefix and suffixed with a single '. (e.g., b64’VGhpcyBpcyBhIHRlc3Q=')
3.5.3. claim (v1 claim)
When a manifest uses claim instead of claim.v2, it conforms to the C2PA CDDL claim-map (claimV1). Required properties:
-
claim_generator— User-Agent string for the claim generator -
claim_generator_info— array of one or more generator-info maps -
signature— JUMBF URI reference to the signature -
assertions— array of one or more hashed URI maps (url,hash, optionalalg) -
dc:format— media type of the asset -
instanceID— uniquely identifies a specific version of an asset
Optional: dc:title, redacted_assertions (JUMBF URI strings), alg, alg_soft, metadata.
All hash values in hashed URI maps shall be Base64 strings with b64' prefix and suffixed with a single '.
3.6. Assertions
3.6.1. General
Each manifest object shall contain an assertions field whose value is an object keyed by assertion label. Each individual assertion shall be represented as an object, where the key is the label of the Assertion, and the value is an object containing the JSON-LD serialization derived from that Assertion. If it is not possible to derive information from an assertion, then the key shall be present in the assertions object, but its value shall be an empty object. Additionally, a generator may choose not to decode custom assertions, in which case it shall represent them as empty objects.
3.6.2. JSON-LD serialised assertions
For any Assertion which is serialised in the C2PA Manifest as JSON-LD, that exact same JSON-LD shall be used as the value for the assertion. For example, the c2pa.metadata assertion is expressed in XMP, that XMP data is serialised as JSON-LD.
An example c2pa.metadata assertion is shown in A JSON-LD serialised assertion.
"c2pa.metadata": {
"@context" : {
"Iptc4xmpExt": "http://iptc.org/std/Iptc4xmpExt/2008-02-29/",
"photoshop" : "http://ns.adobe.com/photoshop/1.0/"
},
"photoshop:DateCreated": "2022-08-31",
"Iptc4xmpExt:LocationCreated": {
"Iptc4xmpExt:City": "Beijing, China"
}
}
| The various terms and context namespaces in A JSON-LD serialised assertion are defined as part of the IPTC Photo Metadata Standard. |
3.6.3. CBOR serialised assertions
For each Assertion that is serialised in the C2PA Manifest as CBOR, the JSON-LD representation shall be described as the same key name in the CBOR map and its value type shall be determined by Table 1, “Mapping from CBOR to JSON-LD”:
| CBOR Type(s) | JSON-LD Type |
|---|---|
integer, unsigned integer |
unsigned number |
negative integer |
integer |
byte string ( |
string (Base64 encoded, RFC4648, surrounded by |
text string ( |
string |
array |
array |
map |
object |
False, True |
boolean |
Null |
null |
half-precision float, single-precision float, double-precision float |
float |
date-time (CBOR tag 0) |
string (direct copy from the text item inside the CBOR tag, should already be RFC 3339) |
Since CBOR allows map keys of any type, whereas JSON-LD only allows strings as keys in object values, CBOR maps with keys other than UTF-8 strings shall have those keys converted to UTF-8 strings, as defined by the implementation.
An example of a CBOR serialised assertion is shown in CBOR Diagnostics for an actions.v2 assertion, and its equivalent JSON-LD representation is shown in JSON-LD representation of [actions-cbordiag].
"c2pa.actions.v2": {
"actions": [
{
"action": "c2pa.cropped",
"whenStart": {
"value": 0("2020-02-11T09:00:00Z"),
"timestampType": "lowerBound"
},
"whenEnd": {
"value": 0("2020-02-11T10:00:00Z"),
"timestampType": "upperBound"
}
},
{
"action": "c2pa.filtered",
"when": 0("2020-02-11T09:00:00Z")
}
]
}
"c2pa.actions.v2": {
"actions": [
{
"action": "c2pa.cropped",
"whenStart": {
"value": "2020-02-11T09:00:00Z",
"timestampType": "lowerBound"
},
"whenEnd": {
"value": "2020-02-11T10:00:00Z",
"timestampType": "upperBound"
}
},
{
"action": "c2pa.filtered",
"when": "2020-02-11T09:00:00Z"
}
]
}
3.6.3.1. Byte string encoding
crJSON normalizes CBOR byte-strings (bstr) into Base64 ([RFC4648]) string encodings, starting with the b64' prefix and suffixed with a single '. For example, the following fields would be serialized as such:
-
hash -
pad -
pad2
3.6.4. Custom Assertions
If a crJSON generator chooses to decode a custom assertion that is serialized in either JSON-LD or CBOR, it shall be decoded according to the rules for standard assertions. However, if it has any other serialization, then the output into crJSON is implementation dependent.
| "Implementation dependent" could include producing an empty object for the assertion value. |
3.7. Signature
The signature object consists of two mandatory fields - algorithm (which is the signature algorithm) and certificateInfo. In addition, it may also contain a timeStampInfo field if the signing certificate contains a time stamp. When signature information is unavailable, signature shall be present as an empty object {}.
The value of the algorithm field shall be one of the strings defined in the [C2PA specification, such as "ES256" or "Ed25519", or "Unknown" if it is not one of the defined values.
The certificateInfo field contains information about the signing certificate, such as the issuer, subject, validity period, and serial number. The JSON-LD representation of the X.509 leaf certificate (as defined in RFC5280) from the claim signature is based on a logical mapping of its ASN.1 serialisation as defined in RFC 5280 into a JSON-LD serialized object whose key is certificateInfo. An example certificate is in An example signature field with X.509 certificate information, with no time stamp. Additional mappings, such as the mapping of the distinguished name to JSON-LD should also be done in the most logical fashion possible.
The signature information shall include (if available):
-
serialNumber(from X.509 certificate) -
issuer(from X.509 certificate, a DN map, e.g.,C,ST,L,O,OU,CN) -
subject(from X.509 certificate, a DN map) -
validity.notBefore -
validity.notAfter
| An X.509 certificate can contain all sorts of information, and implementations may choose to include additional information in their JSON-LD representation. |
The timeStampInfo field contains information about the time stamp applied to the signature, such as the time it was created. If present, it shall contain the following fields:
-
timestamp(RFC 3339 formatted) -
certificateInfo(from the time stamp authority’s leaf X.509 certificate, same structure as thecertificateInfofield described above)
"signature": {
"algorithm": "ES256",
"certificateInfo": {
"serialNumber": "1234567890",
"subject": {
"ST": "CA",
"CN": "C2PA Signer",
"C": "US",
"L": "Somewhere",
"OU": "FOR TESTING_ONLY",
"O": "C2PA Test Signing Cert"
},
"issuer": {
"ST": "CA",
"CN": "Intermediate CA",
"C": "US",
"L": "Somewhere",
"OU": "FOR TESTING_ONLY",
"O": "C2PA Test Intermediate Root CA"
},
"validity": {
"notAfter": "2030-08-26T18:46:40Z",
"notBefore": "2022-06-10T18:46:40Z"
}
}
}
Dates/times (e.g., timeStamp, notBefore, notAfter) shall be represented as RFC 3339 formatted strings.
Additional certificates following the first certificate provided in x5chain (representing intermediate certification authorities) should not be extracted into the crJSON certificateInfo. An implementation may choose to include them, but their serialisation is implementation dependent.
3.8. Manifest Validation Results
Each manifest object shall contain a validationResults field whose value is a statusCodes object along with a validationTime field. The statusCodes object groups validation status entries into success, informational, and failure arrays. These grouped results are the per-manifest assessments produced by the validator.
If ingredient-specific deltas are available for a manifest, they shall be represented in the sibling ingredientDeltas array on that same manifest object.
Each validation status entry is an object with a code (required), and optionally url and explanation fields.
An example of a per-manifest validationResults object is shown in [results-example].
"validationResults": {
"success": [
{
"code": "claimSignature.insideValidity",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.signature",
"explanation": "claim signature valid"
},
{
"code": "claimSignature.validated",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.signature",
"explanation": "claim signature valid"
},
{
"code": "assertion.hashedURI.match",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.assertions/c2pa.actions.v2",
"explanation": "hashed uri matched: self#jumbf=c2pa.assertions/c2pa.actions.v2"
},
{
"code": "assertion.hashedURI.match",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.assertions/c2pa.hash.data",
"explanation": "hashed uri matched: self#jumbf=c2pa.assertions/c2pa.hash.data"
},
{
"code": "assertion.dataHash.match",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.assertions/c2pa.hash.data",
"explanation": "data hash valid"
}
],
"informational": [],
"failure": [
{
"code": "signingCredential.untrusted",
"url": "self#jumbf=/c2pa/urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268/c2pa.signature",
"explanation": "signing certificate untrusted"
},
{
"code": "assertion.action.malformed",
"url": "urn:c2pa:4646c5e4-31e1-4d08-8156-d90a8e323268",
"explanation": "first action must be created or opened"
}
],
"validationTime": "2026-03-10T12:34:56Z"
}
The validationTime field is the date and time when validation was performed, represented as an RFC 3339 date-time string.
3.8.1. Trust List References
A per-manifest validationResults object may contain a trustListUris field identifying the trust lists containing matching trust anchors during the validation of that manifest’s claim signature or a TSA time-stamp. If no trust match was found, this field is omitted. If present, the array contains one or more objects, each with a uri field identifying the trust list and a type field identifying its type. Only trust lists containing matching trust anchors are included, rather than every trust list consulted during validation. Each object may contain an identifier field identifying the specific instance of the trust list used.
The same entry structure and identifier semantics apply to trustListUris in an ingredient assertion’s recorded validationResults. Those references describe the earlier validation recorded by the claim generator, whereas the per-manifest references describe the validation performed by the validator producing crJSON.
Both trustListUris and each entry’s identifier are optional, including when cached or bundled list instances are used.
{
"success": [],
"informational": [],
"failure": [],
"specVersion": "2.5.0",
"validationTime": "2026-10-08T13:18:44Z",
"trustListUris": [
{
"uri": "https://c2pa.org/trustlist",
"type": "c2pa.trustList",
"identifier": "42"
},
{
"uri": "https://c2pa.org/trustlist-tsa",
"type": "c2pa.tsaTrustList",
"identifier": "17"
}
]
}
4. Minimal Example
The following example conforms to the crJSON schema. In many of the example values, a … placeholder is used for a value that is not relevant to the example. Also, any values which would be Base64-encoded are represented as b64'<base64>' (as recommended in RFC 8949, CBOR).
{
"@context": {
"@vocab": "https://c2pa.org/crjson",
"extras": "https://c2pa.org/crjson/extras"
},
"jsonGenerator": {
"name": "Example Tool",
"version": "1.0.0"
},
"manifests": [
{
"label": "urn:uuid:...",
"isUpdateManifest": false,
"isCompressedManifest": false,
"claim.v2": {
"instanceID": "xmp:iid:...",
"claim_generator_info": {"name": "Acme C2PA SDK", "version": "1.0"},
"signature": "self#jumbf=/c2pa/urn:uuid:.../c2pa.signature",
"created_assertions": [
{"url": "self#jumbf=c2pa.assertions/c2pa.hash.data", "hash": "b64'<base64>'"}
],
"gathered_assertions": [],
"redacted_assertions": []
},
"assertions": {
"c2pa.actions.v2": {"actions": [{"action": "c2pa.created"}], "allActionsIncluded": true},
"c2pa.hash.data": {"alg": "sha256", "hash": "b64'<base64>'", "pad": "b64'<base64>'"}
},
"signature": {},
"validationResults": {
"informational": [],
"success": [
{"code": "claimSignature.validated"}
],
"failure": [],
"specVersion": "2.2.0",
"validationTime": "2026-03-16T18:35:24.012Z"
}
}
]
}
5. Full Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://c2pa.org/crjson/crJSON.schema.json",
"title": "Content Credentials JSON (crJSON) Document Schema",
"description": "JSON Schema for Content Credentials JSON (crJSON) documents. crJSON does not include asset_info, content, or metadata.",
"type": "object",
"required": [
"@context",
"manifests",
"jsonGenerator"
],
"properties": {
"@context": {
"description": "JSON-LD context defining namespaces and vocabularies",
"oneOf": [
{
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1
},
{
"type": "object",
"properties": {
"@vocab": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": {
"type": "string"
}
}
]
},
"manifests": {
"description": "Array of C2PA manifests embedded in the asset",
"type": "array",
"items": {
"$ref": "#/definitions/manifest"
}
},
"jsonGenerator": {
"description": "Information about the tool used to generate this JSON",
"$ref": "#/definitions/jsonGenerator"
}
},
"additionalProperties": true,
"definitions": {
"jsonGenerator": {
"type": "object",
"description": "Information about the claim generator (generator-info fields); name/version align with claim.cddl generator-info-map;",
"properties": {
"name": {
"type": "string",
"description": "Name of the software"
},
"version": {
"type": "string",
"description": "Version of the software (SemVer 2.0: major.minor.patch with optional pre-release and build)",
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
}
},
"required": [
"name",
"version"
],
"additionalProperties": true
},
"manifest": {
"type": "object",
"description": "CrJSON manifest wrapper containing label, assertions, claim or claim.v2, signature, and validationResults. Claim content: claim.cddl claim-map or claim-map-v2.",
"required": [
"label",
"isUpdateManifest",
"isCompressedManifest",
"assertions",
"signature",
"validationResults"
],
"oneOf": [
{
"required": [
"claim"
]
},
{
"required": [
"claim.v2"
]
}
],
"properties": {
"label": {
"type": "string",
"description": "Manifest label or URN identifier"
},
"isUpdateManifest": {
"type": "boolean",
"description": "True if this is an update manifest, false if it is a standard manifest."
},
"isCompressedManifest": {
"type": "boolean",
"description": "True if this manifest was compressed in the manifest store."
},
"assertions": {
"$ref": "#/definitions/assertions",
"description": "Assertions contained within the manifest, keyed by the assertion's label"
},
"claim": {
"$ref": "#/definitions/claimV1",
"description": "Claim map (v1) per C2PA CDDL claim-map; alternative to claim.v2. A manifest SHALL contain either claim or claim.v2."
},
"claim.v2": {
"$ref": "#/definitions/claim",
"description": "Normalized claim (v2) per C2PA CDDL claim-map-v2; alternative to claim. A manifest SHALL contain either claim or claim.v2."
},
"signature": {
"$ref": "#/definitions/signature"
},
"validationResults": {
"$ref": "#/definitions/manifestValidationResults",
"description": "Validation status codes for this manifest (success, informational, failure) and when validation was performed"
},
"ingredientDeltas": {
"type": "array",
"description": "Validation deltas for this manifest's ingredient assertions. Present when ingredients are C2PA assets.",
"items": {
"$ref": "#/definitions/ingredientDeltaValidationResult"
}
}
},
"additionalProperties": false
},
"claimV1": {
"type": "object",
"description": "Claim map (v1). CDDL: claim.cddl claim-map. Alternative to claim.v2; each manifest may contain either claim or claim.v2.",
"required": [
"claim_generator",
"claim_generator_info",
"signature",
"assertions",
"dc:format",
"instanceID"
],
"properties": {
"claim_generator": {
"type": "string",
"description": "User-Agent string for the claim generator that created the claim (RFC 7231 §5.5.3)"
},
"claim_generator_info": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/softwareAgent"
},
"description": "Detailed information about the claim generator (one or more generator-info maps)"
},
"signature": {
"type": "string",
"description": "JUMBF URI reference to the signature of this claim"
},
"assertions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "Hashed URI references to assertions in this claim"
},
"dc:format": {
"type": "string",
"description": "Media type of the asset"
},
"instanceID": {
"type": "string",
"description": "Uniquely identifies a specific version of an asset"
},
"dc:title": {
"type": "string",
"description": "Name of the asset (Dublin Core)"
},
"redacted_assertions": {
"type": "array",
"items": {
"type": "string"
},
"description": "JUMBF URI references to redacted ingredient manifest assertions"
},
"alg": {
"type": "string",
"description": "Cryptographic hash algorithm for data hash assertions in this claim (C2PA data hash algorithm identifier registry)"
},
"alg_soft": {
"type": "string",
"description": "Algorithm for soft binding assertions in this claim (C2PA soft binding algorithm identifier registry)"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"hashedUriMap": {
"type": "object",
"description": "Hashed URI reference (url and hash). CDDL: hashed-uri.cddl $hashed-uri-map.",
"required": [
"url",
"hash"
],
"properties": {
"url": {
"type": "string",
"description": "JUMBF URI reference"
},
"hash": {
"type": "string",
"description": "Hash value (Base64-encoded with b64' prefix)"
},
"alg": {
"type": "string",
"description": "Hash algorithm identifier; if absent, taken from enclosing structure"
}
},
"additionalProperties": false
},
"assertionMetadataMap": {
"type": "object",
"description": "Additional information about an assertion. CDDL: assertion-metadata-common.cddl $assertion-metadata-map.",
"properties": {
"dateTime": {
"type": "string",
"format": "date-time",
"description": "RFC 3339 date-time when the assertion was created/generated (tdate)"
},
"processStart": {
"$ref": "#/definitions/generatorLowerBoundTime",
"description": "Recorded start of the overall process or lower bound (generator-lower-bound-time-type)"
},
"processEnd": {
"$ref": "#/definitions/generatorUpperBoundTime",
"description": "Recorded end of the overall process or upper bound (generator-upper-bound-time-type)"
},
"reviewRatings": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/ratingMap"
},
"description": "Ratings given to the assertion"
},
"reference": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to another assertion that this review is about"
},
"dataSource": {
"$ref": "#/definitions/sourceMap",
"description": "(DEPRECATED) Description of the source of the assertion data. Claim generators shall not include this field."
},
"localizations": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/localizationDataEntry"
},
"description": "Localizations for strings in the assertion"
},
"regionOfInterest": {
"$ref": "#/definitions/regionMap",
"description": "Region of the asset where this assertion is relevant ($region-map)"
},
"processStart": {
"type": "string",
"format": "date-time",
"description": "RFC 3339 date-time when the process began (advisory, not a trusted timestamp)"
},
"processEnd": {
"type": "string",
"format": "date-time",
"description": "RFC 3339 date-time when the process ended (advisory, not a trusted timestamp)"
}
},
"additionalProperties": true
},
"generatorLowerBoundTime": {
"description": "Claim generator provided time stamp representing an exact time or lower bound. A string value is interpreted as absolute.",
"oneOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "object",
"properties": {
"value": {
"type": "string",
"format": "date-time"
},
"timestampType": {
"type": "string",
"enum": [
"absolute",
"lowerBound"
],
"default": "absolute"
}
},
"required": [
"value"
],
"additionalProperties": false
}
]
},
"generatorUpperBoundTime": {
"description": "Claim generator provided time stamp representing an exact time or upper bound. A string value is interpreted as absolute.",
"oneOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "object",
"properties": {
"value": {
"type": "string",
"format": "date-time"
},
"timestampType": {
"type": "string",
"enum": [
"absolute",
"upperBound"
],
"default": "absolute"
}
},
"required": [
"value"
],
"additionalProperties": false
}
]
},
"sourceMap": {
"type": "object",
"description": "Source of assertion data. CDDL: assertion-metadata-common.cddl source-map.",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"description": "Source type; $source-type",
"enum": [
"signer",
"claimGenerator.REE",
"claimGenerator.TEE",
"localProvider.REE",
"localProvider.TEE",
"remoteProvider.1stParty",
"remoteProvider.3rdParty",
"humanEntry",
"humanEntry.anonymous",
"humanEntry.identified"
]
},
"details": {
"type": "string",
"description": "Human-readable details about the source, e.g. URL of the remote server"
}
},
"additionalProperties": false
},
"ratingMap": {
"type": "object",
"description": "Rating of an assertion item. CDDL: assertion-metadata-common.cddl rating-map.",
"required": [
"value"
],
"properties": {
"value": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"description": "Rating from 1 (worst) to 5 (best)"
},
"code": {
"type": "string",
"description": "Label-formatted reason for the rating; $review-code",
"enum": [
"actions.unknownActionsPerformed",
"actions.missing",
"actions.possiblyMissing",
"depthMap.sceneMismatch",
"ingredient.modified",
"ingredient.possiblyModified",
"thumbnail.primaryMismatch",
"stds.iptc.location.inaccurate",
"stds.schema-org.CreativeWork.misattributed",
"stds.schema-org.CreativeWork.missingAttribution"
]
},
"explanation": {
"type": "string",
"description": "Human-readable explanation for the rating"
}
},
"additionalProperties": false
},
"localizationDataEntry": {
"type": "object",
"description": "Localization dictionary (language keys to string). CDDL: assertion-metadata-common.cddl $localization-data-entry.",
"additionalProperties": {
"type": "string"
}
},
"claim": {
"type": "object",
"description": "Claim (v2). CDDL: claim.cddl claim-map-v2.",
"required": [
"instanceID",
"claim_generator_info",
"signature",
"created_assertions",
"gathered_assertions",
"redacted_assertions"
],
"properties": {
"instanceID": {
"type": "string",
"description": "Uniquely identifies a specific version of an asset"
},
"claim_generator_info": {
"$ref": "#/definitions/softwareAgent",
"description": "The claim generator of this claim (single generator-info map)"
},
"signature": {
"type": "string",
"description": "JUMBF URI reference to the signature of this claim"
},
"created_assertions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "Hashed URI references to created assertions"
},
"gathered_assertions": {
"type": "array",
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "Hashed URI references to gathered assertions"
},
"dc:title": {
"type": "string",
"description": "Name of the asset (Dublin Core)"
},
"redacted_assertions": {
"type": "array",
"items": {
"type": "string"
},
"description": "JUMBF URI references to the assertions of ingredient manifests being redacted"
},
"alg": {
"type": "string",
"description": "Cryptographic hash algorithm for data hash assertions in this claim (C2PA data hash algorithm identifier registry)"
},
"alg_soft": {
"type": "string",
"description": "Algorithm for soft binding assertions in this claim (C2PA soft binding algorithm identifier registry)"
},
"specVersion": {
"type": "string",
"description": "The version of the specification used to produce this claim (SemVer)"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap",
"description": "Additional information about the assertion (DEPRECATED)"
}
},
"additionalProperties": false
},
"assertions": {
"type": "object",
"description": "Container of assertion objects keyed by assertion label. Each key (e.g. c2pa.hash.data, c2pa.actions) corresponds to a C2PA assertion type; see definitions and INTERNAL/cddl for data-hash, boxes-hash, actions, ingredient, etc.",
"properties": {
"c2pa.hash.data": {
"$ref": "#/definitions/hashDataAssertion"
},
"c2pa.hash.bmff.v2": {
"$ref": "#/definitions/hashBmffAssertion"
},
"c2pa.hash.boxes": {
"$ref": "#/definitions/hashBoxesAssertion"
},
"c2pa.hash.multi-asset": {
"$ref": "#/definitions/hashMultiAssetAssertion"
},
"c2pa.actions": {
"$ref": "#/definitions/actionsAssertionV1"
},
"c2pa.actions.v2": {
"$ref": "#/definitions/actionsAssertionV2"
},
"c2pa.ingredient": {
"$ref": "#/definitions/ingredientAssertionV1"
},
"c2pa.ingredient.v2": {
"$ref": "#/definitions/ingredientAssertionV2"
},
"c2pa.ingredient.v3": {
"$ref": "#/definitions/ingredientAssertionV3"
},
"c2pa.thumbnail.claim.jpeg": {
"$ref": "#/definitions/thumbnailAssertion"
},
"c2pa.thumbnail.ingredient.jpeg": {
"$ref": "#/definitions/thumbnailAssertion"
},
"c2pa.soft-binding": {
"$ref": "#/definitions/softBindingAssertion"
},
"c2pa.linked-resource-integrity": {
"$ref": "#/definitions/linkedResourceIntegrityAssertion"
},
"c2pa.hash.segment": {
"$ref": "#/definitions/hashSegmentAssertion"
}
},
"patternProperties": {
"^c2pa\\.thumbnail\\.ingredient": {
"$ref": "#/definitions/thumbnailAssertion"
},
"^c2pa\\.hash\\.(data|bmff\\.v2|boxes)\\.part(__[0-9]+)?$": {
"description": "Part hash assertion: standard hard binding assertion with .part and optional multiple instance identifier (e.g. c2pa.hash.data.part, c2pa.hash.data.part__2). Byte offsets in the assertion are relative to the part.",
"oneOf": [
{
"$ref": "#/definitions/hashDataAssertion"
},
{
"$ref": "#/definitions/hashBmffAssertion"
},
{
"$ref": "#/definitions/hashBoxesAssertion"
}
]
}
},
"additionalProperties": true
},
"hashDataAssertion": {
"type": "object",
"description": "Data hash assertion (c2pa.hash.data). CDDL: data-hash.cddl data-hash-map, EXCLUSION_RANGE-map.",
"properties": {
"alg": {
"type": "string",
"description": "Hash algorithm"
},
"hash": {
"type": "string",
"description": "Base64-encoded hash value with b64' prefix"
},
"pad": {
"type": "string",
"description": "Padding bytes"
},
"pad2": {
"type": "string",
"description": "Secondary padding bytes"
},
"name": {
"type": "string",
"description": "Name of the hashed data"
},
"exclusions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"start": {
"type": "integer",
"description": "Starting byte position of exclusion"
},
"length": {
"type": "integer",
"description": "Length of exclusion in bytes"
}
},
"required": [
"start",
"length"
]
}
}
},
"required": [
"hash",
"pad"
],
"additionalProperties": false
},
"hashBoxesAssertion": {
"type": "object",
"description": "Boxes hash assertion (c2pa.hash.boxes). CDDL: boxes-hash.cddl box-map.",
"required": [
"boxes"
],
"properties": {
"boxes": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/boxHashMap"
},
"description": "Array of box-hash-map entries"
},
"alg": {
"type": "string",
"description": "Cryptographic hash algorithm (C2PA hash algorithm identifier). If absent, taken from enclosing structure."
}
},
"additionalProperties": false
},
"boxHashMap": {
"type": "object",
"description": "Single box hash entry. CDDL: boxes-hash.cddl box-hash-map.",
"required": [
"names",
"hash"
],
"properties": {
"names": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"description": "Box identifier in order of appearance (e.g. APP0, IHDR); box-name"
},
"description": "Box identifiers in order of appearance"
},
"alg": {
"type": "string",
"description": "Hash algorithm for this box; if absent, from enclosing structure"
},
"hash": {
"type": "string",
"description": "Hash value (byte string; in JSON typically Base64-encoded with b64' prefix)"
},
"excluded": {
"type": "boolean",
"description": "If true, a validator can ignore this box (and associated hash) during validation"
},
"exclusions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/boxExclusionsMap"
},
"description": "Hash exclusion ranges; ranges have monotonically increasing start values and do not overlap"
},
"pad": {
"type": "string",
"description": "Zero-filled byte string used for filling up space (typically Base64-encoded with b64' prefix in JSON)"
},
"pad2": {
"type": "string",
"description": "Zero-filled byte string used for filling up space (typically Base64-encoded with b64' prefix in JSON)"
}
},
"additionalProperties": false
},
"boxExclusionsMap": {
"type": "object",
"description": "Exclusion range for a box. CDDL: boxes-hash.cddl box-exclusions-map.",
"required": [
"start",
"length"
],
"properties": {
"start": {
"type": "integer",
"minimum": 0,
"description": "Starting byte offset from the start of the box (uint)"
},
"length": {
"type": "integer",
"minimum": 0,
"description": "Number of bytes of data to exclude (uint)"
},
"boxIndex": {
"type": "integer",
"description": "0-based index into the names array in the box-hash-map; can be omitted if the number of boxes is one"
}
},
"additionalProperties": false
},
"hashMultiAssetAssertion": {
"type": "object",
"description": "Multi-asset hash assertion (c2pa.hash.multi-asset). CDDL: multi-asset-hash.cddl multi-asset-hash-map.",
"required": [
"parts"
],
"properties": {
"parts": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/partHashMap"
},
"description": "Array of hashes for individual parts of the multi-part file"
}
},
"additionalProperties": false
},
"partHashMap": {
"type": "object",
"description": "Part hash entry. CDDL: multi-asset-hash.cddl part-hash-map.",
"required": [
"location",
"hashAssertion"
],
"properties": {
"location": {
"$ref": "#/definitions/locatorMap",
"description": "Location of the part within the file (byte range or BMFF box path)"
},
"hashAssertion": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI to the hash assertion for the part (e.g. c2pa.hash.data.part, c2pa.hash.data.part__2). Byte offsets in that assertion are relative to the part."
},
"optional": {
"type": "boolean",
"description": "If true, the part is optional and can be discarded"
}
},
"additionalProperties": false
},
"locatorMap": {
"type": "object",
"description": "Location of a part (byte range or BMFF box path). CDDL: multi-asset-hash.cddl locator-map.",
"oneOf": [
{
"required": [
"byteOffset",
"length"
],
"properties": {
"byteOffset": {
"type": "integer",
"minimum": 0,
"description": "Byte offset of the part within the file (uint)"
},
"length": {
"type": "integer",
"minimum": 0,
"description": "Length of the part in bytes (uint)"
}
},
"additionalProperties": false
},
{
"required": [
"bmffBox"
],
"properties": {
"bmffBox": {
"type": "string",
"description": "XPath to the BMFF box of the part"
}
},
"additionalProperties": false
}
]
},
"softBindingAssertion": {
"type": "object",
"description": "Soft binding assertion (c2pa.soft-binding). CDDL: soft-binding.cddl soft-binding-map.",
"required": [
"alg",
"blocks"
],
"properties": {
"alg": {
"type": "string",
"description": "Soft binding algorithm and version from C2PA soft binding algorithm list. If absent, taken from enclosing alg_soft."
},
"blocks": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/softBindingBlockMap"
},
"description": "One or more soft bindings across some or all of the asset's content"
},
"pad": {
"type": "string",
"description": "Zero-filled byte string for filling space (typically Base64 in JSON)"
},
"pad2": {
"type": "string",
"description": "Zero-filled byte string for filling space (typically Base64 in JSON)"
},
"name": {
"type": "string",
"description": "Human-readable description of what this hash covers"
},
"alg-params": {
"type": "string",
"description": "CBOR byte string (e.g. Base64 in JSON) describing parameters of the soft binding algorithm"
},
"bindingMetadata": {
"$ref": "#/definitions/softBindingMetadataMap",
"description": "Additional metadata of the soft binding"
},
"url": {
"type": "string",
"format": "uri",
"description": "Unused and deprecated"
}
},
"additionalProperties": false
},
"softBindingBlockMap": {
"type": "object",
"description": "Single soft binding block. CDDL: soft-binding.cddl soft-binding-block-map.",
"required": [
"scope",
"value"
],
"properties": {
"scope": {
"$ref": "#/definitions/softBindingScopeMap",
"description": "Scope of the digital content over which the soft binding is computed"
},
"value": {
"type": "string",
"description": "CBOR byte string (e.g. Base64 in JSON), in algorithm-specific format, for the soft binding value over this block"
}
},
"additionalProperties": false
},
"softBindingScopeMap": {
"type": "object",
"description": "Scope of content for a soft binding block. CDDL: soft-binding.cddl soft-binding-scope-map.",
"properties": {
"extent": {
"type": "string",
"description": "Deprecated. CBOR byte string (e.g. Base64) describing the part of content over which the binding was computed"
},
"timespan": {
"$ref": "#/definitions/softBindingTimespanMap",
"description": "Time range over which the soft binding value has been computed"
},
"region": {
"$ref": "#/definitions/regionMap",
"description": "Region of interest (region-map)"
}
},
"additionalProperties": false
},
"softBindingTimespanMap": {
"type": "object",
"description": "Time range for soft binding. CDDL: soft-binding.cddl soft-binding-timespan-map.",
"required": [
"start",
"end"
],
"properties": {
"start": {
"type": "integer",
"minimum": 0,
"description": "Start of the time range in milliseconds from media start (uint)"
},
"end": {
"type": "integer",
"minimum": 0,
"description": "End of the time range in milliseconds from media start (uint)"
}
},
"additionalProperties": false
},
"softBindingMetadataMap": {
"type": "object",
"description": "Additional metadata for soft binding. CDDL: soft-binding.cddl soft-binding-metadata-map.",
"properties": {
"description": {
"type": "string",
"description": "Additional description of the implementation or author of the binding or algorithm"
},
"contact": {
"type": "string",
"description": "Contact information for the implementation or author of the binding or algorithm"
},
"informationalUrl": {
"type": "string",
"description": "Web page with more details about the implementation or author of the binding or algorithm"
}
},
"additionalProperties": true
},
"actionsAssertionV1": {
"type": "object",
"description": "Actions assertion (v1) (c2pa.actions). CDDL: actions.cddl actions-map.",
"properties": {
"actions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/actionItemV1"
},
"description": "List of actions (action-items-map)"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"required": [
"actions"
],
"additionalProperties": false
},
"actionItemV1": {
"type": "object",
"description": "Single action (v1). CDDL: actions.cddl action-items-map.",
"properties": {
"action": {
"type": "string",
"description": "Action type (e.g., c2pa.created, c2pa.edited, c2pa.converted); $action-choice"
},
"when": {
"type": "string",
"format": "date-time",
"description": "Time stamp when the action occurred (tdate)"
},
"softwareAgent": {
"type": "string",
"description": "The software agent that performed the action"
},
"changed": {
"type": "string",
"description": "Semicolon-delimited list of parts of the resource that were changed since the previous event history"
},
"instanceID": {
"type": "string",
"description": "xmpMM:InstanceID for the modified (output) resource (buuid)"
},
"parameters": {
"$ref": "#/definitions/parametersMapV1",
"description": "Additional parameters of the action"
},
"digitalSourceType": {
"type": "string",
"description": "One of the defined source types at https://cv.iptc.org/newscodes/digitalsourcetype/"
}
},
"required": [
"action"
],
"additionalProperties": false
},
"parametersMapV1": {
"type": "object",
"description": "Action parameters (v1). CDDL: actions.cddl parameters-map.",
"properties": {
"ingredient": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI to the ingredient assertion this action acts on"
},
"description": {
"type": "string",
"description": "Additional description of the action"
}
},
"additionalProperties": true
},
"actionsAssertionV2": {
"type": "object",
"description": "Actions assertion (v2) (c2pa.actions.v2). CDDL: actions.cddl actions-map-v2.",
"properties": {
"actions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/actionItemV2"
},
"description": "List of actions (action-item-map-v2)"
},
"templates": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/actionTemplateV2"
},
"description": "List of templates for the actions"
},
"softwareAgents": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/softwareAgent"
},
"description": "List of software/hardware that performed the actions (generator-info maps)"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
},
"allActionsIncluded": {
"type": "boolean",
"description": "If true, indicates that all actions performed are included in this assertion"
}
},
"required": [
"actions", "allActionsIncluded"
],
"additionalProperties": false
},
"actionItemV2": {
"type": "object",
"description": "Single action (v2). CDDL: actions.cddl action-item-map-v2.",
"properties": {
"action": {
"type": "string",
"description": "Action type; $action-choice"
},
"softwareAgent": {
"$ref": "#/definitions/softwareAgent",
"description": "Description of the software/hardware that did the action (generator-info map)"
},
"softwareAgentIndex": {
"type": "integer",
"description": "0-based index into the softwareAgents array in the actions assertion"
},
"description": {
"type": "string",
"description": "Additional description of the action, important for custom actions"
},
"digitalSourceType": {
"type": "string",
"description": "One of the defined source types at https://cv.iptc.org/newscodes/digitalsourcetype/"
},
"when": {
"type": "string",
"format": "date-time",
"description": "Exact action time. Cannot be combined with whenStart or whenEnd."
},
"whenStart": {
"$ref": "#/definitions/generatorLowerBoundTime",
"description": "Exact action start or lower bound. Cannot be combined with when."
},
"whenEnd": {
"$ref": "#/definitions/generatorUpperBoundTime",
"description": "Exact action end or upper bound. Cannot be combined with when."
},
"changes": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/regionMap"
},
"description": "Regions of interest of the resource that were changed"
},
"related": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/actionItemV2"
},
"description": "List of related actions"
},
"reason": {
"type": "string",
"description": "Reason the action was performed (required when action is c2pa.redacted); $action-reason"
},
"parameters": {
"$ref": "#/definitions/parametersMapV2",
"description": "Additional parameters of the action"
}
},
"required": [
"action"
],
"allOf": [
{
"not": {
"required": [
"when",
"whenStart"
]
}
},
{
"not": {
"required": [
"when",
"whenEnd"
]
}
}
],
"additionalProperties": false
},
"actionTemplateV2": {
"type": "object",
"description": "Action template (v2). CDDL: actions.cddl action-template-map-v2.",
"properties": {
"action": {
"type": "string",
"description": "Action type or \"*\" for templates; $action-choice / \"*\""
},
"softwareAgent": {
"$ref": "#/definitions/softwareAgent",
"description": "Description of the software/hardware (generator-info map)"
},
"softwareAgentIndex": {
"type": "integer",
"description": "0-based index into the softwareAgents array"
},
"description": {
"type": "string",
"description": "Additional description of the action"
},
"digitalSourceType": {
"type": "string",
"description": "Digital source type URI"
},
"icon": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to an embedded data assertion"
},
"parameters": {
"$ref": "#/definitions/parametersMapV2",
"description": "Parameters to be merged into the parameters of matching actions"
},
"templateParameters": {
"type": "object",
"description": "(DEPRECATED) Superseded by parameters. Consumers shall treat these key-value pairs as if they were in the parameters field, merging them into matching actions using the same precedence rules. (parameters-common-map-v2)",
"additionalProperties": true
}
},
"required": [
"action"
],
"additionalProperties": false
},
"regionMap": {
"type": "object",
"description": "Region of interest. CDDL: regions-of-interest.cddl region-map.",
"additionalProperties": true
},
"parametersMapV2": {
"type": "object",
"description": "Action parameters (v2). CDDL: actions.cddl parameters-map-v2.",
"properties": {
"redacted": {
"type": "string",
"description": "JUMBF URI to the redacted assertion (required when action is c2pa.redacted)"
},
"ingredients": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "List of hashed JUMBF URIs to ingredient (v2 or v3) assertion(s) this action acts on"
},
"sourceLanguage": {
"type": "string",
"description": "BCP-47 code of the source language for c2pa.translated"
},
"targetLanguage": {
"type": "string",
"description": "BCP-47 code of the target language for c2pa.translated"
},
"name": {
"type": "string",
"description": "A machine-readable identifier that sub-classifies the action"
},
"relatedAssertions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "Hashed JUMBF URI(s) to assertion(s) related to this action that are neither ingredients nor actions"
},
"multipleInstances": {
"type": "boolean",
"description": "Whether this action was performed multiple times"
}
},
"additionalProperties": true
},
"softwareAgent": {
"type": "object",
"description": "Generator/software agent info. CDDL: claim.cddl generator-info-map.",
"properties": {
"name": {
"type": "string",
"description": "Name of the software"
},
"version": {
"type": "string",
"description": "Version of the software"
},
"icon": {
"$ref": "#/definitions/hashedUriMap",
"description": "Icon representing the software/hardware"
},
"operating_system": {
"type": "string",
"description": "Operating system the software runs on"
},
"specVersion": {
"type": "string",
"description": "The version of the specification used to produce this manifest (SemVer)"
}
},
"required": [
"name"
],
"additionalProperties": true
},
"certificateInfo": {
"type": "object",
"description": "Certificate details (serial number, issuer, subject, validity). CrJSON decoding of signing certificate; no CDDL rule in INTERNAL/cddl.",
"properties": {
"serialNumber": {
"type": "string",
"description": "Certificate serial number"
},
"issuer": {
"$ref": "#/definitions/distinguishedName"
},
"subject": {
"$ref": "#/definitions/distinguishedName"
},
"validity": {
"type": "object",
"properties": {
"notBefore": {
"type": "string",
"format": "date-time"
},
"notAfter": {
"type": "string",
"format": "date-time"
}
}
}
},
"required": [
"serialNumber",
"issuer",
"subject",
"validity"
],
"additionalProperties": true
},
"signature": {
"description": "Decoded claim signature (algorithm, certificate, optional time stamp), or an empty object when signature information is unavailable. CrJSON decoding of Claim Signature box; no CDDL rule in INTERNAL/cddl.",
"oneOf": [
{
"type": "object",
"additionalProperties": false
},
{
"type": "object",
"properties": {
"algorithm": {
"type": "string",
"description": "Algorithm used for claim signing (e.g., SHA256withECDSA)"
},
"certificateInfo": {
"$ref": "#/definitions/certificateInfo"
},
"timeStampInfo": {
"type": "object",
"description": "TSA time-stamp information, when present",
"properties": {
"timestamp": {
"type": "string",
"format": "date-time",
"description": "Time represented by the time-stamp; RFC 3339 format"
},
"certificateInfo": {
"$ref": "#/definitions/certificateInfo"
}
},
"required": [
"timestamp",
"certificateInfo"
]
}
},
"required": [
"algorithm",
"certificateInfo"
],
"additionalProperties": false
}
]
},
"distinguishedName": {
"type": "object",
"description": "X.509 Distinguished Name components. Used in signature/certificate decoding; no CDDL rule in INTERNAL/cddl.",
"properties": {
"C": {
"type": "string",
"description": "Country"
},
"ST": {
"type": "string",
"description": "State or province"
},
"L": {
"type": "string",
"description": "Locality"
},
"O": {
"type": "string",
"description": "Organization"
},
"OU": {
"type": "string",
"description": "Organizational unit"
},
"CN": {
"type": "string",
"description": "Common name"
},
"E": {
"type": "string",
"description": "Email address"
},
"2.5.4.97": {
"type": "string",
"description": "Organization identifier OID"
}
},
"additionalProperties": false
},
"manifestValidationResults": {
"type": "object",
"description": "Per-manifest validation status codes and validation time. Used in each manifest's validationResults.",
"properties": {
"success": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
},
"informational": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
},
"failure": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
},
"specVersion": {
"type": "string",
"description": "The version of the specification against which the validation was performed (SemVer formatted string)",
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
},
"validationTime": {
"type": "string",
"format": "date-time",
"description": "Time when the validation was performed; RFC 3339 format"
},
"trustListUris": {
"type": "array",
"items": {
"$ref": "#/definitions/trustListUriEntry"
},
"minItems": 1,
"description": "Trust lists containing matching trust anchors during this manifest's claim signature or TSA time-stamp validation"
}
},
"required": [
"success",
"informational",
"failure",
"specVersion",
"validationTime"
],
"additionalProperties": false
},
"ingredientAssertionV1": {
"type": "object",
"description": "Ingredient assertion (v1) (c2pa.ingredient). CDDL: ingredient.cddl ingredient-map.",
"required": [
"dc:title",
"dc:format",
"instanceID",
"relationship"
],
"properties": {
"dc:title": {
"type": "string",
"description": "Name of the ingredient (Dublin Core)"
},
"dc:format": {
"type": "string",
"description": "Media type of the ingredient (format-string)"
},
"documentID": {
"type": "string",
"description": "Value of the ingredient's xmpMM:DocumentID"
},
"instanceID": {
"type": "string",
"description": "Unique identifier, e.g. value of the ingredient's xmpMM:InstanceID"
},
"relationship": {
"type": "string",
"description": "Relationship of this ingredient to the asset; $relation-choice (parentOf, componentOf, inputTo)"
},
"c2pa_manifest": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to the C2PA Manifest of the ingredient"
},
"thumbnail": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to an ingredient thumbnail"
},
"validationStatus": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"description": "Status map per C2PA CDDL $status-map",
"additionalProperties": true
},
"description": "Validation status of the ingredient"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"ingredientAssertionV2": {
"type": "object",
"description": "Ingredient assertion (v2) (c2pa.ingredient.v2). CDDL: ingredient.cddl ingredient-map-v2.",
"required": [
"dc:title",
"dc:format",
"relationship"
],
"properties": {
"dc:title": {
"type": "string",
"description": "Name of the ingredient (Dublin Core)"
},
"dc:format": {
"type": "string",
"description": "Media type of the ingredient (format-string)"
},
"relationship": {
"type": "string",
"description": "Relationship of this ingredient to the asset; $relation-choice"
},
"documentID": {
"type": "string",
"description": "Value of the ingredient's xmpMM:DocumentID"
},
"instanceID": {
"type": "string",
"description": "Unique identifier, e.g. value of the ingredient's xmpMM:InstanceID"
},
"data": {
"description": "Hashed URI to embedded data assertion or hashed_ext_uri to external data",
"oneOf": [
{
"$ref": "#/definitions/hashedUriMap"
},
{
"$ref": "#/definitions/hashedExtUriMap"
}
]
},
"data_types": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"description": "Asset type per C2PA CDDL $asset-type-map",
"additionalProperties": true
},
"description": "Additional information about the data's type"
},
"c2pa_manifest": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to the C2PA Manifest of the ingredient"
},
"thumbnail": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to a thumbnail in an embedded data assertion"
},
"validationStatus": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"description": "Status map per C2PA CDDL $status-map",
"additionalProperties": true
},
"description": "Validation status of the ingredient"
},
"description": {
"type": "string",
"description": "Additional description of the ingredient"
},
"informational_URI": {
"type": "string",
"description": "URI to an informational page about the ingredient or its data"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"ingredientAssertionV3": {
"type": "object",
"description": "Ingredient assertion (v3) (c2pa.ingredient.v3). CDDL: ingredient.cddl ingredient-map-v3. When an activeManifest field is present, validationResults shall also be present. validationResults may also be present without activeManifest, e.g. to record that the active manifest could not be established.",
"required": [
"relationship"
],
"dependentRequired": {
"activeManifest": ["validationResults"]
},
"not": {
"required": ["activeManifest", "digitalSourceType"]
},
"properties": {
"dc:title": {
"type": "string",
"description": "Name of the ingredient (Dublin Core)"
},
"dc:format": {
"type": "string",
"description": "Media type of the ingredient (format-string)"
},
"relationship": {
"type": "string",
"description": "Relationship of this ingredient to the asset; $relation-choice"
},
"validationResults": {
"$ref": "#/definitions/validationResults",
"description": "Results from the claim generator performing full validation on the ingredient asset ($validation-results-map). Shall be present when activeManifest is present; may also be present without activeManifest, e.g. when the active manifest could not be established."
},
"instanceID": {
"type": "string",
"description": "Unique identifier, e.g. value of the ingredient's xmpMM:InstanceID"
},
"data": {
"description": "Hashed URI to embedded data assertion or hashed_ext_uri to external data",
"oneOf": [
{
"$ref": "#/definitions/hashedUriMap"
},
{
"$ref": "#/definitions/hashedExtUriMap"
}
]
},
"dataTypes": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"description": "Asset type per C2PA CDDL $asset-type-map",
"additionalProperties": true
},
"description": "Additional information about the data's type (v3 camelCase)"
},
"activeManifest": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI to the box corresponding to the active manifest of the ingredient. Cannot be combined with digitalSourceType."
},
"digitalSourceType": {
"type": "string",
"description": "One of the source types defined at https://cv.iptc.org/newscodes/digitalsourcetype/ or in this specification. Cannot be combined with activeManifest."
},
"relatedAssertions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedUriMap"
},
"description": "Hashed JUMBF URI(s) to assertion(s) related to this ingredient that are neither ingredients nor actions."
},
"claimSignature": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI to the Claim Signature box in the C2PA Manifest of the ingredient"
},
"thumbnail": {
"$ref": "#/definitions/hashedUriMap",
"description": "Hashed URI reference to a thumbnail in an embedded data assertion"
},
"description": {
"type": "string",
"description": "Additional description of the ingredient"
},
"informationalURI": {
"type": "string",
"description": "URI to an informational page about the ingredient or its data (v3 camelCase)"
},
"softBindingsMatched": {
"type": "boolean",
"description": "Whether soft bindings were matched"
},
"softBindingAlgorithmsMatched": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
},
"description": "Array of algorithm names used for discovering the active manifest"
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"hashedExtUriMap": {
"type": "object",
"description": "Reference to an external URL and its hash. CDDL: hashed-ext-uri.cddl $hashed-ext-uri-map. Used in ingredient v2/v3 data field.",
"properties": {
"url": {
"type": "string",
"description": "HTTP/HTTPS URI reference to external data",
"format": "uri"
},
"alg": {
"type": "string",
"description": "String identifying the cryptographic hash algorithm used to compute the hash on this URI's data, taken from the C2PA hash algorithm identifier list."
},
"hash": {
"type": "string",
"description": "Base64-encoded with b64' prefix hash value of the external data"
},
"dc:format": {
"type": "string",
"description": "IANA media type of the data (optional)"
},
"size": {
"type": "integer",
"description": "Number of bytes of data (optional)"
},
"data_types": {
"type": "array",
"description": "Additional information about the data's type (optional)",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"url",
"alg",
"hash"
],
"additionalProperties": false
},
"thumbnailAssertion": {
"type": "object",
"description": "Thumbnail assertion (e.g. c2pa.thumbnail.claim.jpeg, c2pa.thumbnail.ingredient.jpeg). No CDDL in INTERNAL/cddl; structure is CrJSON/schema-defined.",
"properties": {
"thumbnailType": {
"type": "integer",
"description": "Thumbnail type (0=claim, 1=ingredient)"
},
"mimeType": {
"type": "string",
"description": "MIME type of thumbnail"
}
},
"additionalProperties": false
},
"bmffExclusionsMap": {
"type": "object",
"description": "Exclusion entry for BMFF hash. CDDL: bmff-hash.cddl exclusions-map.",
"required": [
"xpath"
],
"properties": {
"xpath": {
"type": "string",
"description": "Location of box(es) to exclude (XPath from root node)"
},
"length": {
"type": "integer",
"minimum": 0,
"description": "Length that a leafmost box must have to be excluded"
},
"data": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/bmffDataMap"
},
"description": "Data at relative byte offset that must match for box to be excluded"
},
"subset": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/bmffSubsetMap"
},
"description": "Portion of the excluded box that is excluded from the hash"
},
"version": {
"type": "integer",
"description": "Version that must be set in a leafmost FullBox for the box to be excluded"
},
"flags": {
"type": "string",
"description": "24-bit flags (3-byte byte string, e.g. Base64-encoded with b64' prefix in JSON). Only for FullBox when version is specified."
},
"exact": {
"type": "boolean",
"description": "If true, flags must be an exact match (default true). Only for FullBox when flags is specified."
}
},
"additionalProperties": false
},
"bmffDataMap": {
"type": "object",
"description": "CDDL: bmff-hash.cddl data-map.",
"required": [
"offset",
"value"
],
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"description": "Relative byte offset in the leafmost box"
},
"value": {
"type": "string",
"description": "Byte string (e.g. Base64 in JSON) that must match at the offset"
}
},
"additionalProperties": false
},
"bmffSubsetMap": {
"type": "object",
"description": "CDDL: bmff-hash.cddl subset-map.",
"required": [
"offset",
"length"
],
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"description": "Relative byte offset within the excluded box"
},
"length": {
"type": "integer",
"minimum": 0,
"description": "Number of bytes in this subset"
}
},
"additionalProperties": false
},
"bmffMerkleMap": {
"type": "object",
"description": "Merkle tree row for mdat verification. CDDL: bmff-hash.cddl merkle-map.",
"required": [
"uniqueId",
"localId",
"count",
"hashes"
],
"properties": {
"uniqueId": {
"type": "integer",
"description": "1-based unique id to determine which Merkle tree validates a given mdat box"
},
"localId": {
"type": "integer",
"description": "Local id indicating Merkle tree"
},
"count": {
"type": "integer",
"description": "Number of leaf nodes in the Merkle tree (null nodes not included)"
},
"alg": {
"type": "string",
"description": "Hash algorithm for this Merkle tree; if absent, from enclosing structure"
},
"initHash": {
"type": "string",
"description": "Hash of init segment or bytes before first moof (fragmented MP4); absent for non-fragmented"
},
"hashes": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
},
"description": "Ordered array representing a single row of the Merkle tree (e.g. Base64 in JSON)"
},
"fixedBlockSize": {
"type": "integer",
"minimum": 0,
"description": "Size in bytes of a leaf node (non-fragmented MP4, piecewise mdat validation)"
},
"variableBlockSizes": {
"type": "array",
"minItems": 1,
"items": {
"type": "integer",
"minimum": 0
},
"description": "Size in bytes of each leaf node (non-fragmented MP4); length equals count"
}
},
"additionalProperties": false
},
"hashBmffAssertion": {
"type": "object",
"description": "BMFF hash assertion (c2pa.hash.bmff.v2). CDDL: bmff-hash.cddl bmff-hash-map, exclusions-map, merkle-map.",
"required": [
"exclusions"
],
"properties": {
"exclusions": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/bmffExclusionsMap"
},
"description": "Box(es) to exclude from the hash"
},
"alg": {
"type": "string",
"description": "Hash algorithm; if absent, from enclosing structure (C2PA hash algorithm identifier list)"
},
"hash": {
"type": "string",
"description": "Hash of BMFF/segment excluding exclusions (e.g. Base64 in JSON)"
},
"merkle": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/bmffMerkleMap"
},
"description": "Merkle tree rows for verification of mdat box(es) or fragment files"
},
"name": {
"type": "string",
"description": "Human-readable description of what this hash covers"
},
"url": {
"type": "string",
"format": "uri",
"description": "Unused and deprecated"
},
"sequenceNumber": {
"type": "integer",
"minimum": 0,
"description": "In a live media workflow, the monotonically increasing sequence number for each segment"
}
},
"additionalProperties": false
},
"validationResults": {
"type": "object",
"description": "Validation results (active manifest and optional ingredient deltas). CDDL: validation-results.cddl validation-results-map. Used in ingredient assertions (e.g. c2pa.ingredient.v3).",
"properties": {
"activeManifest": {
"$ref": "#/definitions/statusCodes",
"description": "Validation status codes for the active manifest. Present when ingredient is a C2PA asset."
},
"ingredientDeltas": {
"type": "array",
"description": "Validation deltas per ingredient assertion. Present when the ingredient is a C2PA asset.",
"items": {
"$ref": "#/definitions/ingredientDeltaValidationResult"
}
},
"specVersion": {
"type": "string",
"description": "The version of the specification against which the validation was performed (SemVer formatted string)",
"pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
},
"trustListUri": {
"type": "string",
"format": "uri",
"description": "(DEPRECATED) URI to the single trust list that was used to validate certificates. Mutually exclusive with trustListUris."
},
"trustListUris": {
"type": "array",
"items": {
"$ref": "#/definitions/trustListUriEntry"
},
"minItems": 1,
"description": "Trust list(s) used to validate the certificates in the trust chain. Mutually exclusive with trustListUri."
}
},
"not": {
"required": ["trustListUri", "trustListUris"]
},
"required": [
"activeManifest"
],
"additionalProperties": false
},
"statusCodes": {
"type": "object",
"description": "Success, informational, and failure validation status codes. CDDL: validation-results.cddl status-codes-map.",
"properties": {
"success": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
},
"informational": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
},
"failure": {
"type": "array",
"items": {
"$ref": "#/definitions/validationStatusEntry"
}
}
},
"required": [
"success",
"informational",
"failure"
],
"additionalProperties": false
},
"validationStatusEntry": {
"type": "object",
"description": "Single validation status (code, optional url/resourceUrl and explanation). CDDL: validation-result-structs.cddl status-map. At most one of url and resourceUrl may be present.",
"properties": {
"code": {
"type": "string",
"description": "Validation status code"
},
"url": {
"type": "string",
"description": "JUMBF URI reference to the JUMBF box to which this status code applies"
},
"resourceUrl": {
"type": "string",
"description": "The url or uri value of the specific entry (e.g. in a linked resource integrity assertion) to which this status code applies"
},
"explanation": {
"type": "string",
"description": "Human-readable explanation"
}
},
"not": {
"required": ["url", "resourceUrl"]
},
"required": [
"code"
],
"additionalProperties": false
},
"trustListUriEntry": {
"type": "object",
"description": "A trust list containing a matching trust anchor during claim signature or TSA time-stamp validation. CDDL: validation-result-structs.cddl trust-list-uri-map.",
"properties": {
"uri": {
"type": "string",
"format": "uri",
"description": "URI identifying the trust list"
},
"type": {
"type": "string",
"pattern": "([\\da-zA-Z_-]+\\.)+[\\da-zA-Z_-]+",
"description": "Label identifying the type of trust list: `c2pa.trustList` for claim-signing credentials, `c2pa.tsaTrustList` for TSA credentials, or a custom type using entity-specific namespace syntax"
},
"identifier": {
"type": "string",
"description": "Optional unique identifier for a specific instance of the trust list, which may be a version number, a hash, or other unique identifier"
}
},
"required": [
"uri",
"type"
],
"additionalProperties": false
},
"ingredientDeltaValidationResult": {
"type": "object",
"description": "Validation deltas for one ingredient's manifest. CDDL: validation-results.cddl ingredient-delta-validation-result-map.",
"properties": {
"ingredientAssertionURI": {
"type": "string",
"description": "JUMBF URI to the ingredient assertion"
},
"validationDeltas": {
"$ref": "#/definitions/statusCodes"
}
},
"required": [
"ingredientAssertionURI",
"validationDeltas"
],
"additionalProperties": false
},
"linkedResourceIntegrityAssertion": {
"type": "object",
"description": "Linked resource integrity assertion (c2pa.linked-resource-integrity). CDDL: linked-resource-integrity.cddl linked-resource-integrity-map.",
"required": [
"resources"
],
"properties": {
"resources": {
"description": "The resources - either external or relative - that are part of the asset, and their associated hashes",
"oneOf": [
{
"$ref": "#/definitions/externalResourcesMap"
},
{
"$ref": "#/definitions/relativeResourcesMap"
}
]
},
"allURIsIncluded": {
"type": "boolean",
"description": "If true, all URIs embedded in the container format are covered by this assertion. If false or absent, additional unreferenced URIs may exist."
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"externalResourcesMap": {
"type": "object",
"description": "External resources with cryptographic hashes, used when the container format only supports absolute references. CDDL: linked-resource-integrity.cddl external-resources-map.",
"required": [
"externalResources"
],
"properties": {
"externalResources": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/hashedExtUriMap"
},
"description": "External resources identified by absolute URL, each with its own hash and alg"
}
},
"additionalProperties": false
},
"relativeResourcesMap": {
"type": "object",
"description": "Relative resources with cryptographic hashes, used when the container format supports references relative to the asset. CDDL: linked-resource-integrity.cddl relative-resources-map.",
"required": [
"relativeResources",
"alg"
],
"properties": {
"relativeResources": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/definitions/uriHashedDataMap"
},
"description": "Resources identified by a URI relative to the asset"
},
"alg": {
"type": "string",
"description": "Cryptographic hash algorithm used to compute the hash on each entry of the relativeResources array (C2PA hash algorithm identifier list)"
}
},
"additionalProperties": false
},
"uriHashedDataMap": {
"type": "object",
"description": "Reference to a resource by relative URI and its hash. CDDL: uri-hashed-data.cddl $uri-hashed-data-map.",
"required": [
"uri",
"hash"
],
"properties": {
"uri": {
"type": "string",
"description": "Relative URI reference"
},
"hash": {
"type": "string",
"description": "Hash value (Base64-encoded with b64' prefix)"
},
"size": {
"type": "integer",
"description": "Number of bytes of data"
},
"dc:format": {
"type": "string",
"description": "IANA media type of the data"
},
"data_types": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"description": "Asset type per C2PA CDDL $asset-type-map",
"additionalProperties": true
},
"description": "Additional information about the data's type"
}
},
"additionalProperties": false
},
"hashSegmentAssertion": {
"type": "object",
"description": "Segment hash assertion for append-only plain-text files (c2pa.hash.segment). CDDL: segment-hash.cddl segment-hash-map.",
"required": [
"version",
"hash",
"segmentStart",
"segmentEnd"
],
"properties": {
"version": {
"type": "integer",
"const": 1,
"description": "Version of this assertion format. Always 1 for this version of the specification."
},
"alg": {
"type": "string",
"description": "Hash algorithm used to compute hash and predecessorSentinel.hash; if absent, taken from the enclosing structure"
},
"hash": {
"type": "string",
"description": "Hash of the segment bytes [segmentStart, segmentEnd), Base64-encoded with b64' prefix"
},
"segmentStart": {
"type": "integer",
"minimum": 0,
"description": "Byte offset of the first byte of the segment (inclusive); 0 for the first checkpoint"
},
"segmentEnd": {
"type": "integer",
"minimum": 0,
"description": "Byte offset of the first byte of the sentinel line (exclusive end of the segment)"
},
"sentinelLength": {
"type": "integer",
"minimum": 0,
"description": "Byte length of the sentinel line, including its line ending. Present when the sentinel references an external URI; absent when the manifest is embedded inline in the sentinel."
},
"predecessorSentinel": {
"$ref": "#/definitions/predecessorSentinelMap",
"description": "Locates and authenticates the immediately preceding sentinel line. Required for every checkpoint after the first; absent for the first."
},
"metadata": {
"$ref": "#/definitions/assertionMetadataMap"
}
},
"additionalProperties": false
},
"predecessorSentinelMap": {
"type": "object",
"description": "Locates and authenticates the immediately preceding sentinel line. CDDL: segment-hash.cddl predecessor-sentinel-map.",
"required": [
"start",
"length",
"hash"
],
"properties": {
"start": {
"type": "integer",
"minimum": 0,
"description": "Byte offset of the first byte of the preceding sentinel line"
},
"length": {
"type": "integer",
"minimum": 0,
"description": "Byte length of the preceding sentinel line including its line ending"
},
"hash": {
"type": "string",
"description": "Hash of bytes [start, start + length), using the alg of the enclosing segment-hash-map; Base64-encoded with b64' prefix"
}
},
"additionalProperties": false
}
}
}
