Skip to content
Smart Contracts in Solidity to serve as a Standard for Bounties for EVM dApps
Branch: master
Clone or download
Latest commit 52a5e4c Jan 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
contracts bumped versions for test passing, updated tests to fail if they dont … Feb 22, 2018
docs updated to make file related schema fields to be optional Jan 24, 2018
migrations fixed migration, updated tests in tokens Feb 22, 2018
.gitattributes Create .gitattributes Jan 14, 2019
.gitignore fixed bugs, updated tests Sep 28, 2017
.soliumignore Linting and turning the stages state var to an Enum Apr 30, 2017
.soliumrc.json Linting and turning the stages state var to an Enum Apr 30, 2017
LICENSE updated license, removed comments Oct 2, 2017 removed mentions of milestones Mar 19, 2018
package-lock.json fixed migration, updated tests in tokens Feb 22, 2018
package.json removed comma Nov 15, 2017


Gitter Codeship Status for ConsenSys/StandardBounties

Version 1.1.0

  1. Rationale
  2. Implementation
  3. Development
  4. Documentation

A set of standard contracts to be used as interfaces for any kind of bounty, either qualitative or quantitative in nature.

1. Rationale

Ethereum smart contracts can trivially facilitate transactions of resources (or tokens) between individuals or groups, but service transactions are more complex. Requesting individuals (issuers) must first approve the work they're receiving before paying out funds, meaning bounty hunters must have trust that the issuer will pay them in the spirit of the original contract.

The StandardBounties.sol contract facilitates transactions on qualitative data (often representing artifacts of completion of some service), allowing bounty issuers to systematically approve the work they receive.

2. Implementation

A bounty can be used to pay amounts of ETH or a given token, based on the successful completion of the given task. The contract aims to reduce the necessary trust in the issuer by forcing them to deposit sufficient Ether (or tokens) to pay out the bounty at least once.

  • A bounty begins by being issued, either through the issueBounty() function (which issues the bounty into draft stage), or issueAndActivateBounty(), which issues the bounty into the active stage

  • In the Draft state, all bounty details can still be mutated.

    In this state, the various functions which can be called are:

    • contribute() [ANYONE]: contributes ETH (or tokens) to the bounty
    • activateBounty() [ONLY ISSUER]: This will activate the bounty
    • killBounty() [ONLY ISSUER]: This will kill the bounty

    As well as several functions to alter the bounty details:

    • changeBountyDeadline() [ONLY ISSUER]
    • changeBountyData() [ONLY ISSUER]
    • changeBountyFulfillmentAmount() [ONLY ISSUER]
    • changeBountyArbiter() [ONLY ISSUER]
    • extendDeadline() [ONLY ISSUER]
    • transferIssuer() [ONLY ISSUER]
    • increasePayout() [ONLY ISSUER]
  • A bounty transitions to the Active state when the issuer calls activateBounty(), or if it was initially issued and activated.

    This is only possible if

    • the bounty hasn't expired (isn't past its deadline)
    • the bounty has sufficient funds to pay out at least once

    Once a bounty is Active, bounty hunters can submit fulfillments for it, and the bounty issuer can approve fulfillments to pay out the rewards.

    In this state, the various functions which can be called are:

    • contribute() [ANYONE]: contributes ETH (or tokens) to the bounty
    • fulfillBounty() [ANYONE BUT ISSUER OR ARBITER]:
    • updateFulfillment() [ONLY FULFILLER]
    • acceptFulfillment() [ONLY ISSUER OR ARBITER]:
    • increasePayout() [ONLY ISSUER]:
    • transferIssuer() [ONLY ISSUER]
    • extendDeadline() [ONLY ISSUER]
    • killBounty() [ONLY ISSUER]:
  • A bounty transitions to the Dead state when the issuer calls killBounty(), which drains the bounty of its remaining balance.

    In this state, the only functions which can be called are:

    • extendDeadline() [ONLY ISSUER]
    • activateBounty() [ONLY ISSUER]

3. Development

Any application can take advantage of the bounties network registry, which is currently deployed on the Main Ethereum Network at 0x2af47a65da8cd66729b4209c22017d6a5c2d2400, and on the Rinkeby network at 0xf209d2b723b6417cbf04c07e733bee776105a073. The BountiesNetwork.eth name will also always resolve to the most up-to-date registry version for the StandardBounties contract.

Data Schema

For details on the data schema used for all JSON objects which are uploaded to IPFS, see the schema

If you're building on the StandardBounties and would like to add additional data fields, please submit a pull request on this repo.

4. Documentation

For thorough documentation of all functions, see the documentation

You can’t perform that action at this time.