| commit | 3948f75f9adb2ff91578af3171b5909ae99a0e85 | [log] [tgz] |
|---|---|---|
| author | Kealan McCusker <kealanmccusker@gmail.com> | Wed Jun 26 10:01:25 2019 +0100 |
| committer | Kealan McCusker <kealanmccusker@gmail.com> | Wed Jun 26 10:01:25 2019 +0100 |
| tree | 3dd0b68b6d32dee37c03ee2ef957e23ba6582f12 |
initial commit
NOTE: Updated to Rust 2018
NOTE: This version of the library requires Version 1.31+ of Rust for 64-bit integer support and for Rust 2018.
Now AMCL version 3 is distributed as a cargo crate.
Namespaces are used to separate different curves.
To build the library and see it in action, copy all of the files in this directory and its subdirectories to a fresh root directory.
Then for example execute
cargo rustc --release --features “bn254 bls383 bls24 bls48 ed25519 nist256 goldilocks rsa2048”
This will create a build of the library for the current default target (be it 32 or 64 bits).
(To test a 32-bit environment you can follow the Web Assembly (wasm) readme instructions for rust)
Next copy the library from target/release/libamcl.rlib into the root directory and execute
rustc TestALL.rs --extern amcl=libamcl.rlib
rustc TestBLS.rs --extern amcl=libamcl.rlib
rustc BenchtestALL.rs --extern amcl=libamcl.rlib
rustc TestNHS.rs --extern amcl=libamcl.rlib
Finally execute these programs.
To add amcl functionality to your own programs, add a dependency to your Cargo.toml file. For example to use the curve bls48, add this dependency
[dependencies]
amcl = { version = “0.2.0”, optional = true, default-features = false, features = [“bls48”]}
if published to crates.io, or
amcl = { version = “0.2.0”, optional = true, default-features = false, features = [“bls48”], path=“your_amcl_location” }
And to use primitives of the needed curve in your source code:
use amcl::bls48::{ECP, ECP8}; //any primitive you need
Full list of features:
Elliptic Curves
Pairing-Friendly Elliptic Curves
RSA