Skip to content

Commit

Permalink
docs: verkle stateful docs (#3805)
Browse files Browse the repository at this point in the history
* docs: verkle stateful docs

* Update packages/client/README.md

* spelling config fix

---------

Co-authored-by: acolytec3 <[email protected]>
  • Loading branch information
gabrocheleau and acolytec3 authored Nov 20, 2024
1 parent 723005a commit 84700fb
Show file tree
Hide file tree
Showing 3 changed files with 34 additions and 12 deletions.
9 changes: 6 additions & 3 deletions config/cspell-md.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
{
"language": "en-US",
"ignoreRegExpList": ["/0x[0-9A-Fa-f]+/"],
"ignoreRegExpList": [
"/0x[0-9A-Fa-f]+/"
],
"words": [
"trienode",
"t8ntool",
Expand Down Expand Up @@ -318,6 +320,7 @@
"heartedly",
"beaconroot",
"Grandine",
"EVMBN"
"EVMBN",
"kaust"
]
}
}
21 changes: 17 additions & 4 deletions config/cspell-ts.json
Original file line number Diff line number Diff line change
@@ -1,17 +1,30 @@
{
"language": "en-US",
"ignoreRegExpList": ["/0x[0-9A-Fa-f]+/", "@scure"],
"ignoreRegExpList": [
"/0x[0-9A-Fa-f]+/",
"@scure"
],
"overrides": [
{
"filename": "**/packages/devp2p/**",
"ignoreWords": ["pirl", "ubiq", "gwhale", "prichain", "zfill"]
"ignoreWords": [
"pirl",
"ubiq",
"gwhale",
"prichain",
"zfill"
]
},
{
"filename": "**/packages/ethash/**",
"ignoreWords": ["epoc", "cmix"]
"ignoreWords": [
"epoc",
"cmix"
]
}
],
"words": [
"kaust",
"EEST",
"paulmillr",
"t8ntool",
Expand Down Expand Up @@ -610,4 +623,4 @@
"PUSHDATA",
"chunkified"
]
}
}
16 changes: 11 additions & 5 deletions packages/client/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -220,19 +220,25 @@ Then start the Lodestar client with:

The EthereumJS client supports ongoing protocol development efforts, allowing developers and testers to participate in various testnets using the EthereumJS client.

### Stateless Verkle
### Verkle testnet

We currently support the Verkle Kaustinen6 testnet, and will be proactively supporting upcoming testnets (e.g. Kaustinen7) as they launch. To start the EthereumJS client alongside the Lodestar consensus client, use the following commands:
We currently support the Kaustinen7 testnet, both with stateless and stateful execution. We will be proactively supporting upcoming testnets as they launch.

Step 1 - Running the EthereumJS client (from the cloned @ethereumjs/client package)

`npm run client:start:ts -- --dataDir /data/k6data --network kaustinen6 --rpcEngine --rpcEngineAuth false --logLevel warn`
For stateless execution:

`npm run client:start:ts -- --rpc --gethGenesis=./devnets/kaustinen7/genesis.json --dataDir=datadir/kaust7 --rpcEngine --rpcEngineAuth=false --statelessVerkle=true`

For stateful execution:

`npm run client:start:ts -- --rpc --gethGenesis=./devnets/kaustinen7/genesis.json --dataDir=datadir/kaust7 --rpcEngine --rpcEngineAuth=false --statefulVerkle=true`

Step 2 - Running the Lodestar client (from the cloned Lodestar quick-start repository)

`setup.sh --dataDir k6data --network kaustinen6 --justCL`
`./setup.sh --network kaustinen7 --dataDir kaust --justCL`

Additional information on the Kaustinen6 testnet can be retrieve from this page: https://verkle-gen-devnet-6.ethpandaops.io/
Additional information on the Kaustinen7 testnet can be retrieve from this page: https://verkle-gen-devnet-7.ethpandaops.io/

The process should be similar for other testnets, and the quick-start repository should provide testnet-specific configuration instructions for the Lodestar consensus layer client.

Expand Down

0 comments on commit 84700fb

Please sign in to comment.