Merged main

CHANGELOG.md

@@ -7,7 +7,11 @@ More expansive patch notes and explanations may be found in the specific [pathfi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## [0.21.0] - 2025-11-11
+
+### Added
+
+- Support for Starknet 0.14.1 networks.
 
 ### Fixed
 

Cargo.toml

@@ -1,6 +1,7 @@
 [workspace]
 members = [
     "crates/block-hashes",
+    "crates/casm-hashes",
     "crates/class-hash",
     "crates/common",
     "crates/compiler",
@@ -33,7 +34,7 @@ exclude = ["crates/load-test", "utils/pathfinder-probe"]
 resolver = "2"
 
 [workspace.package]
-version = "0.20.5"
+version = "0.21.0"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 rust-version = "1.88"

crates/casm-hashes/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "pathfinder-casm-hashes"
+version = { workspace = true }
+authors = { workspace = true }
+edition = { workspace = true }
+license = { workspace = true }
+rust-version = { workspace = true }
+
+[dependencies]
+pathfinder-common = { path = "../common" }
+pathfinder-crypto = { path = "../crypto" }

crates/casm-hashes/src/lib.rs

@@ -0,0 +1,48 @@
+use std::collections::HashMap;
+use std::sync::LazyLock;
+
+use pathfinder_common::{CasmHash, ClassHash};
+use pathfinder_crypto::Felt;
+
+static PRECOMPUTED_CASM_V2_HASHES: LazyLock<HashMap<ClassHash, CasmHash>> = LazyLock::new(|| {
+    let mut h = HashMap::new();
+
+    let mainnet_casm_hashes_v2 = include_bytes!("../fixtures/mainnet-casm-v2-hashes.bin");
+    for chunk in mainnet_casm_hashes_v2.chunks_exact(64) {
+        let class_hash = ClassHash(
+            Felt::from_be_slice(&chunk[0..32])
+                .expect("Invalid class hash in precomputed CASM v2 hashes"),
+        );
+        let casm_hash = CasmHash(
+            Felt::from_be_slice(&chunk[32..64])
+                .expect("Invalid CASM hash in precomputed CASM v2 hashes"),
+        );
+        h.insert(class_hash, casm_hash);
+    }
+
+    let sepolia_testnet_casm_hashes_v2 =
+        include_bytes!("../fixtures/testnet-sepolia-casm-v2-hashes.bin");
+    for chunk in sepolia_testnet_casm_hashes_v2.chunks_exact(64) {
+        let class_hash = ClassHash(
+            Felt::from_be_slice(&chunk[0..32])
+                .expect("Invalid class hash in precomputed CASM v2 hashes"),
+        );
+        let casm_hash = CasmHash(
+            Felt::from_be_slice(&chunk[32..64])
+                .expect("Invalid CASM hash in precomputed CASM v2 hashes"),
+        );
+        h.insert(class_hash, casm_hash);
+    }
+
+    h
+});
+
+/// Returns the precomputed CASM v2 hash for the given class hash, if it exists.
+///
+/// In Starknet 0.14.1 and later CASM hashes are computed using a new algorithm
+/// (Blake2 hash). This function provides access to a set of precomputed CASM v2
+/// hashes for known class hashes (generated from classes on Mainnet and Sepolia
+/// testnet) to avoid the need for recomputation.
+pub fn get_precomputed_casm_v2_hash(class_hash: &ClassHash) -> Option<&CasmHash> {
+    PRECOMPUTED_CASM_V2_HASHES.get(class_hash)
+}

crates/class-hash/Cargo.toml

@@ -17,8 +17,8 @@ categories = [
 
 [dependencies]
 anyhow = { workspace = true }
-pathfinder-common = { version = "0.20.5", path = "../common" }
-pathfinder-crypto = { version = "0.20.5", path = "../crypto" }
+pathfinder-common = { version = "0.21.0", path = "../common" }
+pathfinder-crypto = { version = "0.21.0", path = "../crypto" }
 primitive-types = { workspace = true }
 serde = { workspace = true, features = ["derive"] }
 serde_json = { workspace = true, features = [

crates/common/Cargo.toml

@@ -27,7 +27,7 @@ metrics = { workspace = true }
 num-bigint = { workspace = true }
 num-traits = "0.2"
 paste = { workspace = true }
-pathfinder-crypto = { version = "0.20.5", path = "../crypto" }
+pathfinder-crypto = { version = "0.21.0", path = "../crypto" }
 pathfinder-tagged = { version = "0.1.0", path = "../tagged" }
 pathfinder-tagged-debug-derive = { version = "0.1.0", path = "../tagged-debug-derive" }
 primitive-types = { workspace = true, features = ["serde"] }