Configure FCL

Configure Blocto wallet to your Flow dApp

Installation

FCL is under heavy developments and the versions are not always backward compatible. We recommend that you use @blocto/fcl@^1.4.0 for now.

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

npm

npm install @blocto/fcl@^1.4.0

yarn

yarn add @blocto/fcl@^1.4.0

pnpm

pnpm install @blocto/fcl@^1.4.0

Configure Flow Networks & Blocto wallet URL

Blocto wallet provides two ways to communicate with FCL, according to your needs, choose one of them to configure your dApp. Visit How to Configure FCL to get further configuration settings.

Using front channel

Mainnet

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

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

Testnet

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

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

Using back channel

Mainnet

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

fcl
  .config()
  // connect to Flow mainnet
  .put("accessNode.api", "https://rest-mainnet.onflow.org")
  // use Blocto wallet
  .put(
    "discovery.wallet",
    "https://wallet-v2.blocto.app/api/flow/authn"
  )
  .put("discovery.wallet.method", "HTTP/POST")
  .put("app.detail.id", YOUR_DAPP_ID)

Testnet

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

fcl
  .config()
  // connect to Flow testnet
  .put("accessNode.api", "https://rest-testnet.onflow.org")
  // use Blocto testnet wallet
  .put(
    "discovery.wallet",
    "https://wallet-v2-dev.blocto.app/api/flow/authn"
  )
  .put("discovery.wallet.method", "HTTP/POST")
  .put("app.detail.id", YOUR_DAPP_ID)

Visit Register App ID to learn how to register App ID