Colony Token and Vesting contracts

About

This is the repository for the Colony token (CLNY) and Token Vesting contracts.

The contracts contained in this repo have been released under a GPL-3.0 license.

It should go without saying, but the code contained herein is designed to handle potentially large amounts of Ether, and as such should be deployed at your own risk and sole responsibility.

If you've found a bug, please reach out to us here on github or by email.

Install

git clone https://github.com/JoinColony/colonyToken.git
cd colonyToken
npm ci
git submodule update --remote --init
npm run provision:multisig:contract

Contracts

Token.sol CLNY Token contract based on an ERC20 token with mint and burn functionality. The Token is based on the DSToken implementation from Dappsys library. Additionally implements a one-way unlock switch to open the token to transfers to all token holders. When deployed initially, token transfers will only be allowed for the Colony MultiSig and Vesting contracts, see TokenAuthority contract for details.

TokenAuthority.sol Acts as the Token Authority while CLNY Token is locked for token transfers. Implements DSAuthority to allow Colony MultiSig, Vesting and other necessary contracts to be able to transfer tokens for the purposes of pre-allocating tokens and token grants as well as the general functioning of the Colony Network. This is an immutable set of permissions which can be reviewed in the contract itself.

VestingSimple.sol Stores and manages the CLNY Token grants via the following functions:

Secured to contract owner only:

• setGrant - Adds a new token grant for a given user. Only one grant per user is allowed. The grant may be increased or decreased after the fact, but not less than any amount already claimed. Grants may also be added after activation, with vesting calculated from the time of activation.

• setGrants - Call setGrant on an array of addresses and values. A convenience function.

• activate - Allows users to begin claiming token grants, with vesting calculated from the timestamp of the activating transaction.

• withdraw - Withdraw any excess tokens from the contract and return them to the contract owner.

Public functions:

• claimGrant - Allows a grant recipient to claim their vested tokens. Errors if no tokens have vested. Note that it is advised recipients check they are entitled to claim via getClaimable before calling this.

• getClaimable - Calculates the amount of tokens currently claimable by a user.

Testing

To run all tests:

npm run test:contracts

To run tests with code coverage using solidity-coverage:

npm run test:contracts:coverage

To lint contracts using Solium

npm run lint:contracts

Deployment

We use a hosted Ethereum node cluster - Infura for deployment to main and test networks.

Flattened contracts are in source control under flattened folder and can be generated via npm run flatten:contracts which uses /solidity-steamroller