@ablack/fundraising-templates-multisig v1.0.0

Aragon 0.8 Fundraising Multisig Template

Description

Aragon Fundraising Multisig Template differenciate two set actors: the board and the shareholders.

Board

The board are the ones being funded by the fundraising campaign. They are represented through a custom BOARD token and a dedicated voting app set to be used as a multisig. Their privileges are intentionnaly limited to protect shareholders. Thus, they only have the following rights.

Handling board members

The board decides on who is to be included / excluded from the board through its TokenManager.

Opening presale

The board decides on when the presale and thus the fundraising campaign is to be open.

Handling fundraising proceeds

The board decides on what use is to be made of the fundraising proceeds which are periodically transferred to their discretionnary Vault / Finance app.

Opening votes

The board decides on when new votes should be open for shareholders to enforce decisions over the organization.

Shareholders

The shareholders are the one contributing to the fundraising campaign. They are represented through a SHARE bonded-token they can buy and redeem through the Aragon Fundraising interface and a voting app. They hold most of the rights over the organization.

Handling system

Shareholders decide on which apps are to be installed, which apps are to to upgraded and how permissions are to be set.

Handling fundraising parameters

Shareholders decide on whether / how beneficiary, fees, collateralization settings and collaterals taps should be updated.

Rationale

This architecture grants most of the governance rights to shareholders to protect their investment. There is thus a need to mitigate situations where a shareholder owning more than 50% of the shares would own the whole organization. This is why SHARE based votes i.e. most of the organization decisions can only be open and initiated by the board.

Usage

Prepare instance

Deploy a DAO and install all board related apps

template.prepareInstance(boardTokenName, boardTokenSymbol, boardMembers, boardVotingsSettings, financePeriod)

• boardTokenName Name for the token used by the board
• boardTokenSymbol Symbol for the token used by the board
• boardMembers Array of board members addresses
• boardVotingSettings: Array of supportRequired, minAcceptanceQuorum, voteDuration to set up the board voting app multisig
• financePeriod Initial duration for accounting periods of the boards discretionnary vault it can be set to zero in order to use the default of 30 days

Install share apps

template.installShareApps(id, shareTokenName, shareTokenSymbol, shareVotingsSettings)

• id Id for org, will assign id.aragonid.eth
• shareTokenName Name for the token used by the shareholders the bonded token
• shareTokenSymbol Symbol for the token used by shareholders the bonded token
• shareVotingSettings: Array of supportRequired, minAcceptanceQuorum, voteDuration to set up the shareholders voting app multisig

Install fundraising apps

template.installFundraisingApps(
    goal,
    period,
    exchangeRate,
    vestingCliffPeriod,
    vestingCompletePeriod,
    supplyOfferedPct,
    fundingForBeneficiaryPct,
    openDate,
    batchBlocks,
    maximumTapRateIncreasePct,
    maximumTapFloorDecreasePct
)

• goal The presale goal
• period The presale period
• exchangeRate The presale exchange rate in PPM
• vestingCliffPeriod The cliff period for vested shares purchased during presale
• vestingCompletePeriod The complete period for vested shares purchased during presale
• supplyOfferedPct The percentage of the initial token supply offered to presale's contributors
• fundingForBeneficiaryPct The percentage of the presale raised funds which are to be transferred to the board's discretionnary vault
• openDate The date upon which the presale will be open if 0, the presale can be open manually later
• batchBlocks The number of blocks trading batches will last
• maximumTapRateIncreasePct The maximum percentage tap rates can be increased at once
• maximumTapFloorDecreasePct The maximum percentage tap floors can be decreased at once

Finalize instance

Set collateralization settings

template.finalizeInstance(virtualSupplies, virtualBalances, slippages, daiRate, daiFloor)

• virtualSupplies Array of daiVirtualSupply, antVirtualSupply to set up the market maker
• virtualBalances Array of daiVirtualBalance, antVirtualBalance to set up the market maker
• slippages Array of daiMaxSlippage, antMaxSlippage to set up the maximum per-batch price slippage in the market maker
• daiRate The rate at which DAIs are to be tapped
• daiFloor The floor above which the DAI reserve pool is to be kept

Permissions

System

Handle apps and permissions

Board

TokenManager

Represents board's membership

Voting

Enforces board's decisions

Vault and Finance

Handle board's funds

Share Holders

TokenManager

Handle shares / bonds minting and burning

Voting

Enforces share holders decisions

Fundraising apps

Agent / Reserve

Handle market maker funds

Presale

Handle preliminary sale

MarketMaker

Handle buy and sell orders

Tap

Control the flow of funds from reserve to board

Controller

API contract forwarding transactions to relevant contracts