feat: psp22 example DAO contract

pop-api/examples/dao/Cargo.toml

@@ -0,0 +1,38 @@
+[package]
+authors = ["R0GUE <go@r0gue.io>"]
+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",
+] }
+sp-io = { version = "23.0.0", default-features = false, features = ["disable_allocator", "disable_oom", "disable_panic_handler"] }
+sp-runtime = { version = "24.0.0", default-features = false }
+
+[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"
+
+# TODO: due to compilation issues caused by `sp-runtime`, `frame-support-procedural` and `staging-xcm` this dependency
+# (with specific version) has to be added. Will be tackled by #348, please ignore for now.
+frame-support-procedural = { version = "=30.0.1", default-features = false }
+sp-runtime = { version = "=38.0.0", default-features = false }
+staging-xcm = { version = "=14.1.0", default-features = false }
+
+[lib]
+path = "src/lib.rs"
+
+[features]
+default = ["std"]
+e2e-tests = []
+ink-as-dependency = []
+std = [
+	"ink/std",
+	"pop-api/std",
+	"sp-io/std",
+	"sp-runtime/std",
+]

pop-api/examples/dao/README.md

@@ -0,0 +1,53 @@
+# PSP22 DAO contract example
+
+## Description
+This contract implements a Decentralized Autonomous Organization using Psp22.
+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 DAO is associated with a specific Psp22 token_id.
+- **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
+```