ICICLE libraries

Device Library

The ICICLE device library serves as an abstraction layer for interacting with various hardware devices. It provides a comprehensive interface for tasks such as setting the active device, querying device-specific information like free and total memory, determining the number of available devices, and managing memory allocation. Additionally, it offers functionality for copying data to and from devices, managing task queues (streams) for efficient device utilization, and abstracting the complexities of device management away from the user.

See programmers guide for more details. C++, Rust, Go

Core Library

ICICLE Core is a template library written in C++ that implements fundamental cryptographic operations, including field and curve arithmetic, as well as higher-level APIs such as MSM and NTT. Each library has a corresponding crate. See Rust and Go.

The Core can be instantiated for different fields, curves, and other cryptographic components, allowing you to tailor it to your specific needs. You can link your application to one or more ICICLE libraries, depending on the requirements of your project. For example, you might only need the babybear library or a combination of babybear and a Merkle tree builder.

Supported curves, fields and operations

This chart is scrollable horizontally & vertically. It shows feature support across different curves and fields.
Each icon represents support for a specific backend.

• A gear icon means partial support.
• A full icon without the gear means full support.
• Icons are clickable — click to reveal the backend and support type.
• For more info on specific operations, please see the API section.

Operation
AllField OpsExtension Field OpsG1G2Vector OpsExtension Vector OpsPolynomial OpsMSM G1MSM G2NTT OpsFRIECNTTSumcheckBlake3 HashBlake2s HashKeccak256 HashKeccak512 HashSha256 HashSha512 HashPoseidon HashPoseidon2 HashMerkle Tree opsMatrix OpsPairingCurve
Allbn254bls377bls381bw6grumpkinbabybearkoalabearstark252m31goldilockslabrador (babybear x koalabear)Tool
AllC++RustGoCPUCUDAMetal

Operation	bn254	bls377	bls381	bw6	grumpkin	babybear	koalabear	stark252	m31	goldilocks	labrador (babybear x koalabear)
Field Ops
Extension Field Ops
G1
G2
Vector Ops
Extension Vector Ops
Polynomial Ops
MSM G1
MSM G2
NTT Ops
FRI
ECNTT
Sumcheck
Blake3 Hash
Blake2s Hash
Keccak256 Hash
Keccak512 Hash
Sha256 Hash
Sha512 Hash
Poseidon Hash
Poseidon2 Hash
Merkle Tree ops
Matrix Ops
Pairing

Backend

Each backend must implement the device API interface. Each backend may implement

• One or more ICICLE library. For example implement only bn254 curve.
• One or more APIs in this library. For example MSM only.

See CUDA backend and Build Your Own Backend for more info about implementing a backend.