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: 已移除

提案状态变化由 act_proposal() 方法驱动。DAO成员可调用该方法对提案执行以下操作:

• VoteApprove: 赞成
• VoteReject: 反对
• VoteRemove: 移除

投票后会调用 policy.proposal_status() 进行计票。满足条件的提案状态将变更为 Approved、Rejected 或 Removed。

Approved 状态的提案将被执行,Rejected 和 Removed 状态则执行收尾操作。Removed 状态的提案会从提案池中移除,并不退还押金。

3. 提案执行

对于 Approved 状态的提案,act_proposal() 会调用 internal_execute_proposal() 执行提案内容。

Sputnik-DAO 支持多种提案类型,主要涉及 DAO 治理模式配置更新。本文重点介绍两种典型提案类型的处理流程:

3.1 合约函数执行提案(FunctionCall)

FunctionCall 类型提案在创建时传入了要执行的函数操作(actions)。internal_execute_proposal() 会通过 Promise Batch Actions 的形式执行这些函数调用。

3.2 合约资金转移提案(Transfer)

Transfer 类型提案用于将合约账户积累的代币转移到指定账户。internal_execute_proposal() 会调用 internal_payout() 函数,实现对不同类型代币和接收账户的转账操作。

4. 总结

本文介绍了 Sputnik DAO 合约的核心概念——提案(Proposal),包括提案的创建、状态变化和执行流程。后续文章将基于提案机制,对 Sputnik-DAO 的治理模式(Policy)实现与配置进行更详细的描述。