@ablack/fundraising-templates-multisig 中文文档教程
Aragon 0.8 Fundraising Multisig Template
Description
Aragon 筹款多重签名模板区分两组参与者：董事会和股东。
Board
董事会是由筹款活动资助的。 它们通过自定义 BOARD 令牌和一个专门用作多重签名的投票应用程序来表示。 他们的特权被有意限制以保护股东。 因此，他们只有以下权利。
Handling board members
董事会 [通过其 TokenManager] 决定谁被包括/排除在董事会之外。
Opening presale
董事会决定预售 [以及筹款活动] 何时开放。
Handling fundraising proceeds
董事会决定如何使用定期转移到他们自行决定的 Vault / Finance 应用程序的筹款收益。
Opening votes
董事会决定何时应向股东开放新的投票权，以对组织执行决策。
Shareholders
股东是为筹款活动做出贡献的人。 他们通过 SHARE 绑定令牌 [他们可以通过 Aragon 筹款界面购买和赎回] 和投票应用程序来代表。 他们拥有组织的大部分权利。
Handling system
股东决定安装哪些应用程序、升级哪些应用程序以及如何设置权限。
Handling fundraising parameters
股东决定是否/如何更新受益人、费用、抵押设置和抵押水龙头。
Rationale
该架构将 [大部分] 治理权授予股东 [以保护他们的投资]。 因此，需要缓解持有超过 50% 股份的股东将拥有整个组织的情况。 这就是为什么基于SHARE 的投票[即 大多数组织决策] 只能由董事会公开和发起。
Usage
Prepare instance
部署 DAO 并安装所有与委员会相关的应用程序
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
设置抵押设置
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
处理应用程序和权限
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Kernel | APP_MANAGER | Voting [SHARE] | Voting [SHARE] |
| ACL | CREATE_PERMISSIONS | Voting [SHARE] | Voting [SHARE] |
| EVMScriptRegistry | REGISTRY_MANAGER | Voting [SHARE] | Voting [SHARE] |
| EVMScriptRegistry | REGISTRYADDEXECUTOR | Voting [SHARE] | Voting [SHARE] |
Board
TokenManager
代表委员会成员
| App | Permission | Grantee | Manager |
|---|---|---|---|
Token Manager [BOARD] | MINT | Voting [BOARD] | Voting [SHARE] |
Token Manager [BOARD] | BURN | Voting [BOARD] | Voting [SHARE] |
Token Manager [BOARD] | ISSUE | NULL | NULL |
Token Manager [BOARD] | ASSIGN | NULL | NULL |
Token Manager [BOARD] | REVOKE_VESTINGS | NULL | NULL |
Voting
执行委员会的决定
| App | Permission | Grantee | Manager |
|---|---|---|---|
Voting [BOARD] | CREATE_VOTES | Token Manager [BOARD] | Voting [SHARE] |
Voting [BOARD] | MODIFY_QUORUM | Voting [BOARD] | Voting [SHARE] |
Voting [BOARD] | MODIFY_SUPPORT | Voting [BOARD] | Voting [SHARE] |
Vault and Finance
处理委员会的资金< /em>
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Vault | TRANSFER | Finance | Voting [SHARE] |
| Finance | CREATE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | EXECUTE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | MANAGE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | CHANGE_PERIOD | NULL | NULL |
| Finance | CHANGEBUDGETSROLE | NULL | NULL |
Share Holders
TokenManager
处理股票/债券的铸造和销毁
| App | Permission | Grantee | Manager |
|---|---|---|---|
Token Manager [SHARE] | MINT | MarketMaker | Voting [SHARE] |
Token Manager [SHARE] | BURN | MarketMaker, Presale | Voting [SHARE] |
Token Manager [SHARE] | ISSUE | Presale | Voting [SHARE] |
Token Manager [SHARE] | ASSIGN | Presale | Voting [SHARE] |
Token Manager [SHARE] | REVOKE_VESTINGS | Presale | Voting [SHARE] |
Voting
执行股东的决定
| App | Permission | Grantee | Manager |
|---|---|---|---|
Voting [SHARE] | CREATE_VOTES | Token Manager [BOARD] | Voting [SHARE] |
Voting [SHARE] | MODIFY_QUORUM | Voting [SHARE] | Voting [SHARE] |
Voting [SHARE] | MODIFY_SUPPORT | Voting [SHARE] | Voting [SHARE] |
Fundraising apps
Agent / Reserve
处理做市商资金
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Pool | SAFE_EXECUTE | Voting [SHARE] | Voting [SHARE] |
| Pool | ADDPROTECTEDTOKEN | Controller | Voting [SHARE] |
| Pool | REMOVEPROTECTEDTOKEN | NULL | NULL |
| Pool | EXECUTE | NULL | NULL |
| Pool | DESIGNATE_SIGNER | NULL | NULL |
| Pool | ADDPRESIGNEDHASH | NULL | NULL |
| Pool | RUN_SCRIPT | NULL | NULL |
| Pool | TRANSFER | Tap, MarketMaker | Voting [SHARE] |
Presale
处理初步销售
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Presale | OPEN | Controller | Voting [SHARE] |
| Presale | CONTRIBUTE | Controller | Voting [SHARE] |
MarketMaker
< em>处理买卖订单
| App | Permission | Grantee | Manager |
|---|---|---|---|
| MarketMaker | OPEN | Controller | Voting [SHARE] |
| MarketMaker | UPDATE_FORMULA | NULL | NULL |
| MarketMaker | UPDATE_BENEFICIARY | Controller | Voting [SHARE] |
| MarketMaker | UPDATE_FEES | Controller | Voting [SHARE] |
| MarketMaker | ADDCOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | REMOVECOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | UPDATECOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | OPENBUYORDER | Controller | Voting [SHARE] |
| MarketMaker | OPENSELLORDER | Controller | Voting [SHARE] |
Tap
控制资金从储备到董事会的流动
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Tap | UPDATE_CONTROLLER | NULL | NULL |
| Tap | UPDATE_RESERVE | NULL | NULL |
| Tap | UPDATE_BENEFICIARY | Controller | Voting [SHARE] |
| Tap | UPDATEMAXIMUMTAPRATEINCREASE_PCT | Controller | Voting [SHARE] |
| Tap | UPDATEMAXIMUMTAPFLOORDECREASE_PCT | Controller | Voting [SHARE] |
| Tap | ADDTAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | REMOVETAPPEDTOKEN | NULL | NULL |
| Tap | UPDATETAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | RESETTAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | WITHDRAW | Controller | Voting [SHARE] |
Controller
API 合约转发交易到相关合约
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Controller | UPDATE_BENEFICIARY | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATE_FEES | Voting [SHARE] | Voting [SHARE] |
| Controller | ADDCOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | REMOVECOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATECOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATEMAXIMUMTAPRATEINCREASE_PCT | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATEMAXIMUMTAPFLOORDECREASE_PCT | Voting [SHARE] | Voting [SHARE] |
| Controller | ADDTOKENTAP | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATETOKENTAP | Voting [SHARE] | Voting [SHARE] |
| Controller | OPEN_PRESALE | Voting [BOARD] | Voting [SHARE] |
| Controller | OPEN_TRADING | Presale | Voting [SHARE] |
| Controller | CONTRIBUTE | Any | Voting [SHARE] |
| Controller | OPENBUYORDER | Any | Voting [SHARE] |
| Controller | OPENSELLORDER | Any | Voting [SHARE] |
| Controller | WITHDRAW | Any | Voting [SHARE] |
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
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Kernel | APP_MANAGER | Voting [SHARE] | Voting [SHARE] |
| ACL | CREATE_PERMISSIONS | Voting [SHARE] | Voting [SHARE] |
| EVMScriptRegistry | REGISTRY_MANAGER | Voting [SHARE] | Voting [SHARE] |
| EVMScriptRegistry | REGISTRYADDEXECUTOR | Voting [SHARE] | Voting [SHARE] |
Board
TokenManager
Represents board's membership
| App | Permission | Grantee | Manager |
|---|---|---|---|
Token Manager [BOARD] | MINT | Voting [BOARD] | Voting [SHARE] |
Token Manager [BOARD] | BURN | Voting [BOARD] | Voting [SHARE] |
Token Manager [BOARD] | ISSUE | NULL | NULL |
Token Manager [BOARD] | ASSIGN | NULL | NULL |
Token Manager [BOARD] | REVOKE_VESTINGS | NULL | NULL |
Voting
Enforces board's decisions
| App | Permission | Grantee | Manager |
|---|---|---|---|
Voting [BOARD] | CREATE_VOTES | Token Manager [BOARD] | Voting [SHARE] |
Voting [BOARD] | MODIFY_QUORUM | Voting [BOARD] | Voting [SHARE] |
Voting [BOARD] | MODIFY_SUPPORT | Voting [BOARD] | Voting [SHARE] |
Vault and Finance
Handle board's funds
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Vault | TRANSFER | Finance | Voting [SHARE] |
| Finance | CREATE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | EXECUTE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | MANAGE_PAYMENTS | Voting [BOARD] | Voting [SHARE] |
| Finance | CHANGE_PERIOD | NULL | NULL |
| Finance | CHANGEBUDGETSROLE | NULL | NULL |
Share Holders
TokenManager
Handle shares / bonds minting and burning
| App | Permission | Grantee | Manager |
|---|---|---|---|
Token Manager [SHARE] | MINT | MarketMaker | Voting [SHARE] |
Token Manager [SHARE] | BURN | MarketMaker, Presale | Voting [SHARE] |
Token Manager [SHARE] | ISSUE | Presale | Voting [SHARE] |
Token Manager [SHARE] | ASSIGN | Presale | Voting [SHARE] |
Token Manager [SHARE] | REVOKE_VESTINGS | Presale | Voting [SHARE] |
Voting
Enforces share holders decisions
| App | Permission | Grantee | Manager |
|---|---|---|---|
Voting [SHARE] | CREATE_VOTES | Token Manager [BOARD] | Voting [SHARE] |
Voting [SHARE] | MODIFY_QUORUM | Voting [SHARE] | Voting [SHARE] |
Voting [SHARE] | MODIFY_SUPPORT | Voting [SHARE] | Voting [SHARE] |
Fundraising apps
Agent / Reserve
Handle market maker funds
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Pool | SAFE_EXECUTE | Voting [SHARE] | Voting [SHARE] |
| Pool | ADDPROTECTEDTOKEN | Controller | Voting [SHARE] |
| Pool | REMOVEPROTECTEDTOKEN | NULL | NULL |
| Pool | EXECUTE | NULL | NULL |
| Pool | DESIGNATE_SIGNER | NULL | NULL |
| Pool | ADDPRESIGNEDHASH | NULL | NULL |
| Pool | RUN_SCRIPT | NULL | NULL |
| Pool | TRANSFER | Tap, MarketMaker | Voting [SHARE] |
Presale
Handle preliminary sale
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Presale | OPEN | Controller | Voting [SHARE] |
| Presale | CONTRIBUTE | Controller | Voting [SHARE] |
MarketMaker
Handle buy and sell orders
| App | Permission | Grantee | Manager |
|---|---|---|---|
| MarketMaker | OPEN | Controller | Voting [SHARE] |
| MarketMaker | UPDATE_FORMULA | NULL | NULL |
| MarketMaker | UPDATE_BENEFICIARY | Controller | Voting [SHARE] |
| MarketMaker | UPDATE_FEES | Controller | Voting [SHARE] |
| MarketMaker | ADDCOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | REMOVECOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | UPDATECOLLATERALTOKEN | Controller | Voting [SHARE] |
| MarketMaker | OPENBUYORDER | Controller | Voting [SHARE] |
| MarketMaker | OPENSELLORDER | Controller | Voting [SHARE] |
Tap
Control the flow of funds from reserve to board
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Tap | UPDATE_CONTROLLER | NULL | NULL |
| Tap | UPDATE_RESERVE | NULL | NULL |
| Tap | UPDATE_BENEFICIARY | Controller | Voting [SHARE] |
| Tap | UPDATEMAXIMUMTAPRATEINCREASE_PCT | Controller | Voting [SHARE] |
| Tap | UPDATEMAXIMUMTAPFLOORDECREASE_PCT | Controller | Voting [SHARE] |
| Tap | ADDTAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | REMOVETAPPEDTOKEN | NULL | NULL |
| Tap | UPDATETAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | RESETTAPPEDTOKEN | Controller | Voting [SHARE] |
| Tap | WITHDRAW | Controller | Voting [SHARE] |
Controller
API contract forwarding transactions to relevant contracts
| App | Permission | Grantee | Manager |
|---|---|---|---|
| Controller | UPDATE_BENEFICIARY | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATE_FEES | Voting [SHARE] | Voting [SHARE] |
| Controller | ADDCOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | REMOVECOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATECOLLATERALTOKEN | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATEMAXIMUMTAPRATEINCREASE_PCT | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATEMAXIMUMTAPFLOORDECREASE_PCT | Voting [SHARE] | Voting [SHARE] |
| Controller | ADDTOKENTAP | Voting [SHARE] | Voting [SHARE] |
| Controller | UPDATETOKENTAP | Voting [SHARE] | Voting [SHARE] |
| Controller | OPEN_PRESALE | Voting [BOARD] | Voting [SHARE] |
| Controller | OPEN_TRADING | Presale | Voting [SHARE] |
| Controller | CONTRIBUTE | Any | Voting [SHARE] |
| Controller | OPENBUYORDER | Any | Voting [SHARE] |
| Controller | OPENSELLORDER | Any | Voting [SHARE] |
| Controller | WITHDRAW | Any | Voting [SHARE] |
