Skip to content
Scott Moore edited this page Oct 1, 2017 · 15 revisions

Who can use GitToken?

Anyone with a GitHub organization can use GitToken. As a community focused project our solution is for organizations of all sizes, not just enterprise.

Is GitToken a single token and if so do I have to purchase it to reward contributors?

No! GitToken is a service that allows anyone to create their own ERC20 tokens to reward contributors. As such the value of distributions in your organization are completely independent of the value of GTK.

How can I get started with GitToken

Simply run git token register and follow the instructions provided to set up your tokens and get your web hook. Note that in order to register you'll need a GitHub organization and personal access token. which you can access by going to Settings > Developer Settings > Personal Access Tokens. Here's an example of what the registration process looks like: git-token-register

What events can I track and reward using GitToken?

Any GitHub event can be tracked and rewarded. Reward values are completely customizable by the user, but the default values are as follows:

EventReward ValueDescription
*0Any time any event is triggered
commit_comment250Any time a Commit is commented on.
create2500Any time a Branch or Tag is created.
delete0Any time a Branch or Tag is deleted.
deployment5000Any time a Repository has a new deployment created from the API.
deployment_status100Any time a deployment for a Repository has a status update from the API.
fork5000Any time a Repository is forked.
gollum100Any time a Wiki page is updated.
installation250Any time a GitHub App is installed or uninstalled.
installation_repositories1000Any time a repository is added or removed from an installation.
issue_comment250Any time a comment on an issue is created, edited, or deleted.
issues500Any time an Issue is assigned, unassigned, labeled, unlabeled, opened, edited, milestoned, demilestoned, closed, or reopened.
label100Any time a Label is created, edited, or deleted.
marketplace_purchase0Any time a user purchases, cancels, or changes their GitHub Marketplace plan.
member1000Any time a User is added or removed as a collaborator to a Repository, or has their permissions modified.
membership1000Any time a User is added or removed from a team. Organization hooks only.
milestone15000Any time a Milestone is created, closed, opened, edited, or deleted.
organization1000Any time a user is added, removed, or invited to an Organization. Organization hooks only.
org_block0Any time an organization blocks or unblocks a user. Organization hooks only.
page_build500Any time a Pages site is built or results in a failed build.
ping2500Any time a web hook is configured.
project_card250Any time a Project Card is created, edited, moved, converted to an issue, or deleted.
project_column50Any time a Project Column is created, edited, moved, or deleted.
project1000Any time a Project is created, edited, closed, reopened, or deleted.
public10000Any time a Repository changes from private to public.
pull_request_review_comment250Any time a comment on a pull request's unified diff is created, edited, or deleted (in the Files Changed tab).
pull_request_review100Any time a pull request review is submitted, edited, or dismissed.
pull_request1000Any time a pull request is assigned, unassigned, labeled, unlabeled, opened, edited, closed, reopened, or synchronized (updated due to a new push in the branch that the pull request is tracking). Also any time a pull request review is requested, or a review request is removed.
push1000Any Git push to a Repository, including editing tags or branches. Commits via API actions that update references are also counted. This is the default event.
repository2500Any time a Repository is created, deleted (organization hooks only), made public, or made private.
release5000Any time a Release is published in a Repository.
status200Any time a Repository has a status update from the API
team2000Any time a team is created, deleted, modified, or added to or removed from a repository. Organization hooks only
team_add2000Any time a team is added or modified on a Repository.
watch100Any time a User stars a Repository.

We encourage users to set rewards that incentivize good GitHub practices for the best results. One such workflow, the feature branching workflow, is described in our 'best practices' section.

Can I block or remove users that abuse the reward system?

Yes, you can use the tools already provided by GitHub to remove users from your repository and prevent spam.

How can I see who's donated to my project?

Since any exchange of tokens is processed through the Ethereum blockchain it is up to those donating whether they want to disclose more than their public Ethereum address.

Are my donations to projects through GitToken tax deductible?

No, GitToken is not a registered non-profit and so donations to projects are not tax deductible.

How can contributors redeem tokens issued?

Since any token generated by the GitToken service is ERC20 compliant it can be openly exchanged on any service that supports this standard.

How can I see the number of tokens I've issued or donations my project has received?

The GitToken terminal and dashboard will both provide details on the tokens associated with your organization. We'll make sure to provide more updates on this as we continue to build these features.