Rust智能合約養成日記(11):Sputnik DAO 提案機制解讀

Sputnik-DAO 作爲 NEAR Protocol 的基礎設施,有力推動着NEAR生態向"去中心化"發展。目前該平台已促成衆多NEAR項目的"去中心化"自治社區,同時提供了完整靈活且高效的社區決策治理方案。

Sputnikdaov2 是用於 Sputnik-DAO 社區治理投票的智能合約。本文將介紹該合約的核心概念:提案(Proposal),並在後續文章中圍繞"提案"介紹相關的DAO社區治理模式(Policy)。

1. 提案發起

Sputnik-DAO 中每位成員都可以就項目治理或管理發表意見或提交提案。每個持股的社區成員都可以對提案進行審議和投票。成員可以通過投票或發起新提案來影響項目未來走向。

在合約層面,DAO成員可調用sputnikdaov2合約的add_proposal()方法來發起新提案:

rust pub fn add_proposal(&mut self, proposal: ProposalInput) -> u64

提案者需提供提案的詳細信息(ProposalInput):

• 提案的文字描述(Description)
• 提案的類型(kind)

這些信息將作爲參數傳入add_proposal()方法,該方法會進行校驗處理,生成一個完整初始化的提案(Proposal)。最終提案會與唯一的proposal_id綁定,添加到合約全局維護的提案池中。

提案的完整屬性信息包括:

• 描述(description)
• 類型(kind)
• 提案者(proposer)
• 狀態(status)
• 提交時間(submission_time)
• 投票狀態(vote_counts, votes)

需要注意的是,Sputnik-DAO中存在提案押金(proposal_bond)的概念。合約要求提案者在調用add_proposal()時質押一定數額的NEAR代幣作爲保證金。該押金會在提案正常結束時退還給提案者。

2. 提案狀態

Sputnik-DAO中的提案可能經歷多種狀態:

• InProgress:新提案的初始狀態
• Approved:獲得通過
• Rejected:被否決
• Removed:被移除
• Expired:已過期
• Moved:已轉移
• Failed:執行失敗

提案狀態變化由act_proposal()方法驅動。DAO成員可調用該方法對提案執行投票等操作:

• VoteApprove:贊成
• VoteReject:反對
• VoteRemove:移除

投票後會調用policy.proposal_status()進行計票。對於滿足投票閾值的提案,狀態會相應變更:

• Approved狀態的提案會被執行
• Rejected或Removed狀態的提案會執行收尾操作

Removed狀態的提案會從提案池中移除,不退還押金。Rejected狀態的提案會保留在池中,並退還押金。

3. 提案執行

若提案狀態變爲Approved,act_proposal()會調用internal_execute_proposal()執行提案內容。

Sputnik-DAO支持多種提案類型,如ChangeConfig、ChangePolicy、FunctionCall、Transfer等。每種類型都有相應的處理分支。

以下是兩種典型提案類型的處理流程:

3.1 合約函數執行提案(FunctionCall)

FunctionCall類型提案可執行指定的合約方法。提案中包含要執行的函數操作(actions),每個action可指定合約方法名和參數。

最終通過Promise Batch Actions的形式完成函數調用。

3.2 合約資金轉移提案(Transfer)

Transfer類型提案可將合約帳戶中的代幣轉移到指定帳戶。

internal_execute_proposal()會調用internal_payout()函數,實現對不同類型代幣和接收帳戶的轉帳操作。

4. 總結

本文介紹了Sputnik DAO合約的核心概念——提案(Proposal),包括提案的創建、投票、狀態變化和執行流程。後續將基於提案進一步介紹Sputnik-DAO的治理模式(Policy)實現。