#team-crypto #ff #finite-fields #ce


Library for building and interfacing with finite fields

17 unstable releases

new 0.14.3 Nov 30, 2022
0.14.1 Jun 23, 2022
0.13.1 May 14, 2021
0.12.0 Aug 10, 2020
0.6.0 Mar 31, 2019

#189 in Rust patterns

Download history 2186/week @ 2022-08-13 3064/week @ 2022-08-20 3025/week @ 2022-08-27 3125/week @ 2022-09-03 3716/week @ 2022-09-10 3094/week @ 2022-09-17 3420/week @ 2022-09-24 3594/week @ 2022-10-01 3732/week @ 2022-10-08 3620/week @ 2022-10-15 3171/week @ 2022-10-22 3293/week @ 2022-10-29 4943/week @ 2022-11-05 4156/week @ 2022-11-12 3298/week @ 2022-11-19 2516/week @ 2022-11-26

15,534 downloads per month
Used in 13 crates (4 directly)


590 lines

"FF community edition"

This library is community maintained fork of the original ff library by Sean Bowe. Name of the library is changed to allow publishing to the crates.io

Original ff

ff is a finite field library written in pure Rust, with no unsafe{} code.


  • This library does not provide constant-time guarantees.


Add the ff_ce crate to your Cargo.toml:

ff_ce = "0.6"

The ff_ce crate contains Field, PrimeField, PrimeFieldRepr and SqrtField traits. See the documentation for more.


If you need an implementation of a prime field, this library also provides a procedural macro that will expand into an efficient implementation of a prime field when supplied with the modulus. PrimeFieldGenerator must be an element of Fp of p-1 order, that is also quadratic nonresidue.

First, enable the derive crate feature:

ff = { ..., features = ["derive"] }

And then use the macro like so:

extern crate rand;
extern crate ff_ce;

#[PrimeFieldModulus = "52435875175126190479447740508185965837690552500527637822603658699938581184513"]
#[PrimeFieldGenerator = "7"]
struct Fp(FpRepr);

And that's it! Fp now implements Field and PrimeField. Fp will also implement SqrtField if supported. The library implements FpRepr itself and derives PrimeFieldRepr for it.


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~17K SLoC