Binius

Binius is a Rust library implementing a cryptographic succinct non-interactive argument of knowledge (SNARK) over towers of binary fields. The techniques are described formally in the paper Succinct Arguments over Towers of Binary Fields.

This library is a work in progress. It is not yet ready for use, but may be of interest for experimentation.

Usage

At this stage, the primary interfaces are the unit tests and benchmarks. The benchmarks use the criterion library.

To run the benchmarks, use the command cargo bench. To run the unit tests, use the command cargo test.

Binius implements optimizations for certain target architectures. To enable these, export the environment variable

RUSTFLAGS="-C target-cpu=native"

Binius has notable optimizations on Intel processors featuring the Galois Field New Instructions (GFNI) instruction set extension. To determine if your processor supports this feature, run

rustc --print cfg -C target-cpu=native | grep gfni

If the output of the command above is empty, the processor does not support these instructions.

Examples

There are examples of simple commit-and-prove SNARKs in the examples directory. For example, you may run

cargo run --release --example bitwise_and_proof

The environment variable PROFILE_CSV_FILE can be set to an output filename to dump profiling data to a CSV file for more detailed analysis.

By default all the examples are run on a relatively small data. The environment variable BINIUS_LOG_TRACE can be used to override the default log trace size value.

Support

This project is under active development. The developers with make breaking changes at will. Any modules that are stabilized will be explicitly documented as such.

We use GitLab's issue system for tracking bugs, features, and other development tasks.

This codebase certainly contains many bugs at this point in its development. We discourage the production use of this library until future notice. Any bugs, including those affecting the security of the system, may be filed publicly as an issue.

Authors

Binius is developed by Irreducible.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

SuccinctPaul / binius