Skip to content
You are reading Hyperledger Besu development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.
Last update: February 17, 2022

Network ID and chain ID

Ethereum networks have two identifiers, a network ID and a chain ID. Although they often have the same value, they have different uses.

Peer-to-peer communication between nodes uses the network ID, while the transaction signature process uses the chain ID.

Note

EIP-155 introduced using the chain ID as part of the transaction signing process to protect against transaction replay attacks.

For most networks, including Mainnet and the public testnets, the network ID and the chain ID are the same, with the network ID defaulting to the chain ID, as specified in the genesis file.

Chain ID in the genesis file

{
  "config": {
    "ethash": {
    },
     "chainID": 1981
  },
  ...
}

Besu sets the chain ID (and by default the network ID) automatically, using either the --genesis-file option or when specifying a network using the --network option. The following table lists the available networks and their chain and network IDs.

Network Chain Chain ID Network ID Type
mainnet ETH 1 1 Production
ropsten ETH 3 3 Test
rinkeby ETH 4 4 Test
goerli ETH 5 5 Test
dev ETH 2018 2018 Development
classic ETC 61 1 Production
mordor ETC 63 7 Test
kotti ETC 6 6 Test
astor ETC 212 212 Test

Specify a different network ID

Usually the network ID is the same as the chain ID, but if you want to separate specific nodes from the rest of the network so they can’t connect or synchronize with other nodes, you can override the default network ID for those nodes using the --network-id option.

Start a new chain with a new chain ID

If you update the chain ID (or network ID) of existing nodes, they can no longer peer with other nodes in the network. Nodes need to have a matching genesis file, including the chain ID, in order to peer. In this case, you’re effectively running two chains that can’t communicate with each other.

To change a chain ID and start a new chain:

  1. Stop all your nodes using Ctrl+C in each terminal window.
  2. Update the genesis file with the new chain ID.
  3. Make sure all nodes have the same genesis file.
  4. Delete the old data directory or point to a new location for each node.
  5. Restart the nodes.

Important

Starting a new chain is starting from block zero. This means when you start a new chain with a new chain ID, you lose all previous data.

Questions or feedback? You can discuss issues and obtain free support on Hyperledger Besu chat channel.
For Hyperledger Besu community support, contact the mailing list besu@lists.hyperledger.org