Grow Open Source
Switch branches/tags
activity-pagination-changes avatar-updates bulk-send cancel-bounty-reason cancel_grant cleanup-move-urls contribution_model details_edit details_updates endpoint-fixes feature/vlad/funder-dashboard fix-958 fix-1976-gcbot-notifs fix-2654-mintrange fix/bounty-payment fix/kudos-profile fix/loading-kudos funder-dashboard gas-buffer gh-pages gitcoinbot-refactor grant-listener grant-nav grants-lis grants-listener grants-search grants-updates-details-admin grants_dummy grants grantz-cleanup grantz infinite-expire inno-django-compressor ipfs-always-pin-infura kevin/admin_actions_as_seperate_view kevin/animatejs-POC kevin/blush-makeup kevin/cleanup_dupe_profiles kevin/confirm_before_redeem kevin/dataviz-experiments kevin/dataviz3 kevin/dead_branch kevin/developer-guide-promotion kevin/dupe_profiles kevin/feedback_system kevin/gas-limit-fix kevin/gas_advisories kevin/gas_estimator_on_gas_page kevin/gas_memory_error kevin/gas_prices_auto kevin/gaspricefixkudos kevin/grants-db-sync kevin/grants_updates kevin/handle_unique kevin/how_many_contributors_by_country kevin/kevin-demo kevin/kudos-direct-send-eth-address kevin/kudos-docs kevin/kudos_activity_stream kevin/labs_nav_treatment kevin/lighted-jack-o-lantern kevin/lookup_txids_for_tips kevin/make-email-sender-less-aggressive-for-tips-kudos kevin/new_bounty_email_keyword_cleanup kevin/new_kudos_form kevin/new_leaderboard_items kevin/no_sumo_if_logged_in kevin/offchain_ui_experiment kevin/orgs_and_profiles kevin/pjs kevin/premium_avatar_items kevin/profilenotfound kevin/programming_langs_in_db kevin/quickfund kevin/receive_email_copy kevin/refactors_kudos_profile kevin/roundup_email_20181019 kevin/search_history kevin/security-docs kevin/send_kudos_to_eth_address kevin/stray_activities kevin/subminer kevin/sync_get_stopgap_fix kevin/tmp-mint-kudos-hotfix kevin/tmp2 kevin/tree_interactivity ks_approve_fix ks_cancel_fixes ks_contract_versioning ks_convert_fix ks_default_image ks_dub_sub ks_emails ks_fund_decimal ks_fund_miner_fixes ks_miner_fixes ks_save_tx_id ks_sub_network_fix ks_successful_contribution_def ks_tx_data kudos-feed kudos-suggestions kudos-v1 kudosfeed kudosgh-msg logging-updates mark-avatar-be mark-browser-push mark-celery-int mark-integrations mark-livestream-sessions mark-orgs master mig-pref-address-wallets more-kudos new-notifications paginate-api profile-fixes profile_subscriptions rinkeby_fixes roundup-30OCT2018 search-error stable tooltip-fix
Nothing to show
Clone or download
octavioamu Merge pull request #3205 from gitcoinco/fix/bounty-payment
fix suggestions, validations onload
Latest commit 98bffdc Dec 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Debug circleci path issues Nov 30, 2018
.github Update PR template Dec 6, 2018
app stickler Dec 13, 2018
bin verbosity to 0 (#3031) Nov 30, 2018
charts Update secondary ingress Oct 18, 2018
docs link Dec 5, 2018
js-sdk Kudos v1 (#2492) Oct 27, 2018
ops Migrate to multistage build and alpine 3.8 image base Nov 30, 2018
requirements Merge pull request #2130 from pinkiebell/wagtail Dec 4, 2018
scripts Merge branch 'master' into grantz Dec 4, 2018
.dockerignore Draft create Oct 11, 2018
.editorconfig Initial commit for EthOS redemption May 4, 2018
.eslintignore Kudos v1 (#2492) Oct 27, 2018
.eslintrc Minor eslint/stickler changes to avoid unnecessary comments May 4, 2018
.gitignore Kudos v1 (#2492) Oct 27, 2018
.helmignore Draft create Oct 11, 2018
.pre-commit-config.yaml Update precommit yapf config Aug 2, 2018
.stickler.yml Update and include more apps to yapf Jul 9, 2018
.stylelintignore Kudos v1 (#2492) Oct 27, 2018
.stylelintrc birth: landing page (#1377) Jun 7, 2018
.travis.yml Migrate image converter to pyvips (#2346) Oct 4, 2018 Enhancing user's profile Nov 13, 2018
Dockerfile Remove multistage Nov 30, 2018
Jenkinsfile Modify preview env match Oct 11, 2018
LICENSE Update docs Mar 27, 2018
Makefile Migrate to multistage build and alpine 3.8 image base Nov 30, 2018
OWNERS Update charts Oct 11, 2018
OWNERS_ALIASES Update charts Oct 11, 2018
detect Update charts Oct 11, 2018
docker-compose.yml Migrate to multistage build and alpine 3.8 image base Nov 30, 2018
package-lock.json Final Changes Nov 20, 2018
package.json npm update Oct 9, 2018
pydocmd.yml Format ABI and grants md for linting plus add pydocmd configs for grants Dec 5, 2018
setup.cfg Upgrade django to 2.1, modify field defaults, and address deprecations ( Aug 9, 2018
skaffold.yaml Update charts Oct 11, 2018
webpack.config.js Fix test_tool vote scoring and test_bounty since std bounty ID in url Apr 23, 2018
yarn.lock Remove lodash core Mar 20, 2018


Gitcoin Grows Open Source. Learn more at

web repo

Build Status codecov - Columns and their card count

This is the website that is live at


How to interact with this repo

Table of Contents

On Github

Star and watch this github repository to stay up to date, we're pushing new code several times per week!

Check out the CHANGELOG for details about recent changes to this repository.


On Gitcoin

Check out the available open issues on Gitcoin.


Functionally, the app has several key features:

  • Smart Contracts -- Where funded issues are stored and indexed.
  • Brochureware -- Describes the project.
  • Funded Issue Explorer -- A searchable index of all of the work available in the system.
  • Funded Issue Submission / Acceptance flow -- Interface between the application and web3.
  • API - the HTTPS API
  • Bot - the GitcoinBot

More about how/why to interact with web3 here.

Technically, the system is architected:

  • Web3 The main source of truth for the system is the Ethereum blockchain. Check out the smart contracts.
  • Web2 This part of the app is built with Python, Django, Postgres, and a handful of other tools that are common in the web2 ecosystem.
  • Web 3 Bridge This is the bridge between web3 and the rest of the application. Mostly built in javascript(web3js) and python(web3py).
  • Brochureware Just a nice little landing page telling folks what the Gitcoin project is.



For more information on the HTTPS API, please view the api README

Running locally

With Docker (Recommended)

For more information on running the app locally, please view the documentation for running gitcoinco/web with Docker

Without Docker

For more information on running the app locally, please view the documentation for running gitcoinco/web without Docker

Overriding Application Defaults

For more information on overriding the local dev environment configuration defaults, please view the environment variables documentation

Trying out Gitcoin

Posting your first issue

If you

  • have some work on your Github Issues board that you don't have time (or skills) to do.
  • are dependant upon an upstream repo for something, and you'd like to incentivize them to work onit.

try posting a funded issue at

Integrating Gitcoin




Testimonials & Case Studies

Integrating the 'available work widget' on your repo.

This widget will help you advertise that you support Gitcoin bounties, so that your community knows the best place to contribute.

Check out the widget documentation to learn how

Adding GitcoinBot to your repo

Gitcoinbot will allow you to add issues straight from github.

Check out the gitcoinbot readme to learn how

Adding your token to Gitcoin

Have an ERC20 compatible token that you'ud like to add support for? Great! Submit this form to submit it to the system

High Level flows

of a Bounty

This is the high level flow of a bounty on Gitcoin:

Chain of Custody

  1. Bounty Funder's Wallet
  2. StandardBounties Smart Contract deployed at 0x2af47a65da8cd66729b4209c22017d6a5c2d2400
  3. (Submission Made)
  4. (Submission Accepted)
  5. Recipient's Wallet

Anywhere between 2 and 4 above, Funder may withdraw their funds via 'Cancel Bounty' function for any reason.

We may introduce Arbitration via Delphi at some point in the future. Until then, we are lucky that Github users are very protective of their reputation, and therefore very kind to each other, and disputes have not generally arisen.

of a Tip

or of a Kudos


  • Crowdfunded bounties + bulk payouts are secured by Tips (at least until Standard Bounties 2.0 is released).
  • Kudos are also secured by Tips

This is the high level flow of a bounty on Gitcoin:


''' Copyright (C) 2018 Gitcoin Core

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <>.