🐺 Starknet Rust types 🦀
This repository is an initiative by a group of maintainers to address the fragmentation in the Starknet Rust ecosystem and improve its interoperability. The key motivation behind this repository is to standardize the representation of the Felt (Field Element) type in Rust, which is massively used as the core and atomic type of the Cairo language and its Virtual Machine.
The Felt type is currently defined in many different crates and repositories, resulting in increased code complexity and performance issues due to the need for numerous conversions. This repository aims to mitigate these issues by providing a universal Felt type in Rust.
This repository hosts three crates:
-
stark-felt: This crate provides the universal Felt (Field Element) type for Cairo and STARK proofs. -
starknet-types-core: This crate focuses on Starknet types related to computation and execution, requiring performance and optimization for specific arithmetic and cryptographic operations. -
starknet-types-rpc: This crate deals with Starknet types used in RPC communication, serde, and transport.
You can include any of these crates in your library via crates.io or as a git dependency. For example, to include the stark-felt crate, add the following to your Cargo.toml:
As a crates.io dependency:
[dependencies]
stark-felt = "0.0.1"As a git dependency:
[dependencies]
stark-felt = { git = "https://github.com/starknet-io/types-rs" }
starknet-types-core = { git = "https://github.com/starknet-io/types-rs.git", version = "0.0.1", default-features = false, features = ["serde"] }To build the crates from source, clone the repository and run the following command:
cargo build --releaseTo run the tests, clone the repository and run the following command:
cargo testContributions are welcome! Please read our contributing guidelines for more information.
This repository is licensed under the MIT License, see LICENSE for more information.