Go to file
Andreas Fackler 527d407063 Remove two more extern crate statements. 2018-12-17 10:19:01 +01:00
abi Also show validators with no votes, add check. 2018-12-17 10:19:01 +01:00
ci Update Rust, Clippy, Rustfmt. 2018-05-19 17:13:01 +02:00
contracts Support hard fork 2 contracts. 2018-10-15 16:00:10 +02:00
src Remove two more extern crate statements. 2018-12-17 10:19:01 +01:00
.gitignore Initial commit. 2018-03-31 18:50:43 +02:00
.travis.yml Upgrade to Rust 2018, update deps. 2018-12-17 10:19:01 +01:00
CHANGELOG.md Also show validators with no votes, add check. 2018-12-17 10:19:01 +01:00
CONTRIBUTING.md created changelog and contributing files, updated README, added png files including updated screenshot 2018-06-05 22:00:29 -06:00
Cargo.lock Upgrade to Rust 2018, update deps. 2018-12-17 10:19:01 +01:00
Cargo.toml Upgrade to Rust 2018, update deps. 2018-12-17 10:19:01 +01:00
LICENSE Add the GPL3 license. 2018-04-19 09:28:19 +02:00
README.md Recommended README changes 2018-06-11 16:41:02 -06:00
screenshot3.png Recommended README changes 2018-06-11 16:41:02 -06:00


POA ballot stats

Build Status

POA ballot stats is a command line tool used to display voting statistics for the POA network.

Validators on the network engage in active governance, managing their roles and creating on-chain consensus. This is achieved through a balloting process.

Ballot tracking provides transparency for POA token holders and promotes validator accountability. The poa-ballot-stats tool displays active validator voting participation ordered by percentage of missed votes.

The default display includes:

  • non-participation/associated ballots
  • missed %
  • validator voting key (truncated to fit screen)
  • validator mining key (truncated)
  • first name last name



Prior to downloading poa-ballot-stats, install and activate a fully synchronized node connected to the POA network. See the POA installation guide for instructions.

Note: poa-ballot-stats must access the full network logs. Use these flags when running a node: --pruning=archive --no-warp


$ parity --chain poa-chain-spec/spec.json --reserved-peers poa-chain-spec/bootnodes.txt --pruning=archive --no-warp


Stable Release

Download the archive for your platform from the latest release and unpack.

Run the tool with ./poa-ballot-stats <options>.


-h, --help view command line options and help information.

<url> specify a different endpoint if your node uses a non-standard port. The default connects to a local node

-V, --version prints version information.

-v, --verbose display collected ballot and key change events and the list of participating and abstaining voters for each ballot.

-c, --contracts <contracts> append a map file with POA contract addresses in JSON format. The current maps for the main and test network are in the contracts folder. Default is the main network core.json file.

-p, --period <period> a time interval in hours, days, months, etc. For example, -p "10 weeks" only counts participation in ballots created within the last 10 weeks.

-b, --block takes the earliest block number as a decimal option. For example, -b 524647 counts participation from block number 524647 onward.


# run the application
$ ./poa-ballot-stats

# view options
$ ./poa-ballot-stats -h

# track voting on poa core network, display voting details for previous 10 weeks
$ ./poa-ballot-stats https://core.poa.network -v -p "10 weeks"

# specify the contracts/sokol.json map file and run on sokol test network with voting details
$ ./poa-ballot-stats -c contracts/sokol.json https://sokol.poa.network -v

Latest code

If you have a recent version of Rust, you can clone this repository and use cargo run -- instead of ./poa-ballot-stats to compile and run the latest version of the code.


No Events Found error

  1. Parity must be fully synced to the correct node and running in full mode, not "light" mode. Check Parity UI and/or Task Manager to confirm Parity is synced and actively connected to peers.

  2. poa-ballot-stats must run with a file matching the Parity network node. Use the contracts address file (-c option) that matches the network connection. Included are files for the main POA network ("core") and the POA test network ("sokol"). The Parity UI will show the current network selection in green. Make sure this is the correct network, and not the Foundation or other Ethereum network.


We use SemVer for versioning. See the project releases and the changelog for historical changes.


Please read CONTRIBUTING.md for contribution and pull request protocol.

Contributors should look into issues or reference RFC9 Statistics of ballots for additional information.


License: LGPL v3

This project is licensed under the GNU Lesser General Public License. See the LICENSE file for details.