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: ee91c3f

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 17, 2025 7:06pm

💡 Enable Vercel Agent with $100 free credit for automated AI reviews

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

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

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 <chasefleming@users.noreply.github.com>

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) 🚀

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

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

c2023b3

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

mfbz added 3 commits October 14, 2025 16:58

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

c20706e

Minor ordering update

b296b19

Updated card id

0fedcd8

vercel bot deployed to Preview October 14, 2025 15:04 View deployment

Refactored single hook into multiple ones

27b072e

vercel bot had a problem deploying to Preview October 14, 2025 22:17 Failure

Improved hooks and added card implementation in demo

dfedfc2

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

Made setup transaction idempodent

96bf4ba

vercel bot deployed to Preview October 15, 2025 14:32 View deployment

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

db9c4bc

vercel bot deployed to Preview October 15, 2025 14:43 View deployment

chasefleming requested a review from Copilot October 15, 2025 17:30

chasefleming reviewed Oct 15, 2025

View reviewed changes

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

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 <chasefleming@users.noreply.github.com>

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

8a761cf

Co-authored-by: Chase Fleming <chasefleming@users.noreply.github.com>

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

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

Add useFlowSchedule hook #2653

Are you sure you want to change the base?

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!

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!

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