Pye Finance

Pye CLI

Alberto Cevallos
Alberto Cevallos
– 3 min read
Pye CLI

The Pye CLI is a lightweight, validator-operated software tool that powers reward accounting for Pye Bonds. It plays a foundational role in how rewards are calculated and distributed for fixed-term staked SOL on the Pye protocol. As we prepare to launch the Pye Pilot Program, it’s important that validators and stakers understand how the CLI works, what it measures, and why it matters.

What Is the Pye CLI?

The Pye CLI is a command-line tool designed for validators who issue Pye Bonds. Its primary function is to calculate the total amount of rewards generated by a validator from one Solana epoch to the next, and then attribute those rewards proportionally to the validator and the bondholders, based on the terms embedded inside each Pye Bond.

It ensures transparent, auditable, and deterministic accounting of:

  • Inflationary staking rewards
  • Block production rewards
  • MEV rewards

This provides the accounting engine necessary to operate a decentralized fixed-income instrument on-chain.

Why It Matters

For Validators

The Pye CLI gives validators a new way to monetize their infrastructure. By issuing time-locked Pye Bonds with transparent yield-sharing terms, validators can access longer-term stake while still earning a portion of the rewards through a performance-based sharing model.

The CLI allows validators to:

  • Generate and submit epoch reward data
  • Maintain credibility with stakers via transparent reporting
  • Track the precise breakdown of their share vs. bondholder share

For Stakers

For stakers, the Pye CLI provides trustless assurance that their share of yield is calculated correctly according to the terms of the bond they purchased. This includes:

  • A flat deposit fee (general validator commission)
  • A block reward sharing rate
  • A MEV reward sharing rate

All of these are programmable fields inside the Pye Bond data structure.

How It Works

Step 1: Reward Accrual Measurement

Each epoch, the CLI measures how much the validator earned across:

  • Inflation Rewards – Standard epoch-based staking yield
  • Block Rewards – Payments for successful block production
  • MEV Rewards – Tips or fees earned through priority transactions

These are summed into a total gross reward.

Step 2: Reward Attribution Using Bond Metadata

Each Pye Bond includes validator-specified terms embedded in its on-chain metadata:

  • deposit_fee: a flat percentage taken off the top as a general validator commission
  • block_reward_share: the percentage of block rewards the validator keeps
  • mev_reward_share: the percentage of MEV rewards the validator keeps

The CLI uses these values to apply a pro-rata split of rewards between the validator and bondholders:

Each reward stream (inflation, block, MEV) has its own pro-rata logic, defined per bond, and enforced via the CLI logic.

Step 3: Emitting and Submitting Results

The CLI emits a signed output of this breakdown, which is submitted to the protocol and becomes the canonical source of truth for downstream accounting, UI display, and epoch payment execution.

Who Is This For?

  • Validators who are onboarding into the Pye ecosystem and wish to issue Pye Bonds
  • Stakers who are purchasing Pye Bonds and want transparency on reward logic
  • Auditors or analysts verifying how rewards flow through the system
  • Developers and node operators who want to automate reward data collection or integrate into dashboards

Next Steps

Pye CLI (command-line interface) is a tool designed for validators who are issuing bonds on the Pye protocol. The CLI calculates the total inflation, MEV and blockrewards generated by the validator every epoch.

If you’re a validator and would like to become a launch partner, please fill out this form and reach out to our BD team: @eash0x on Telegram.

Meantime, follow us on our official links: X/Twitter | Discord | Telegram

Share this: