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:
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 |
|
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"}
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"}
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"}
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
- Endpoint:
-
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
- Endpoint:
-
gRPC endpoint: gRPC endpoint, enabling the usage of code-generated stubs in various languages and supporting streaming.
- Endpoint:
https://cosmos-grpc-api.flare.network
- Visit the Cosmos SDK documentation for a detailed example.
- Endpoint:
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