Class hash computation for Cairo and Sierra contracts.

This crate provides functionality to compute class hashes for both Cairo 0.x and Sierra (Cairo 1.x+) contracts in the Starknet ecosystem. The class hash is a unique identifier for a contract's code that is used throughout the Starknet protocol.

Class Hash Types

There are two main types of class hashes:

• Cairo 0.x class hashes - Computed for legacy Cairo contracts
• Sierra class hashes - Computed for newer Cairo 1.x+ contracts using the Sierra intermediate representation

Main Components

• compute_class_hash - The main entry point for computing class hashes for both Cairo and Sierra contracts
• ComputedClassHash - An enum representing the computed hash for either contract type
• PreparedCairoContractDefinition - A prepared Cairo contract definition ready for hashing
• RawCairoContractDefinition - An unprepared Cairo contract definition

Implementation Details

Cairo Class Hash

The Cairo class hash computation follows these steps:

1. The contract definition is prepared by removing debug info and handling special cases for Cairo 0.8+ attributes
2. The prepared definition is serialized to JSON with Python-compatible formatting
3. A truncated Keccak hash is computed from the serialized JSON
4. Entry points, builtins, and bytecode are processed through hash chains
5. The final class hash is computed by combining all components

Sierra Class Hash

The Sierra class hash computation is simpler:

1. The contract version is validated
2. Entry points are processed in order
3. The ABI string is hashed
4. The Sierra program is hashed
5. All components are combined into the final hash

Compatibility

This crate maintains compatibility with the official Starknet implementation and includes extensive test vectors to ensure hash computation matches the network's expectations.

See the official Starknet documentation for more details on class hash computation.