13 releases

new 0.1.3 Jun 13, 2024
0.1.2 May 18, 2024
0.1.1 Apr 25, 2024
0.0.11 Mar 27, 2024
0.0.5 Dec 22, 2023

#1028 in Magic Beans

Download history 1013/week @ 2024-02-22 547/week @ 2024-02-29 604/week @ 2024-03-07 979/week @ 2024-03-14 1400/week @ 2024-03-21 1405/week @ 2024-03-28 4068/week @ 2024-04-04 6755/week @ 2024-04-11 7982/week @ 2024-04-18 6890/week @ 2024-04-25 7990/week @ 2024-05-02 2807/week @ 2024-05-09 4570/week @ 2024-05-16 4237/week @ 2024-05-23 6082/week @ 2024-05-30 3368/week @ 2024-06-06

18,798 downloads per month
Used in papyrus_common

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