feat: psp22 Dao_example0

pop-api/examples/dao/Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+authors = ["R0GUE <[email protected]>"]
+edition = "2021"
+name = "dao"
+version = "0.1.0"
+
+[dependencies]
+ink = { version = "5.1.0", default-features = false, features = ["ink-debug"] }
+pop-api = { path = "../../../pop-api", default-features = false, features = [
+	"fungibles",
+] }
+
+[dev-dependencies]
+drink = { package = "pop-drink", git = "https://github.com/r0gue-io/pop-drink" }
+env_logger = { version = "0.11.3" }
+serde_json = "1.0.114"
+
+[lib]
+path = "src/lib.rs"
+
+[features]
+default = ["std"]
+e2e-tests = []
+ink-as-dependency = []
+std = [
+	"ink/std",
+	"pop-api/std",
+]

pop-api/examples/dao/README.md

@@ -0,0 +1,56 @@
+# Simple DAO contract example
+A basic Decentralized Autonomous Organization (DAO) that lets members vote on funding proposals using tokens. Built with Pop API.
+## Description
+This contract implements a Decentralized Autonomous Organization.
+The objectivbe of this DAO is to allow its members to vote for funding of projects they would like to see developped.
+To become a member, a user needs to pay some amount of the Dao_token to the Dao Treasury(Dao_tokens obtained through airdrops or token purchase...) ⇒ The subscription payment becomes the Member voting_power. 
+Approved projects are funded by the Dao Treasury.  
+The key functionalities include:
+- **Membership Management**: It maintains a registry of DAO members.
+- **Proposal Lifecycle**: The contract manages the creation, voting, and execution of proposals. Each proposal includes details like description, voting period, vote tallies, execution status, beneficiary, and amount to be awarded.
+- **Voting Mechanism**: It implements a voting system where members can vote with their balance on proposals. The contract tracks voting periods and maintains vote counts for each proposal.
+- **Token Integration**: The Pop API is used to create and manage the DAO token.
+- **Governance Parameters**: governance parameters such as voting periods are customizable.
+- **Vote Tracking**: The contract keeps track of when members last voted.
+- **Proposal Execution**: Once a proposal's voting period ends and passes, the contract handles its execution: transferring funds to the chosen beneficiary.
+
+
+## Dao Workflow
+- **Subscription**: The first step is membership: users use their funds* to join the Dao, become members, and determine their voting power, as membership gives them the right to vote on the use of the Dao Treasury.
+- **Proposal**: Dao members can create spending proposals for the treasury. At the moment, the voting period for the proposal is given by the proposal creator, but this could be a Dao parameter, determined by the creator of the Dao contract.
+- **Vote**: Members of the Dao can vote for or against a given proposal, through the selection of the corresponding proposal ID. The vote has to be cast within the voting period of the selected proposal.
+- **Proposal enactment**: After the end of the voting period, If the proposal has been accepted by the Dao Members, the proposal can be enacted, i.e. funds can be claimed/transferred to the account specified as the beneficiary in the proposal. Any member can claim the reward for the winning proposal.
+
+*It is assumed that after Dao & associated token creation, potential members own the Dao Token through airdrop, token purchase, etc... (These mechanisms are not part of the contract). 
+
+### Flowchart
+
+```mermaid
+flowchart LR
+    A[Subscriber A] -->|Joins DAO| M[Membership Process]
+    B[Subscriber B] -->|Joins DAO| M
+    C[Subscriber C] -->|Joins DAO| M
+    D[Subscriber D] -->|Joins DAO| M
+    M --> E[Subscriber B creates Proposal]
+    E --> F[Voting Process]
+    F -->|Votes by| G[Subscribers A, C, D]
+    G --> H{Proposal Accepted?}
+    H -- Yes --> I[Proposal Enactment]
+    H -- No --> J[End of Process]
+    I --> K[Subscriber A claims reward for proposal's beneficiary]
+    K --> L[Funds transferred to beneficiary]
+
+    style A fill:#f9f,stroke:#333,stroke-width:2px
+    style B fill:#f9f,stroke:#333,stroke-width:2px
+    style C fill:#f9f,stroke:#333,stroke-width:2px
+    style D fill:#f9f,stroke:#333,stroke-width:2px
+    style M fill:#bbf,stroke:#333,stroke-width:2px
+    style E fill:#bbf,stroke:#333,stroke-width:2px
+    style F fill:#bbf,stroke:#333,stroke-width:2px
+    style G fill:#bbf,stroke:#333,stroke-width:2px
+    style H fill:#ff0,stroke:#333,stroke-width:2px
+    style I fill:#bfb,stroke:#333,stroke-width:2px
+    style J fill:#f99,stroke:#333,stroke-width:2px
+    style K fill:#bfb,stroke:#333,stroke-width:2px
+    style L fill:#bfb,stroke:#333,stroke-width:2px
+```