Refer to the CHANGELOG for detailed changes derived from Git commit history.
The current release has a new API that replaces the previous methods of reading and writing C2PA data, which are still supported but will be deprecated.
The new API focuses on streaming I/O and supports the following structs:
The goals of this release are to provide a consistent, flexible, well-tested API; specifically:
- Move toward a JSON + binary resources model that ports well to multiple languages.
- Eliminate multiple variations of functions for file/memory/stream, sync/async & etc.
- Have one stream-based version of each function that works sync and async.
- Design APIs that work well for multiple language bindings.
- Enable sign-only/verify-only and support usage without OpenSSL.
- Support Box Hash and Data Hashed signing models.
- Enable builds for cameras and other embedded environments.
- Provide a consistent model for setting runtime options.
- Keep porting as simple as possible.
To use the new API, enable the unstable_api feature; for example:
c2pa = {version="0.39.0", features=["unstable_api"]}
When version 1.0 of the library is released, the new API will become the default, but you will still be able to use the deprecated API by enabling the v1_api feature; for example:
c2pa = {version="0.39.0", features=["v1_api"]}
| Module | Method | C++ | Python | WASM | Node |
|---|---|---|---|---|---|
| Builder | |||||
| new | |||||
| from_json | X | X | X | ||
| set_claim_generator_info | |||||
| set_format | |||||
| set_remote_url | X | ||||
| set_no_embed | X | ||||
| set_thumbnail | |||||
| add_assertion | |||||
| add_assertion_json | |||||
| add_ingredient_from_stream | X | X | |||
| add_ingredient_from_stream_async | |||||
| add_ingredient | |||||
| add_resource | X | X | |||
| to_archive | X | X | |||
| from_archive | X | X | |||
| data_hashed_placeholder | |||||
| sign_data_hashed_embeddable | |||||
| sign_data_hashed_embeddable_async | |||||
| sign_box_hashed_embeddable | |||||
| sign_box_hashed_embeddable_async | |||||
| sign | X | X | |||
| sign_async | |||||
| sign_fragmented_files | |||||
| sign_file | X | X | |||
| Reader | |||||
| from_stream | X | ||||
| from_stream_async | |||||
| from_file | X | ||||
| from_file_async | |||||
| from_json | |||||
| from_manifest_data_and_stream | X | ||||
| from_manifest_data_and_stream_async | |||||
| from_fragment | |||||
| from_fragment_async | |||||
| from_fragmented_files | |||||
| json | |||||
| validation_status | |||||
| active_manifest | X | ||||
| active_label | |||||
| iter_manifests | |||||
| get_manifest | X | ||||
| resource_to_stream | X | X | |||
| to_folder | |||||
| CallbackSigner | |||||
| new | |||||
| set_tsa_url | |||||
| set_context | |||||
| ed25519_sign |