#proposal #dao #approval #module #contract #flow #single

dao-pre-propose-approval-single

A DAO DAO pre-propose module handling a proposal approval flow for for dao-proposal-single

5 stable releases

2.4.2 Jul 22, 2024
2.4.0 Jul 21, 2024
2.3.0 Oct 18, 2023
2.2.0 Jul 9, 2023

#2 in #dao

Download history 76/week @ 2024-07-15 561/week @ 2024-07-22 192/week @ 2024-07-29 40/week @ 2024-08-05 268/week @ 2024-08-12 21/week @ 2024-09-02 86/week @ 2024-09-09 57/week @ 2024-09-16 121/week @ 2024-09-23 9/week @ 2024-09-30

280 downloads per month
Used in dao-pre-propose-approver

BSD-3-Clause

220KB
5K SLoC

Single choice proposal approval contract

dao-pre-propose-approval-single on crates.io docs.rs

This contract implements an approval flow for proposals, it also handles deposit logic. It works with the cwd-proposal-single proposal module.

Approval Logic

This contract is instantatied with an approver address. This address is allowed to approve or reject the proposal.

      ┌──────────┐
      │          │
      │  Account │
      │          │
      └─────┬────┘
            │
            │ Makes prop
            ▼
┌────────────────────────┐               ┌────────────────────────┐
│                        │               │                        │
│  Pre-propose Approval  │ ◄─────────────┤    Approver Address    │
│                        │    Approves   │                        │
└───────────┬────────────┘    or rejects └────────────────────────┘
            │
            │ Creates prop
            │ on approval
            ▼
┌────────────────────────┐
│                        │
│     Proposal Single    │
│                        │
└───────────┬────────────┘
            │
            │ Normal voting
            │
            ▼
┌────────────────────────┐
│                        │
│       Main DAO         │
│                        │
└────────────────────────┘

The approver may also register a ProposalSubmitHook, which fires every time a proposal is submitted to the cwd-pre-propose-approval-single contract.

Deposit Logic

It may accept either native (bank module), cw20 tokens, or no tokens as a deposit. If a proposal deposit is enabled the following refund strategies are avaliable:

  1. Never refund deposits. All deposits are sent to the DAO on proposal completion.
  2. Always refund deposits. Deposits are returned to the proposer on proposal completion and even rejection by the approver.
  3. Only refund passed proposals. Deposits are only returned to the proposer if the proposal is approved and passes. Otherwise, they are sent to the DAO.

This module may also be configured to only accept proposals from members (addresses with voting power) of the DAO.

Here is a flowchart showing the proposal creation process using this module:

Resources

More about the pre-propose design.

More about pre-propose modules.

Dependencies

~10MB
~210K SLoC