hotmint-crypto 0.2.0

Cryptographic primitives for Hotmint: Ed25519, Blake3, aggregate signatures
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
60
61
62

# hotmint-crypto

[![crates.io](https://img.shields.io/crates/v/hotmint-crypto.svg)](https://crates.io/crates/hotmint-crypto)
[![docs.rs](https://docs.rs/hotmint-crypto/badge.svg)](https://docs.rs/hotmint-crypto)

Cryptographic implementations for the [Hotmint](https://github.com/rust-util-collections/hotmint) BFT consensus framework.

Provides concrete implementations of the `Signer` and `Verifier` traits defined in `hotmint-types`, using Ed25519 for digital signatures and Blake3 for block hashing.

## Components

| Component | Description |
|:----------|:------------|
| `Ed25519Signer` | Implements `Signer` using ed25519-dalek |
| `Ed25519Verifier` | Implements `Verifier` for single and aggregate signature verification |
| `hash_block()` | Blake3 hashing of block fields |

## Usage

```rust
use hotmint_types::{Signer, ValidatorId};
use hotmint_crypto::{Ed25519Signer, Ed25519Verifier};

// Generate a random keypair
let signer = Ed25519Signer::generate(ValidatorId(0));

// Sign a message
let sig = signer.sign(b"hello");
let pk = signer.public_key();

// Verify
let verifier = Ed25519Verifier;
assert!(verifier.verify(&pk, b"hello", &sig));
```

### Construct from existing key

```rust
use ed25519_dalek::SigningKey;

let signing_key = SigningKey::from_bytes(&secret_key_bytes);
let signer = Ed25519Signer::new(signing_key, ValidatorId(0));
```

### Block hashing

```rust
use hotmint_crypto::hash_block;
use hotmint_types::{Height, BlockHash, ViewNumber, ValidatorId};

let hash = hash_block(
    Height(1),
    &BlockHash::default(),
    ViewNumber(0),
    ValidatorId(0),
    b"payload",
);
```

## License

GPL-3.0-only