Skip to content

Commit 4df8705

Browse files
authored
feat: add single-sequencer, EVM rollup (#2085)
## Overview This PR introduces rollup binary for single-sequencer with EVM. Resolves #2029
1 parent 4fed1e6 commit 4df8705

9 files changed

Lines changed: 2480 additions & 4 deletions

File tree

block/manager.go

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1242,6 +1242,12 @@ func (m *Manager) publishBlock(ctx context.Context) error {
12421242

12431243
// set the signature to current block's signed header
12441244
header.Signature = signature
1245+
1246+
if err := header.ValidateBasic(); err != nil {
1247+
// TODO(tzdybal): I think this is could be even a panic, because if this happens, header is FUBAR
1248+
m.logger.Error("header validation error", "error", err)
1249+
}
1250+
12451251
err = m.store.SaveBlockData(ctx, header, data, &signature)
12461252
if err != nil {
12471253
return SaveBlockError{err}

rollups/evm/centralized/go.mod

Lines changed: 0 additions & 3 deletions
This file was deleted.

rollups/evm/single/README.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Rollkit EVM Single Sequencer
2+
3+
This directory contains the implementation of a single EVM sequencer using Rollkit.
4+
5+
## Prerequisites
6+
7+
- Go 1.20 or later
8+
- Docker and Docker Compose
9+
- Access to the go-execution-evm repository
10+
11+
## Starting the Aggregator Node
12+
13+
1. Both EVM and DA layers must be running before starting the aggregator
14+
1. For the EVM layer, Reth can be conveniently run using `docker compose` from the go-execution-evm repository.
15+
2. For the DA layer, local-da can be built and run from the `rollkit/da/cmd/local-da` directory.
16+
17+
18+
2. Build the sequencer:
19+
```bash
20+
go build -o evm-single ./cmd/
21+
```
22+
23+
3. Initialize the sequencer:
24+
```bash
25+
./evm-single init --rollkit.node.aggregator=true --rollkit.signer.passphrase secret
26+
```
27+
28+
4. Start the sequencer:
29+
```bash
30+
./evm-single start \
31+
--evm.jwt-secret $(cat <path_to>/go-execution-evm/docker/jwttoken/jwt.hex) \
32+
--evm.genesis-hash 0x0a962a0d163416829894c89cb604ae422323bcdf02d7ea08b94d68d3e026a380 \
33+
--rollkit.node.block_time 1s \
34+
--rollkit.node.aggregator=true \
35+
--rollkit.signer.passphrase secret
36+
```
37+
38+
Note: Replace `<path_to>` with the actual path to your go-execution-evm repository.
39+
40+
## Configuration
41+
42+
The sequencer can be configured using various command-line flags. The most important ones are:
43+
44+
- `--rollkit.node.aggregator`: Set to true to run in aggregator mode
45+
- `--rollkit.signer.passphrase`: Passphrase for the signer
46+
- `--evm.jwt-secret`: JWT secret for EVM communication
47+
- `--evm.genesis-hash`: Genesis hash of the EVM chain
48+
- `--rollkit.node.block_time`: Block time for the Rollkit node

rollups/evm/single/cmd/main.go

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
package main
2+
3+
import (
4+
"fmt"
5+
"os"
6+
7+
"github.com/spf13/cobra"
8+
9+
"github.com/rollkit/rollkit/pkg/cmd"
10+
rollkitconfig "github.com/rollkit/rollkit/pkg/config"
11+
)
12+
13+
func main() {
14+
// Initiate the root command
15+
rootCmd := &cobra.Command{
16+
Use: "evm-single",
17+
Short: "Rollkit with EVM; single sequencer",
18+
}
19+
20+
rollkitconfig.AddGlobalFlags(rootCmd, "evm-single")
21+
22+
// Add subcommands to the root command
23+
initCmd := cmd.InitCmd
24+
rollkitconfig.AddFlags(initCmd)
25+
26+
rootCmd.AddCommand(
27+
initCmd,
28+
RunCmd,
29+
cmd.NewDocsGenCmd(rootCmd, "evm-single"),
30+
cmd.VersionCmd,
31+
cmd.NodeInfoCmd,
32+
)
33+
34+
if err := rootCmd.Execute(); err != nil {
35+
// Print to stderr and exit with error
36+
fmt.Fprintln(os.Stderr, err)
37+
os.Exit(1)
38+
}
39+
}

rollups/evm/single/cmd/run.go

Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
1+
package main
2+
3+
import (
4+
"context"
5+
"fmt"
6+
"github.com/rollkit/rollkit/sequencers/single"
7+
"github.com/rs/zerolog"
8+
"os"
9+
"path/filepath"
10+
11+
"cosmossdk.io/log"
12+
"github.com/ethereum/go-ethereum/common"
13+
"github.com/spf13/cobra"
14+
15+
evm "github.com/rollkit/go-execution-evm"
16+
17+
coreda "github.com/rollkit/rollkit/core/da"
18+
"github.com/rollkit/rollkit/core/execution"
19+
"github.com/rollkit/rollkit/da"
20+
"github.com/rollkit/rollkit/da/proxy"
21+
rollcmd "github.com/rollkit/rollkit/pkg/cmd"
22+
"github.com/rollkit/rollkit/pkg/config"
23+
"github.com/rollkit/rollkit/pkg/p2p"
24+
"github.com/rollkit/rollkit/pkg/p2p/key"
25+
"github.com/rollkit/rollkit/pkg/store"
26+
)
27+
28+
var RunCmd = &cobra.Command{
29+
Use: "start",
30+
Aliases: []string{"node", "run"},
31+
Short: "Run the rollkit node with EVM execution client",
32+
RunE: func(cmd *cobra.Command, args []string) error {
33+
opts := []log.Option{}
34+
logLevel, _ := cmd.Flags().GetString(config.FlagLogLevel)
35+
if logLevel != "" {
36+
zl, err := zerolog.ParseLevel(logLevel)
37+
if err != nil {
38+
return err
39+
}
40+
opts = append(opts, log.LevelOption(zl))
41+
}
42+
43+
logger := log.NewLogger(os.Stdout, opts...)
44+
45+
executor, err := createExecutionClient(cmd)
46+
if err != nil {
47+
return err
48+
}
49+
50+
nodeConfig, err := rollcmd.ParseConfig(cmd)
51+
if err != nil {
52+
return err
53+
}
54+
55+
daJrpc, err := proxy.NewClient(nodeConfig.DA.Address, nodeConfig.DA.AuthToken)
56+
if err != nil {
57+
return err
58+
}
59+
60+
datastore, err := store.NewDefaultKVStore(nodeConfig.RootDir, nodeConfig.DBPath, "evm-single")
61+
if err != nil {
62+
return err
63+
}
64+
65+
singleMetrics, err := single.NopMetrics()
66+
if err != nil {
67+
return err
68+
}
69+
70+
sequencer, err := single.NewSequencer(
71+
context.Background(),
72+
logger,
73+
datastore,
74+
daJrpc,
75+
[]byte(nodeConfig.DA.Namespace),
76+
[]byte(nodeConfig.ChainID),
77+
nodeConfig.Node.BlockTime.Duration,
78+
singleMetrics,
79+
nodeConfig.Node.Aggregator,
80+
)
81+
if err != nil {
82+
return err
83+
}
84+
85+
// Create DA client with dummy DA
86+
dummyDA := coreda.NewDummyDA(100_000, 0, 0)
87+
dac := da.NewDAClient(dummyDA, 0, 1.0, []byte("test"), []byte(""), logger)
88+
89+
nodeKey, err := key.LoadNodeKey(filepath.Dir(nodeConfig.ConfigPath()))
90+
if err != nil {
91+
return err
92+
}
93+
94+
p2pClient, err := p2p.NewClient(nodeConfig, nodeKey, datastore, logger, nil)
95+
if err != nil {
96+
return err
97+
}
98+
99+
return rollcmd.StartNode(logger, cmd, executor, sequencer, dac, nodeKey, p2pClient, datastore, nodeConfig)
100+
},
101+
}
102+
103+
func init() {
104+
config.AddFlags(RunCmd)
105+
addFlags(RunCmd)
106+
}
107+
108+
func createExecutionClient(cmd *cobra.Command) (execution.Executor, error) {
109+
// Read execution client parameters from flags
110+
ethURL, err := cmd.Flags().GetString("evm.eth-url")
111+
if err != nil {
112+
return nil, fmt.Errorf("failed to get 'evm.eth-url' flag: %w", err)
113+
}
114+
engineURL, err := cmd.Flags().GetString("evm.engine-url")
115+
if err != nil {
116+
return nil, fmt.Errorf("failed to get 'evm.engine-url' flag: %w", err)
117+
}
118+
jwtSecret, err := cmd.Flags().GetString("evm.jwt-secret")
119+
if err != nil {
120+
return nil, fmt.Errorf("failed to get 'evm.jwt-secret' flag: %w", err)
121+
}
122+
genesisHashStr, err := cmd.Flags().GetString("evm.genesis-hash")
123+
if err != nil {
124+
return nil, fmt.Errorf("failed to get 'evm.genesis-hash' flag: %w", err)
125+
}
126+
feeRecipientStr, err := cmd.Flags().GetString("evm.fee-recipient")
127+
if err != nil {
128+
return nil, fmt.Errorf("failed to get 'evm.fee-recipient' flag: %w", err)
129+
}
130+
131+
// Convert string parameters to Ethereum types
132+
genesisHash := common.HexToHash(genesisHashStr)
133+
feeRecipient := common.HexToAddress(feeRecipientStr)
134+
135+
return evm.NewPureEngineExecutionClient(ethURL, engineURL, jwtSecret, genesisHash, feeRecipient)
136+
}
137+
138+
// addFlags adds flags related to the EVM execution client
139+
func addFlags(cmd *cobra.Command) {
140+
cmd.Flags().String("evm.eth-url", "http://localhost:8545", "URL of the Ethereum JSON-RPC endpoint")
141+
cmd.Flags().String("evm.engine-url", "http://localhost:8551", "URL of the Engine API endpoint")
142+
cmd.Flags().String("evm.jwt-secret", "", "Path to the JWT secret file for authentication with the execution client")
143+
cmd.Flags().String("evm.genesis-hash", "", "Hash of the genesis block")
144+
cmd.Flags().String("evm.fee-recipient", "", "Address that will receive transaction fees")
145+
}
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
/*
22
This package implements a centralized rollup for RETH
33
*/
4-
package centralized
4+
package single

0 commit comments

Comments
 (0)