通过治理机制修改 DAO 的设置

关于链上治理的介绍请参看 Starcoin 去中心化治理, 这是一个例子，演示如何通过 cli 进行链上治理。

DAO 本身也拥有几个链上参数，包括：

voting_delay: 提案公示期。
voting_period: 投票期。
quorum_vote: 投票率。
min_action_delay: 提案执行的最小公示期。

这些参数也可以通过 DAO 本身去投票修改。

DEV 环境下，STC 的 DAO 治理参数默认是：

voting_delay: 60000,       // 1min
voting_period: 60 * 60 * 1000, // 1h
voting_quorum_rate: 4,  // 4%
min_action_delay: 60 * 60 * 1000, // 1h

以下通过 cli 命令，演示如何投票更改 STC 治理参数中的提案公示期为 60 * 60 * 1000 = 1h，以展示 提案-投票-执行 这系列流程。

注：以下假设你使用的是 DEV 环境的节点，并且节点默认账号是 0x84b4a430c50322a66007469a645a6a06。命令中出现 0x84b4a430c50322a66007469a645a6a06 的地方需要换成你的节点的默认账号。

提交修改 DaoConfig 的提案（具体参数可以参考 stdlib 中 ModifyDaoConfigProposal module 的文档说明）：

# 解锁节点账号，用节点账号发起提案
account unlock 0x84b4a430c50322a66007469a645a6a06
dev get-coin
account execute-function -s 0x84b4a430c50322a66007469a645a6a06 --function 0x1::ModifyDaoConfigProposal::propose -t 0x1::STC::STC --arg 60000 600000 4u8 1000 0

注：dao参数不能等于0，否则该参数不会被更新。

提案发起后，用户需要等待公示期过后才能开始投票。

可以使用如下命令查看提案信息。

dev call --function 0x1::Dao::proposal_info -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06

返回结果包含了五个值，依次是：proposal_id，投票开始时间，投票结束时间，赞成票数，反对票数。

{
  "ok": [
    0,
    66776,
    3666776,
    0,
    0
  ]
}

dev sleep -t 61000

dev gen-block

用户投票

DEV 链启动后，会默认给基金会账号 mint 一笔 stc，而节点账号还没有 stc，所以需要使用基金会账号来投票，让提案通过。（DEV 环境下，用户可以直接使用基金会账号）

# 解锁基金会账号，用基金会账号对提案投票
account unlock 0000000000000000000000000a550c18
account execute-function -s 0x0000000000000000000000000a550c18 --function 0x1::DaoVoteScripts::cast_vote -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06 --arg 0 --arg true --arg 59256798999894453u128

再次查看提案信息。

dev call --function 0x1::Dao::proposal_info -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06

{
  "ok": [
    0,
    69682,
    3669682,
    1592566999998944,
    0
  ]
}

dev sleep -t 3600000

dev gen-block

投完票，然后等待投票期结束。

提案通过

投票期结束后，如果提案是通过状态，那就可以将其放入待执行队列，进入执行公示期。

可以通过以下命令查看提案状态：

dev call --function 0x1::Dao::proposal_state -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06 --arg 0

返回：（如果返回结果是 4，说明提案通过，其他提案状态可以参考标准库文档）

{
  "ok": [
    4
  ]
}

放入待执行对列：

# 用节点账号将通过后的提案入队列
account execute-function -s 0x84b4a430c50322a66007469a645a6a06 --function 0x1::Dao::queue_proposal_action -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06 --arg 0

取回质押的 Token

投票期过后，用户可以把自己质押的 token 取回，使用如下脚本提交交易：

# 取回基金会账号质押的 token
account execute-function -s 0x0000000000000000000000000a550c18 --function 0x1::DaoVoteScripts::unstake_vote -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06 --arg 0

执行提案

待执行的提案在执行公示期过后，可以由任何人发起交易触发执行。命令如下：

dev sleep -t 3600000

dev gen-block

# # 用节点账号发起交易执行提案
account execute-function -s 0x84b4a430c50322a66007469a645a6a06 --function 0x1::ModifyDaoConfigProposal::execute -t 0x1::STC::STC --arg 0x84b4a430c50322a66007469a645a6a06 --arg 0

确认执行结果

最后，我们还需要确认参数被成功修改掉。

starcoin% dev call --function 0x1::Dao::voting_delay -t 0x1::STC::STC
{
  "ok": [
    60000
  ]
}

7.清理掉完成的提案

account execute-function -s 0x84b4a430c50322a66007469a645a6a06 --function 0x1::Dao::destroy_terminated_proposal -t 0x1::STC::STC -t 0x1::ModifyDaoConfigProposal::DaoConfigUpdate --arg 0x84b4a430c50322a66007469a645a6a06 0

以上是一个去中心化治理的案例流程，它没有展示出 DAO 模块的所有功能。更多请探索 Starcoin 标准库的官方文档。