install and sync relay server
git clone https://github.com/galperins4/tbw
cd ~/tbw/config
fill out configs (see below)
cd ~/tbw
bash install.shNote: All coins are currently leveraging core_v1 folder
After the repository has been cloned you need to open the config.json / pool.json and change it to your liking. Once this has been done navigate to core_v1 or core_v2 folder and execute python3 tbw.py to start true block weight script. After the initial start up, you can run the script via python3 tbw.py or the pm2 command pm2 start apps.json
Important! - pay_addresses and keep keys should match in config.json. DO NOT delete the reserve key as it is required. All other's can be deleted or more added. In addition, payment is triggered to start based on when total blocks forged / interval is an integer (with no remainder).
As the script leverages @FaustBrians ARK python client as well as database retreival and storage classes, python 3.6+ is required. In addition it is now required to run this alongside a relay node given the DB interaction and little reliance on the API.
- network: which network (options are ark, dark, kapu, dkapu, persona-t, lwf, lwf-t, oxy, oxy-t, onz, onz-t, shift, shift-t, rise, rise-t, ripa, swapblocks-t)
- start_block: script will start calculations only for blocks after specified start block
- manual_pay: Use this to make a final payout (or manual payment) if needed. ONLY RUN USING PYTHON3 and not PM2
- delegate IP: this serves as a back-up IP for the API to call to in case the localhost does not respond
- dbusername: this is the postgresql database username nodeDB (usually your os username)
- publicKey: delegate public key
- interval: the interval you want to pay voters in blocks. A setting of 211 would pay ever 211 blocks (or 422 ark)
- voter_share: percentage to share with voters (0.xx format)
- passphrase: delegate passphrase
- secondphrase: delegate second passphrase
- voter_msg: ARK and ARKfork coins only - message you want in vendor field for share payments
- block_check: How often you want the script to check for new blocks in seconds. Recommend low value (e.g., 30 seconds for ARK coins, high value for LISK coins)
- cover_tx_fees: Use this to indicate if you want to cover transaction fees (Y) or not (N)
- vote_cap: Use this if you cap voters for how much they can earn with votes. For example 10000 will mean any wallet over 10K will only be paid based on 10K weight
- vote_min: Use this if you have a minumum wallet balance to be eligible for payments
- whitelist: Y or N. Enable payment to only whitelisted addresses
- whitelist_addr: comma seperated list of addresses to allow voter payments to
- blacklist: Options are block or assign. Block zero's out blocked accounts which then distributes their earnings to voters. Assign does the same but assigns weight to a designated account.
- blacklist_addr: comma seperated list of addresses to block from voter payments
- blacklist_assign: if assign option is picked, this is the address those blacklisted shares go to. DO NOT SET to an account voting for said delegate. It is HIGHLY recommended this is set to the reserve address!
- fixed_deal: use this if you have a fixed deal with a voter (e.g., 45 ark per day).
- fixed_deal_amt: format is address:amount. The amount to pay should correspond to interval.
- min_payment: Minimum threshold for payment. If set to 1, any payout less than 1 ARK will be held until the next pay run and accumulate
- reach: how many peers to broadcast payments to (Recommended - 20)
- keep: there are the percentages for delegates to keep and distrubute among x accounts (Note: reserve is required! all others are optional)
- pay_addresses: these are the addresses to go with the keep percentages (Note: reserve is required! all others are optional)
- network: which network (same as tbw options)
- pool_ip: IP of the node the pool is installed on
- explorer: The address of the explorer for the coin
- coin: which coin (e.g., ARK, KAPU)
- proposal: link to delegate proposal (if any)
- dbusername: this is the postgresql database username nodeDB (usually your os username)
- pubkey: delegate public key
Note: Pool runs on port 5000
- Add more features as necessary
- Additional exception handling
- added swapblocks testnet
- fixed broken pool site if delegate falls out of forging
- updated with new installation script
- Added persona mainnet
- Minor changes and prep code for Ark Core v2 release
- Added anti-dilution for min-payout config. Now wallets under min payment aren't diluted when wallets above min payout are paid
- Added super basic front end website for pool runners. See config details above
- Added support for Shift and Rise (mainnet and testnets)
- NOTE: V1.0 made changes to database structure. As such, upgrades from 0.9 and below need to pay out old version (can force it with manual.py or wait until next payrun to switch over) balances and reinitilaize ark.db with v1.0
- added start_block config
- seperated dependency of pay.py on tbw.py. tbw and pay both run via pm2. Pay looks for pay files every 5 minutes and executes
- streamlined payment tx creation. Script now batches 40 tx per run and then pauses 5 minutes
- added support for lwf testnet and mainnet
- added support for oxy testnet and mainnet
- added suppport for onz testnet and mainnet
- added configurable block check option
- added configurable voter share message (ARK coins only)
- added vote-min option to allow for minimum wallet balances eligible for payouts
- small fix for 0 balances in delegate rewards due to changed/unused addresses to prevent broadcasting issues
- Added fixed deal options
- Added functionality for paying (or not paying) transaction fees on share payments
- Added reserve balance check - will not payout if your reserve account <=0 on payrun
- Added manual.py - This will let you pay manually based on values in ark.db (will also update db)
- Completely rewritten to pull data directly from node database for TBD
- Added blacklist functionality
- Added functionality to cap voters for distributions
- Squashed import on payment interval bug
- Added file to allow tbw to run via pm2
- Modified config file to add minimum payment threshold functionality
- Modified config file and added multi-address capability for delegate share addresses
- Initial release
If you like this project and it helps you in your every day work I would greatly appreciate it if you would consider to show some support by donating to one of the below mentioned addresses.
- BTC - 38jPmBCdu9C5SBPbeb4BTBQG2SAbGvbfKf
- ETH - 0x9c3BB145C6bCde9BC502B90B8C32C0aa26714394
- ARK - AMhTN98yvWP8SJNyxmgEfg9ufuxHyapW73
If you discover a security vulnerability within this package, please open an issue. All security vulnerabilities will be promptly addressed.