Skip to content

Commit b1a6a09

Browse files
committed
update config.md file
1 parent ca26acd commit b1a6a09

1 file changed

Lines changed: 35 additions & 0 deletions

File tree

docs/learn/config.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ This document provides a comprehensive reference for all configuration options a
1717
- [Maximum Pending Blocks](#maximum-pending-blocks)
1818
- [Lazy Mode (Lazy Aggregator)](#lazy-mode-lazy-aggregator)
1919
- [Lazy Block Interval](#lazy-block-interval)
20+
- [Pruning (Height-Based Pruning)](#pruning-height-based-pruning)
2021
- [Data Availability Configuration (`da`)](#data-availability-configuration-da)
2122
- [DA Service Address](#da-service-address)
2223
- [DA Authentication Token](#da-authentication-token)
@@ -279,6 +280,40 @@ _Example:_ `--rollkit.node.lazy_block_interval 1m`
279280
_Default:_ `"30s"`
280281
_Constant:_ `FlagLazyBlockTime`
281282

283+
### Pruning (Height-Based Pruning)
284+
285+
**Description:**
286+
Controls height-based pruning of stored block data (headers, data, signatures, and index) from the local store. When pruning is enabled, the node periodically deletes old blocks while keeping a recent window of history. When disabled, the node keeps all blocks (archive mode).
287+
288+
**YAML:**
289+
290+
```yaml
291+
node:
292+
pruning_enabled: true
293+
pruning_keep_recent: 100000
294+
pruning_interval: 1000
295+
```
296+
297+
**Command-line Flags:**
298+
299+
- `--evnode.node.pruning_enabled` (boolean)
300+
- _Description:_ Enable height-based pruning of stored block data. When disabled, all blocks are kept (archive mode).
301+
- `--evnode.node.pruning_keep_recent <uint64>`
302+
- _Description:_ Number of most recent blocks to retain when pruning is enabled. Must be > 0 when pruning is enabled; set `pruning_enabled=false` to keep all blocks.
303+
- `--evnode.node.pruning_interval <uint64>`
304+
- _Description:_ Run pruning every N blocks. Must be >= 1 when pruning is enabled.
305+
306+
_Defaults:_
307+
308+
```yaml
309+
node:
310+
pruning_enabled: false
311+
pruning_keep_recent: 0
312+
pruning_interval: 0
313+
```
314+
315+
_Constants:_ `FlagNodePruningEnabled`, `FlagNodePruningKeepRecent`, `FlagNodePruningInterval`
316+
282317
## Data Availability Configuration (`da`)
283318

284319
Parameters for connecting and interacting with the Data Availability (DA) layer, which Evolve uses to publish block data.

0 commit comments

Comments
 (0)