Migration Guide

Migrating Blocto wallet from v1 to v2

This guide is primarily for early Flow developers adopting Blocto wallet who want to learn about our latest progress on Flow & Blocto. Read the following guide to enhance your experience with Blocto.

For why to use @blocto/fcl instead of @onflow/fcl, check out this Github PR for further information.

Changes

• Latest version of @blocto/fcl@1.6.1 has been released

• New version of the blocto wallet interface and endpoints

• Update some deprecated methods or properties

Upgrading Dependency

Upgrade the @blocto/fcl in the package.json to ^1.6.1

yarn

yarn upgrade @blocto/fcl@^1.6.1

npm

npm install @blocto/fcl@^1.6.1

pnpm

npm install @blocto/fcl@^1.6.1

Upgrading the FCL Configuration

Replace the value of accessNode.api and configuration keys:

Mainnet

import * as fcl from "@blocto/fcl";

fcl
  .config({
    "accessNode.api": "https://rest-mainnet.onflow.org",
    "discovery.wallet": `https://wallet-v2.blocto.app/${YOUR_DAPP_ID || "-"}/flow/authn`
  })

Testnet

import * as fcl from "@blocto/fcl";

fcl
  .config({
    "accessNode.api": "https://rest-testnet.onflow.org",
    "discovery.wallet": `https://wallet-v2-dev.blocto.app/${YOUR_DAPP_ID || "-"}/flow/authn`
  })

For dApps that haven't applied for a dApp ID, we recommend you apply for a better user experience, or use - as an alternative.

Visit Register App ID to learn how to register App ID

If you have been using the back channel to communicate with FCL, follow the guide below:

Mainnet

import * as fcl from "@blocto/fcl";

fcl
  .config({
    "accessNode.api": "https://rest-mainnet.onflow.org",
    "discovery.wallet": "https://wallet-v2.blocto.app/api/flow/authn",
    "app.detail.id": "YOUR_DAPP_ID"// this line is optional
    "discovery.wallet.method": "HTTP/POST"
  })

Testnet

import * as fcl from "@blocto/fcl";

fcl
  .config({
    "accessNode.api": "https://rest-testnet.onflow.org",
    "discovery.wallet": "https://wallet-v2-dev.blocto.app/api/flow/authn",
    "app.detail.id": "YOUR_DAPP_ID"// this line is optional
    "discovery.wallet.method": "HTTP/POST"
  })

For dApps that haven't applied for a dApp ID, there is no need to set the app.detail.id key.

FCL Wallet Discovery

Good news for those who use wallet discovery to support multiple wallet on Flow, there is no action required from your side. You can keep the configuration as you did in FCL and Blocto wallet v2 will show up there automatically.