Add useBridgeTokenFromEvm hook #2592

mfbz · 2025-07-15T16:55:08Z

changeset-bot · 2025-07-15T16:55:11Z

🦋 Changeset detected

Latest commit: 4175aab

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

This PR includes changesets to release 2 packages

Name	Type
@onflow/react-sdk	Minor
@onflow/demo	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-07-15T16:55:16Z

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

Project	Deployment	Preview	Comments	Updated (UTC)
react-sdk-demo	Canceled			Oct 20, 2025 10:08pm

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

Copilot

Pull Request Overview

This PR adds a new React hook useCrossVmReceiveToken to enable transferring fungible tokens from EVM to Cadence on the Flow blockchain. The hook provides a user-friendly interface for bridging ERC20 tokens to their corresponding Cadence vault equivalents.

Added useCrossVmReceiveToken hook with comprehensive Cadence transaction logic for cross-VM token bridging
Implemented comprehensive test coverage for both successful and error scenarios
Created demo UI component with form inputs and transaction status display

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/react-sdk/src/hooks/useCrossVmReceiveToken.ts	Core hook implementation with Cadence transaction generation
packages/react-sdk/src/hooks/useCrossVmReceiveToken.test.ts	Unit tests covering various scenarios and edge cases
packages/react-sdk/src/hooks/index.ts	Export declaration for the new hook
packages/demo/src/constants.ts	Added ClickToken contract address for testnet
packages/demo/src/components/container.tsx	Integration of new demo component
packages/demo/src/components/cards/cross-vm-receive-token-card.tsx	Interactive demo UI for testing the hook
.changeset/chilly-kangaroos-train.md	Changeset documentation

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

Copilot · 2025-08-15T21:46:59Z

packages/demo/src/components/cards/cross-vm-receive-token-card.tsx

+    const clickTokenAddress = getContractAddress("ClickToken", currentNetwork)
+    return {
+      name: "ClickToken",
+      vaultIdentifier: `A.${clickTokenAddress.replace("0x", "")}.EVMVMBridgedToken_a7cf2260e501952c71189d04fad17c704dfb36e6.Vault`,


The hard-coded token identifier EVMVMBridgedToken_a7cf2260e501952c71189d04fad17c704dfb36e6 contains what appears to be a magic value. Consider extracting this to a constant or making it configurable to improve maintainability.

Suggested change

vaultIdentifier: `A.${clickTokenAddress.replace("0x", "")}.EVMVMBridgedToken_a7cf2260e501952c71189d04fad17c704dfb36e6.Vault`,

vaultIdentifier: `A.${clickTokenAddress.replace("0x", "")}.${EVM_VM_BRIDGED_TOKEN_IDENTIFIER}.Vault`,

Ok, but hardcoded just for the sake of running the demo

Copilot · 2025-08-15T21:46:59Z

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

+        //
+        // Set a cap on the withdrawable bridge fee
+        var approxFee = FlowEVMBridgeUtils.calculateBridgeFee(
+                bytes: 400_000 // 400 kB as upper bound on movable storage used in a single transaction


The magic number 400_000 for calculating bridge fees should be extracted to a named constant to improve code maintainability and make it easier to adjust if needed.

Suggested change

bytes: 400_000 // 400 kB as upper bound on movable storage used in a single transaction

let BRIDGE_FEE_UPPER_BOUND_BYTES = 400_000 // 400 kB as upper bound on movable storage used in a single transaction

var approxFee = FlowEVMBridgeUtils.calculateBridgeFee(

bytes: BRIDGE_FEE_UPPER_BOUND_BYTES

Ok, but hardcoded just for the sake of running the demo

Copilot · 2025-08-15T21:46:59Z

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

+        self.scopedProvider <- ScopedFTProviders.createScopedFTProvider(
+                provider: providerCapCopy,
+                filters: [ providerFilter ],
+                expiration: getCurrentBlock().timestamp + 1.0


The expiration time of 1.0 seconds is a magic number that should be extracted to a named constant for better maintainability and clarity of intent.

Suggested change

expiration: getCurrentBlock().timestamp + 1.0

expiration: getCurrentBlock().timestamp + SCOPED_FT_PROVIDER_EXPIRATION_SECONDS

Ok, but hardcoded just for the sake of running the demo

chasefleming · 2025-08-19T22:21:44Z

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

+ *
+ * @returns The mutation object used to send the transaction.
+ */
+export function useCrossVmReceiveToken({


Same question on naming from the other pr.

…k-ft-evm-to-cadence

vercel · 2025-10-20T20:18:42Z

Deployment failed with the following error:

Failed to create deployment for team_odoxRGdrzIzasFJE67wM7Gzm in project prj_Sm8VPqaAfgcYJQgrSl9OaRcqkiFR: FetchError: request to https://76.76.21.112/v13/now/deployments?ownerId=team_odoxRGdrzIzasFJE67wM7Gzm&projectId=prj_Sm8VPqaAfgcYJQgrSl9OaRcqkiFR&skipAutoDetectionConfirmation=1&teamId=team_odoxRGdrzIzasFJE67wM7Gzm&traceCarrier=%7B%22ot-baggage-webhookAt%22%3A%221760990675366%22%2C%22ot-baggage-senderUsername%22%3A%22gh.mfbz%22%2C%22baggage%22%3A%22webhookAt%3D1760990675366%2CsenderUsername%3Dgh.mfbz%22%2C%22x-datadog-trace-id%22%3A%227393282319159151552%22%2C%22x-datadog-parent-id%22%3A%228951854390054108791%22%2C%22x-datadog-sampling-priority%22%3A%222%22%2C%22x-datadog-tags%22%3A%22_dd.p.tid%3D68f695d300000000%2C_dd.p.dm%3D-3%22%2C%22traceparent%22%3A%2200-68f695d300000000669a371915a84bc0-7c3b602388323e77-01%22%2C%22tracestate%22%3A%22dd%3Dt.tid%3A68f695d300000000%3Bt.dm%3A-3%3Bs%3A2%3Bp%3A7c3b602388323e77%22%7D failed, reason: socket hang up

mfbz added 2 commits July 15, 2025 18:53

Added crossvm hook to transfer tokens from evm to cadence

ec1837b

Added changeset

98619db

mfbz requested a review from a team as a code owner July 15, 2025 16:55

vercel bot deployed to Preview July 15, 2025 17:00 View deployment

Minor text fix

6d7884e

vercel bot deployed to Preview July 15, 2025 17:35 View deployment

mfbz changed the title ~~Mfbz/hook ft evm to cadence~~ Added hook to move tokens from evm to cadence Jul 16, 2025

Base automatically changed from feature/components to release/july July 16, 2025 17:04

jribbink force-pushed the release/july branch 2 times, most recently from ecfd844 to e1393ed Compare July 25, 2025 00:08

Base automatically changed from release/july to master July 25, 2025 02:47

mfbz added 2 commits August 15, 2025 22:20

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

f783214

Fixed wrong import

199a166

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

Fixed changeset

3ed88cc

vercel bot deployed to Preview August 15, 2025 20:35 View deployment

Fixed failing tests

9a14d98

vercel bot deployed to Preview August 15, 2025 20:52 View deployment

chasefleming requested a review from Copilot August 15, 2025 21:46

Copilot AI reviewed Aug 15, 2025

View reviewed changes

chasefleming reviewed Aug 19, 2025

View reviewed changes

chasefleming requested a review from jribbink September 30, 2025 12:19

Merge commit '430bb0813bab6c2de59e152184256238bda20d99' into mfbz/hoo…

4caf743

…k-ft-evm-to-cadence

vercel bot deployed to Preview October 2, 2025 12:46 View deployment

mfbz and others added 2 commits October 2, 2025 16:53

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

b83934b

Renamed hook

240fcf8

vercel bot had a problem deploying to Preview October 2, 2025 15:06 Failure

Updated changeset

70a3d79

vercel bot had a problem deploying to Preview October 2, 2025 15:13 Failure

mfbz changed the title ~~Added hook to move tokens from evm to cadence~~ Add useBridgeTokenFromEvm hook Oct 2, 2025

mfbz added 2 commits October 2, 2025 18:29

Fixed tests and added playground cards

64902ce

Prettier fix

1ddad2c

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

mfbz requested a review from chasefleming October 2, 2025 17:00

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

7d0e5ac

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

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

c7e2682

vercel bot deployed to Preview October 17, 2025 18:53 View deployment

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

81405d1

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

jribbink approved these changes Oct 20, 2025

View reviewed changes

mfbz and others added 3 commits October 20, 2025 22:04

Renamed crossvm token hooks

7060446

Prettier fix

b65a583

Merge branch 'master' into mfbz/hook-ft-evm-to-cadence

4175aab

mfbz merged commit 52688c3 into master Oct 21, 2025
2 checks passed

mfbz deleted the mfbz/hook-ft-evm-to-cadence branch October 21, 2025 08:14

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

Version Packages #2656

Merged

	vaultIdentifier: `A.${clickTokenAddress.replace("0x", "")}.EVMVMBridgedToken_a7cf2260e501952c71189d04fad17c704dfb36e6.Vault`,
	vaultIdentifier: `A.${clickTokenAddress.replace("0x", "")}.${EVM_VM_BRIDGED_TOKEN_IDENTIFIER}.Vault`,

	expiration: getCurrentBlock().timestamp + 1.0
	expiration: getCurrentBlock().timestamp + SCOPED_FT_PROVIDER_EXPIRATION_SECONDS

Uh oh!

Add useBridgeTokenFromEvm hook #2592

Add useBridgeTokenFromEvm hook #2592

Uh oh!

Conversation

mfbz commented Jul 15, 2025

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

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

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 Aug 15, 2025

Choose a reason for hiding this comment

Uh oh!

mfbz Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 15, 2025

Choose a reason for hiding this comment

Uh oh!

mfbz Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 15, 2025

Choose a reason for hiding this comment

Uh oh!

mfbz Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

chasefleming Aug 19, 2025

Choose a reason for hiding this comment

Uh oh!

vercel bot commented Oct 20, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot bot commented Jul 15, 2025 •

edited

Loading

vercel bot commented Jul 15, 2025 •

edited

Loading