Hey everyone,
A little while back, I posted about the dividend logic for my "Armero/Baj" project and asked for community feedback. After giving it a lot of thought and tinkering, I've come back with a significantly updated version of the script that's not only better looking but also much more flexible.
This tool is designed to help you project and plan dividend payouts with a ton of flexibility.
A Clean Interface for Complex Numbers
First off, I wanted the output to be easy to understand at a glance. The script uses the Python rich library to present the dividend projection in a clean, modern panel right in your terminal, so you're not just staring at a wall of text.
Here’s what the output looks like:
Flexible Logic & Powerful Features
The real power of this script comes from a couple of key features I built into it:
1. Payout in Any Token:
The script isn't locked into paying out just HIVE. It's completely currency-agnostic, meaning you can set any Hive or Hive-Engine token as the dividend currency you want to distribute. For example, you could have a "miner" token and use this script to project how to pay out a completely different "reward" token. This is perfect for complex token ecosystems.
2. Balance Simulation for "What-If" Scenarios:
This is probably the most useful feature for planning. The script includes a --simulate-balance flag. This lets you run a projection with a hypothetical balance, so you don't need the actual funds in your wallet to see how a distribution would work.
You can answer questions like, "What would the payout rate be if I had 10,000 SWAP.HIVE to distribute right now?" It’s an excellent tool for modeling and planning.
Understanding the Output
The script gives you all the key info you need for your projection:
- Dividend Units Available: This tells you how many "payout cycles" your current (or simulated) balance can fund. In the example screenshot, the balance can fund 422 full dividend units.
- Payout per [TOKEN]: This is the bottom line – it shows you the calculated reward rate that each token holder would receive per token they hold.
Where to Find the Script
I wanted to make this easy for anyone to grab and use. The script is available as a Gist, which you can download and run directly.
I hope some of you out there building projects on Hive-Engine find this little projection tool useful for your own planning and tokenomics!
As always,
Michael Garcia a.k.a. TheCrazyGM