Skip to content

Latest commit

 

History

History
155 lines (105 loc) · 3.43 KB

keeper-bot-quick-start.md

File metadata and controls

155 lines (105 loc) · 3.43 KB
Raw

Keeper Bot Quick-start

Below are the steps to configuring and running the Stakenet Keeper Bot. We recommend running it as a docker container.

Setup

Credentials

In the root directory create a new folder named credentials and then populate it with a keypair. This is keypair that signs and pays for all transactions.

mkdir credentials
solana-keygen new -o ./credentials/keypair.json

ENV

In the root directory create .env file

touch .env

Then copy into the .env file the contents below. Everything should be set as-is, however you will need to include a JSON_RPC_URL that can handle getProgramAccounts calls.

# RPC URL for the cluster
JSON_RPC_URL="INCLUDE YOUR RPC URL HERE"

# Cluster to specify (mainnet, testnet, devnet)
CLUSTER=mainnet

# Log levels
RUST_LOG="info,solana_gossip=error,solana_metrics=info"

# Path to keypair used to execute tranasactions
KEYPAIR=./credentials/keypair.json

# Validator history program ID (Pubkey as base58 string)
VALIDATOR_HISTORY_PROGRAM_ID=HistoryJTGbKQD2mRgLZ3XhqHnN811Qpez8X9kCcGHoa

# Tip distribution program ID (Pubkey as base58 string)
TIP_DISTRIBUTION_PROGRAM_ID=4R3gSG8BpU4t19KYj8CfnbtRpnT8gtk4dvTHxVRwc2r7

# Steward program ID
STEWARD_PROGRAM_ID=Stewardf95sJbmtcZsyagb2dg4Mo8eVQho8gpECvLx8

# Steward config account for JitoSOL
STEWARD_CONFIG=jitoVjT9jRUyeXHzvCwzPgHj7yWNRhLcUoXtes4wtjv

# Priority Fees in microlamports
PRIORITY_FEES=20000

# Retry count
TX_RETRY_COUNT=100

# Confirmation time after submission
TX_CONFIRMATION_SECONDS=30

# Run flags (true/false)
RUN_CLUSTER_HISTORY=true
RUN_COPY_VOTE_ACCOUNTS=true
RUN_MEV_COMMISSION=true
RUN_MEV_EARNED=true
RUN_STEWARD=true
RUN_EMIT_METRICS=false

# Interval to update Validator History Accounts (in seconds)
VALIDATOR_HISTORY_INTERVAL=300

# Interval to run steward (in seconds)
STEWARD_INTERVAL=301

# Interval to emit metrics (in seconds)
METRICS_INTERVAL=60

# For Oracle Authority Only
RUN_STAKE_UPLOAD=false
RUN_GOSSIP_UPLOAD=false

# Run with the startup flag set to true
FULL_STARTUP=true

# Running with no_pack set to true skips packing the instructions and will cost more
NO_PACK=false

# Pay for new accounts when necessary
PAY_FOR_NEW_ACCOUNTS=false

# Max time in minutes to wait after any fire cycle
COOL_DOWN_RANGE=20

# Metrics upload influx server (optional)
SOLANA_METRICS_CONFIG=""

Running Docker image from source

Once the setup is complete use the following commands to run/manage the docker container:

Note: We are running Docker version 24.0.5, build ced0996

Start Docker

docker compose --env-file .env up -d --build  stakenet-keeper --remove-orphans

View Logs

docker logs stakenet-keeper -f

Stop Docker**

docker stop stakenet-keeper; docker rm stakenet-keeper;

Run from Dockerhub

This image is available on Dockerhub at: https://hub.docker.com/r/jitolabs/stakenet-keeper

docker pull jitolabs/stakenet-keeper:latest
docker run -d \
  --name stakenet-keeper \
  --env-file .env \
  -v $(pwd)/credentials:/credentials \
  --restart on-failure:5 \
  jitolabs/stakenet-keeper:latest

Running as Binary

To run the keeper in terminal, build for release and run the program.

Build for Release

cargo build --release --bin stakenet-keeper

Run Keeper

RUST_LOG=info ./target/release/stakenet-keeper

To see all available parameters run:

RUST_LOG=info ./target/release/stakenet-keeper -h