Rust智能合约养成日记(10-2):SputnikDAO工厂合约代码解析

本文将详细介绍Sputnik-DAO平台工厂模式(sputnikdao-factory)的设计实现。

1. Sputnik-DAO 工厂合约

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

2. DAPP 模块功能介绍

Sputnik DAO平台DAPP页面可见已有不少DAO在该平台创建了实例对象。截至2022年3月,最活跃的DAO为news.sputnik-dao.near,已有3051个提案正在公开投票或已结。

所有基于Sputnik DAO平台创建的DAO实例合约都被部署在sputnik-dao.near账户的子账户下,如:

• pcp.sputnik-dao.near
• test-dao-bro.sputnik-dao.near
• blaqkstereo.sputnik-dao.near
• octopode-dao.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账户地址

创建DAO实例的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], ) { // 1. 载入合约模板代码 // 2. 构造Promise // 3. 创建部署账户 // 4. 转账NEAR // 5. 部署合约 // 6. 调用初始化函数new() // 7. 回调on_create() }

回调函数on_create的处理逻辑:

• 若步骤3-6执行失败,退还NEAR
• 若执行成功,记录新DAO实例账户地址

3.2 更新DAO

工厂合约提供update()接口用于升级DAO:

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或DAO账户执行
• 错误处理:对异常情况实现合理的错误处理机制