Struct ClassHash

pub struct ClassHash(/* private fields */);

A type-safe wrapper for Starknet class hashes.

Class hashes are 256-bit values represented as hexadecimal strings prefixed with “0x”. This type ensures that only valid class hashes can be constructed and used throughout the application.

Format Requirements

• Must start with “0x”
• Must contain only hexadecimal characters (0-9, a-f, A-F)
• Must be at most 66 characters long (including “0x” prefix)

Examples

use verifier::class_hash::ClassHash;

// Valid class hash
let hash = ClassHash::new("0x044dc2b3239382230d8b1e943df23b96f52eebcac93efe6e8bde92f9a2f1da18")?;
println!("Hash: {}", hash);

// Shorter hashes are also valid
let short_hash = ClassHash::new("0x123")?;
println!("Short hash: {}", short_hash);

// Invalid hashes will return an error
assert!(ClassHash::new("invalid").is_err());
assert!(ClassHash::new("0xGGG").is_err());

Implementations

impl ClassHash

pub fn new(raw: &str) -> Result<Self, ClassHashError>

Creates a new ClassHash from a string.

Validates that the input string follows the correct format for a Starknet class hash:

• Must start with “0x”
• Must contain only hexadecimal characters (0-9, a-f, A-F)
• Must be at most 66 characters long (including “0x” prefix)

Arguments

• raw - The string representation of the class hash

Returns

Returns Ok(ClassHash) if the input is valid, or Err(ClassHashError) with detailed error information if the input is invalid.

Examples

use verifier::class_hash::ClassHash;

// Valid class hash
let hash = ClassHash::new("0x044dc2b3239382230d8b1e943df23b96f52eebcac93efe6e8bde92f9a2f1da18")?;
println!("Created hash: {}", hash);

// Invalid format will return an error
let result = ClassHash::new("invalid_hash");
assert!(result.is_err());

Errors

Returns ClassHashError::Match if the input doesn’t match the expected format, or ClassHashError::RegexError if there’s an internal regex compilation error.

Trait Implementations

impl AsRef<String> for ClassHash

fn as_ref(&self) -> &String

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for ClassHash

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ClassHash

fn clone(&self) -> ClassHash

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClassHash

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ClassHash

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Ord for ClassHash

fn cmp(&self, other: &ClassHash) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ClassHash

fn eq(&self, other: &ClassHash) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for ClassHash

fn partial_cmp(&self, other: &ClassHash) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for ClassHash

impl StructuralPartialEq for ClassHash