status-im
/
open-bounty
mirror of https://github.com/status-im/open-bounty.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
open-bounty/doc/testing.md

5.5 KiB
Raw Permalink Blame History

Testing Open Bounty

We have two environments for testing purposes:

Both of them use the Ropsten Ethereum testnet. Any one is welcome to use it and your help with testing Open Bounty is greatly appreciated!

General

For testing you will need:

  • a web browser (Chrome is known to work, testing with others appreciated)
  • an Ethereum account on the Ropsten testnet
  • 2 Github accounts (one for Bounty Hunter, second - for Bounty Creator with administrative access to one or more repositories)
  • for approving bounty payouts you will additionally need access to an Ethereum wallet. (MetaMask plugin)

The developers can be reached on the #openbounty channel in the Status slack.

Signing up

Process is the same for Bounty Creator and Bounty Hunter.

  • point your browser to URL of selected environment (staging or testing) and click Login
  • Authorise status-open-bounty to have read access to your public GitHub profile.

You should now see Bounties, Activity, Repositories tabs. In the upper right hand corner, there should be a dropdown with your GitHub username and options My Payment Details and Sign Out.

For Bounty Creator

Connecting your wallet

  • install Metamask and configure your account
  • select My Payment Details from the top-right dropdown, select the account you want to use from the selection list and click Update

Creating bounty issues

Before you can create bounties, you need to add Open Bounty GitHub App to your account or repos. Go to GitHub app for selected environment(or link to another GitHub App you've created for testing, as described in the README and click Install. Specify whether access to all org repos or specific repos is granted. This will install webhooks for SOB in your repos.

  • Request for your account to be whitelisted. Contact Riot for more information
  • now, add the bounty label to a new or an existing issue. This should cause Status Open Bounty to post a new comment for the issue containing an image with text Deploying contract, please wait
  • once the contract has been mined, the comment will be updated to contain the bounty contract's address and a QR code
  • in SOB Manage Payouts should appear (when you logged in)

Funding bounties

The Github comment has a QR code as an image containing the bounty contract address. The address is also on the comment as text. Use any ethereum wallet to send ETH and/or supported ERC20 tokens to this address. After a small delay (max 5 minutes), the activity feed should show that the related bounty issue's balance increased and comment should be updated. After this process bounty is available for BountyHunters on URL of selected environment in Open Bounty list.

Managing payouts

Repository admins see a listing of all open claims and bounties that have already been paid out on the Manage Payouts tab. The open claims listing includes unmerged claim pull requests and merged pull requests. Once a claim pull request has been merged, it is selected as the winning claim. The repository admin will still need to sign off the payout with his connected Ethereum wallet. This is done with the Confirm button. Once the payout transaction has been mined, the Activity feed view will show that the claimer received the bounty funds. All tokens and ETH will be transferred to the claimer's Ethereum address.

Removing bounties

To remove issue from the Bounties list you can close it in GitHub.

For Bounty Hunter

Submitting claims

Whole process is explained here: Status Open Bounty Tutorial.

To get bounties you need to provide an Ethereum address in you Payment details on the selected that will be used to send bounties to.

Open a pull request against the target repository with any keyword from Closing issues using keywords, i. e. Fixes: #NN in the comment where NN is the issue number of the bountied Github issue. After the PR has been opened, the Activity feed should show an item indicating that your username has opened a claim for the related bounty issue. The repository admin (Bounty Creator) should also see the claim under Open claims in the Manage payouts view.

Flow walkthrough for Bounty Creator and Bounty Contributor is here.

Reporting bugs

All bugs should be reported as issues in the OpenBounty Github repository.

Please first check that there is not already a duplicate issue. Issues should contain exact and minimal step-by-step instructions for reproducing the problem.

Status Open Bounty end-to-end tests

Framework for testing located in: open-bounty/test/end-to-end

Full installation and configuring manual: Status Open Bounty end-to-end tests

Currently supports local and Jenkins environment running (you can find example of JenkinsFile in open-bounty/test )