Rust智能合约养成日记(11) Sputnik DAO::提案机制解析

Sputnik-DAO 是 NEAR Protocol 提供的基础设施,推动 NEAR 生态向去中心化方向发展。目前该平台已促成多个 NEAR 项目建立去中心化自治社区,提供完整灵活的社区决策治理方案。

Sputnikdaov2 是用于 Sputnik-DAO 社区治理投票的智能合约。本文将介绍该合约的核心概念:提案(Proposal),后续文章将围绕提案介绍相关的 DAO 社区治理模式(Policy)。

1. 提案发起

Sputnik-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:状态(默认为 InProgress)
• submission_time:提交时间
• vote_counts:投票计数(初始为空)
• votes:投票详情(初始为空)

Sputnik-DAO 中存在提案押金(proposal_bond)的概念,提案者需在调用 add_proposal() 时质押一定数额的 NEAR 代币作为保证金。该押金在提案正常结束时会退还给提案者。

2. 提案状态

Sputnik-DAO 中的提案可能经历多种状态,初始状态为 InProgress。状态变化由 act_proposal() 方法驱动。

成员可调用 act_proposal() 对提案执行以下操作:

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

投票后,程序会调用 policy.proposal_status() 进行计票。满足投票阈值的提案状态将相应变更:

• Approved:通过 internal_execute_proposal() 执行
• Rejected/Removed:通过 internal_reject_proposal() 处理

Removed 状态的提案会从提案池中移除且不退还押金,Rejected 状态的提案会保留并退还押金。

3. 提案执行

Approved 状态的提案会调用 internal_execute_proposal() 执行决策内容。Sputnik-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)实现。