Skip to content

Commit 4e04379

Browse files
authored
Update node types documentation (#537)
1 parent e8c22c8 commit 4e04379

1 file changed

Lines changed: 16 additions & 10 deletions

File tree

website/docs/Usage/NodeTypes.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,25 @@ You can run an Archive node, with all history and full lookup for all historical
1010

1111
You can run a Full node, with all history and limited lookup for historical transactions. This fits into a 4TB drive and is often the choice for RPC nodes.
1212

13-
You can run an Expired node, with pre-merge history and receipts gone. This fits into a 2TB drive and is often the choice for validator nodes.
13+
You can run an Expired node, with pre-merge history and receipts gone. This fits into a 2TB drive and is often the choice for validator nodes. This is the default.
1414

1515
This is controlled by variables in `.env`, which can be set with `nano .env`. Switching from one type to another often requires a full resync.
1616

17-
`EL_ARCHIVE_NODE` - run the execution layer node as an archive. The required space can vary widely depending on the client: From right around 2 TB to well over 50TB
18-
`EL_MINIMAL_NODE` - run the execution layer node with history expiry. `true` is pre-merge history expiry; `rolling` is 1-year rolling if the client supports it;
19-
`aggressive` expires all but the last few blocks, if the client supports it
20-
21-
If both variables are set to `false`, you have a Full node.
22-
23-
`CL_ARCHIVE_NODE` - run the consensus layer node as an archive, including blobs where supported
24-
`CL_MINIMAL_NODE` - run the consensus layer node with minimal storage, if the client makes that distinction. See the `--help` for Grandine and Teku, for example,
25-
with `./ethd cmd run --rm consensus --help`, or directly via `docker run` on their image.
17+
`EL_NODE_TYPE` can be one of:
18+
- `archive`
19+
- `full`
20+
- `pre-merge-expiry` - the default
21+
- `pre-cancun-expiry` - supported by some EL clients, see `default.env`
22+
- `rolling-expiry` - keeps one year of history by default. Supported by some EL clients, see `default.env`
23+
- `aggressive-expiry` - keep minimal history. Supported by some EL clients, see `default.env`
24+
25+
Please be careful with expiry options: Expired history also means expired receipts, which can throw protocols such as RocketPool, SSV, Stakewise for a loop. All of these work with pre-merge-expiry, but will likely break with the other expiry options, unless they get receipts from another (unexpired) RPC endpoint.
26+
27+
`CL_NODE_TYPE` can be one of:
28+
- `archive`
29+
- `full`
30+
- `pruned` - the default
31+
- `pruned-with-zkproofs` - **highly** experimental running mode without an execution layer client, currently only supported by a special build of Lighthouse
2632

2733
## Switch from Full to Expired node
2834

0 commit comments

Comments
 (0)