11 releases

new 0.1.1 Apr 25, 2024
0.1.0 Apr 2, 2024
0.0.11 Mar 27, 2024
0.0.9 Feb 14, 2024
0.0.5 Dec 22, 2023

#711 in Magic Beans

Download history 1068/week @ 2024-01-03 1035/week @ 2024-01-10 738/week @ 2024-01-17 611/week @ 2024-01-24 402/week @ 2024-01-31 708/week @ 2024-02-07 605/week @ 2024-02-14 1055/week @ 2024-02-21 511/week @ 2024-02-28 647/week @ 2024-03-06 850/week @ 2024-03-13 863/week @ 2024-03-20 1774/week @ 2024-03-27 3068/week @ 2024-04-03 6132/week @ 2024-04-10 6569/week @ 2024-04-17

17,832 downloads per month

MIT license

110KB
2.5K SLoC

starknet-types-core

Core types representation for Starknet.

Overview

The starknet-types-core crate provides:

  • The universal Felt (Field Element) type for Cairo and STARK proofs. It was created to reduce the fragmentation in the Starknet Rust ecosystem by providing a standardized representation of the Felt type.

Features

Always on

  • Standardized Felt type: Simplify your codebase by using our standardized Felt type. Optimized for performance: The Felt type has been optimized for high-performance applications.
  • No_std support ✅

Serde

  • Provides a Serialization and Deserialization implementations for the Felt type
  • No_std support ✅

Parity Scale Codec

  • Provides Serialization and Deserialization implementations for the Felt type within the Parity serialization framework
  • No_std support ✅

Arbitrary

  • Provides an Arbitrary implementations for the Felt type

Curve

  • Add the AffinePoint and ProjectivePoint structs, which represent points on the Stark curve for performing elliptic curve operations.
  • No_std support ✅

Hash

  • Implements Pedersen hashing for Felts and Felts array

Examples

Here are some examples of how to use the starknet-types-core types:

    let felt = Felt::from(18);
    let projective_point = ProjectivePoint::new(Felt::from(0), Felt::from(1), Felt::from(0));
    let affine_point = AffinePoint::new(Felt::from(0), Felt::from(1)).unwrap();

Usage

Include starknet-types-core in your library by adding the following to your Cargo.toml:

[dependencies]
starknet-types-core = { version = "0.0.3", git = "https://github.com/starknet-io/types-rs", default-features = false, features = [
    "alloc",
    "serde",
    "arbitrary",
    "curve",
    "hash",
] }

Build from source

Clone the repository and navigate to the starknet-types-core directory. Then run:

cargo build --release

Testing

Clone the repository and navigate to the starknet-types-core directory. Then run:

cargo test

Contributing

Contributions are welcome! Please read our contributing guidelines for more information.

License

This repository is licensed under the MIT License, see LICENSE for more information.

Dependencies

~1.2–2MB
~41K SLoC