Setup Node Workshop

Setup the client pair

Execution client: Geth

1. Download the geth's pre-built binary (in tar.gz) and the stable release (in .asc)

   • https://geth.ethereum.org/downloads

2. Download the signature

   • openPGP signature

3. Import the key

   ​​​​gpg --import macos_builder_key.asc 
   

   ​​​​cat macos_builder_key.asc 
   

   When cat, should return:

   ​​​​-----BEGIN PGP PUBLIC KEY BLOCK-----
   ​​​​Comment: Hostname: 
   ​​​​Version: Hockeypuck 2.2
   
   ​​​​xsFNBFggyxoBEAC299KoAS43p0FyJetAc7E0m1B/wnpyQesFycop/1csNQCjSGMy
   ​​​​EvERt8Mv5VvbyZ696gTnzyLP/YHvx5+j/lKZhixw+7VkOng6JgPF3YgN3WrykIjK
   ​​​​.....
   ​​​​-----END PGP PUBLIC KEY BLOCK-----
   

4. Verify the downloaded binary with the key

   ​​​​gpg --verify Geth_Darwin_AMD64_1.15.2.asc Geth_Darwin_AMD64_1.15.2.tar.gz 
   

   Should return:

   ​​​​gpg: Signature made Lun 17 fév 13:16:21 2025 CET
   ​​​​gpg:                using RSA key 558915E17B9E2481
   ​​​​gpg: Good signature from "Go Ethereum macOS Builder <[e-mail]>" [unknown]
   ​​​​gpg: WARNING: This key is not certified with a trusted signature!
   ​​​​gpg:          There is no indication that the signature belongs to the owner.
   ​​​​Primary key fingerprint: 6D1D AF5D 0534 DEA6 1AA7  7AD5 5589 15E1 7B9E 2481
   

5. Unpack the Geth binary

   ​​​​tar -xzf Geth_Darwin_AMD64_1.15.2.tar.gz 
   

Consensus light: Lighthouse

1. Download the lighthouse's pre-built binary (in tar.gz) and the stable release (in .asc)
   • https://github.com/sigp/lighthouse/releases
   • recommended downloading stable release > beta release
2. Obtain & importe the PGP key
   • lighthouse PGP key: 15E66D941F697E28F49381F426416DC3F30674B0 from its release page
   ​​​​gpg --keyserver keys.openpgp.org --search-keys 15E66D941F697E28F49381F426416DC3F30674B0
   ​​​​gpg --recv-keys 15E66D941F697E28F49381F426416DC3F30674B0
   

   Should return:
   ​​​​gpg: data source: http://keys.openpgp.org:11371
   ​​​​(1)	Sigma Prime <[e-mail]>
   ​​​​    4096 bit RSA key 26416DC3F30674B0, created: 2020-11-27
   ​​​​Keys 1-1 of 1 for "15E66D941F697E28F49381F426416DC3F30674B0".  Enter number(s), N)ext, or Q)uit > 
   
   ​​​​gpg: key 26416DC3F30674B0: public key "Sigma Prime <[e-mail]>" imported
   ​​​​gpg: Total number processed: 1
   ​​​​gpg:               imported: 1
   

3. Verify the downloaded binary with the key
   ​​​​gpg --verify Lighthouse_v6.0.1_macOS.tar.gz.asc Lighthouse_v6.0.1_macOS.tar.gz 
   

   Should return:
   ​​​​gpg: Signature made Lun 16 déc 05:07:42 2024 CET
   ​​​​gpg:                using RSA key 15E66D941F697E28F49381F426416DC3F30674B0
   ​​​​gpg: Good signature from "Sigma Prime <[e-mail]>" [unknown]
   ​​​​gpg: WARNING: This key is not certified with a trusted signature!
   ​​​​gpg:          There is no indication that the signature belongs to the owner.
   ​​​​Primary key fingerprint: 15E6 6D94 1F69 7E28 F493  81F4 2641 6DC3 F306 74B0
   

4. Unpack the lighthouse binary
   ​​​​tar -xzf Lighthouse_v6.0.1_macOS.tar.gz 
   

Launch the client pair

1. Launch geth in default

   ​​​​./geth
   

2. Create a separate folder to store data

   ​​​​mkdir geth_data lighthouse_data
   

3. See the comments/ flags

   ​​​​geth --help
   ​​​​lighthouse --help
   

4. Launch geth with config

   ​​​​geth --sepolia \
   ​​​​--datadir geth_data \
   ​​​​--syncmode snap \
   ​​​​--http \
   ​​​​--http.port 8545 \
   ​​​​--authrpc.jwtsecret /tmp/jwt \
   ​​​​--authrpc.port 8551
   

5. Cat a JWT secret file (should return a 64-bit code)

   ​​​​cat /tmp/jwt
   

6. Launch lighthouse with config

   • launch with checkpoint sync
   • beacon chain checkpoint endpoints: https://eth-clients.github.io/checkpoint-sync-endpoints/
   ​​​​lighthouse beacon_node \
   ​​​​--network sepolia \
   ​​​​--datadir lighthouse_data \
   ​​​​--http \
   ​​​​--checkpoint-sync-url https://checkpoint-sync.sepolia.ethpandaops.io \
   ​​​​--execution-endpoint http://127.0.0.1:8551 \
   ​​​​--execution-jwt /tmp/jwt
   

   I had some trouble when connecting to Holesky testnet, which always return error as below (probably due to the recent Pectra upgrade situation, if switch to Sepolia, everything works fine)

   ​​​​Feb 24 11:33:32.566 INFO Logging to file                         path: "lighthouse_data/beacon/logs/beacon.log"
   ​​​​Feb 24 11:33:32.569 INFO Lighthouse started                      version: Lighthouse/v6.0.1-0d90135
   ​​​​Feb 24 11:33:32.569 INFO Configured for network                  name: holesky
   ​​​​Feb 24 11:33:32.578 INFO Data directory initialised              datadir: lighthouse_data
   ​​​​Feb 24 11:33:32.585 INFO Deposit contract                        address: 0x4242424242424242424242424242424242424242, deploy_block: 0
   ​​​​Feb 24 11:33:32.651 INFO Blob DB initialized                     oldest_data_column_slot: None, oldest_blob_slot: Some(Slot(950272)), path: "lighthouse_data/beacon/blobs_db", service: freezer_db
   ​​​​Feb 24 11:33:37.180 INFO Starting checkpoint sync                remote_url: https://checkpoint-sync.holesky.ethpandaops.io/, service: beacon
   ​​​​Feb 24 11:36:37.877 CRIT Failed to start beacon node             reason: Error loading checkpoint state from remote: HttpClient(, kind: timeout, detail: operation timed out)
   ​​​​Feb 24 11:36:37.877 INFO Internal shutdown received              reason: Failed to start beacon node
   ​​​​Feb 24 11:36:37.878 INFO Shutting down..                         reason: Failure("Failed to start beacon node")
   ​​​​Failed to start beacon node
   

Launch the client pair with ephemery

1. Download the testnet_all.tar.gz from the ephemery release
   • https://github.com/ephemery-testnet/ephemery-genesis/releases/
2. Init the ephemery on Geth
   ​​​​geth --datadir geth-ephemery init Ephemery_tester_all/genesis.json 
   ​​​​source Ephemery_tester_all/nodevars_env.txt 
   

   Should return
   ​​​​INFO [02-24|12:50:57.200] Maximum peer count                       ETH=50 total=50
   ​​​​INFO [02-24|12:50:57.204] Set global gas cap                       cap=50,000,000
   ​​​​INFO [02-24|12:50:57.204] Initializing the KZG library             backend=gokzg
   ​​​​INFO [02-24|12:50:57.226] Defaulting to pebble as the backing database
   ​​​​INFO [02-24|12:50:57.227] Allocated cache and file handles         database=/Users/.../ephemery/geth/chaindata cache=16.00MiB handles=16
   ​​​​INFO [02-24|12:50:57.284] Opened ancient database                  database=/Users/.../ephemery/geth/chaindata/ancient/chain readonly=false
   ​​​​INFO [02-24|12:50:57.284] State schema set to default              scheme=path
   ​​​​ERROR[02-24|12:50:57.284] Head block is not reachable
   ​​​​INFO [02-24|12:50:57.321] Opened ancient database                  database=/Users/.../ephemery/geth/chaindata/ancient/state readonly=false
   ​​​​INFO [02-24|12:50:57.321] Writing custom genesis block
   ​​​​INFO [02-24|12:50:57.428] Successfully wrote genesis state         database=chaindata hash=a45355..e0c1d2
   ​​​​INFO [02-24|12:50:57.428] Defaulting to pebble as the backing database
   ​​​​INFO [02-24|12:50:57.428] Allocated cache and file handles         database=/Users/.../ephemery/geth/lightchaindata cache=16.00MiB handles=16
   ​​​​INFO [02-24|12:50:57.481] Opened ancient database                  database=/Users/.../ephemery/geth/lightchaindata/ancient/chain readonly=false
   ​​​​INFO [02-24|12:50:57.481] State schema set to default              scheme=path
   ​​​​ERROR[02-24|12:50:57.481] Head block is not reachable
   ​​​​INFO [02-24|12:50:57.520] Opened ancient database                  database=/Users/.../ephemery/geth/lightchaindata/ancient/state readonly=false
   ​​​​INFO [02-24|12:50:57.520] Writing custom genesis block
   ​​​​INFO [02-24|12:50:57.600] Successfully wrote genesis state         database=lightchaindata hash=a45355..e0c1d2
   

3. Launch geth with config
   ​​​​geth --datadir geth-ephemery --authrpc.jwtsecret=/tmp/jwt --bootnodes $BOOTNODE_ENODE --networkid $CHAIN_ID  --http
   

4. Launch lighthouse with config
   ​​​​lighthouse beacon_node -t ephemery_test_all --execution-endpoint http://localhost:8551 --execution-jwt=/tmp/jwt --boot-nodes=$BOOTNODE_ENR_LIST
   

Query the data

Through JSON-RPC API

1. Query the eth_blockNumber
   ​​​​curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' localhost:8545
   

2. Query the syncing status
   ​​​​curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_syncing","id":1}' localhost:8545
   

3. More info
   • https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance

Through IPC

geth attach ./geth_data/geth.ipc

Resource

• EPS node workshop: https://epf.wiki/#/eps/nodes_workshop