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)进行更详细的描述。