Cairo Library

The Garaga Cairo library is available on the scarbs.xyz registry, the official package registry for Cairo/Scarb projects.

Quick Install

The recommended way to add Garaga to your Cairo project:

scarb add garaga

This will add the latest version to your Scarb.toml.

Manual Installation

Alternatively, add Garaga directly to your Scarb.toml:

[dependencies]
garaga = "1.0.1"

[cairo]
sierra-replace-ids = false  # Required for Garaga

Important: The sierra-replace-ids = false setting is required for Garaga to compile correctly.

Installing a Specific Version

To install a specific version:

scarb add garaga@1.0.1

Or in Scarb.toml:

[dependencies]
garaga = "=1.0.1"  # Exact version

Installing from Git

If you need an unreleased version or a specific commit:

[dependencies]
garaga = { git = "https://github.com/keep-starknet-strange/garaga.git", tag = "v1.0.1" }

Or from a specific branch/commit:

[dependencies]
garaga = { git = "https://github.com/keep-starknet-strange/garaga.git", branch = "main" }

For more information on managing dependencies with Scarb, see the Scarb documentation.

Version Compatibility

Version Matching: When using Garaga SDKs (Python, Rust, npm) to generate calldata, ensure the Cairo library version matches the SDK version. Mismatched versions may produce incompatible calldata.

For example, if using pip install garaga==1.0.1, use garaga = "1.0.1" in your Scarb.toml.

Usage

After installation, you can import Garaga modules:

use garaga::definitions::{G1Point, u384};
use garaga::ec_ops::msm_g1;
use garaga::signatures::ecdsa::{ECDSASignatureWithHint, is_valid_ecdsa_signature_assuming_hash};

See Using Garaga Libraries for detailed usage documentation.

Registry Links

• Package Page: scarbs.xyz/packages/garaga

• Source Code: github.com/keep-starknet-strange/garaga