bcx-crypto 0.4.0

Crypto-agile BCX envelope metadata and verifier traits.
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

# bcx-crypto

Crypto-agile signature envelope metadata for the main
[`bcx`](https://crates.io/crates/bcx) crate.

This crate belongs to the BCX workspace. It is published separately so the main
crate can keep small internal modules and precise dependency boundaries, but it
is not meant to be used as a standalone protocol product. Prefer depending on
`bcx` unless you are working on BCX internals.

## Example

```rust
use bcx_core::Digest;
use bcx_crypto::{ExactAlgorithmPolicy, SignatureAlgorithm, SignatureEnvelope};
use bcx_wire::WireLimits;

let signature = [7; SignatureAlgorithm::ED25519_SIGNATURE_LEN];
let limits = WireLimits::new(64 * 1024, 16, 5, 100).unwrap();
let envelope = SignatureEnvelope::new(
    Digest::new([1; Digest::LEN]),
    SignatureAlgorithm::Ed25519,
    &signature,
    limits,
)
.unwrap();
let policy = ExactAlgorithmPolicy::new(SignatureAlgorithm::Ed25519);

assert!(policy.admits(envelope.algorithm()));
```

## Notes

- `no_std` by default.
- This crate defines metadata and verifier traits, not cryptographic provider
  implementations.
- Hybrid signature verification requires both components to be checked.