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)实现。