Skip to content

CONTRIBUTION_FLOW.md

Latest commit

 

History

History
111 lines (76 loc) · 5.73 KB

CONTRIBUTION_FLOW.md

File metadata and controls

111 lines (76 loc) · 5.73 KB
Raw

district0x Contribution Period Flow (DNT Token Sale)


Instantiation

1. Deploy contribution contract District0xContribution.sol

district0x contribution contract will be deployed at least 5 days prior to the beginning of the contribution period.

Parameters:

  • Owners: Addresses allowed to confirm contract transactions that require multiple signatures. Such as enabling or cancelling contribution period.
  • Required: Number of signatures required to run multi-signature transaction
  • Wallet: Multi-signature wallet holding raised funds
  • Cofounder 1: Address of Matus
  • Cofounder 2: Address of Joe
  • Early Sponsor: Address of our early sponsor
  • Advisers: 4 addresses of advisers consisting of: Luis Cuende from Aragon, Carl Bennett from Status, our legal adviser and community advisers wallet. From community advisers wallet, DNT rewards will be send after sale to community members listed in this spreadsheet.

2. Deploy MiniMeTokenFactory MiniMeToken.sol

MiniMeTokenFactory contract must be deployed, so DNT Token becomes clonable.

No parameters.

3. Deploy token contract District0xNetworkToken.sol

Parameters:

  • Controller: Address of District0xContribution contract. Its address will be the only one allowed to generate predetermined amount of DNT tokens. District0xContribution doesn't implement function to transfer controller ownership, therefore additional DNT tokens can never be generated.
  • TokenFactory: Address of earlier deployed MiniMeTokenFactory

4. Set DNT Token address District0xContribution.setDistrict0xNetworkToken()

This method sets address of District0xNetworkToken in contribution contract. At this moment, exactly 1,000,000,000 DNT tokens is generated and assigned to contribution contract.

Parameters:

  • district0xNetworkToken: Address of earlier deployed District0xNetworkToken

5. Set contribution period parameters District0xContribution.setContribPeriod()

This method sets up contribution period parameters and also vesting for founders, early sponsor and advisers. Note, after setting up, contribution period is still not valid. To be valid it must be confirmed by multiple signatures (see following step).

Parameters:

  • Contribution Period Index: 0 Index number of contribution period to be set up (0, 1 or 2)
  • Soft Cap Amount: 10 Mil USD in ETH Soft Cap for a contribution period
  • After Soft Cap Duration: 48 hours Time to the end of contribution from the moment of reaching soft cap (unless reaching Hard Cap)
  • Hard Cap Amount: 50 Mil USD in ETH When reached this amount, the contribution period ends instantly
  • Start Time: July 18, 3:00pm UTC Beginning of a contribution period
  • End Time: August 1, 3:00pm UTC End of a contribution period, unless Soft or Hard cap is reached

6. Enable contribution period District0xContribution.enableContribPeriod()

This method will be executed only with multiple signatures 4/6 of our team and trusted individuals from Ethereum community (listed in our whitepaper). It will make a contribution period confirmed with current parameters.

Parameters:

  • Contribution Period Index: 0 Index number of contribution period to be enabled (0, 1 or 2)

Contribution

7. Buy DNT tokens District0xContribution.contribute() or District0xContribution.fallback()

This method will save your address and amount of your contribution. If you contribute multiple times from the same address amounts will be added up. Note, since we'll allocate DNT proportionally to the contributed amount, DNT tokens will not be send to contributors immediately. Distribution will happen shortly after sale. Contributed Ether is transferred to our multi-signature wallet after each contribution. Note, maximum gas price that can be used for contribution is 50Gwei, otherwise transaction will fail!

No parameters

8. Emergency stop District0xContribution.emergencyStop()

In case of emergency, district0x is able to pause contribution period

After Contribution

9. Send DNT to contributors District0xContribution.compensateContributors()

This method is called by owner after contribution period ends to distribute DNT in proportional manner. In case of many contributors will need to be executed multiple times, due to gas limit restrictions.

Parameters:

  • Contribution Period Index: 0 Index number of contribution period to be enabled (0, 1 or 2)
  • offset: Number of first contributors to skip.
  • limit: Maximum number of contributors compensated with this transaction. Offset and limit parameters are used to "paging" through contributors

10. Enable DNT transfers District0xContribution.enableDistrict0xNetworkTokenTransfers()

This method is called by owner after DNT tokens were distributed to all contributors. DNT transfers should be enabled in matter of hours after end of contribution period. We'll enable them as soon as we're sure that distribution of DNT went without bugs.

No Parameters.

11. Cancel following contribution period District0xContribution.cancelContribPeriod()

Second and third contribution period might be subject to cancellation if district0x doesn't need more funds to achieve goals stated in our roadmap. In this case tokens allocated for a contribution period will be destroyed. This method must be executed by multi-signature.

Parameters:

  • Contribution Period Index: 1 Index number of contribution period to be enabled (1 or 2)