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

v2.9.0

This release brings the Flow CLI in sync with the mainnet Forte network upgrade (October 22, 2025), establishing Flow as the home for AI-native, autonomous applications. Forte empowers developers and AI agents with protocol composability and native automation—making user-owned, trustless workflows a reality.

What's New in Forte:

• 🧩 Flow Actions - Composable DeFi building blocks for autonomous agents (swap, source, sink, flasher, oracle)
• ⏰ Scheduled Transactions - Native time scheduler enabling true on-chain automation
• 🤖 Flow Agents - User-owned, autonomous execution triggered by native events
• 🏗️ New CLI Commands - Full tooling support for managing scheduled transactions
• 📦 Project Scaffolds - Ready-to-use templates for Flow Actions development

Forte enables fully autonomous, composable applications that execute on-chain without off-chain bots or custodians.

⬆️ Install or Upgrade

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

⭐ Features

Scheduled Transactions Manager Commands

The Flow CLI now supports Scheduled Transactions, Flow's native time scheduler that enables autonomous, time-based transaction execution directly on-chain—like cron for blockchains. Part of the mainnet Forte network upgrade, this feature allows developers and AI agents to build fully automated workflows without relying on off-chain infrastructure.

Use Cases:

• Recurring Payments - Automate subscription payments, salaries, or DCA strategies
• AI-Driven Agents - Enable autonomous agents to proactively rebalance, settle, and sweep on schedule
• Automated Arbitrage - Schedule price-dependent swaps across DEXs
• Time-Based Logic - Unlock tokens, distribute rewards, or trigger governance actions
• DeFi Workflows - Combine with Flow Actions for complex automated strategies

🧩 Key Commands

• Manager Resource Setup

  Initialize a Manager resource in your account storage to manage all your scheduled transactions in one place. This is required before you can schedule transactions.

  flow schedule setup --signer my-account --network mainnet

  The Manager resource is stored at the standardized storage path and provides a consistent interface across all tools and explorers.

• List Transactions

  View all scheduled transactions associated with an account, including their IDs, status, and scheduled execution time.

  flow schedule list <account> --network mainnet

• Get Transaction Details

  Fetch complete details for a specific scheduled transaction by ID, including the transaction payload, execution window, and current status.

  flow schedule get <transaction-id> --network mainnet

• Cancel Transactions

  Cancel a pending scheduled transaction before it executes and receive a partial fee refund. This provides flexibility to adjust or remove scheduled operations.

  flow schedule cancel <transaction-id> --signer my-account --network mainnet

🏗️ Under the Hood

These commands rely on two key contracts:

• FlowTransactionScheduler - System contract handling transaction scheduling and execution
• FlowTransactionSchedulerUtils - Helper contract providing the Manager resource and discovery utilities

The Manager resource provides a standardized interface for managing and discovering scheduled transactions, ensuring consistency across wallets, explorers, and development tools.

💡 Pro Tip

Combine Scheduled Transactions with Flow Agents and Flow Actions to create user-owned, autonomous financial strategies that execute trustlessly on-chain—no off-chain bots or custodians required!

📘 Learn more: Scheduled Transactions Guide
🧰 CLI Documentation: Flow CLI Scheduled Transactions Commands
🎯 Forte Upgrade: Introducing Actions & Agents

(#2141, #2140, #2133, #2132, #2130) @chasefleming

---

DeFi Actions Project Starter in flow init

You can now bootstrap a DeFi Actions project directly from the flow init wizard. This starter provides a complete, working example for building composable DeFi connectors—the building blocks that power autonomous agents and user-owned financial workflows on Flow.

What's included:

• TokenSink connector implementing the DeFiActions.Sink interface
• Pre-configured dependencies (DeFiActions, DeFiActionsUtils, DeFiActionsMathUtils)
• Working tests using the Flow Testing Framework
• Example transaction demonstrating token deposits via the connector
• Comprehensive README with Quick Start guide

Example:

flow init
# Select: "DeFi Actions project (build composable DeFi connectors)"
flow test  # Everything works out of the box

📘 Learn more: Flow Actions FLIP #339 | Flow Actions Docs | Repository

(#2143) @jribbink

🛠 Improvements

Mainnet Forte upgrade compatibility updates

Updated all core dependencies to support the mainnet Forte network upgrade:

Flow Core Dependencies:

• onflow/cadence → v1.8.1 - Cadence language runtime with Forte features
• onflow/flow-go-sdk → v1.9.0 - Flow Go SDK with updated transaction types
• onflow/flow-go → v0.43.3 - Core Flow protocol implementation
• onflow/flow-emulator → v1.9.0 - Local development emulator
• onflow/flowkit/v2 → v2.7.0 - Flow development toolkit

Cadence Tools:

• onflow/cadence-tools/test → v1.7.0 - Testing framework with Forte support
• onflow/cadence-tools/lint → v1.6.0 - Cadence linter
• onflow/cadence-tools/languageserver → v1.7.0 - LSP for Cadence IDE support

Additional Dependencies:

• onflow/flixkit-go/v2 → v2.6.0 - FLIX template support
• onflow/flow-evm-gateway → v1.3.5 - EVM gateway with bridge improvements
• github.com/getsentry/sentry-go → v0.36.1 - Error tracking
• golang.org/x/term → v0.36.0 - Terminal utilities
• google.golang.org/grpc → v1.76.0 - gRPC communication

These updates ensure full compatibility with the mainnet Forte network upgrade and enable support for Flow Actions, Scheduled Transactions, and Flow Agents.

(#2146) @jribbink
(#2137) @dependabot
(#2126) @dependabot
(#2123) @dependabot