v0.8.1

Starknet Devnet v0.8.1

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.1
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.1-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-2bb7ffb
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-2bb7ffb-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Cargo

cargo install starknet-devnet

What's Changed

Bug Fixes 🐛

• Update predeployed ERC20 metadata initialization by @3alpha in #928

Dependencies & Maintenance 🔧

• Update tracing to disable cairo runner target logs by @3alpha in #929

Other Changes

• Remove #[ignore] from mainnet fork tests by @3alpha in #927
• Release v0.8.1 by @3alpha in #930

Full Changelog: v0.8.0...v0.8.1

v0.8.0

Starknet Devnet v0.8.0

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-3fe1958
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-3fe1958-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Organize devnet errors, remove unneeded Result by @3alpha in #904
• Cairo native feature flag by @3alpha in #905
• Starknet v0.14.2 and RPC v0.10.1 by @3alpha in #909
• Bump RPC spec to v0.10.2 by @3alpha in #912
• feat: prove_transaction L2→L1 messages, ProofMode::None behavior change by @3alpha in #915

Bug Fixes 🐛

• Fix empty proof/proof_facts deserialization and accept BroadcastedTransaction in proveTransaction by @3alpha in #914
• fix: StorageResult last_update_block non-optional, add integration test by @3alpha in #917

Dependencies & Maintenance 🔧

• Bump rust and dev deps by @3alpha in #908
• Update dependecies and fix tests for v0.14.1 by @3alpha in #910
• chore: upgrade RC dependencies to stable releases by @3alpha in #920

Other Changes

• Optimize Contract Compilation with LRU Caching by @3alpha in #906
• Prerelease 0.8.0-rc.0 by @3alpha in #911
• Release 0.8.0-rc.1 by @3alpha in #913
• Release 0.8.0-rc.2 by @3alpha in #916
• Release 0.8.0-rc.3 by @3alpha in #918
• Release 0.8.0 by @3alpha in #921

Full Changelog: v0.7.2...v0.8.0

v0.8.0-rc.3

Starknet Devnet v0.8.0-rc.3

Usage related changes

• StorageResult.last_update_block is now non-optional: When the INCLUDE_LAST_UPDATE_BLOCK response flag is set on starknet_getStorageAt, the last_update_block field is always returned as a u64 (defaulting to 0 for never-modified slots) instead of Option<u64>. This aligns with the RPC spec STORAGE_RESULT schema.

Development related changes

• Bumped all crate versions from 0.8.0-rc.2 to 0.8.0-rc.3.
• Versioned website docs for 0.8.0-rc.3.
• Added get_storage_with_response_flags integration test covering INCLUDE_LAST_UPDATE_BLOCK flag behavior across multiple storage updates and block advancements.

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.3
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.3-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-af35df1
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-af35df1-seed0

false
falsedocker.io/shardlabs/starknet-devnet-rs:latest
falsedocker.io/shardlabs/starknet-devnet-rs:latest-seed0

Note\nLatest tags are not available for release candidates.

Cargo

cargo install starknet-devnet

What's Changed

Other Changes

• fix: StorageResult last_update_block non-optional, add integration test by @3alpha in #917
• Release 0.8.0-rc.3 by @3alpha in #918

Full Changelog: v0.8.0-rc.2...v0.8.0-rc.3

v0.8.0-rc.2

Starknet Devnet v0.8.0-rc.2

Usage related changes

• prove_transaction now supports L2→L1 messages: Transactions are simulated during proof generation to extract L2→L1 messages. A new l2_to_l1_messages field is included in ProveTransactionResponse, and a messages_hash is bound into the proof/proof_facts (now 9 elements instead of 8).
• ProofMode::None behavior change: When proof_mode is None, proof generation is skipped but proof_facts are still preserved and validated. Previously both were skipped.
• Execution failures are now explicit errors: prove_transaction returns a TransactionExecutionFailed error
• proveTransaction accepts BroadcastedTransaction: The endpoint now accepts BroadcastedTransaction input to conform with the spec.
• Empty proof/proof_facts handled gracefully: Fixed an issue where empty proof or proof_facts fields could cause errors.

Development related changes

• Bumped all crate versions from 0.8.0-rc.1 to 0.8.0-rc.2.
• Versioned website docs for 0.8.0-rc.2.
• Added messages() and all_messages() accessors to FunctionInvocation.
• Extracted proof generation into a dedicated generate_proof function.
• Added integration tests for L2→L1 message extraction, proof_facts validation, and execution failure error propagation.
• Fixed flaky integration test by adding block retention buffer and re-fetching gas prices.
• Updated CLI help text and documentation for proofs.

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.2
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.2-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-c126758
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-c126758-seed0

false
falsedocker.io/shardlabs/starknet-devnet-rs:latest
falsedocker.io/shardlabs/starknet-devnet-rs:latest-seed0

Note\nLatest tags are not available for release candidates.

Cargo

cargo install starknet-devnet

What's Changed

Other Changes

• Fix empty proof/proof_facts deserialization and accept BroadcastedTransaction in proveTransaction by @3alpha in #914
• feat: prove_transaction L2→L1 messages, ProofMode::None behavior change by @3alpha in #915
• Release 0.8.0-rc.2 by @3alpha in #916

Full Changelog: v0.8.0-rc.1...v0.8.0-rc.2

v0.8.0-rc.1

Starknet Devnet v0.8.0-rc.1

Usage related changes

• Bumped RPC spec to v0.10.2: The RPC specification version was updated from v0.10.1 to v0.10.2. The API was already aligned with the spec, but the reported version string was incorrect.

Development related changes

• Bumped all crate versions from 0.8.0-rc.0 to 0.8.0-rc.1.
• Versioned website docs for 0.8.0-rc.1.
• Fixed RC version handling in the CI get-version-info action.
• Reordered sidebar and removed duplicate content from proofs docs.

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.1
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.1-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-ba9edaa
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-ba9edaa-seed0

false
falsedocker.io/shardlabs/starknet-devnet-rs:latest
falsedocker.io/shardlabs/starknet-devnet-rs:latest-seed0

Note\nLatest tags are not available for release candidates.

Cargo

cargo install starknet-devnet

What's Changed

Other Changes

• Bump RPC spec to v0.10.2 by @3alpha in #912
• Release 0.8.0-rc.1 by @3alpha in #913

Full Changelog: v0.8.0-rc.0...v0.8.0-rc.1

v0.8.0-rc.0

Starknet Devnet v0.8.0-rc.0

Usage related changes

• Starknet v0.14.2 and RPC v0.10.1: Upgraded to Starknet v0.14.2 with full RPC v0.10.1 support, including:
  • New proveTransaction endpoint for generating transaction proofs (--proof-mode CLI flag)
  • Multiple addresses in event subscription filters
  • Simulation flags support
  • New transaction response fields and block fields
  • New RPC error code for invalid proofs
• Cairo Native feature flag: Added optional cairo_native feature flag for compiling with Cairo Native support, enabling native execution of contracts.
• Contract compilation LRU caching: Optimized repeated contract compilations with an LRU cache, improving performance for workloads that reuse the same contract classes.
• Updated dependencies for Starknet v0.14.1: Updated blockifier and related dependencies to align with Starknet v0.14.1, with proof serialization adjustments.

Development related changes

• Bumped all crate versions from 0.7.2 to 0.8.0-rc.0.
• Versioned website docs for 0.8.0-rc.0.
• Bumped Rust toolchain and dev dependencies.
• Reorganized devnet error types, removed unnecessary Result wrapping in core crate.
• Renamed all integration test files (removed test_ prefix).
• Added prove_transaction integration tests (564 lines) and get_block_with_txs_and_receipts tests.
• Expanded event subscription and simulation transaction test coverage.
• Added test_proof_base64_pattern.py for proof format validation.
• Added CI LLVM dependency installation for Cairo Native builds.
• Added proof types (Proof, ProofFacts) to starknet-devnet-types.
• Added proofs documentation page to the website.

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.0
docker pull docker.io/shardlabs/starknet-devnet-rs:0.8.0-rc.0-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-7ed5a96
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-7ed5a96-seed0

false
falsedocker.io/shardlabs/starknet-devnet-rs:latest
falsedocker.io/shardlabs/starknet-devnet-rs:latest-seed0

Note\nLatest tags are not available for release candidates.

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Organize devnet errors, remove unneeded Result by @3alpha in #904
• Cairo native feature flag by @3alpha in #905

Dependencies & Maintenance 🔧

• Bump rust and dev deps by @3alpha in #908

Other Changes

• Optimize Contract Compilation with LRU Caching by @3alpha in #906
• Starknet v0.14.2 and RPC v0.10.1 by @3alpha in #909
• Update dependecies and fix tests for v0.14.1 by @3alpha in #910
• Prerelease 0.8.0-rc.0 by @3alpha in #911

Full Changelog: v0.7.2...v0.8.0-rc.0

v0.7.2

Starknet Devnet v0.7.2

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.2
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.2-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-dbe4270
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-dbe4270-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Adding prometheus metrics server and basic metrics by @3alpha in #900
• Skip commitment calculation in lite mode by @3alpha in #901
• Add defaulter caching by @3alpha in #884

Other Changes

• Wrap writing to env vars in unsafe (prepare for 2024) by @3alpha in #896
• Release 0.7.2 by @3alpha in #903

Full Changelog: v0.7.1...v0.7.2

v0.7.1

Starknet Devnet v0.7.1

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.1
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.1-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-9220e34
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-9220e34-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Print verbose message on forking incompatibility by @3alpha in #893

Bug Fixes 🐛

• Fix wrong fee error mappings by @3alpha in #895

Dependencies & Maintenance 🔧

• Enable tests by @3alpha in #892

Other Changes

• Release 0.7.1 by @3alpha in #898

Full Changelog: v0.7.0...v0.7.1

v0.7.0

Starknet Devnet v0.7.0

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.0
docker pull docker.io/shardlabs/starknet-devnet-rs:0.7.0-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-b761ede
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-b761ede-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Add tests for old block rejection on subscription by @3alpha in #881
• Starknet 0.14.1 by @3alpha in #880
• Align with spec for RPC v0.10.0 by @3alpha in #890

Dependencies & Maintenance 🔧

• Starknet rs 0.17 by @FabijanC in #867
• Scripts refactor after migration from CircleCI by @3alpha in #879
• Migrate from Ethers to Alloy by @3alpha in #887
• Update dependencies, workflows and incident changes by @3alpha in #889

Other Changes

• Fix messaging bridge when using forked network by @Kelvyne in #882
• Release v0.7.0 by @3alpha in #891

New Contributors

• @Kelvyne made their first contribution in #882

Full Changelog: v0.6.1...v0.7.0

v0.6.1

Starknet Devnet v0.6.1

Installation

Binary

Download the appropriate binary for your platform from the assets below.

Docker

# Pull by version
docker pull docker.io/shardlabs/starknet-devnet-rs:0.6.1
docker pull docker.io/shardlabs/starknet-devnet-rs:0.6.1-seed0

# Pull by SHA
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-a3e975f
docker pull docker.io/shardlabs/starknet-devnet-rs:sha-a3e975f-seed0

# Pull latest versions
docker pull docker.io/shardlabs/starknet-devnet-rs:latest
docker pull docker.io/shardlabs/starknet-devnet-rs:latest-seed0

Important: We are no longer pushing architecture specific docker images, just multiarch ones.

Cargo

cargo install starknet-devnet

What's Changed

New Features 🚀

• Configure class size limit by @FabijanC in #862

Bug Fixes 🐛

• Fetch data on origin on subscription by @3alpha in #865

Documentation 📚

• Add line about block hashes inconsistencies in the docs [skip ci] by @3alpha in #868
• add starkup to docs [skip ci] by @3alpha in #872

Dependencies & Maintenance 🔧

• Improve ApiError variants by @3alpha in #861
• Misc QoL improvements of the code, code rabbit nitpicks, TODOs by @3alpha in #863
• Gha workflows by @3alpha in #877

Other Changes

• Remove leftover Rest API docs by @3alpha in #859
• Remove non-RPC deprecation notice by @FabijanC in #860
• Remove starknet mutex when fetching config by @3alpha in #871

Full Changelog: v0.6.0...v0.6.1