camaocande / autoclock-validator Goto Github PK

• A fast and straightforward way to spin up a Solana validator running the Jito client.
• The Autoclock Validator Ansible script has been designed and tested on c3.large Latitude servers running Ubuntu thus far. Other OS and machine/disk configurations are untested yet, but feel free to fork or submit PRs to support additional infra.
• C3.large machines have 2 disks. One of these is mounted to / and the second one needs to be supplied in the defaults.

1. Install Solana Tool Suite https://docs.solana.com/cli/install-solana-cli-tools
2. Create validator identity keypair https://docs.solana.com/running-validator/validator-start#generate-identity
3. Create withdrawer account keypair https://docs.solana.com/running-validator/validator-start#create-authorized-withdrawer-account
4. Create vote account keypair https://docs.solana.com/running-validator/validator-start#create-vote-account

https://docs.ansible.com/ansible/latest/installation_guide/installation_distros.html

• https://github.com/Overclock-Validator/autoclock-validator/blob/master/hosts.example.yaml
• Edit hosts.yaml so that it points to your validator's IP address and needed ssh parameters

• This step assumes that validator-keypair.json and vote-account-keypair.json have been generated using solana-keygen and that the vote-account has already been created. The Ansible playbook executes the vote-account command to see that vote-account-keypair.json actually exists and is associated with validator-keypair.json. It will fail before starting the validator if that is not the case.
• Make sure that the solana_version is up-to-date and that you specify the correct cluster

ansible-playbook setup.yaml -i hosts.yaml -e id_path=./keys/validator-keypair.json -e vote_path=./keys/vote-account-keypair.json -e region=ny -e cluster=mainnet -e rpc_address=https://api.mainnet-beta.solana.com -e repo_version=v1.13.6-jito

• https://github.com/overclock-validator/autoclock-validator/blob/master/roles/common/defaults/main.yaml
• Inside this file you will see (and may need to edit):

ledger_disk: "nvme1n1"
swap_mb: 100000

• ledger_disk needs to point to the nvme disk on the c3.large that is not currently mounted, which you can find using lsblk
• The Ansible script puts the ledger on a separate disk from everything else (accounts, snapshots, OS). Ledger and snapshots are both write intensive, so it's good to separate those to different disks.
• By default, swap_mb is set to 100gb, but for validators it's not that helpful outside of preventing a crash. If your machine is swapping however, there are other issues that need to be solved anyway.

• https://github.com/overclock-validator/autoclock-validator/blob/master/roles/jito/defaults/main.yaml
• Inside this file you will see (and may need to edit):

# 1. Supply a valid cluster
# testnet, mainnet
cluster: "mainnet"

# 2. Supply a valid jito block engine location
# mainnet: amsterdam, frankfurt, ny, tokyo 
# testnet: dallas, ny
location: "ny"

# Commission is in basis points (bps). 100 bps = 1%
commission-bps: 800
# Optional. This sends metricss to Solana's public influx and it is encouraged to set to true since it helps Solana Labs and others debug your validator as well as network issues.
metrics: true
org_name: "jito-foundation"
repo_name: "jito-solana"
repo_dir: "jito-solana"
repo_version: "v1.13.6-jito"

• The location as mentioned in the comment needs to be one of the 4 (for mainnet) or one of 2 (for testnet) - the validator parameters for block engine, relayer, etc are set based on the nearest location to your validator server.
• The repo_version needs to be modified to whichever tag you want the validator to run. Consult Jito discord (link below) for the latest version expected to be run.
• Other parameters can be left as is (most validators set commission to 800 basis points atm, but you can adjust that if you want to).

screen -S sol

sudo su - solana

source ~/.profile
solana-validator --ledger /mnt/solana-ledger monitor
ledger monitor
Ledger location: /mnt/solana-ledger
⠉ Validator startup: SearchingForRpcService...

⠉ Validator startup: SearchingForRpcService...

⠐ 00:08:26 | Processed Slot: 156831951 | Confirmed Slot: 156831951 | Finalized Slot: 156831917 | Full Snapshot Slot: 156813730 |

solana catchup --our-localhost

If you see the message above, then everything is working fine! gratz. You have a new validator server and you can visit the URL at http://xx.xx.xx.xx:8899/

• Search your validator's identity on a block explorer to see if votes from your validator are landing.
• If this is your first time starting a validator, your Identity account needs enough Sol for voting fees.
• Example: https://solana.fm/address/C1ocKDYMCm2ooWptMMnpd5VEB2Nx4UMJgRuYofysyzcA

• Jito Discord
• Jito Docs
• Solana Discord (validator-support channel)
• Overclock Discord (autoclock channel)

• support different disk configurations
• support skipping disk setup
• support flag to make starting the validator optional
• support Labs client as well, later Firedancer