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绑定,添加到合约全局维护的提案池中。

提案包含的完整属性信息有:

• description: 描述
• kind: 类型
• proposer: 提案者
• status: 状态
• submission_time: 提交时间
• vote_counts: 投票统计
• votes: 投票详情

Sputnik-DAO要求提案者在发起提案时质押一定数额的NEAR代币作为保证金。该押金将在提案正常结束时退还给提案者。

2. 提案状态

Sputnik-DAO中的标准提案可能经历以下状态:

• InProgress: 进行中
• Approved: 已批准
• Rejected: 已拒绝
• Removed: 已移除
• Expired: 已过期
• Moved: 已转移

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

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

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

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

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

3. 提案执行

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

Sputnik-DAO支持多种提案类型,如ChangeConfig、ChangePolicy、FunctionCall、Transfer等。

以下介绍两种典型提案类型的执行流程:

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

FunctionCall类型提案在创建时会传入具体要执行的函数操作(actions)。每个action可指定合约方法名和参数。

Sputnik-DAO采用Promise Batch Actions的形式完成合约函数执行类型提案的执行。

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

Transfer类型提案可将合约账户积累的代币(NEAR或NEP-141标准代币)转移到指定账户。

internal_execute_proposal()会调用internal_payout()函数,实现对不同类型代币和接收账户的转账操作。

4. 总结

本文介绍了Sputnik DAO合约的核心概念 - 提案(Proposal),说明了如何创建新提案并投票执行,以及提案状态的变化规则。后续将基于提案进一步介绍Sputnik-DAO的治理模式(Policy)实现与配置。