nimbus-eth2/docs/rayonism_merge.md

# How to run Catalyst

- Clone Geth master into ~/client/catalyst: `git clone https://github.com/ethereum/go-ethereum ~/clients/catalyst`
- Build Geth and Catalyst with `go build -o ./build/bin/catalyst ./cmd/geth`
- Run `scripts/run-catalyst.sh` to run Catalyst. It listens on port 8545.

# Verify Catalyst is working

- Clone https://github.com/protolambda/mergenet-tutorial
- Navigate to `rpc_examples` and run `consensus_assembleBlock.sh`, `consensus_newBlock.sh`, `consensus_setHead.sh`, and `
get_genesis_hash.sh` to verify that Catalyst is properly configured.
- If issues present themselves here, or when Nimbus attempts to use the API, one can `debug.verbosity(4)` console command in Catalyst.

# How to run Nimbus

- Check out branch `quick-merge-v1`
- Run `./scripts/launch_local_testnet.sh --testnet 0 --nodes 4 --disable-htop --stop-at-epoch 8 -- --verify-finalization --discv5:no`

![./rayonism_catalyst_logs.png](./rayonism_catalyst_logs.png)

# How to post a transaction

- Set up the MetaMask Chrome extension and use the seed phrase corresponding to an address with funds at genesis.
- Configure the localhost:8545 network to use the Chain ID corresponding to the Catalyst chain configuration.
![./rayonism_metamask_network_setup.png](./rayonism_metamask_network_setup.png)
- Create a transaction from that address to another address.
![./rayonism_metamask_send_eth.png](./rayonism_metamask_send_eth.png)
- Run the local testnet to confirm the transaction.
![./rayonism_metamask_transaction_confirmation.png](./rayonism_metamask_transaction_confirmation.png)