The Giveth platform is currently in a minimal viable product (MVP) state, and will allow users to give ether and DAI contributions to Communities organized around causes. The system is a set of smart contracts living on the Ethereum blockchain bridged to Rinkeby, with a caching server middle-layer and a graphical user interface (GUI). Currently we are in closed beta testing, should you be interested to help us test the system, please contact
@danibelle in the Giveth community.
The system consists of:
- DACs short for Decentralised Altruistic Community. Every DAC is a Community built around a cause to which users can donate. A DAC is owned by a Delegate who can delegate the donations to Campaigns that fund actions supportive of the DAC mission.
- Campaigns are individual projects which are owned by a Campaign Manager. These projects have Milestones through which the Campaign can get funding.
- Milestones can be created within a Campaign and are the only way to get donations out of the Giveth system. Proposed milestones must be approved by the Campaign Manager and follow a workflow where multiple people can interact with it, to ensure the Milestone has been accomplished.
There are 7 roles:
- Campaign Manager is the sole owner of a Campaign and can fund a Milestone with donations delegated to the Campaign.
- Campaign Reviewer can cancel Campaigns and oversee completion of any Milestone within the Campaign.
- Delegate is the sole owner of a DAC and can delegate money from the DAC to a Campaign or a Milestone within the Campaign.
- Giver gives (donates) funds (Ether) to a DAC, Campaign or a Milestone.
- Milestone Manager is responsible for making sure that a Milestone is accomplished.
- Milestone Reviewer reviews the completion of a Milestone (Optional).
- Recipient receives donations upon completion of Milestones.
Please note: Every entity within the Giveth system is represented by an Ethereum address. For now these are simple accounts created upon registration; eventually, these roles could be filled by a multisig, oracle, DAO, etc.
Giveth in Depth
Let's have a second, more in-depth, look at the Giveth system. There are 3 distinct entities in the system which are handling the flow of donations. The relations between them are depicted in Figure 1. Each of these 3 entities corresponds to one or more smart contracts.
Figure 1: Relationships between DACs, Campaigns and Milestones. DACs and Campaigns can be linked with each other, but can also exist as stand-alone entities without more complex relations. Special rules apply to Milestones: Every Milestone can be linked to exactly one Campaign, but multiple Milestones can exist in one Campaign. A Milestone can not exist by itself without a parent Campaign.
Before we dive in the different entities, let's briefly talk about arguably the most important users in our system - Givers. The term Giver describes anyone who used our platform to give donations to a DAC, Campaign or a Milestone. You can see all possible versions of how funds flow in the system (Figure 2). Givers can interact with these 3 entities, but they are not explicitly part of any, unless they choose to join a DAC or assume another role as well. The 'roles locality' can be observed in Figure 3. The full list of a Giver's possible interaction with other roles is depicted in the 'use case diagram' in Figure 4.
Figure 2: Donation flow within the Giveth system. A Giver can give ETH to a DAC, a Campaign or directly to a Milestone. From a DAC the money can be delegated to a Campaign and from a Campaign donations can be locked in a Milestone within the Campaign the funds were donated to. The only way for a Recipient to move funds out of the system is by successfully completing a Milestone.
Figure 3: The locality of roles. All roles have a limited scope and once an entity seizes to exist, so do the connected roles. Every DAC contains exactly one Delegate, every Campaign has one Campaign Manager and Campaign Reviewer and every Milestone has a Milestone Manager, a Milestone Reviewer and a Recipient. The Giver is not explicitly associated with any entity, but may interact with all of them.
DACs (Decentralised Altruistic Communities), are the most general entity in the Giveth System. The purpose of a DAC is to unite Givers around a cause and provide them with the possibility to give money to a cause without having to research the exact Campaigns, destined to make a change. Any money donated to a DAC can be retrieved by the Giver, however we strongly discourage Givers to do so. The funds remain in the DAC until they are taken back by the Giver, or delegated to either a Campaign or a Milestone.
A Delegate is a registered user owning a DAC. They can delegate the funds donated to their DACs. The 'use case diagram' in Figure 5 shows all possible actions a Delegate can take. Currently, in the MVP version of Giveth, donations can not be split, hence any donation needs to be fully delegated with the total amount to a Campaign or a Milestone. A delegation is a process, where the donation pledged to a DAC is transferred to a Campaign or Milestone. Once delegated, the Giver has 3 days to reject the delegation. After that time, the money is locked in the Campaign or Milestone to which the money was delegated. This process is visualised in Figure 6 for delegating to a Campaign and in Figure 7 for delegating directly to a Milestone.
Figure 6: State diagram for DAC -> Campaign delegation flow, showing how donations made to a DAC are delegated to a Campaign.
Figure 7: State diagram for DAC -> Milestone delegation flow, showing how donations made to a DAC are delegated directly to a Milestone.
In the Giveth System, a Campaign represents one or more individual project(s) which take action to make a change in the world. Donations made to a Campaign are locked and unless the Campaign gets cancelled, the Giver no longer has control over the donation. The reason why we lock the donations, is to give the people behind the Campaign some level of certainty that they can count on getting the pledged donations and pledge them to one of their Milestones. The previously mentioned Figure 6 describes the donation flow from a DAC to a Campaign and Figure 10 shows the state diagram for direct donations to a Milestone.
A Campaign Manager is a registered user who has created a Campaign (and therefore acquires sole ownership of the new Campaign). The role of the Campaign manager is to create Milestones through which they can fund the work of people and cost of resources behind the project. Figure 8 depicts all the actions a Campaign manager can take.
Because donations to a Campaign are locked, we have added a Campaign Reviewer role to give some oversight over the Campaign's progress. A Campaign Reviewer is a registered user who has the power to reject a Milestone's completion (set goal unfulfilled), cancel Milestones (duplicates, prevent fraud) and even cancel a Campaign if necessary (to prevent fraud). You can see all possible actions for Campaign Reviewers in Figure 9.
Figure 10: State diagram for donations made to Campaign.
Milestones can be created within a Campaign and are the only way to get donations out of the Giveth system. Givers can donate money directly to a Milestone: The actual donation flow is very simple and is depicted in Figure 14.
Milestones require a specific workflow, where several roles have to work with the Milestone in order for it to be completed and for the donated funds to transfer ownership to the Receiver and allow the donations to be taken out of the Giveth system (see Figure 15). Each Milestone has a completion date, by which it needs to be completed or it will be cancelled.
Required information upon creation of a Milestone are: - requested amount of Ether - description of conditions to be fulfilled to complete the Milestone.
A Milestone Manager is a registered user who has been nominated by the Campaign Manager. The role of the Milestone Manager is to make sure the work and the status described in the Milestone has been achieved. Once a state of completion has been achieved, the Milestone Manager needs to mark the Milestone complete. Should there be any major issues, they have the power to cancel the Milestone.
Because direct donations by Givers to a Milestone are locked immediately, each Milestone requires a Milestone Reviewer role to keep an oversight on the Milestone progress. A Milestone Reviewer is a registered user who is appointed by the Campaign Manager upon creation of a Milestone. They have the power to approve successful completion, reject successful completion or even cancel the Milestone in case of suspected fraud. You can see all possible actions for Milestone Reviewers in Figure 12.
A Recipient is a registered user, who will receive payment from their successfully completed Milestone. In the majority of cases, the Recipient would be the Milestone Manager as they are the ones working on the Milestone. However, there may be some cases where someone else is being rewarded (for example direct payments to settle a suppliers bill).
Figure 14: State diagram for donations made to a Milestone.
Figure 15: Full Milestone workflow state diagram. Apart from states and actions, this diagram also shows who is the actor that can take these actions.
Many actions within the Giveth MVP System are automatic actions that are executed with time delay.
The first action is delegation approval which is automatically invoked after 3 days if the user does not reject the delegation before time-out.
Additionally, each Milestone has some timespan for fulfillment. Should this date be reached without achieving the
Authorisation for Payment state, the Milestone gets cancelled automatically.
Another automated action is releasing Milestone payout once it was marked as complete. By default, as a security measure, donations for successfully completed Milestones have a 3 days period after which the funds can be retrieved.
Lastly, if a Milestone is marked as complete and the Reviewers don't take any action, the Milestone is automatically approved to be complete and achieves the state
Authorised for Payment.