dao-pre-propose-approval-single

Crates.iodao-pre-propose-approval-single
lib.rsdao-pre-propose-approval-single
version2.6.0
sourcesrc
created_at2023-07-03 18:44:21.801815
updated_at2024-11-08 00:01:48.751745
descriptionA DAO DAO pre-propose module handling a proposal approval flow for for dao-proposal-single.
homepage
repositoryhttps://github.com/DA0-DA0/dao-contracts
max_upload_size
id907316
size261,133
publishers (github:da0-da0:publishers)

documentation

README

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 dao-proposal-single proposal module.

Approval Logic

This contract is instantatied with an approver address. This address is allowed to approve or reject the proposal. An approved proposal opens for voting immediately, whereas a rejected proposal is simply discarded.

      ┌──────────┐
      │          │
      │  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 dao-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.

Commit count: 879

cargo fmt