How to Configure FCL

Configuration

FCL has a mechanism that lets you configure various aspects of FCL. The main idea here (from an FCL perspective) should be that when you move from one instance of the Flow Blockchain to another (Local Emulator to Testnet to Mainnet) the only thing you should need to change (once again from an FCL perspective) is your configuration.

Setting Configuration Values

Values only need to be set once. We recomend doing this once and as early in the life cycle as possible. To set a configuation value, the put method on the config instance needs to be called, the put method returns the config instance so they can be chained.

import * as fcl from "@onflow/fcl"

fcl.config()         // returns the config instance
  .put("foo", "bar") // configures "foo" to be "bar"
  .put("baz", "buz") // configures "baz" to be "buz"

Getting Configuration Values

The config instance has an asynchronous get method. You can also pass it a fallback value incase the configuration state does not include what you are wanting.

import * as fcl from "@onflow/fcl"

fcl.config()
  .put("foo", "bar")
  .put("woot", 5)
  .put("rawr", 7)

const FALLBACK = 1

async function addStuff () {
  var woot = await fcl.config().get("woot", FALLBACK) // will be 5 -- set in the config before
  var rawr = await fcl.config().get("rawr", FALLBACK) // will be 7 -- set in the config before
  var hmmm = await fcl.config().get("hmmm", FALLBACK) // will be 1 -- uses fallback because this isnt in the config

  return woot + rawr + hmmm
}

addStuff().then(d => console.log(d)) // 13 (5 + 7 + 1)

Common Configuration Keys

accessNode.api -- Api URL for the Flow Blockchain Access Node you want to be communicating with.
challenge.handshake -- (DEPRECATED @onflow/fcl@0.0.68) Points FCL at the Wallet or Wallet Discovery mechanism.
discovery.wallet -- (INTRODUCED @onflow/fcl@0.0.68) Points FCL at the Wallet or Wallet Discovery mechanism.
env -- Used in conjunction with stored interactions. Possible values: local, canarynet, testnet, mainnet
app.detail.title - (INTRODUCED @onflow/fcl@0.0.68) Your applications title, can be requested by wallets and other services.
app.detail.icon - (INTRODUCED @onflow/fcl@0.0.68) Url for your applications icon, can be requested by wallets and other services.
service.OpenID.scopes - (INTRODUCED @onflow/fcl@0.0.68) Open ID Connect claims for Wallets and OpenID services.

Address replacement in scripts and transactions

Configuration keys that start with 0x will be replaced in FCL scripts and transactions, this allows you to write your script or transaction Cadence code once and not have to change it when you point your application at a difference instance of the Flow Blockchain.

import * as fcl from "@onflow/fcl"

fcl.config()
  .put("0xFungibleToken", "0xf233dcee88fe0abe")

async function myScript () {
  return fcl.send([
    fcl.script`
      import FungibleToken from 0xFungibleToken // will be replaced with 0xf233dcee88fe0abe because of the configuration

      pub fun main() { /* Rest of the script goes here */ }
    `
  ]).then(fcl.decode)
}

async function myTransaction () {
  return fcl.send([
    fcl.transaction`
      import FungibleToken from 0xFungibleToken // will be replaced with 0xf233dcee88fe0abe because of the configuration

      transaction { /* Rest of the transaction goes here */ }
    `
  ]).then(fcl.decode)
}

Example

import * as fcl from "@onflow/fcl"

fcl.config()
  .put("env", "testnet")
  .put("accessNode.api", "https://access-testnet.onflow.org")
  .put("discovery.wallet", "http://localhost:3000/fcl/authn")
  .put("app.detail.title", "Test Harness")
  .put("app.detail.icon", "https://i.imgur.com/r23Zhvu.png")
  .put("service.OpenID.scopes", "email email_verified name zoneinfo")
  .put("0xFlowToken", "0x7e60df042a9c0868")

MAINNET:
Loading...

TESTNET:
Loading...