Add useFlowSchedule hook #2653

mfbz · 2025-10-01T17:17:31Z

Added hook with core scheduled transactions functionalities as in flow cli.

changeset-bot · 2025-10-01T17:17:34Z

🦋 Changeset detected

Latest commit: 35d80ff

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@onflow/react-sdk	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2025-10-01T17:17:37Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
react-sdk-demo	Ready	Preview	Comment	Oct 21, 2025 9:16pm

chasefleming · 2025-10-01T23:10:20Z

.changeset/upset-cities-start.md

+"@onflow/react-sdk": minor
+---
+
+Added useFlowSchedule hook


Can we make this more descriptive?

Improved 👍

chasefleming · 2025-10-01T23:11:29Z

packages/react-sdk/src/hooks/useFlowSchedule.ts

+  High = 2,
+}
+
+export enum TransactionStatus {


Is this already exported from FCL? If so, should we use that type?

No, this type is specific for Scheduled Transactions

chasefleming · 2025-10-01T23:12:01Z

packages/react-sdk/src/hooks/useFlowSchedule.ts

+import {CONTRACT_ADDRESSES, CADENCE_UFIX64_PRECISION} from "../constants"
+import {parseUnits} from "viem/utils"
+
+export enum TransactionPriority {


Should we export this from FCL?

No, this type is specific for Scheduled Transactions

chasefleming · 2025-10-01T23:12:22Z

packages/react-sdk/src/hooks/useFlowSchedule.ts

+  Cancelled = 4,
+}
+
+export interface TransactionInfo {


This type is specific to the scripts used to retrieve data from the manager, so it's specific for the implementation

chasefleming · 2025-10-01T23:14:31Z

packages/react-sdk/src/hooks/useFlowSchedule.ts

+  // Gets a transaction by ID
+  // Equivalent to: flow schedule get <transaction-id> [--include-handler-data]
+  get: (
+    transactionId: bigint,


I think we have mixed txId and transactionId across the React SDK. We should probably be consistent. I'm for transactionId for clarity, so this is fine, but curious what everyone else thinks. cc @jribbink

Yes you are right, we are using txId in react-sdk. i just updated it to have txId instead of transactionId for consistency 👍

Same discussion goes for the numeric values. FCL traditionally uses string to represent numbers. We don't use/support bigint elsewhere so I'm hesitant to introduce this inconsistency

Yep, just updated to string for consistency

Copilot

Pull Request Overview

This PR adds comprehensive support for Flow blockchain scheduled transactions through new React hooks. The implementation provides setup, listing, fetching, and canceling capabilities for scheduled transactions, following patterns similar to the Flow CLI's scheduled transaction functionality.

Key changes:

Added four new hooks for scheduled transaction management
Implemented type-safe transaction status and priority enums
Integrated contract addresses for scheduler utilities across networks
Created demo UI for testing the new functionality

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
`packages/react-sdk/src/hooks/useFlowScheduledTransactionSetup.ts`	Hook for one-time scheduler manager setup in user accounts
`packages/react-sdk/src/hooks/useFlowScheduledTransactionList.ts`	Hook for listing all scheduled transactions for an account
`packages/react-sdk/src/hooks/useFlowScheduledTransactionCancel.ts`	Hook for canceling scheduled transactions with fee refunds
`packages/react-sdk/src/hooks/useFlowScheduledTransaction.ts`	Hook for fetching individual scheduled transaction details
`packages/react-sdk/src/hooks/index.ts`	Exports the new hooks and types
`packages/react-sdk/src/constants.ts`	Added scheduler contract addresses for all networks
`packages/demo/src/components/hook-cards/use-flow-scheduled-transaction-card.tsx`	Interactive demo component showcasing all scheduler hooks
`packages/demo/src/components/content-sidebar.tsx`	Added sidebar navigation for the demo
`packages/demo/src/components/content-section.tsx`	Integrated demo card into main content
`.changeset/upset-cities-start.md`	Changeset documenting the new feature
Test files	Comprehensive unit tests for all new hooks

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-10-15T17:31:01Z

packages/react-sdk/src/constants.ts

+    FlowTransactionScheduler: "0x0000000000000000",
+    FlowTransactionSchedulerUtils: "0x0000000000000000",


The placeholder addresses for mainnet (0x0000000000000000) could cause runtime errors if used before being updated. Consider adding runtime validation to throw a descriptive error when these placeholder addresses are detected, helping developers identify the issue quickly.

packages/demo/src/components/content-sidebar.tsx

chasefleming

Can we capitalize "Scheduled Transactions" here?

Can we also add more context on what they are please?

Co-authored-by: Chase Fleming <[email protected]>

mfbz · 2025-10-15T20:25:36Z

Can we capitalize "Scheduled Transactions" here?
Can we also add more context on what they are please?

@chasefleming Improved playground card with full description of scheduled transactions and description of each feature in each tab (list, setup, cancel, get) 🚀

jribbink · 2025-10-21T18:37:22Z

packages/react-sdk/src/constants.ts

+    FlowTransactionScheduler: "0x0000000000000000",
+    FlowTransactionSchedulerUtils: "0x0000000000000000",


I think we can update these now, it's just going to be the service address https://contractbrowser.com/A.e467b9dd11fa00df.FlowServiceAccount

Added, thanks!

jribbink · 2025-10-21T18:38:38Z

packages/react-sdk/src/hooks/useFlowScheduledTransactionList.ts

any concerns about pagination/limits?

Yep, it make sense even if the number probably won't be that high because it will only show the ones in "Pending" state. To avoid overengineering this (which would be the part of the indexer API), i think we can:

Add a limit parameter with a default

Update the Cadence script to apply the limit after fetching

Alternatively, we could leverage getTransactionIDsByTimestampRange from the FlowTransactionSchedulerUtils contract for time-based pagination, which feel more natural for scheduled transactions. This would let users fetch transactions by time windows while still applying a limit to prevent unbounded queries.

Ok sounds good, let's just ship as is then and worry about pagination as future scope 👍

jribbink · 2025-10-21T19:06:44Z

packages/react-sdk/src/hooks/useFlowScheduledTransaction.ts

+} from "./useFlowScheduledTransactionList"
+
+export interface UseFlowScheduledTransactionArgs {
+  scheduledTxId?: string


Thoughts about renaming this arg to simply txId everywhere?

From a DevEx angle, we're going to try to mostly hide the distinction between TX ID/scheduled TX ID through SDKs/APIs.

Devs will already be able to use scheduled tx IDs as txId in useFlowTransaction/useFlowTransactionResult, so this would be consistent.

The idea is that if we frame and support scheduled tx id as interchangeable with regular tx IDs everywhere, the developers do not need to learn this distinction between identifier types.

mfbz added 4 commits September 18, 2025 18:29

First implementation still preview

4afcbd0

Minor fixes

f1e376b

Added improved implementation of useFlowSchedule hook

808282f

Cleaned up hook

0374705

mfbz requested a review from a team as a code owner October 1, 2025 17:17

mfbz added 3 commits October 1, 2025 22:05

Added tests

77295d3

Added changeset

d62421d

Merge branch 'master' into mfbz/use-flow-schedule-hook

f431cab

vercel bot deployed to Preview October 1, 2025 20:11 View deployment

chasefleming reviewed Oct 1, 2025

View reviewed changes

Improved changeset description

cbc1d78

vercel bot deployed to Preview October 2, 2025 08:58 View deployment

Changed transactionId to txId for consistency

6950c0b

vercel bot deployed to Preview October 2, 2025 09:15 View deployment

mfbz requested a review from chasefleming October 2, 2025 09:21

Merge branch 'master' into mfbz/use-flow-schedule-hook

f0517cb

vercel bot deployed to Preview October 2, 2025 15:01 View deployment

Added useFlowSchedule card to demo and improved naming

70440a3

vercel bot deployed to Preview October 2, 2025 20:47 View deployment

Renamed txId to scheduledTxId for better clarity

c6bbe8a

vercel bot deployed to Preview October 2, 2025 21:01 View deployment

Converted txid from bigint to string for consistency

3862072

vercel bot deployed to Preview October 3, 2025 09:00 View deployment

mfbz requested a review from jribbink October 3, 2025 12:03

Copilot AI reviewed Oct 15, 2025

View reviewed changes

chasefleming reviewed Oct 15, 2025

View reviewed changes

packages/demo/src/components/content-sidebar.tsx Outdated Show resolved Hide resolved

chasefleming reviewed Oct 15, 2025

View reviewed changes

mfbz and others added 2 commits October 15, 2025 21:42

Update packages/demo/src/components/content-sidebar.tsx

567e80a

Co-authored-by: Chase Fleming <[email protected]>

Update packages/demo/src/components/content-sidebar.tsx

8a761cf

Co-authored-by: Chase Fleming <[email protected]>

vercel bot deployed to Preview October 15, 2025 19:48 View deployment

Improved scheduled transactions demo card

66f39dd

vercel bot deployed to Preview October 15, 2025 20:26 View deployment

Merge branch 'master' into mfbz/use-flow-schedule-hook

7fee026

vercel bot deployed to Preview October 16, 2025 20:41 View deployment

Merge branch 'master' into mfbz/use-flow-schedule-hook

ee91c3f

vercel bot deployed to Preview October 17, 2025 19:06 View deployment

Merge branch 'master' into mfbz/use-flow-schedule-hook

b22ea28

vercel bot deployed to Preview October 18, 2025 07:22 View deployment

Merge branch 'master' into mfbz/use-flow-schedule-hook

ffd246a

vercel bot deployed to Preview October 21, 2025 08:38 View deployment

jribbink reviewed Oct 21, 2025

View reviewed changes

Added scheduled transactions contract mainnet hashes

4a6a755

vercel bot deployed to Preview October 21, 2025 19:24 View deployment

Renamed scheduledTxId to txId

73dd26c

vercel bot deployed to Preview October 21, 2025 20:58 View deployment

Minor fix on scheduled transaction card in playground

35d80ff

vercel bot deployed to Preview October 21, 2025 21:16 View deployment

jribbink approved these changes Oct 21, 2025

View reviewed changes

mfbz merged commit 9ff0f85 into master Oct 21, 2025
4 checks passed

mfbz deleted the mfbz/use-flow-schedule-hook branch October 21, 2025 21:56

github-actions bot mentioned this pull request Oct 21, 2025

Version Packages #2656

Merged

		FlowTransactionScheduler: "0x0000000000000000",
		FlowTransactionSchedulerUtils: "0x0000000000000000",

Add useFlowSchedule hook #2653

Add useFlowSchedule hook #2653

Uh oh!

Conversation

mfbz commented Oct 1, 2025

Uh oh!

changeset-bot bot commented Oct 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Oct 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chasefleming Oct 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mfbz Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jribbink Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chasefleming left a comment

Choose a reason for hiding this comment

Uh oh!

mfbz commented Oct 15, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jribbink Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot bot commented Oct 1, 2025 •

edited

Loading

vercel bot commented Oct 1, 2025 •

edited

Loading

chasefleming Oct 1, 2025 •

edited

Loading

mfbz Oct 2, 2025 •

edited

Loading

jribbink Oct 2, 2025 •

edited

Loading

jribbink Oct 21, 2025 •

edited

Loading