5 releases

0.1.5 Oct 24, 2021
0.1.4 Jul 20, 2021
0.1.3 Jun 18, 2021
0.1.1 May 24, 2021
0.1.0 May 24, 2021

#749 in Cryptography

Download history 48/week @ 2022-06-03 30/week @ 2022-06-10 14/week @ 2022-06-17 75/week @ 2022-06-24 78/week @ 2022-07-01 21/week @ 2022-07-08 84/week @ 2022-07-15 58/week @ 2022-07-22 85/week @ 2022-07-29 70/week @ 2022-08-05 54/week @ 2022-08-12 69/week @ 2022-08-19 25/week @ 2022-08-26 71/week @ 2022-09-02 112/week @ 2022-09-09 91/week @ 2022-09-16

302 downloads per month
Used in kem

MIT license

27KB
611 lines

Crate License Coverage Status Workflow Status Maintenance

x3dh-ke

Implementation of X3DH

Implementation of extended triple diffie hellman written in Rust, as described by Signal. WARNING! This crate hasn't been reviewed and may include serious faults. Use with care.

Example Usage:

Standard:

use x3dh_ke::{IdentityKey, SignedPreKey, EphemeralKey, OneTimePreKey, Key, x3dh_a, x3dh_b};
let ika = IdentityKey::default();
let ikas = ika.strip();
let ikb = IdentityKey::default();
let ikbs = ikb.strip();
let spkb = SignedPreKey::default();
let spkbs = spkb.strip();
let eka = EphemeralKey::default();
let ekas = eka.strip();
let opkb = OneTimePreKey::default();
let opkbs = opkb.strip();
let signature = ikb.sign(&spkbs.pk_to_bytes());
let cka = x3dh_a(&signature, &ika, &spkbs, &eka, &ikbs, &opkbs).unwrap();
let ckb = x3dh_b(&ikas, &spkb, &ekas, &ikb, &opkb);
assert_eq!(cka, ckb)

Serialize and Deserialize

Every key described by this library can be turned into bytes and created from them too.

use x3dh_ke::{IdentityKey, Key};
let ika = IdentityKey::default();
let data = ika.to_bytes();
let ikr = IdentityKey::from_bytes(&data).unwrap();
assert_eq!(ika.to_bytes(), ikr.to_bytes())

Strip Private Key

To share a key, the private part has to be striped previously from that.

use x3dh_ke::{IdentityKey, Key};
let ika = IdentityKey::default();
let _iks = ika.strip(); // Without private key

WASM

This crate supports WASM. In order to do that, enable the wasm feature.

Current version: 0.1.3

License: MIT

Dependencies

~2.5MB
~48K SLoC