v2.10.0

⬆️ Install or Upgrade

Follow the Flow CLI installation guide for instructions on how to install or upgrade the CLI.

⭐ Features

Fork mode in test framework

flow test --fork lets you run tests against a local snapshot, exercising real contracts and dependencies. Supports optional --fork-height for deterministic runs.

Examples

# Fork latest testnet state for your test run
flow test --fork testnet

# Run against mainnet at a specific block height
flow test --fork mainnet --fork-height 123456789

Docs: Fork Testing Tutorial

(#2131) @jribbink

🛠 Improvements

Emulator forking via --fork

flow emulator --fork <network> starts the emulator from a live network snapshot, exercising real contracts and dependencies. Honors flow.json networks and supports --fork-height.

Examples

# Start emulator by forking testnet
flow emulator --fork testnet

# Fork mainnet at an exact height
flow emulator --fork mainnet --fork-height 123456789

Docs: Emulator Reference Docs

(#2148) @jribbink

Get account by name

Add ability to retrieve accounts by their configured name.
(#2147) @chasefleming

Account output readability

Improve the readability of account command output.
(#2163) @chasefleming

Emulator performance & reliability

Targeted improvements to rate-limit handling and caching for smoother forked sessions.

Security and analysis tooling

Add code analysis and dependency review.
(#2150) @JGowsk9

Fix SAST configuration and checks.
(#2151) @JGowsk9

Related Docs & guides

See Testing Smart Contracts for more details on testing smart contracts on Flow.

Dependency updates

• onflow/flow-emulator → v1.10.1
• onflow/cadence-tools/test → v1.8.0
• onflow/flow/protobuf/go/flow → v0.4.16

(#2148) @jribbink · (#2131) @jribbink