You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/learn/config.md
+41-1Lines changed: 41 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,7 @@ This document provides a comprehensive reference for all configuration options a
4
4
5
5
## Table of Contents
6
6
7
+
-[DA-Only Sync Mode](#da-only-sync-mode)
7
8
-[Introduction to Configurations](#introduction-to-configurations)
8
9
-[Base Configuration](#base-configuration)
9
10
-[Root Directory](#root-directory)
@@ -49,6 +50,41 @@ This document provides a comprehensive reference for all configuration options a
49
50
-[Signer Path](#signer-path)
50
51
-[Signer Passphrase](#signer-passphrase)
51
52
53
+
## DA-Only Sync Mode
54
+
55
+
Evolve supports running nodes that sync exclusively from the Data Availability (DA) layer without participating in P2P networking. This mode is useful for:
56
+
57
+
-**Pure DA followers**: Nodes that only need the canonical chain data from DA
58
+
-**Resource optimization**: Reducing network overhead by avoiding P2P gossip
59
+
-**Simplified deployment**: No need to configure or maintain P2P peer connections
60
+
-**Isolated environments**: Nodes that should not participate in P2P communication
61
+
62
+
**To enable DA-only sync mode:**
63
+
64
+
1.**Leave P2P peers empty** (default behavior):
65
+
```yaml
66
+
p2p:
67
+
peers: ""# Empty or omit this field entirely
68
+
```
69
+
70
+
2. **Configure DA connection** (required):
71
+
```yaml
72
+
da:
73
+
address: "your-da-service:port"
74
+
namespace: "your-namespace"
75
+
# ... other DA configuration
76
+
```
77
+
78
+
3.**Optional**: You can still configure P2P listen address for potential future connections, but without peers, no P2P networking will occur.
79
+
80
+
When running in DA-only mode, the node will:
81
+
- ✅ Sync blocks and headers from the DA layer
82
+
- ✅ Validate transactions and maintain state
83
+
- ✅ Serve RPC requests
84
+
- ❌ Not participate in P2P gossip or peer discovery
85
+
- ❌ Not share blocks with other nodes via P2P
86
+
- ❌ Not receive transactions via P2P (only from direct RPC submission)
87
+
52
88
## Configs
53
89
54
90
Evolve configurations can be managed through a YAML file (typically `evolve.yaml` located in `~/.evolve/config/` or `<your_home_dir>/config/`) and command-line flags. The system prioritizes configurations in the following order (highest priority first):
@@ -461,17 +497,21 @@ p2p:
461
497
**Description:**
462
498
A comma-separated list of peer addresses (e.g., multiaddresses) that the node will attempt to connect to for bootstrapping its P2P connections. These are often referred to as seed nodes.
463
499
500
+
**For DA-only sync mode:** Leave this field empty (default) to disable P2P networking entirely. When no peers are configured, the node will sync exclusively from the Data Availability layer without participating in P2P gossip, peer discovery, or block sharing. This is useful for nodes that only need to follow the canonical chain data from DA.
0 commit comments