Related: REQ-008. This module defines a per-method result; it does not run watermark detection or cryptographic verification.
| Status | Meaning within the named method's scope |
|---|---|
not_checked |
Check could not run; a reason is required |
not_found |
Check ran successfully and found no supported claim |
invalid |
Check found invalid evidence; a reason is required |
recovered_claim |
A record was recovered, but its signature is absent or unchecked |
verified_claim |
Adapter reports a valid content-bound signature for the record |
signature separately records not_checked, absent, invalid, or valid.
issuer_trust separately records not_checked, untrusted, or trusted.
A valid signature never automatically makes the issuer trusted. An unsigned
record cannot receive either verified-claim status or trusted-issuer status.
Unsupported formats, missing models, timeouts and decode failures must be
reported as not_checked with a reason, never not_found. A negative result
from one method is not a global AI detector result or proof of human origin.
Confidence scores from different detectors are not treated as interchangeable.
Adapter responsibility
VerificationResult checks consistency, not truth. A caller can construct a
valid-looking result, so do not trust arbitrary JSON as verification evidence.
There is deliberately no deserializer that authenticates external results.
Actual adapters must verify content binding, signatures and a documented issuer
trust policy before setting these states. Failure messages must not contain
keys, upload contents or private identifiers.
Executable tests: test_results.py. The media adapters now exercise these distinctions on actual signed, transformed, unmarked and corrupted files; see release evidence.
Media API additions in 0.5.1
expired_credential: the native validator cannot establish a valid signing time for an expired credential. This is distinct from detected tampering.- Untrusted, mathematically valid signatures retain their raw signed claims in
JSON, but the headline is
Signature valid; issuer unverified. recovery.content_binding:exact_registered_fileonly when SHA-256 matches the registry's original; otherwisenot_verified. A matching public ID alone is not authenticated source attribution. Even perceptual similarity would not make a copy-resistant signature.- Video
watermark.sample_coveragereports matched/sample counts per engine, partial/aggregate-only evidence andwhole_video_coverage: not_established. It does not invent a whole-file confidence percentage from sampled frames. No new acceptance percentage is imposed; conflicts and absent read-back IDs still fail export as before.
A valid C2PA binding covers its signed asset; that is separate from the extent to which watermark IDs can be recovered across a video's timeline.
Several IDs, frame identity and scope (report schema 2, shipped in 0.7.3a4)
watermark.status=multiple_ids: two or more distinct IDs were read (individually or by aggregation). Every ID stays inwatermark.idswithstatusconfirmedorobserved, itsconfirmation_basis, per-schemebases(individual unique frames or aggregate hits) and observed positions. No ID is chosen for the file. Several IDs do not by themselves make a C2PA signature invalid;c2pa.statusis evaluated separately on the original bytes.- Confirmation counts unique decoded frames within one payload scheme. Rows
carry
frame={stream, pts, time_base}when the decoder reports them; otherwise only float time is known and that is what is compared. A frame read by two passes or views stays as two rows but is one unique frame. Different payload schemes are never merged. Unique means a distinct decoded frame identity, not independent content: pictures repeated by frame-rate conversion have different PTS and count separately, so two concordant reads are not claimed to be statistically independent. watermark.evidence_scopelists each pass: scheme, implementation, selection (sequential_from_start,uniform_positions,known_schedule_windows,whole_image), unique frames, time range and stop reason.whole_file_examinedis true when at least one scheme decoded every frame (named infull_decode_schemes) or for an image;unexamined_contentisnoneonly when every pass was exhaustive and no scheme was unavailable, otherwisenot_established. An ID applies only to the positions where it was read. Five requested uniform positions may yield fewer unique frames. A signed scheme without its decoder isnot_checked(no_decoder_for_signed_scheme).- Export read-back keeps its separate known-window rule; an ID promoted by it is
marked
reclassifiedwith basisknown_schedule_export_readback. - With several IDs,
recovery.status=per_idlists one registry result per confirmed ID, bound to the schemes that read it; unconfirmed reads are not looked up. The public API returns a bounded summary (at most 16 IDs, 8 positions each, 8 passes); frame-level rows remain in the local report.
Semantics follow the B06 contract (observations retained, conclusions may be revised). This is not a whole-file attribution or a coverage percentage.