v2.13.3-prerelease.0

Full Changelog: v2.13.2...v2.13.3-prerelease.0

v2.13.2

What's Changed

• Fix release build in GHA by @nialexsan in #2237

Full Changelog: v2.13.0...v2.13.2

v2.13.0

What's Changed

• Improve tx output readability by @chasefleming in #2162
• Bump golang.org/x/term from 0.37.0 to 0.38.0 by @dependabot[bot] in #2222
• Update emulator to v1.14.0 by @jribbink in #2223
• Catch unhandled panics in cadence lint and add proper account access checking by @jribbink in #2227
• Disable stablecoin scaffold by @chasefleming in #2229
• Add GRPC retry to flaky test by @jribbink in #2230
• Fix dependency manager update prompts and filesystem actions by @jribbink in #2226
• Add alias configuration command by @T4Bu in #2114
• Update to Cadence v1.9.2 by @turbolent in #2236

New Contributors

• @T4Bu made their first contribution in #2114

Full Changelog: v2.12.0...v2.13.0

v2.12.0

⬆️ Install or Upgrade

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

What's Changed

• Include mainnet-fork in default flow.json (#2220) @jribbink
• Update flow dev deprecation message (#2219) @chasefleming
• Fix nested paths in flow cadence lint (#2213) @jribbink
• Bump github.com/onflow/flow-evm-gateway from 1.4.2 to 1.4.3 (#2216) @dependabot
• refactor: replace interface{} with any for clarity and modernization (#2205) @bigmoonbit
• Bump github.com/spf13/cobra from 1.10.1 to 1.10.2 (#2217) @dependabot
• Update to Cadence v1.8.7 (#2215) @jribbink
• Bump github.com/getsentry/sentry-go from 0.39.0 to 0.40.0 (#2206) @dependabot
• Bump github.com/onflow/fcl-dev-wallet from 0.8.0 to 0.9.1 (#2208) @dependabot
• Bump github.com/getsentry/sentry-go from 0.36.2 to 0.39.0 (#2195) @dependabot
• Bump golang.org/x/term from 0.36.0 to 0.37.0 (#2197) @dependabot
• Bump actions/checkout from 5 to 6 (#2200) @dependabot
• Bump actions/setup-go from 5 to 6 (#2201) @dependabot
• Include system transactions in flow blocks get <txid> --include transactions (#2211) @jribbink
• Support Cadence import aliasing in Dependency Manager (#2192) @chasefleming
• Allow flow cadence lint with empty args (#2212) @jribbink

v2.11.2

What's Changed

• Skip updating dependencies aliased on another network by @jribbink in #2204

Full Changelog: v2.11.1...v2.11.2

v2.11.1

What's Changed

• Free up more disk space for goreleaser action by @jribbink in #2193
• Fix state leaking between test files by @jribbink in #2194

Full Changelog: v2.11.0...v2.11.1

v2.11.0

⬆️ Install or Upgrade

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

⭐ Features

Inline Fork Testing with #test_fork Pragma

The Cadence Test Framework now supports the #test_fork pragma, enabling inline fork testing directly in your test files. Fork a network snapshot for individual test functions without needing separate CLI flags.

Example:

// Test swapping on IncrementFi by forking mainnet
#test_fork(mainnet)
access(all) fun testIncrementFiSwap() {
    // ... test swap logic with live contract dependencies
}

The DeFi Actions scaffold (flow init) includes a ready-to-use IncrementFi fork test example showcasing this new capability.

(#2188) @jribbink

Full Scheduled Transaction Support

The Flow Emulator and Cadence Test Framework now support scheduled transactions, including all the latest scheduled callback features live (or coming soon) on mainnet. Test time-based logic and deferred execution end-to-end in your local environment.

(#2188) @jribbink @janezpodhostnik

🛠 Improvements

Execution Effort Recalibration (FLIP 346)

The Flow Emulator and Test Framework now support the updated execution effort weights from FLIP 346, which recalibrates transaction metering to better align with actual computational costs. This delivers fairer pricing and stronger network stability.

Key improvements:

• Flow token transfer: 27 → 19 computation (30% reduction)
• NFT transfer: 48 → 26 computation (46% reduction)
• EVM token transfer: 143 → 28 computation (80% reduction)
• EVM gas capacity: 50M → 220M gas per transaction
• 99.995% of existing transactions remain compatible

This change improves fee fairness, reduces costs for common operations, and strengthens network resilience against resource exhaustion attacks.

(#2188) @jribbink @janezpodhostnik

Compute Limit Terminology

Updated terminology from "gas limit" to "compute limit" to better reflect Flow's resource metering model. This change affects CLI output and messaging, aligning with FLIP 346's execution effort recalibration.

(#2180) @chasefleming

Fork Testing Metrics

Added instrumentation and metrics for fork testing operations to help track performance and reliability of forked test sessions.

(#2188) @jribbink

Dependency updates

• onflow/flow-emulator → v1.12.0 → v1.13.0
• onflow/cadence-tools/test → v1.8.1 → v1.9.1
• onflow/cadence-tools/languageserver → v1.7.2 → v1.7.3
• onflow/cadence-tools/lint → v1.6.1 → v1.6.2
• onflow/flow-go-sdk → v1.9.2 → v1.9.3

(#2188) @jribbink @janezpodhostnik

🐛 Bug Fixes

Typo Fixes

Fixed typos in FLIP template documentation.

(#2189) @efcking

GoReleaser Build

Fixed GitHub Actions release build configuration to ensure proper CLI binary distribution.

(#2190) @jribbink

v2.10.2

What's Changed

• Bump github.com/getsentry/sentry-go from 0.36.1 to 0.36.2 by @dependabot[bot] in #2170
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in #2159
• Bump github/codeql-action from 3 to 4 by @dependabot[bot] in #2154
• Bump actions/setup-go from 4 to 6 by @dependabot[bot] in #2156
• Bump actions/github-script from 7 to 8 by @dependabot[bot] in #2157
• Bump golangci/golangci-lint-action from 8 to 9 by @dependabot[bot] in #2172
• Update to Cadence v1.8.3 by @jribbink in #2178
• Update to Flow Emulator v1.12.0 by @jribbink in #2179

Full Changelog: v2.10.1...v2.10.2

v2.10.1

⬆️ Install or Upgrade

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

🐞 Bug Fixes

• Fix flow test --fork flag default (#2165) @jribbink

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