Awesome Open Source
Awesome Open Source

The Colony Network

Contracts for running the Colony Network as defined in the Colony White Paper

Bug Bounty Program

Colony is offering substantial rewards to external developers who report bugs and flaws in the colonyNetwork contracts.

See the Bug Bounty program overview for more information about bounties, rules, and terms.


node v10.12 or higher (we recommend using nvm)

yarn v1.13 or higher

docker v18 or higher

Add the required solidity compiler by running:

$ docker pull ethereum/solc:0.5.8


In the working directory of your choice, clone the latest version of the colonyNetwork repository:

$ git clone

Move into the directory and install dependencies:

$ cd colonyNetwork && yarn

Update submodule libraries:

$ git submodule update --init

Provision token contracts for testing:

$ yarn provision:token:contracts


The contract upgradability is using the EtherRouter pattern, see the delegate proxy pattern in the documentation for implementation details.

The math, erc20, auth, roles and a significant part of the token contract have been reused from the Dappsys library.

Local Development and Testing

You can start a local test node and deploy the contracts yourself using the locally installed truffle package.

yarn start:blockchain:client

yarn truffle migrate --reset --compile-all

To deploy all contracts and run all contract tests:

yarn test:contracts

To deploy all contracts and run all reputation mining tests:

yarn test:reputation

To run tests with code coverage using solidity-coverage:

yarn run test:contracts:coverage

To lint contracts using Solium

yarn run solium

To lint JS using eslint (this is also a pre-commit hook)

yarn run eslint


For details about how to contribute you can check the contributing page

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,537,249
Blockchain (8,902
Ethereum (7,261
Solidity (7,091
Smart Contracts (2,371
Ethereum Contract (523
Solidity Contracts (416
Related Projects