Skip to content

Network Configuration#

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
    
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
    
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
    

Last update: 2024-03-01