c2pa_raw_crypto 0.1.1

Raw cryptographic signing and validation primitives for C2PA
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

// Copyright 2026 Adobe. All rights reserved.
// This file is licensed to you under the Apache License,
// Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
// or the MIT license (http://opensource.org/licenses/MIT),
// at your option.

// Unless required by applicable law or agreed to in writing,
// this software is distributed on an "AS IS" BASIS, WITHOUT
// WARRANTIES OR REPRESENTATIONS OF ANY KIND, either express or
// implied. See the LICENSE-MIT and LICENSE-APACHE files for the
// specific language governing permissions and limitations under
// each license.

#![doc = include_str!("../README.md")]
#![deny(missing_docs)]

// Note: `SigningAlg` is defined in this crate, so `#[non_exhaustive]` does not
// force a wildcard arm on the matches below; downstream crates, however, must
// account for future algorithms.
//
// Backend selection: `rust_native_crypto` takes precedence. When both features
// are enabled (which can happen through Cargo feature unification in a
// workspace), the signer/validator dispatch uses the rust-native backend; the
// OpenSSL backend is still compiled but goes unused. The OpenSSL backend is
// exercised only when `openssl` is enabled and `rust_native_crypto` is not.

pub mod ec_utils;
pub mod oids;

mod oid;
pub use oid::Oid;

// The OpenSSL backend is *compiled* whenever the `openssl` feature is enabled,
// but the runtime dispatch (see `signer.rs` / `validator.rs`) only selects it
// when `rust_native_crypto` is not also enabled. This split keeps the API
// surface (e.g. `OpenSslMutex`) consistent for downstream crates regardless of
// how Cargo unifies features.
#[cfg(feature = "openssl")]
mod openssl;
#[cfg(feature = "openssl")]
pub use openssl::{OpenSslMutex, OpenSslMutexUnavailable};

#[cfg(feature = "rust_native_crypto")]
mod rust_native;

mod signer;
pub use signer::{RawSigner, RawSignerError, signer_from_private_key};

mod signing_alg;
pub use signing_alg::{SigningAlg, UnknownAlgorithmError};

#[cfg(test)]
mod tests;

mod validator;
pub use validator::{
    RawSignatureValidationError, RawSignatureValidator, validator_for_sig_and_hash_algs,
    validator_for_signing_alg,
};