The allocation module distributes the vCOW tokens that were allocated to the the CoW Protocol team to future employees. New claims can be created by the Cow Protocol team Gnosis Safe. When a claim is created, an address is assigned a specific vCOW amount that will be vested linearly in the chosen amount of time. A claimant can interact with the module to receive the tokens at any time. The team Safe can terminating any vesting before the end of the vesting period.

The code in this project describes the module contract and tests all its functionalities. It also takes care of deployment on mainnet and activation on the CoW Protocol team safe.

yarn install
yarn build

All tests:

export INFURA_KEY='your infura key here'
yarn test

All tests except mainnet tests:

yarn test:no-mainnet

Only mainnet tests:

export INFURA_KEY='your infura key here'
yarn test:mainnet

The contracts code in this repo is fully covered by unit tests. Test coverage can be checked by running the following command:

yarn coverage

A summary of coverage results are printed out to console. More detailed information is presented in the generated file coverage/index.html.

Contracts that are either vendored from other repositories or only used in tests are not included in coverage.

Gas consumption can be estimated from the tests. Setting the REPORT_GAS flag when running tests shows details on the gas consumption of each method.

REPORT_GAS=1 yarn test

The contract can be deployed on mainnet by running:

export INFURA_KEY='your infura key here'
yarn deploy --network mainnet

It will be associated with the mainnet team controller address automatically.

This contract is designed to be a module for a Gnosis Safe, and before using it it needs to be activated in the controller safe. Running the command above will print to screen instructions on how to enable the module.

After obtaining an Etherscan API key, run:

export ETHERSCAN_API_KEY=your key here
yarn verify:etherscan --network mainnet

This repository provides a script to create new vesting position from a CSV file describing the allocations. The script outputs a file that is compatible with the Safe transaction builder app and can be imported in the team controller safe context for execution.

npx hardhat start-vesting --network mainnet --csv ./vesting_positions.csv

The format of the CSV file is as follows:

Address,Number of Tokens,Start Date,Duration (days)
0x1111111111111111111111111111111111111111,4000000,1 January 2021,1460
0x2222222222222222222222222222222222222222,2000000,2. February 2022,1095

Note that the date format is anything supported by Javascript's Date.

Try npx hardhat start-vesting --help for more options.