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

Sputnik-DAO作爲NEAR生態的基礎設施,正推動着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要求提案者質押一定數額NEAR代幣作爲保證金。該押金在提案正常結束時會退還。

2. 提案狀態

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

• InProgress:進行中
• Approved:已批準
• Rejected:已拒絕
• Removed:已移除

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

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

投票後會進行計票,達到閾值的提案狀態會相應變更。Approved狀態的提案將被執行,Rejected或Removed狀態的提案將被結束。

3. 提案執行

狀態爲Approved的提案將通過internal_execute_proposal()函數執行。

Sputnik-DAO支持多種提案類型,主要涉及DAO治理模式的配置更新。這裏介紹兩種典型提案類型的處理流程:

3.1 合約函數執行提案

FunctionCall類型提案可執行指定的合約方法。提案中包含具體要執行的函數操作(actions),可以是多個連續的function_call。Sputnik-DAO採用Promise Batch Actions的形式完成執行。

3.2 合約資金轉移提案

Transfer類型提案可將合約帳戶積累的代幣轉移到指定帳戶。底層調用internal_payout()函數,實現對不同類型代幣和接收帳戶的轉帳操作。

4. 總結

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