Skip to content

Linea is a supported network #1871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Nov 28, 2025
Merged

Linea is a supported network #1871

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
5dd30c8
adds notes that linea is supported
m4sterbunny Nov 24, 2025
50bd126
adds linea named
m4sterbunny Nov 24, 2025
9178a45
details naming linea network plus tag along fixes
m4sterbunny Nov 24, 2025
5a04fe7
tweaks the comment
m4sterbunny Nov 24, 2025
ca1b86f
Update docs/public-networks/index.md
m4sterbunny Nov 28, 2025
4dd596a
Update docs/public-networks/get-started/connect/index.md
m4sterbunny Nov 28, 2025
081643d
Bump node-forge in the npm_and_yarn group across 1 directory (#1878)
dependabot[bot] Nov 26, 2025
55209c5
rmvs commented line
m4sterbunny Nov 28, 2025
9c70155
Merge branch 'main' into 1866-add-linea-known-network
m4sterbunny Nov 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/public-networks/concepts/network-and-chain-id.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,11 @@ Besu sets the chain ID (and by default the network ID) automatically, using eith
| `hoodi` | ETH | 560048 | 560048 | Test |
| `sepolia` | ETH | 11155111 | 11155111 | Test |
| `dev` | ETH | 2018 | 2018 | Development |
| `ephemery`| ETH | [dynamic](https://github.com/ephemery-testnet/ephemery-genesis/releases) | [dynamic](https://github.com/ephemery-testnet/ephemery-genesis/releases) | Test |
| `ephemery`| ETH | [dynamic](https://github.com/ephemery-testnet/ephemery-genesis/releases) | [dynamic](https://github.com/ephemery-testnet/ephemery-genesis/releases) | Test |
| `lukso` | Lukso | 4201 | 4201 | Production |
| `linea` | Linea | 59144 | 59144 | Production |
| `linea_sepolia`| Linea |59141 | 59141 | Test |


:::info

Expand Down
7 changes: 7 additions & 0 deletions docs/public-networks/get-started/connect/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,10 @@ hide:
# Connect to a network

This section provides information on connecting Besu to a public Ethereum network.

:::note

Besu is also compatible with [Linea](https://docs.linea.build/get-started/how-to/run-a-node/besu), the Ethereum L2.

:::

25 changes: 18 additions & 7 deletions docs/public-networks/get-started/start-node.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,12 @@ tags:
- public networks
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Start Besu

Nodes can connect to Ethereum Mainnet and public testnets.
Nodes can connect to Ethereum Mainnet, [Linea](https://docs.linea.build/get-started/how-to/run-a-node), and their respective public testnets.

Use the [`besu`](../reference/cli/options.md) command with the required command line options to start a node.

Expand All @@ -24,7 +27,7 @@ To delete the local block data, delete the `database` directory in the `besu/bui

## Genesis configuration

Besu specifies the genesis configuration, and sets the network ID and bootnodes when connecting to [Hoodi](#run-a-node-on-hoodi-testnet), [Sepolia](#run-a-node-on-sepolia-testnet), [Ephemery](#run-a-node-on-ephemery-testnet), and [Mainnet](#run-a-node-on-ethereum-mainnet).
Besu specifies the genesis configuration, and sets the network ID and bootnodes when connecting to [ETH testnets](#run-a-node-on-an-eth-testnet), and [Mainnet](#run-a-node-on-ethereum-mainnet).

:::info

Expand Down Expand Up @@ -80,7 +83,11 @@ The following settings are a security risk in production environments:

:::

## Run a node on Hoodi testnet
## Run a node on an Ethereum testnet

<Tabs>

<TabItem value="Hoodi" label="Hoodi" default>

To run a node on [Hoodi](https://github.com/eth-clients/hoodi) specifying a data directory:

Expand All @@ -90,9 +97,9 @@ besu --network=hoodi --data-path=<path>/<hoodidata-path>

Where `<path>` and `<hoodidata-path>` are the path and directory to save the Hoodi chain data to.

See the [guide on connecting to a testnet](connect/testnet.md) for more information.
</TabItem>

## Run a node on Sepolia testnet
<TabItem value="Sepolia" label="Sepolia">

To run a node on [Sepolia](https://github.com/eth-clients/sepolia) specifying a data directory:

Expand All @@ -102,9 +109,9 @@ besu --network=sepolia --data-path=<path>/<sepoliadata-path>

Where `<path>` and `<sepoliadata-path>` are the path and directory to save the Sepolia chain data to.

See the [guide on connecting to a testnet](connect/testnet.md) for more information.
</TabItem>

## Run a node on Ephemery testnet
<TabItem value="Ephemery" label="Ephemery">

To run a node on [Ephemery](https://github.com/ephemery-testnet/ephemery-resources?tab=readme-ov-file) specifying a data directory:

Expand All @@ -114,6 +121,10 @@ besu --network=ephemery --data-path=<path>/<ephemery-data-path>

Where `<path>` and `<ephemery-data-path>` are the path and directory to save the Ephemery chain data to.

</TabItem>

</Tabs>

See the [guide on connecting to a testnet](connect/testnet.md) for more information.

## Run a node on Ethereum Mainnet
Expand Down
6 changes: 6 additions & 0 deletions docs/public-networks/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,12 @@ Besu serves as an [execution client](concepts/node-clients.md#execution-clients)
- Ephemery
- Sepolia

:::note

Besu is also compatible with [Linea](https://docs.linea.build/get-started/how-to/run-a-node/besu), the Ethereum L2.

:::

Get started by [installing Besu](get-started/install/index.md).

## Architecture
Expand Down
20 changes: 11 additions & 9 deletions docs/public-networks/reference/api/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7145,18 +7145,20 @@ None
#### Returns

`result`: _string_ - current network ID

| Network ID | Chain | Network | Description |
| ---------- | ----- | ------- | ----------------------------- |
| `1` | ETH | Mainnet | Main Ethereum network |
| `560048` | ETH | Hoodi | PoS test network |
| `11155111` | ETH | Sepolia | PoS test network |
| `2018` | ETH | Dev | PoW development network |


| Network ID | Chain | Network | Description |
| ---------- | -------| ------- | ----------------------------- |
| `1` | ETH | Mainnet | Main Ethereum network |
| `560048` | ETH | Hoodi | Ethereum PoS test network |
| `11155111` | ETH | Sepolia | Ethereum PoS test network |
| `2018` | ETH | Dev | Ethereum PoW development network|
| `59144` | Linea | Mainnet | Main Linea network |
| `59141` | Linea | Testnet | Linea Sepolia testnet |
| `4201` | Lukso | Mainnet | Main Lukso network |

:::note

For almost all networks, network ID and chain ID are the same.
For almost all networks, network ID and chain ID are the same. For Ephemery, the network ID is dynamic.

:::

Expand Down
15 changes: 9 additions & 6 deletions docs/public-networks/reference/cli/options.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2963,12 +2963,15 @@ Possible values include the following:

| Network | Chain | Type | Default sync mode | Consensus mechanism | Description |
|:-----------|:------|:------------|:---------------------|:--------------------|:-------------------------------------------------------------------------------|
| `mainnet` | ETH | Production | [`SNAP`](#sync-mode) | A PoS network | The main [Ethereum network](https://ethereum.org/en/developers/docs/networks/) |
| `hoodi` | ETH | Test | [`SNAP`](#sync-mode) | A PoS network | Multi-client testnet [Hoodi](https://hoodi.ethpandaops.io/) |
| `sepolia` | ETH | Test | [`SNAP`](#sync-mode) | A PoS network | Multi-client testnet [Sepolia](https://sepolia.dev) |
| `lukso` | ETH | Production | [`SNAP`](#sync-mode) | A PoS network | Network for the [Lukso chain](https://lukso.network/) |
| `dev` | ETH | Development | [`FULL`](#sync-mode) | A PoW network | Development network with low difficulty to enable local CPU mining |
| `ephemery` | ETH | Test | [`SNAP`](#sync-mode) | A PoS network | Multi-client testnet [Ephemery](https://ephemery.dev) |
| `mainnet` | ETH | Production | [`SNAP`](#sync-mode) | PoS network | The main [Ethereum network](https://ethereum.org/en/developers/docs/networks/) |
| `hoodi` | ETH | Test | [`SNAP`](#sync-mode) | PoS network | Multi-client Ethereum testnet [Hoodi](https://hoodi.ethpandaops.io/) |
| `sepolia` | ETH | Test | [`SNAP`](#sync-mode) | PoS network | Multi-client Ethereum testnet [Sepolia](https://sepolia.dev) |
| `dev` | ETH | Development | [`FULL`](#sync-mode) | PoW network | Development network with low difficulty to enable local CPU mining |
| `ephemery` | ETH | Test | [`SNAP`](#sync-mode) | PoS network | Multi-client Ethereum testnet [Ephemery](https://ephemery.dev)
| `linea` | Linea | Production | [`SNAP`](#sync-mode) | Sequencer-based (zkEVM rollup) | The main [Linea network](https://docs.linea.build/get-started/build/network-info) |
| `linea_sepolia` | Linea | Test | [`SNAP`](#sync-mode) | Sequencer-based (zkEVM rollup) | Linea [Sepolia testnet](https://docs.linea.build/get-started/build/network-info/) |
| `lukso` | Lukso | Production | [`SNAP`](#sync-mode) | PoS network | Network for the [Lukso chain](https://lukso.network/) |


:::tip

Expand Down
2 changes: 1 addition & 1 deletion docs/public-networks/reference/evm-tool.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -329,7 +329,7 @@ The [Besu genesis file](genesis-items.md) to use when evaluating the EVM. Most u
<TabItem value="Syntax" label="Syntax" default>

```bash
--chain=<mainnet|sepolia|dev|hoodi>
--chain=<mainnet|sepolia|dev|hoodi|linea|linea_sepolia>
```

</TabItem>
Expand Down
Loading