How to join the UCT Finhub Devnet

This guide will demonstrate how to setup nodes on the UCT Finhub testnet (uct_finhub-devnet-1). If the network changes a new network will be added e.g. devnet-2, but the overall setup should remain the same.

Preparation

The preparation steps are the same as the ones in the guide for creating an ethereum devnet setup.

1. Complete the setup a gke cluster section
2. Complete the Setup Kubernetes Commandline Tool (Kubectl) section
3. Complete the Setup Kurtosis section

Deploy a participating node

1. To deploy a node that syncs to an existing network we will use the network config file in this repo, kurtosis_network_params.yaml file
   • network: - This parameter will specify the dev network the nodes sync to.

     • The devnet-1 in the network name is a key word that lets the ethereum-package know that the created nodes will synch to devnet-1 of the uct-finhub-devnets repository.

       Example: For the network: verkle-gen-devnet-7 there is the github repository verkle-gen-devnets from the ethpandaops github account.

       There is also a network-configs folder which containes the gen-devnet-7 metadata that the ethereum-package will use to bootstrap from and sync the created nodes to.

   • network_id: - This is the ID of the UCT Finhub network.
   • devnet_repo: - This parameter specifies which github account to search for to find the dev network specified by the network parameter.
     • The default account is ethpandaops which runs the verkle-gen-devnets.
   • nat_exit_ip: - Static IP of the loadbalancer used to access the nodes
   • checkpoint_sync_enabled: - This is for the consensus node to sync up to a bootstrap node specified by the end-point checkpoint_sync_url.
   • checkpoint_sync_url: - URL for the consensus client that will be used for performing a checkpoint sync.
2. To deploy a node on our uct_finhub-devnet-1 network:
   • Run the ethereum kurtosis package as below:

     kurtosis run github.com/ethpandaops/ethereum-package --args-file ./network-configs/devnet-1/kurtosis_network_params.yaml --image-download always