Network ID and chain ID | Besu documentation (2024)

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.

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.

{
 "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.

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.