CLI

The Pye CLI automates reward calculation and distribution for validator-issued Pye Accounts. It is designed to run continuously on a small server, monitoring for epoch changes and executing payouts when required.

Github Repo: https://github.com/pyefi/pye-cli

Requirements

  • Server: A small, long-running machine (e.g. t3.nano or t3.micro EC2 instance).

    ⚠️ Running multiple instances simultaneously is not supported. Deploy a single dedicated instance per validator.

  • Keypair: A filesystem keypair with sufficient SOL to cover transaction fees and distributions. The required SOL balance depends on the validator’s stake size and expected epoch rewards.

  • Dependencies: Rust toolchain and build utilities.

Installation

From a fresh Ubuntu host:

# Update system packages
sudo apt-get update
sudo apt-get install -y build-essential curl

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env

# Clone and build the CLI
git clone https://github.com/pyefi/pye-cli
cd pye-cli
cargo build --release

The compiled binary will be located at:

target/release/pye-cli

Running as a Service

We recommend running the CLI as a persistent systemd service.

Example unit file (/etc/systemd/system/pye-cli.service):

[Unit]
Description=Pye CLI
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=1
User=YOUR_USER

# Environment variables
Environment=RPC=https://api.mainnet-beta.solana.com
Environment=PAYER=/home/ubuntu/keys/payer.json
Environment=VOTE_PUBKEY=YOUR_VOTE_ACCOUNT_PUBKEY
Environment=ISSUERS=ISSUER_KEY1,ISSUER_KEY2
Environment=CONCURRENCY=50
Environment=RUST_LOG=info

ExecStart=/home/ubuntu/pye-cli/target/release/pye-cli validator-pye-account-manager

[Install]
WantedBy=multi-user.target

For multiple issuers, provide a comma-separated list in ISSUERS.

Enable and start:

sudo systemctl daemon-reload
sudo systemctl enable pye-cli
sudo systemctl start pye-cli

CLI Usage

Run with:

pye-cli validator-pye-account-manager [OPTIONS] --vote-pubkey <VOTE_PUBKEY> --payer <PAYER>

Common Options

Flag
Description

-r, --rpc <RPC>

RPC endpoint. Default: https://api.mainnet-beta.solana.com.

--program-id <PROGRAM_ID>

Pye program ID. Default: PYEQZ2qYHPQapnw8Ms8MSPMNzoq59NHHfNwAtuV26wx.

-v, --vote-pubkey <VOTE_PUBKEY>

Validator’s vote account pubkey.

-i, --issuers <ISSUERS>

Restrict pye_account payments to specific issuers (comma-delimited).

-p, --payer <PAYER>

Path to payer keypair JSON file.

--concurrency <N>

Max concurrent RPC requests. Default: 50.

--dry-run

Calculate rewards without transferring funds.

--cycle-secs <N>

Interval (seconds) between epoch checks. Default: 60.

--block-retry-delay <N>

Retry delay (seconds) for get_block calls. Default: 1800.

-h, --help

Show help.

Notes

  • The CLI automatically calculates and distributes excess rewards for all Lockups associated with the validator.

  • Use --dry-run for testing without sending transactions.

  • Ensure your payer key has enough SOL to cover transfers and fees.

PreviousRedeemNextCalculator

Last updated