Rust智能合约养成日记(10-2):Sputnik DAO 工厂合约解析

本文将深入解读Sputnik DAO平台工厂模式(sputnikdao-factory)的设计实现。

1. Sputnik-DAO 工厂合约

Sputnik-DAO采用创建型工厂设计模式实现了该平台下去中心化自治组织(DAO)的统一创建与管理。

对应合约的源代码仓库位于:

2. DAPP 模块功能介绍

Sputnik DAO平台的DAPP页面展示了已创建的DAO实例对象(Sputnikdaov2合约)。截至2022年3月,该平台下最活跃的DAO为news.sputnik-dao.near,有3051个提案正在投票或已结束。

所有基于Sputnik DAO平台创建的DAO实例合约都由sputnik-dao.near账户(sputnikdao-factory合约)统一部署在其子账户下,例如:

• pcp.sputnik-dao.near
• test-dao-bro.sputnik-dao.near
• blaqkstereo.sputnik-dao.near

组织可在NEAR主网中公开调用sputnikdao-factory合约的create()方法来创建新的DAO实例。

3. sputnikdao-factory 合约代码解读

3.1 创建 DAO

sputnikdao-factory合约状态主要由两部分组成:

rust pub struct SputnikDAOFactory { factory_manager: FactoryManager, daos: UnorderedSet, }

• factory_manager:提供创建/删除/更新DAO实例的方法
• daos:记录已创建DAO实例的NEAR账户地址

create()方法定义:

rust #[payable] pub fn create(&mut self, name: AccountId, args: Base64VecU8) { let account_id: AccountId = format!('{}.{}', name, env::current_account_id()) .parse() .unwrap(); let callback_args = serde_json::to_vec(&json!({ 'account_id': account_id, 'attached_deposit': U128(env::attached_deposit()), 'predecessor_account_id': env::predecessor_account_id() })) .expect('Failed to serialize'); self.factory_manager.create_contract( self.get_default_code_hash(), account_id, 'new', &args.0, 'on_create', &callback_args, ); }

factory_manager.create_contract的具体实现:

rust pub fn create_contract( &self, code_hash: Base58CryptoHash, account_id: AccountId, new_method: &str, args: &[u8], callback_method: &str, callback_args: &[u8], ) { // 载入合约代码 // 创建Promise // 创建账户 // 转账 // 部署合约
// 调用初始化函数 // 设置回调 }

on_create回调函数:

rust #[private] pub fn on_create( &mut self, account_id: AccountId, attached_deposit: U128, predecessor_account_id: AccountId, ) -> bool { if near_sdk::is_promise_success() { self.daos.insert(&account_id); true } else { Promise::new(predecessor_account_id).transfer(attached_deposit.0); false } }

3.2 更新DAO

update()方法:

rust pub fn update(&self, account_id: AccountId, code_hash: Base58CryptoHash) { let caller_id = env::predecessor_account_id(); assert!( caller_id == self.get_owner() || caller_id == account_id, 'Must be updated by the factory owner or the DAO itself' ); assert!( self.daos.contains(&account_id), 'Must be contract created by factory' ); self.factory_manager .update_contract(account_id, code_hash, 'update'); }

4. Sputnik-DAO Factory合约安全性分析

主要从以下几个方面保证安全性:

• 权限控制:view方法不修改状态变量
• 特权函数只能由owner执行
• 合理的错误处理机制