saymrwulf/curve25519-dalek-source
1
0
Fork 0
mirror of https://github.com/saymrwulf/curve25519-dalek-source.git synced 2026-09-04 20:24:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

update readme & fix benches

Browse source
This commit is contained in:
DebugSteven 2018-11-10 16:17:19 -05:00
parent 1b64afd83d
commit cb18af7c1b
2 changed files with 18 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
README.md
View file

@ -25,28 +25,27 @@ up on modern public key cryptography and have learned a nifty trick called
kittens will be able to secretly organise to find their mittens, and then spend kittens will be able to secretly organise to find their mittens, and then spend
the rest of the afternoon nomming some yummy pie! the rest of the afternoon nomming some yummy pie!
First, Alice uses `x25519_dalek::generate_secret()` and then First, Alice uses `x25519_dalek::Ephemeral::generate_secret()` and then
`x25519_dalek::generate_public()` to produce her secret and public keys: `x25519_dalek::Ephemeral::generate_public()` to produce her secret and public keys:
```rust ```rust
extern crate x25519_dalek; extern crate x25519_dalek;
extern crate rand; extern crate rand;
use x25519_dalek::generate_secret; use x25519_dalek::Ephemeral;
use x25519_dalek::generate_public;
use rand::OsRng; use rand::OsRng;
let mut alice_csprng = OsRng::new().unwrap(); let mut alice_csprng = OsRng::new().unwrap();
let alice_secret = generate_secret(&mut alice_csprng); let alice_secret = Ephemeral::generate_secret(&mut alice_csprng);
let alice_public = generate_public(&alice_secret); let alice_public = Ephemeral::generate_public(&alice_secret);
``` ```
Bob does the same: Bob does the same:
```rust ```rust
let mut bob_csprng = OsRng::new().unwrap(); let mut bob_csprng = OsRng::new().unwrap();
let bob_secret = generate_secret(&mut bob_csprng); let bob_secret = Ephemeral::generate_secret(&mut bob_csprng);
let bob_public = generate_public(&bob_secret); let bob_public = Ephemeral::generate_public(&bob_secret);
``` ```
Alice meows across the room, telling `alice_public` to Bob, and Bob Alice meows across the room, telling `alice_public` to Bob, and Bob
@ -54,15 +53,15 @@ loudly meows `bob_public` back to Alice. Alice now computes her
shared secret with Bob by doing: shared secret with Bob by doing:
```rust ```rust
use x25519_dalek::diffie_hellman; use x25519_dalek::Ephemeral;
let shared_secret = diffie_hellman(&alice_secret, &bob_public.as_bytes()); let shared_secret = Ephemeral::diffie_hellman(&alice_secret, &bob_public);
``` ```
Similarly, Bob computes the same shared secret by doing: Similarly, Bob computes the same shared secret by doing:
```rust ```rust
let shared_secret = diffie_hellman(&bob_secret, &alice_public.as_bytes()); let shared_secret = Ephemeral::diffie_hellman(&bob_secret, &alice_public);
``` ```
Voilá! Alice and Bob can now use their shared secret to encrypt their Voilá! Alice and Bob can now use their shared secret to encrypt their

15
benches/x25519.rs
View file

@ -11,26 +11,27 @@
#[macro_use] #[macro_use]
extern crate criterion; extern crate criterion;
extern crate curve25519_dalek;
extern crate rand; extern crate rand;
extern crate x25519_dalek; extern crate x25519_dalek;
use criterion::Criterion; use criterion::Criterion;
use curve25519_dalek::montgomery::MontgomeryPoint;
use rand::OsRng; use rand::OsRng;
use x25519_dalek::generate_public; use x25519_dalek::Ephemeral;
use x25519_dalek::generate_secret;
use x25519_dalek::diffie_hellman;
fn bench_diffie_hellman(c: &mut Criterion) { fn bench_diffie_hellman(c: &mut Criterion) {
let mut csprng: OsRng = OsRng::new().unwrap(); let mut csprng: OsRng = OsRng::new().unwrap();
let alice_secret: [u8; 32] = generate_secret(&mut csprng); let alice_secret: Ephemeral = Ephemeral::generate_secret(&mut csprng);
let bob_secret: [u8; 32] = generate_secret(&mut csprng); let bob_secret: Ephemeral = Ephemeral::generate_secret(&mut csprng);
let bob_public: [u8; 32] = generate_public(&bob_secret).to_bytes(); let bob_public: MontgomeryPoint = Ephemeral::generate_public(&bob_secret);
c.bench_function("diffie_hellman", move |b| { c.bench_function("diffie_hellman", move |b| {
b.iter(|| b.iter(||
diffie_hellman(&alice_secret, &bob_public) Ephemeral::diffie_hellman(&alice_secret, &bob_public)
) )
}); });
} }