Skip to content

Commit 3a877bf

Browse files
committed
updated the content
1 parent ee062f8 commit 3a877bf

File tree

2 files changed

+165
-219
lines changed

2 files changed

+165
-219
lines changed

pages/operators/chain-operators/tutorials/sequncer-node.mdx

Lines changed: 49 additions & 103 deletions
Original file line numberDiff line numberDiff line change
@@ -47,17 +47,27 @@ This guide provides step-by-step instructions for spinning up a single sequencer
4747

4848
## Latest release information
4949

50-
### Current stable releases (May 2025)
50+
### Finding the current stable releases
5151

52-
**op-node**: v1.13.2 (required for Mainnet Superchain by May 9, 2025 for Isthmus fork)
52+
To ensure you're using the latest compatible versions of OP Stack components, always check the official releases page:
5353

54-
**op-geth**: v1.101503.3 (Isthmus release for Mainnet Superchain, mandatory upgrade by May 9, 2025)
54+
**[release page](https://github.com/ethereum-optimism/optimism/releases)**
5555

56-
**op-batcher**: v1.12.0 (required before activating Isthmus on chains)
56+
The main components you'll need for sequencer deployment are:
5757

58-
### Version naming convention
58+
* **op-node**: Look for the latest `op-node/v*` release
59+
* **op-geth**: Look for the latest `op-geth/v*` release (found at [https://github.com/ethereum-optimism/op-geth/releases](https://github.com/ethereum-optimism/op-geth/releases))
60+
* **op-batcher**: Look for the latest `op-batcher/v*` release
5961

60-
op-geth embeds upstream geth's version inside its own version as follows: vMAJOR.GETH\_MAJOR GETH\_MINOR GETH\_PATCH.PATCH. For example, if geth is at v1.12.0, the corresponding op-geth version would be v1.101200.0.
62+
### Docker images
63+
64+
Pre-built Docker images are available for all releases at:
65+
66+
* `us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:[VERSION]`
67+
* `us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:[VERSION]`
68+
* `us-docker.pkg.dev/oplabs-tools-artifacts/images/op-batcher:[VERSION]`
69+
70+
Replace `[VERSION]` with the specific version tag from the releases page.
6171

6272
## Network flags and superchain registry
6373

@@ -78,16 +88,17 @@ Common networks include:
7888

7989
## Installation options
8090

81-
### Option 1: Docker-based Setup (Recommended)
82-
83-
#### 1. Download latest docker images
91+
### Option 1: Docker-based setup (Recommended)
8492

8593
```bash
8694
# Pull latest op-node image
8795
docker pull us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:v1.13.2
8896

89-
# Pull latest op-geth image
90-
docker pull us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.3
97+
# Pull latest op-geth image
98+
docker pull us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.4
99+
100+
# Pull latest op-batcher image
101+
docker pull us-docker.pkg.dev/oplabs-tools-artifacts/images/op-batcher:v1.13.1
91102
```
92103

93104
### Option 2: building from source
@@ -125,11 +136,27 @@ make geth
125136
# Binary will be available at ./build/bin/geth
126137
```
127138

139+
#### 3. Clone and build op-batcher
140+
141+
```bash
142+
# op-batcher is part of the optimism monorepo
143+
cd optimism
144+
145+
# Checkout the latest release tag (if not already done)
146+
git checkout op-batcher/v1.13.1
147+
148+
# Build op-batcher
149+
cd op-batcher
150+
make op-batcher
151+
152+
# Binary will be available at ./bin/op-batcher
153+
```
154+
128155
## Configuration setup
129156

130157
### 1. Generate JWT secret
131158

132-
To communicate with op-node and enable the Engine API, you'll also need to generate a JWT secret file and enable Geth's authenticated RPC endpoint.
159+
To communicate with op-node and enable the Engine API, you'll also need to generate a JWT secret file and enable `op-geth's` authenticated RPC endpoint.
133160

134161
```bash
135162
# Generate JWT secret
@@ -148,13 +175,15 @@ sequencer-node/
148175
├── jwt.txt
149176
├── data/
150177
│ ├── op-geth/
151-
│ └── op-node/
178+
│ ├── op-node/
179+
│ └── op-batcher/
152180
├── configs/
153181
│ ├── rollup.json (if not using network flags)
154182
│ └── genesis.json (if not using network flags)
155183
└── scripts/
156184
├── start-op-geth.sh
157-
└── start-op-node.sh
185+
├── start-op-node.sh
186+
└── start-op-batcher.sh
158187
```
159188

160189
### 3. Environment variables
@@ -164,7 +193,7 @@ Create a `.env` file:
164193
```bash
165194
# L1 Configuration
166195
L1_RPC_URL=https://mainnet.infura.io/v3/YOUR_INFURA_KEY
167-
L1_BEACON_URL=https://beacon-nd-123-456-789.p2pify.com/YOUR_BEACON_KEY
196+
L1_BEACON_URL=https://ethereum-sepolia-beacon-api.publicnode.com
168197

169198
# Network configuration
170199
NETWORK=op-mainnet # or your target network
@@ -225,7 +254,7 @@ source .env
225254

226255
### op-node configuration for sequencer
227256

228-
The sequencer can be initialized in a stopped state using the sequencer.stopped flag. The sequencer can be started using the admin\_startSequencer RPC.
257+
The sequencer can be initialized in a stopped state using the sequencer.stopped flag. The sequencer can be started using the `admin\_startSequencer` RPC.
229258

230259
Create `scripts/start-op-node.sh`:
231260

@@ -387,92 +416,9 @@ curl -X POST http://localhost:8547 \
387416
-d '{"method":"optimism_sequencerActive","params":[],"id":1,"jsonrpc":"2.0"}'
388417
```
389418

390-
## Security considerations
391-
392-
### 1. Network Security
393-
394-
* Configure firewall to allow only necessary ports
395-
* Use VPN or private networks when possible
396-
* Regular security updates
397-
398-
### 2. Key Management
399-
400-
* Secure JWT secret file with appropriate permissions
401-
* Regular rotation of authentication secrets
402-
* Hardware security modules for production
403-
404-
### 3. Monitoring
405-
406-
* Set up alerting for sequencer downtime
407-
* Monitor L1 connectivity
408-
* Track block production metrics
409-
410-
## Troubleshooting
411-
412-
### Common Issues
413-
414-
**Sequencer Not Starting:**
415-
416-
* Verify L1 RPC connectivity
417-
* Check JWT secret configuration
418-
* Ensure proper network flags
419+
## Next steps
419420

420-
**P2P Connection Issues:**
421-
422-
* Verify firewall settings for port 9222
423-
* Check public IP configuration
424-
* Validate bootnode connectivity
425-
426-
**Block Building Failures:**
427-
428-
* Monitor resource usage (CPU, memory)
429-
* Check L1 gas prices and availability
430-
* Verify execution engine connectivity
431-
432-
### Log Analysis
433-
434-
Node log levels determine the verbosity of log messages. The log levels for the op-node are: Silent (0), Error (1), Warn (2), Info (3), Debug (4). Info (3) is the default level and provides a balanced view of the node's operations.
435-
436-
For debugging, increase verbosity:
437-
438-
```bash
439-
# For op-geth
440-
--verbosity=4
441-
442-
# For op-node
443-
--log.level=debug
444-
```
445-
446-
## Production Considerations
447-
448-
### 1. High Availability
449-
450-
* Implement redundant sequencer setups
451-
* Use load balancers for RPC endpoints
452-
* Regular backup procedures
453-
454-
### 2. Performance Optimization
455-
456-
* SSD storage with high IOPS
457-
* Adequate CPU and memory allocation
458-
* Network optimization for low latency
459-
460-
### 3. Monitoring and Alerting
461-
462-
* Prometheus metrics collection
463-
* Grafana dashboards
464-
* PagerDuty or similar alerting systems
465-
466-
## Resources
467-
468-
* [Optimism Documentation](https://docs.optimism.io)
469-
* [OP Stack Specifications](https://github.com/ethereum-optimism/specs)
470-
* [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry)
471-
* [Node Software Releases](https://docs.optimism.io/builders/node-operators/releases)
421+
* [OP Stack specs](https://github.com/ethereum-optimism/specs)
422+
* [Superchain registry](https://github.com/ethereum-optimism/superchain-registry)
423+
* [Node software releases](/operators/node-operators/releases)
472424
* [Developer Forum](https://github.com/ethereum-optimism/developers/discussions)
473-
474-
## Conclusion
475-
476-
This guide provides the foundation for setting up an Optimism sequencer node. Remember that currently only OP Labs PBC can run sequencer nodes, but this is expected to change in the future as the network becomes more decentralized. Always use the latest releases and monitor the official documentation for updates and changes to the setup process.
477-
478-
For production deployments, thorough testing in a staging environment and comprehensive monitoring are essential for reliable operation.

0 commit comments

Comments
 (0)