{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"0f355db7-55ff-4582-83ea-c9a9b4c81c76"},"schemaVersion":{"value":"1"},"title":"目录"}},"localId":"fe06d0f1-af7d-4ae1-91e3-195b6ef5faef"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"DAO和插件的关系","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DAO是主体，可以安装插件和使用插件","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"插件来完成具体的功能的扩展","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"分几部分来描述插件","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"第一部分，插件功能，如何使用，以及插件API文档","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. 插件的功能","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.1 Grant插件","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Grant 插件提供：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"创建/执行颁发 Grant 的提案","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"创建/执行修改 Grant 的提案","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"创建/执行收回 Grant 的提案","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"创建安装 Grant 插件的提案","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.2 Member插件","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.3 Stake插件","type":"text"}]},{"type":"paragraph","content":[{"text":"主要功能：根据质押时长和质押额度来质押Token以获得相应的SBT，例如: 在Token和SBT为1:1的DAO中来质押，质押10个Token 10分钟，可得100SBT","type":"text"}]},{"type":"paragraph","content":[{"text":"用户可以做什么：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"根据时间和质押额度来质押Token以获得相应的SBT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"查询当前质押Token的列表","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"质押到期之后退回相应的Token","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"针对插件中的一些参数进行投票，参数有：接收的Token类型，质押Token转成SBT的权重","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"DAO安装插件后可以做什么：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"初始化时指定接收Token的类型，质押Token转成SBT的权重","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"执行投票结果","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. 场景：描述StarcoinDAO下插件的使用和对接","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.1 Grant插件","type":"text"}]},{"type":"paragraph","content":[{"text":"在Starcoin DAO 中其他项目可以创建颁发 Grant 的提案，来为申请人获得 Grant 奖励","type":"text"}]},{"type":"paragraph","content":[{"text":"当申请人拥有 Grant 时，任意成员可以提案要求撤销/修改申请人的 Grant 奖励，当提案通过后，申请人的 Grant 将被撤销/修改 ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.2 Member插件","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.3 Stake插件","type":"text"}]},{"type":"paragraph","content":[{"text":"StarcoinDAO中用户可以通过StakeToSBT插件来增加用户在DAO中的SBT","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"…","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"第二部分：在DAO里如何install插件，以及如何使用插件","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. 如何安装插件","type":"text"}]},{"type":"paragraph","content":[{"text":"插件的安装方式有两种：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"当 DAO 被创建时安装（静态安装）","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"当 DAO 已经创建好后通过 “安装插件的插件”提案安装（动态安装）","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"插件被安装后暂时没有卸载方法","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.1 静态安装","type":"text"}]},{"type":"paragraph","content":[{"text":"DAO 初始化创建（合约 Write 接口）","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"在一个DAO被实例化创建时，需要先上传该 DAO 的合约模块后执行 DAO 的 ","type":"text"},{"text":"初始化函数","type":"text","marks":[{"type":"strong"}]},{"text":"（对应下方","type":"text"},{"text":"create_dao","type":"text","marks":[{"type":"code"}]},{"text":"）","type":"text"}]},{"type":"paragraph","content":[{"text":"参数","type":"text","marks":[{"type":"strong"}]},{"text":"：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"voting_delay","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"投票多久后开始","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"voting_period","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"投票的时间区间","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"voting_quorum_rate","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"投票成功的比例","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"min_action_delay","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"多久后可以执行提案","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"min_proposal_deposit","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"最小的提案质押 Token 数","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"public(script) fun create_dao(\n sender: signer, \n voting_delay: u64,\n voting_period: u64,\n voting_quorum_rate: u8,\n min_action_delay: u64,\n min_proposal_deposit: u128,\n)","type":"text"}]},{"type":"paragraph","content":[{"text":"安装插件","type":"text","marks":[{"type":"strong"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"DAOSpace::install_plugin_with_root_cap","type":"text","marks":[{"type":"code"}]},{"text":" 调用此函数可以在 ","type":"text"},{"text":"DAO 创建的同时","type":"text","marks":[{"type":"strong"}]},{"text":" 安装插件，无需投票安装","type":"text"}]}]},{"type":"paragraph","content":[{"text":"DAOSpace::install_plugin_with_root_cap(&dao_root_cap, InstallPluginProposalPlugin::required_caps());","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"例子","type":"text","marks":[{"type":"strong"}]},{"text":"：","type":"text"},{"text":"XDAO","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"module creator::XDAO {\n use StarcoinFramework::DAOAccount;\n use StarcoinFramework::DAOSpace;\n use StarcoinFramework::MemberProposalPlugin::{Self, MemberProposalPlugin};\n use StarcoinFramework::InstallPluginProposalPlugin::{Self, InstallPluginProposalPlugin};\n\n struct X has store{}\n \n const NAME: vector = b\"X\";\n\n /// directly upgrade the sender account to DAOAccount and create DAO\n public(script) fun create_dao(\n sender: signer, \n voting_delay: u64,\n voting_period: u64,\n voting_quorum_rate: u8,\n min_action_delay: u64,\n min_proposal_deposit: u128,\n ){\n let dao_account_cap = DAOAccount::upgrade_to_dao(sender);\n let config = DAOSpace::new_dao_config(\n voting_delay,\n voting_period,\n voting_quorum_rate,\n min_action_delay,\n min_proposal_deposit,\n );\n let dao_root_cap = DAOSpace::create_dao(dao_account_cap, *&NAME, b\"ipfs://description\", X{}, config);\n \n DAOSpace::install_plugin_with_root_cap(&dao_root_cap, InstallPluginProposalPlugin::required_caps()); \n DAOSpace::install_plugin_with_root_cap(&dao_root_cap, MemberProposalPlugin::required_caps());\n \n DAOSpace::burn_root_cap(dao_root_cap);\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"1.2 动态安装（","type":"text"},{"text":"合约 Write 接口","type":"text","marks":[{"type":"strong"}]},{"text":"）","type":"text"}]},{"type":"paragraph","content":[{"text":"动态安装适用于 DAO 已经创建好后，想要安装其他插件","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"需要","type":"text"},{"text":"被安装插件","type":"text","marks":[{"type":"strong"}]},{"text":"提供","type":"text"},{"text":"install_plugin_proposal","type":"text","marks":[{"type":"code"}]},{"text":" 接口，或者其他类似功能的接口","type":"text"}]}]},{"type":"paragraph","content":[{"text":"public(script) fun install_plugin_proposal(sender: signer, description:vector, action_delay: u64) ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"参数","type":"text","marks":[{"type":"strong"}]},{"text":"：","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"description:vector","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"要安装插件提案的描述","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action_delay:u64","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"多久后可以执行提案","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"StakeToSBT安装插件时","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":268,"id":"92fdd26c-a7d9-475d-a96a-b83070b74722","collection":"contentId-66453570","type":"file","height":263}},{"type":"caption","content":[{"text":"StakeToSBT安装插件","type":"text"}]}]},{"type":"paragraph","content":[{"text":"备注：插件的安装和插件的配置是否需要分两个界面。应该有一个插件列表，用户选择插件后安装。","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. 使用插件","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.1 Grant 插件","type":"text"}]},{"type":"paragraph","content":[{"text":"Grant 授予：","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"合约接口:","type":"text"}]},{"type":"codeBlock","content":[{"text":" public (script) fun create_grant_proposal(sender: signer, description: vector,grantee: address, total: u128, start_time:u64, period: u64, action_delay:u64)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":1280,"id":"bd49b084-dc7f-4a9b-86dd-55e76816841f","collection":"contentId-66453570","type":"file","height":800}}]},{"type":"paragraph","content":[{"text":"Grant 销毁：","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"合约接口:","type":"text"}]},{"type":"codeBlock","content":[{"text":"public (script) fun create_grant_revoke_proposal(sender: signer, description: vector, grantee:address, action_delay:u64)","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":576,"id":"5feb5fec-ddf7-4cd9-8db6-0b5d63981007","collection":"contentId-66453570","type":"file","height":360}}]},{"type":"paragraph","content":[{"text":"Grant 修改：","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"合约接口:","type":"text"}]},{"type":"codeBlock","content":[{"text":"public (script) fun create_grant_config_proposal(sender: signer, description: vector, old_grantee: address, new_grantee: address, total: u128, period: u64,start_time:u64, action_delay:u64)","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":576,"id":"5feb5fec-ddf7-4cd9-8db6-0b5d63981007","collection":"contentId-66453570","type":"file","height":360}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"2.2 StakeToSBT插件","type":"text"}]},{"type":"paragraph","content":[{"text":"发起提案，接口：","type":"text"}]},{"type":"codeBlock","attrs":{"language":"rust"},"content":[{"text":"/// 发起质押类型的提案\n/// 模板参数:\n/// 1. DAOT，DAO类型\n/// 2. TokenT，Token类型\n/// 普通参数:\n/// 1. sender 发起者签名\n/// 2. description 描述信息\n/// 3. action_delay，投票成功后多长时间才可以执行动作\nfun StakeToSBT::create_token_accept_proposal(\n sender: signer,\n description:vector,\n action_delay: u64);\n \n/// 发起质押参数的提案\n/// 模板参数:\n/// 1. DAOT，DAO类型\n/// 2. TokenT，Token类型\n/// 普通参数:\n/// 1. sender 发起者签名\n/// 2. description 描述信息\n/// 3. lock_time 锁仓时长\n/// 4. weight 倍率\n/// 5. action_delay，投票成功后多长时间才可以执行动作\nfun StakeToSBT::create_weight_proposal(\n sender: signer,\n description:vector,\n lock_time: u64,\n weight: u64,\n action_delay: u64);","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":591,"id":"2fa6ce25-0232-484c-8207-1e0a72adc4bd","collection":"contentId-66453570","type":"file","height":249}},{"type":"caption","content":[{"text":"发起提案","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"用户查看质押列表","type":"text"}]},{"type":"paragraph","content":[{"text":"左侧为按Token类型汇总，（接口","type":"text"},{"type":"mention","attrs":{"id":"557058:c6d21e6c-bff4-4e6d-87ed-cff66822cebb","text":"@Jiefeng Yang"}},{"text":" 提供），点进去则是右侧的列表（接口","type":"text"},{"type":"mention","attrs":{"id":"557058:c6d21e6c-bff4-4e6d-87ed-cff66822cebb","text":"@Jiefeng Yang"}},{"text":" 提供），即当前用户所质押的列表","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"赎回按钮未到时间不可点击","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"点击➕，则弹出“新增质押”界面","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"rust"},"content":[{"text":"/// 查询单个质押的信息\n/// 模板参数:\n/// 1. DAOT，DAO类型\n/// 2. TokenT，Token类型\n///\n/// 普通参数:\n/// 1. member 查询的用户\n/// 2. id 质押的id\n///\n/// 返回参数：\n/// 1. 质押开始时间\n/// 2. 锁仓时间\n/// 3. 倍率权重\n/// 4. SBT的额度\n/// 5. 质押的额度\nfun StakeToSBT::query_stake(\n member: address, \n id: u64) : (u64, u64, u64, u128, u128);\n \n/// 赎回质押（未到锁仓时间不可赎回）\n/// 模板参数:\n/// 1. DAOT，DAO类型\n/// 2. TokenT，Token类型\n///\n/// 普通参数:\n/// 1. member 查询的用户\n/// 2. id 质押的id\nfun StakeToSBT::unstake_by_id(member: address, id: u64);","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":590,"id":"0fc0fd37-20d2-4162-896c-aa70ee1572cf","collection":"contentId-66453570","type":"file","height":336}},{"type":"caption","content":[{"text":"用户查看质押列表","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"新增质押界面","type":"text"}]},{"type":"codeBlock","content":[{"text":"/// 质押\n/// 模板参数:\n/// 1. DAOT，DAO类型\n/// 2. TokenT，Token类型\n///\n/// 普通参数:\n/// 1. sender 发起的用户\n/// 2. token 质押的Token\n/// 3. lock_time 锁仓的时间\nfun stake(\n sender: &signer,\n token: Token::Token,\n lock_time: u64);","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":250,"id":"8c119269-313c-47fe-a3ac-1244bf4ca7d8","collection":"contentId-66453570","type":"file","height":315}},{"type":"caption","content":[{"text":"新增质押","type":"text"}]}]},{"type":"paragraph"}],"version":1}

浏览器不受支持