Skip to main content

Release notes

Refer to the CHANGELOG for detailed changes derived from Git commit history.

Embeddable API

Release 0.77.0 adds a new embeddable manifest API with Context/Settings, CAWG, and BMFF.v3 support. For details, see Embeddable signing API.

API Changes for C2PA 2.2

Reader has some new methods:

  • validation_state() returns ValidationState, which can be Invalid, Valid or Trusted. Use this method instead of checking for validation_status() = None.
  • validation_results() returns ValidationResults, which is a more complete form of ValidationStatus and returns success, informational, and failure codes for the active manifest and ingredients. ValidationStatus is deprecated in favor of ValidationResults.

Ingredient now supports a validation_results() method and a validation_results field.

An AssetType assertion is now supported.

C2PA v2 claims

note

The library now supports C2PA v2 claims by default. V2 claims have many new checks and status codes. Additionally:

  • The title() and format() methods of both Manifest and Ingredient objects now return an Option<String> because in v2 claims, title is optional and format does not exist.
  • The first action must be c2pa.created or c2pa.opened (which requires an ingredient).
warning

Implementations should not generate deprecated v1 claims. If needed, though, you can generate v1 claims by setting the Builder manifest definition claim_version field to 1.