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

v2.8.3

⬆️ Install or Upgrade

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

• Add preview network for EVM gateway (#2121) @nialexsan

Full Changelog: v2.8.2...v2.8.3

v2.8.2

⬆️ Install or Upgrade

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

• Update EVM Gateway (#2120) @jribbink

Full Changelog: v2.8.1...v2.8.2

v2.8.1

⬆️ Install or Upgrade

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

⭐ Features

Stablecoin scaffold in flow init

You can now bootstrap a Stablecoin project directly from the flow init wizard. The scaffold is based on the community template and comes pre-wired for a fast start.
Source: https://github.com/onflow/stablecoin-scaffold

Example:

flow init
# then select: "Stablecoin scaffold"

Reduces confusion during redeploys by prompting users to pass --update if a contract already exists.
(#2116) @chasefleming

🛠 Improvements

Deploy hint: suggest --update when contract exists

Reduces confusion during redeploys by prompting users to pass --update if a contract already exists.
(#2111) @jribbink

Dependency updates

• onflow/cadence → v1.7.1
• onflow/flow-go-sdk → v1.8.4
• onflow/flow-go → c6967df18fa9
• onflow/flow-emulator → v1.8.0
• onflow/cadence-tools/test → v1.6.0
• onflow/cadence-tools/lint → v1.4.1
• onflow/cadence-tools/languageserver → v1.6.1
• onflow/flixkit-go/v2 → v2.5.1
• onflow/flowkit/v2 → v2.6.1
• onflow/flow-evm-gateway → cae1289

(#2117)

🐞 Bug Fixes

Resolves an issue where emulator VM bridge setup events were not indexed by the EVM gateway.

v2.8.0

⬆️ Install or Upgrade

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

⭐ Features

Scheduled Transactions starter project in flow init

You can now bootstrap a project preconfigured for Scheduled Transactions directly from the flow init wizard.

Example:

flow init
# then select: "Scheduled Transactions" starter

(#2091) @chasefleming

Fund emulator accounts with flow accounts fund

flow accounts fund now supports funding emulator accounts, making local testing faster.

Example:

flow accounts fund service

(#2099) @chasefleming

🛠 Improvements

Language Server: Automatic flow.json management & concurrent projects

Cadence Language Server updated to v1.6.0. The LS now natively detects the project root per open file, infers the nearest ancestor flow.json, supports multiple open projects at once, and prompts to create a project if none exists. Backward-compatible: specifying an explicit flow.json path in init options still works.

(#2109) @jribbink

Mix testnet & mainnet dependency sources

Dependency installation now allows mixing sources across networks when appropriate.
(#2105) @chasefleming

Prompt flow: show tree before prompting

Improves UX by displaying the project tree before interactive prompts in init/install flows.
(#2108) @chasefleming - (#2096) @chasefleming

Other improvements

Test maintenance: fix handler tests.
(#2107) @chasefleming

Dependency updates

github.com/onflow/flow-evm-gateway → 1.3.3.
(#2104) @dependabot

🐞 Bug Fixes

No user-facing bug fixes in this release.

v2.7.3

What's Changed

• Update emulator to v1.7.4 by @jribbink in #2097

Full Changelog: v2.7.2...v2.7.3

v2.7.2

⬆️ Install or Upgrade

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

🛠 Improvements

• Add tx alias for transactions subcommand (#2092) @B9UU
• Skip prompts on flow dependencies install with no args (#2090) @chasefleming
• Update to latest version of Scheduled Transactions (#2094) @jribbink
• chore: remove duplicate package import (#2088) @juejinyuxitu