autobounty/readme.md

Status OpenBounty Autobounty

Massive Thanks to the Amazing Aragon Team for starting this project! Original repo here

Status Autobounty bot for OpenBounty

A docker bot that will automatically fund issues that are labelled with bounty. These bounties will use Status OpenBounty to incentivize community members to participate and contribute to the development of Open Source Software projects like Status, Riot and Aragon.

Open source is awesome, but it is challenging and needs to be rewarded to ensure top quality work. It's also important that everyone in the world gets a fair chance to do it.

We at Status, Aragon and Riot are using OpenBounty to reward open source contributions outside our Core teams.

All issues tagged with bounty are eligible for a bounty on a succesfully merged Pull Request that solves the issue. Currently bounties have to be funded one after the other and manually by a real human being. This bot's purpose in life is therefore to create and automate the process of funding issues so that contributors can be rewarded accordingly.

The process

1. An issue is created at the repo
2. Issue is labeled with bounty and bounty-{xs,s,m,l,xl}
3. Status OpenBounty bot adds a bounty to the issue and it is displayed in the issue's comments
4. Webhook is triggered for issue comments.
5. Autobounty checks if the request needs funding (by default: if the user status-open-bounty posts a new comment). If it needs funding proceed to 6 otherwise do nothing.
6. Bot waits for X seconds (configurable parameter) to allow label corrections before proceeding.
7. Address to fund is obtained from status-open-bounty comment.
8. Amount to fund is computed as the hours of work corresponding to the given label multiplied by the configured price per hour, divided by the token price obtained from etherscan.io (amount_of_work * price_per_hour / token_price).
9. The gas price for the transaction is retrieved from ethgasstation and the minimun safeLow amount is used.
10. With all the information the bot funds the bounty from config param sourceAddress.

Configuration

Bot config

Autobounty is build using docker. Before building the image, you need to set up a configuration as follows:

The config folder contains the files for configuring the bot. The description for the variables can be found in default.js. Simply input the missing information to override the default values in this file.

Remember to set the WEBHOOK_SECRET to the value specified in the secret field during the webhook creation (e.g. for random creation ruby -rsecurerandom -e 'puts SecureRandom.hex(20)'). )

Github Webhook

Create a github webhook with the following information:

• Payload URL: IP_HOST/URL_ENDPOINT
• Content Type: application/json
• Secret: the value you set for environment variable WEBHOOK_SECRET.
• Configure the webhook to be triggered by comments in issues selecting the Issue Comment box in 'Let me select individual events'

Where IP_HOST is the ip of the machine running the docker image and URL_ENDPOINT is the configuration variable with the same name in your custom config file.

Build

To build and run the docker image issue the following commands:

docker build -t autobounty .
docker run -p 8080:8080 autobounty

Important Notes

• Bot always aborts on error and logs the cause of the error in the folder ./log. The aborted transaction must then be manually funded.
• Only one token can be specified on the configuration file variable token.
• Ongoing requests are not recorded in any persistent data storage. If the machine crashes during a request processing the request will be lost.