Crate csidh

CSIDH algorithm implementation

Pure Rust implementation of the CSIDH cryptographic algorithm for secret key exchange.

CSIDH-512 as defined in Castryck, W., Lange, T., Martindale, C., Panny, L., Renes, J.: CSIDH: An efficient post-quantum commutative group action. In: Peyrin, T., Galbraith, S. (eds.) ASIACRYPT 2018, LNCS 11274. pp. 395–427. Springer (2018) is available.

Propositions for CSIDH-1024 and CSIDH-1792 are available too.

Example

An example using CSIDH-512:

use csidh::{CsidhParams, PrivateKey, PrivateKeyCsidh512, PublicKey, SharedSecret};

let mut rng = rand::thread_rng();

// Alice
const ALICE_PRIVATE_KEY: PrivateKeyCsidh512 = PrivateKey::new(
    CsidhParams::CSIDH_512,
    [
        8, 2, 9, 3, 3, 0, 7, 2, 0, 8, 1, 9, 9, 4, 0, 10, 6, 3, 10, 7, 2, 3, 1, 4, 5, 3, 9, 10,
        9, 3, 8, 5, 1, 10, 2, 4, 2, 10, 1, 1, 10, 8, 0, 9, 1, 8, 7, 6, 10, 9, 9, 4, 10, 6, 4,
        4, 2, 3, 5, 5, 5, 3, 0, 9, 6, 9, 8, 5, 5, 9, 2, 0, 3, 6,
    ],
);
let alice_public_key = PublicKey::from(ALICE_PRIVATE_KEY, &mut rng);

// Bob
const BOB_PRIVATE_KEY: PrivateKeyCsidh512 = PrivateKey::new(
    CsidhParams::CSIDH_512,
    [
        1, 2, 0, 6, 2, 1, 2, 6, 4, 3, 10, 1, 4, 0, 1, 7, 5, 6, 9, 10, 8, 9, 7, 5, 4, 7, 10, 10,
        5, 6, 5, 2, 1, 4, 0, 6, 0, 3, 8, 7, 0, 10, 0, 3, 0, 3, 6, 9, 2, 3, 4, 4, 3, 3, 0, 10,
        10, 2, 1, 4, 8, 10, 6, 0, 7, 1, 2, 7, 2, 0, 9, 9, 0, 6,
    ],
);
let bob_public_key = PublicKey::from(BOB_PRIVATE_KEY, &mut rng);

// Shared secret
let alice_shared_secret = SharedSecret::from(bob_public_key, ALICE_PRIVATE_KEY, &mut rng);
let bob_shared_secret = SharedSecret::from(alice_public_key, BOB_PRIVATE_KEY, &mut rng);
assert_eq!(alice_shared_secret, bob_shared_secret);

Re-exports

pub use crypto_bigint::impl_modulus;

pub use crypto_bigint::modular::ConstMontyForm;

pub use crypto_bigint::Uint;

Structs

CsidhParams

Parameters of the CSIDH key exchange.

PrivateKey

A private key for the CSIDH key exchange.

PublicKey

A public key for the CSIDH key exchange.

SharedSecret

A shared secret created with the CSIDH key exchange.

Type Aliases

PrivateKeyCsidh512

A helper type for const CSIDH-512 private key declaration.

PrivateKeyCsidh1024

A helper type for const CSIDH-1024 private key declaration.

PrivateKeyCsidh1792

A helper type for const CSIDH-1792 private key declaration.