Rust智能合约系列: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绑定,添加到合约全局维护的proposals映射中。

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

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

Sputnik-DAO要求提案者在调用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()处理

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

3. 提案执行

Approved状态的提案将调用internal_execute_proposal()执行决策内容。Sputnik-DAO支持多种提案类型,本文介绍两种典型类型:

3.1 合约函数执行提案

FunctionCall类型提案通过ProposalInput参数传入要执行的函数操作(actions)。每个ActionCall可指定合约方法名及参数。Sputnik-DAO采用Promise Batch Actions形式完成合约函数执行。

3.2 合约资金转移提案

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