Skip to content

Network Configuration#

Only EVM versions up to London are currently supported

All Flare networks support only EVM versions up to London.

Learn how to set the EVM version in your compiler in the Solidity documentation. Example of how to do this using Hardhat.

Flare Networks#

These are the values required to configure the different Flare networks:

../../assets/images/dev/reference/logo-FLR.png Flare
Chain ID 14
Asset Ticker FLR
RPC endpoint https://flare-api.flare.network/ext/bc/C/rpc
Rosetta API https://flare-rosetta-api.flare.network/
Block Explorer https://flare-explorer.flare.network
Bootstraping nodes
  • https://flare.flare.network
  • https://flare-bootstrap-1.staking.production.figment.io
  • https://flare.senseinode.com
Sample query

You can check that you are accessing the RPC endpoint correctly with this sample query:

curl -s -m 10 --request POST 'https://flare-api.flare.network/ext/bc/C/rpc' \
    -H 'Content-Type: application/json' \
    -d '{
            "jsonrpc":"2.0",
            "method":"eth_blockNumber",
            "params":[],
            "id":1
    }'

It should return the current chain height in a message similar to:

{"jsonrpc":"2.0","id":1,"result":"0x103384"}
../../assets/images/dev/reference/logo-SGB.png Songbird
Chain ID 19
Asset Ticker SGB
RPC endpoint https://songbird-api.flare.network/ext/bc/C/rpc
Block Explorer https://songbird-explorer.flare.network
Bootstraping nodes https://songbird.flare.network
Sample query

You can check that you are accessing the RPC endpoint correctly with this sample query:

curl -s -m 10 --request POST 'https://songbird-api.flare.network/ext/bc/C/rpc' \
    -H 'Content-Type: application/json' \
    -d '{
            "jsonrpc":"2.0",
            "method":"eth_blockNumber",
            "params":[],
            "id":1
    }'

It should return the current chain height in a message similar to:

{"jsonrpc":"2.0","id":1,"result":"0x103384"}
logo-CST.png Coston
Chain ID 16
Asset Ticker CFLR
RPC endpoint https://coston-api.flare.network/ext/bc/C/rpc
Block Explorer https://coston-explorer.flare.network
Bootstraping nodes https://coston.flare.network
Test Faucet https://faucet.flare.network
Sample query

You can check that you are accessing the RPC endpoint correctly with this sample query:

curl -s -m 10 --request POST 'https://coston-api.flare.network/ext/bc/C/rpc' \
    -H 'Content-Type: application/json' \
    -d '{
            "jsonrpc":"2.0",
            "method":"eth_blockNumber",
            "params":[],
            "id":1
    }'

It should return the current chain height in a message similar to:

{"jsonrpc":"2.0","id":1,"result":"0x103384"}
logo-CST2.png Coston2
Chain ID 114
Asset Ticker C2FLR
RPC endpoint https://coston2-api.flare.network/ext/bc/C/rpc
Block Explorer https://coston2-explorer.flare.network
Bootstraping nodes https://coston2.flare.network
Test Faucet https://faucet.flare.network
Sample query

You can check that you are accessing the RPC endpoint correctly with this sample query:

curl -s -m 10 --request POST 'https://coston2-api.flare.network/ext/bc/C/rpc' \
    -H 'Content-Type: application/json' \
    -d '{
            "jsonrpc":"2.0",
            "method":"eth_blockNumber",
            "params":[],
            "id":1
    }'

It should return the current chain height in a message similar to:

{"jsonrpc":"2.0","id":1,"result":"0x103384"}

All public RPC endpoints are experimental and rate-limited to avoid spamming attacks. For a production-grade option check out Flare's API Portal and the Google Cloud Marketplace.

Connected Networks#

Along with the endpoints listed above to interact with its own networks, Flare offers public RPC nodes for a series of other blockchain networks, to bootstrap development of connected services like attestation providers.

All public RPC endpoints are experimental and rate-limited to avoid spamming attacks. For a production-grade option check out Flare's API Portal and the Google Cloud Marketplace.

Algorand
  • RPC endpoint: https://algorand-api.flare.network

  • Sample query:

    curl -s -m 10 \
-H "X-Algo-API-Token: zl748k3wddvld8cvn64utnslbf7otorkijp84se0f58pmuu0shgm27gttpcjpmuq" \
https://algorand-api.flare.network/v2/status | jq
Avalanche
  • RPC endpoint: https://avalanche-api.flare.network

  • Sample query:

    curl -X POST \
-H 'content-type:application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "info.getNodeVersion"
}' https://avalanche-api.flare.network/ext/info | jq
Bitcoin
  • RPC endpoint: https://bitcoin-api.flare.network
  • Sample query:
curl -s -X POST -m 10 -H "Content-type: application/json" \
-d '{"jsonrpc": "1.0", "id":"hc", "method": "getblockchaininfo", "params":[]}' \
-u public:d681co1pe2l3wcj9adrm2orlk0j5r5gr3wghgxt58tvge594co0k1ciljxq9glei \
https://bitcoin-api.flare.network | jq
BNB-BSC
  • RPC endpoint: https://bnb-bsc-api.flare.network

  • Sample query:

    curl -s -X POST -m 10 -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id":67, "method":"eth_blockNumber", "params":[]}' \
https://bnb-bsc-api.flare.network | jq
Cosmos Hub

Cosmos Hub provides several APIs for accessing its functionalities:

  • RPC: Tendermint RPC endpoint, offering a user-friendly API with larger over-the-wire message sizes (JSON).

    • Endpoint: https://cosmos-rpc-api.flare.network

    • Sample query:

      curl -s -X GET -m 10 -H "Content-type: application/json" \
"https://cosmos-rpc-api.flare.network/block?height=19570438" | jq

  • REST: REST endpoint, widely used for faster implementation with client libraries.

    • Endpoint: https://cosmos-rest-api.flare.network

    • Sample query:

      curl -s -X GET -m 10 -H "Content-type: application/json" \
https://cosmos-rest-api.flare.network/blocks/latest | jq

  • gRPC endpoint: gRPC endpoint, enabling the usage of code-generated stubs in various languages and supporting streaming.

Dogecoin
  • RPC endpoint: https://dogecoin-api.flare.network

  • Sample query:

    curl -s -X POST -m 10 -H "Content-type: application/json" \
-d '{"jsonrpc": "1.0", "id":"hc", "method": "getblockchaininfo", "params":[]}' \
-u public:6r1e5z3w9g6qruvkzkqvz8w67yqrq5js2cmyl2f1cncbp7gpp7tqixqskuub5v70 \
https://dogecoin-api.flare.network | jq
Ethereum

Ethereum has two layers: the execution layer and consensus layer, which work in tandem.

  • The execution layer creates blocks with transactions and executes smart contracts.
  • The consensus layer, sometimes referred to as the beacon chain, governs consensus and was the extra layer required for the Ethereum 2.0 proof-of-stake (PoS) merge.

These two layers have their own API, which can be called from the provided nodes. When querying the Ethereum network nodes, specifying only the root path / will target the execution layer API. Prefixing your path with /eth will target the consensus layer API.

Official API specifications for each layer:

  • RPC endpoint: https://ethereum-api.flare.network

  • Sample query - consensus layer:

    curl -s -X GET -m 10 -H "Content-type: application/json" \
https://ethereum-api.flare.network/eth/v1/beacon/pool/attestations | jq

  • Sample query - execution layer:

    curl -s -X POST -m 10 -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id":67, "method":"eth_blockNumber", "params":[]}' \
https://ethereum-api.flare.network | jq
  • RPC endpoint: https://goerli-api.flare.network

  • Sample query - consensus layer:

    curl -s -X GET -m 10 -H "Content-type: application/json" \
https://goerli-api.flare.network/eth/v1/beacon/pool/attestations | jq

  • Sample query - execution layer:

    curl -s -X POST -m 10 -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id":67, "method":"eth_blockNumber", "params":[]}' \
https://goerli-api.flare.network | jq
  • RPC endpoint: https://sepolia-api.flare.network

  • Sample query - consensus layer:

    curl -s -X GET -m 10 -H "Content-type: application/json" \
https://sepolia-api.flare.network/eth/v1/beacon/pool/attestations | jq

  • Sample query - execution layer:

    curl -s -X POST -m 10 -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id":67, "method":"eth_blockNumber", "params":[]}' \
https://sepolia-api.flare.network | jq
Filecoin
  • RPC endpoint: https://filecoin-api.flare.network/rpc/v1

  • Sample query:

    curl -X POST -H "Content-type: application/json" \
-d '{"jsonrpc": "2.0", "id": "1", "method": "Filecoin.NodeStatus", "params": [true]}' \
"https://filecoin-api.flare.network/rpc/v1" | jq
Litecoin
  • RPC endpoint: https://litecoin-api.flare.network

  • Sample query:

    curl -s -X POST -m 10 -H "Content-type: application/json" \
-d '{"jsonrpc": "1.0", "id":"hc", "method": "getblockchaininfo", "params":[]}' \
-u public:ntvzi4i1yne499t7vcdjqhhp92m3jvm0bb6dkpr406gkndvuns9sg6th3jd393uc \
https://litecoin-api.flare.network | jq
Polygon
  • RPC endpoint: https://polygon-api.flare.network

  • Sample query:

    curl -X GET -H "Content-type: application/json" \
https://polygon-api.flare.network/block?height=1000 | jq
Solana
  • RPC endpoint: https://solana-api.flare.network

  • Sample query:

    curl -s -X POST -m 10 -H "Content-type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "getVersion"}' \
https://solana-api.flare.network | jq
XRPL
  • RPC endpoint: https://xrpl-api.flare.network

  • Sample query:

    curl -s -X POST -m 10 -H "Content-type: application/json" \
-d '{"method": "server_info", "params":[{"api_version": 1}]}' \
https://xrpl-api.flare.network | jq