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

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

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

1. 提案发起

Sputnik-DAO中每位成员都可就项目治理管理发表意见或提交提案。持股成员可对提案进行审议投票。成员可通过投票或发起提案来影响项目走向。

在合约层面,DAO成员可调用sputnikdaov2合约的add_proposal()方法发起新提案。提案者需提供提案的详细信息(ProposalInput):

• 提案的文字描述(Description)
• 提案的类型(kind)

提案信息将作为参数传入add_proposal()方法,经过校验处理后生成一个完整的提案(Proposal),并与唯一的proposal_id绑定,添加到合约全局维护的Contract.proposals映射中。

完整的提案属性信息包括:

• description:提案描述
• kind:提案类型
• proposer:提案者
• status:提案状态,初始为InProgress
• submission_time:提交时间
• vote_counts:投票计数
• votes:投票详情

需要注意的是,Sputnik-DAO存在提案押金(proposal_bond)的概念。合约要求提案者在调用add_proposal()时质押一定数额的NEAR代币作为保证金。该押金将在提案正常结束时退还给提案人。

2. 提案状态

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

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

• VoteApprove:表示赞成
• VoteReject:表示反对
• VoteRemove:认为该提案无意义,需移除

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

• Approved:通过internal_execute_proposal()执行
• Rejected/Removed:通过internal_reject_proposal()执行后续操作

Rejected和Removed状态的区别在于,Removed状态的提案将从提案池中移除,并不退还押金。Rejected状态的提案会保留在池中,并退还押金。

3. 提案执行

若提案状态为Approved,act_proposal()将调用internal_execute_proposal()执行提案内容。

Sputnik-DAO支持多种提案类型,本节将介绍两种典型类型的处理流程:

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

FunctionCall类型提案在添加时已传入具体要执行的函数操作(actions)。每个action可指定合约方法名及参数。Sputnik-DAO采用Promise Batch Actions的形式完成此类提案的执行。

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

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

4. 总结

本文介绍了Sputnik DAO合约的核心概念——提案(Proposal),说明了如何创建、投票和执行提案,以及提案状态的变化规则。后续将基于提案对Sputnik-DAO的治理模式(Policy)展开更详细的描述。