治理模块

Introduction

Gov 模块负责链上治理。

区块链应用的升级需要在全网就升级内容达成社区共识，而社区共识通常很难达成，为了应对达成社区共识的挑战，Gov 模块实现了这一链上治理的功能。

任何人都可以通过发起链上提案来修改某一个参数，或者对代码进行升级，链上资产持有人可以通过对提案投票的方式来表达对提案的支持或者反对,只有通过抵押参与了共识投票的链上资产所代表的投票才算有效投票，当有足够多的投票支持提案时，提案生效。

提案的创建与投票

任何人都可以通过 MsgSubmitProposql 结构体类型的消息发起链上提案。

type MsgSubmitProposal struct {
    Content        *types.Any                               // 提案内容
    InitialDeposit github_com_cosmos_cosmos_sdk_types.Coins // 初始抵押资金
    Proposer       string                                   // 提案者
}

为了防止发起垃圾提案，要求每个提案者为其发起的提案抵押一定的链上资产作为初始抵押资金，gov 模块要求初始抵押资金不为零。如果提案者的初始抵押资金不满足最小抵押要求，链上资产持有人可以通过发送 MsgDeposit 消息为自己支持的提案追加抵押资金。

type MsgDeposit struct {
    ProposalId uint64                                  // 提案标识
    Depositor  string                                  // 存款人
    Amount     github_com_cosmos_cosmos_sdk_types.Coins// 存款金额
}

最低存款金额由模块参数 MinDeposit 指定，以防止提案长时间处于非投票状态。为了进一步防止提案陷入无投票状态，gov 模块指定了一个时间段，在此期间可以通过参数 MaxDepositPeriod 进行额外存款。如果提案的存款在超时后未达到最低要求，则提案将被关闭，相应的存款将被“销毁”。提案的存款存储在 Gov 模块帐户中。

提案类型

文本提案：此类提案仅包含标题和说明。一旦颁布，它不会对链上行为产生任何影响。它仅用于收集社区反馈。文本提案不包含任何代码，其批准不会直接导致对链的任何更改。文本提案是进行社区民意调查的官方和公开方式。它们存储在链上，任何人都可以查看。提案的发起人可以使用文本提案来收集意见和观点，为未来的工作做准备。

TextProposal 结构用于实现文本建议。

type TextProposal struct {
    Title       string   // 标题
    Description string   // 描述
}

这里有三个组成部分：

标题 - 提案的特别名称，通常是探索者列出提案的方式
描述 - 提案的主体部分，进一步描述了提案的内容以及提案的相关细节
存款 - 将从提交提案的账户贡献给存款的金额

实际例子

{
  "title": "Test Proposal",
  "description": "My awesome proposal",
  "type": "Text",
  "deposit": "10unit"
}

参数修改提案：每个模块都有自己的一组参数，这些参数中的任何一个都可以使用参数更改提案进行更新，目前这些模块中的参数可以通过治理提案进行更改，后期还会加入新的模块。
- auth - 账户和交易认证模块
- bank - token 传输
- mint - 创建新的质押代币
- staking - 链上资产抵押
- slashing - 验证者惩罚机制
- gov - 链上治理提案和投票
- distribution - 奖励分配

关于参数变更提案，可以说有七个组成部分，尽管其中三个被归类于'变更'之下：

标题 - 提案的独特名称，通常是探索者列出提案的方式
描述 - 进一步描述所提议的内容以及提案相关详细情况的提案正文
变更 - 包含以下内容的组成部分
子空间 - 带有将要更改的参数的 Cosmos Hub 模块
键 - 将被改变的参数
值 - 通过治理机制将被更改的参数的值
存款 - 提交提案的账户将为存款贡献的金额

实际例子

{
  "title": "Staking Param Change",
  "description": "Update max validators",
  "changes": [
    {
      "subspace": "staking",
      "key": "MaxValidators",
      "value": 105
    }
  ],
  "deposit": "1000stake"
}

社区储备资金花费提案：部分区块奖励会作为社区储备资金用于支持社区建设，社区储备资金花费提案将部分社区储备资金转到特定的地址,用来奖励做出贡献的账户。

以下是五个组成部分：

标题 - 提案的特殊名称，通常是探索者列出提案的方式
描述 - 进一步描述提议内容及其细节的提案主体
接收方 - 将从社区池中接收资金的 Cosmos Hub（基于 bech32 的）地址
数额 - 接收方将接收的资金数量
存款 - 将从提交提案的帐户中贡献给存款的金额

如果描述中说某个地址将接收到一定数量的 UNIT，那么也应该进行相应的编程，但可能并非如此（无意或有意）。请检查描述是否与“接收方”地址相符。

实际例子

{
  "title": "Community Pool Spend",
  "description": "Pay me some Units!",
  "recipient": "treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg",
  "amount": "1000unit",
  "deposit": "1unit"
}

软件升级提案。

在具体执行提案时，需要找到提案处理函数，每个模块都可以定义新的提案类型。

params 模块定义了参数修改提案
distribution 模块定义了社区储备金的花费提案。
upgrade 模块定义了软件升级提案。

遵循模块化设计理念，各个模块独自管理自己存储空间，各个提案的执行只能定义在相应模块内部。gov 模块管理所有提案的投票,并在 EndBlocker()中触发对应的提案处理函数。

gov 模块的 Keeper 为上述 5 个消息分别定义了相应的处理函数。而 staking 模块的所有逻辑都围绕验证者结构体 Validator 和委托结构体 Delegation 展开。前者记录验证者信息，后者记录委托操作信息。

举例：在 treasurenet/app 中定义了 gov 提案治理的路由信息

govRouter := govtypes.NewRouter()
    govRouter.AddRoute(govtypes.RouterKey, govtypes.ProposalHandler).
        AddRoute(paramproposal.RouterKey, params.NewParamChangeProposalHandler(app.ParamsKeeper)).

对应 params 模块中的 NewParamChangeProposalHandler() 该函数仅处理提案类型参数修改的提案。

提案流程

gov 流程

交易和查询

交易

treasurenetd tx gov submit-proposal - 提交提案和初始存款

treasurened tx gov submit-proposal (proposal type>):
- proposal type 为空，则说明为文本提案
- proposal type 为 param-change 说明我们正在提交参数修改提案
- proposal type 为 community-pool-spend 说明正在提交社区池支出提案
- proposal type 为 software-upgrade 说明正在提交软件升级的提案
- proposal type 为 cancel-software-upgrade 说明正在提交取消软件升级的提案

提交文本提案

$ treasurenetd tx gov submit-proposal \
--proposal="/root/proposal_text.json" \
--from="[name_of_your_key]" \
--chain-id="[chain-id]" \
--fees="1unit" \
--gas="auto" \
--home="[defaule:/root/.treasurenet/]" \
--keyring-backend test

## Transactions payload##
{"body":{"messages":[{"@type":"/cosmos.gov.v1beta1.MsgSubmitProposal","content":{"@type":"/cosmos.gov.v1beta1.TextProposal","title":"Test Proposal","description":"My awesome proposal"},"initial_deposit":[{"denom":"aunit","amount":"10000000000000000000"}],"proposer":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg"}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[{"denom":"aunit","amount":"1000000000000000000"}],"gas_limit":"152151","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

提交参数修改提案

$ treasurenetd tx gov submit-proposal param-change /root/proposql_param.json \
--from="[name_of_your_key]" \
--chain-id="[chain-id]" \
--fees="1unit" \
--gas="auto" \
--home="[defaule:/root/.treasurenet/]" \
--keyring-backend test

## Transactions payload##
{"body":{"messages":[{"@type":"/cosmos.gov.v1beta1.MsgSubmitProposal","content":{"@type":"/cosmos.params.v1beta1.ParameterChangeProposal","title":"Staking Param Change","description":"Update max validators","changes":[{"subspace":"staking","key":"MaxValidators","value":"105"}]},"initial_deposit":[{"denom":"stake","amount":"1000"}],"proposer":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg"}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[{"denom":"aunit","amount":"1000000000000000000"}],"gas_limit":"145519","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

提交社区储备资金花费提案

$ treasurenetd tx gov submit-proposal community-pool-spend /root/proposal_community.json \
--from="[name_of_your_key]" \
--chain-id="[chain-id]" \
--fees="1unit" \
--gas="auto" \
--home="[defaule:/root/.treasurenet/]" \
--keyring-backend test

## Transactions payload##
{"body":{"messages":[{"@type":"/cosmos.gov.v1beta1.MsgSubmitProposal","content":{"@type":"/cosmos.distribution.v1beta1.CommunityPoolSpendProposal","title":"Community Pool Spend","description":"Pay me some Units!","recipient":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg","amount":[{"denom":"aunit","amount":"100000000000000000000"}]},"initial_deposit":[{"denom":"aunit","amount":"1000"}],"proposer":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg"}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[{"denom":"aunit","amount":"1000000000000000000"}],"gas_limit":"163639","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

treasurenetd tx gov deposit [proposal-id][deposit] - 为活跃提案存入代币用户可以提交存款交易来资助和支持积极的提案

treasurenetd tx tx gov deposit 2 1unit
--from treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg 
--home (defaule:"/root/.treasurenet/")  
--fees 1unit 
--gas auto
--keyring-backend test

## Transactions payload##
{"body":{"messages":[{"@type":"/cosmos.gov.v1beta1.MsgDeposit","proposal_id":"2","depositor":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg","amount":[{"denom":"aunit","amount":"1000000000000000000"}]}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[{"denom":"aunit","amount":"1000000000000000000"}],"gas_limit":"125659","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

treasurenetd tx gov vote [proposal-id][option] - 投票给一个积极的提案用户可以投票给一个活跃的提案。字段的有效值"option"可以是"yes"、"no"、"no_with_veto"和"abstain"

treasurenetd tx gov vote 2 yes
--home (defaule:"/root/.treasurenet/")
--from treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg
--chain-id treasurenet_5005-1
--fees 1unit
--gas auto
--keyring-backend test

## Transactions payload##
{"body":{"messages":[{"@type":"/cosmos.gov.v1beta1.MsgVote","proposal_id":"2","voter":"treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg","option":"VOTE_OPTION_YES"}],"memo":"","timeout_height":"0","extension_options":[],"non_critical_extension_options":[]},"auth_info":{"signer_infos":[],"fee":{"amount":[{"denom":"aunit","amount":"1000000000000000000"}],"gas_limit":"104034","payer":"","granter":""}},"signatures":[]}

confirm transaction before signing and broadcasting [y/N]: y

查询

treasurenetd query gov proposals --home -o json | jq - 查询所有提案

{
  "proposals": [
    {
      "proposal_id": "1",
      "content": {
        "@type": "/cosmos.params.v1beta1.ParameterChangeProposal",
        "title": "Staking Param Change",
        "description": "Update max validators",
        "changes": [
          {
            "subspace": "staking",
            "key": "MaxValidators",
            "value": "105"
          }
        ]
      },
      "status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
      "final_tally_result": {
        "yes": "0",
        "abstain": "0",
        "no": "0",
        "no_with_veto": "0"
      },
      "submit_time": "2023-02-16T07:48:55.807762743Z",
      "deposit_end_time": "2023-02-18T07:48:55.807762743Z",
      "total_deposit": [
        {
          "denom": "stake",
          "amount": "1000"
        }
      ],
      "voting_start_time": "0001-01-01T00:00:00Z",
      "voting_end_time": "0001-01-01T00:00:00Z"
    },
    {
      "proposal_id": "2",
      "content": {
        "@type": "/cosmos.gov.v1beta1.TextProposal",
        "title": "Test Proposal",
        "description": "My awesome proposal"
      },
      "status": "PROPOSAL_STATUS_VOTING_PERIOD",
      "final_tally_result": {
        "yes": "0",
        "abstain": "0",
        "no": "0",
        "no_with_veto": "0"
      },
      "submit_time": "2023-02-16T08:02:28.455657793Z",
      "deposit_end_time": "2023-02-18T08:02:28.455657793Z",
      "total_deposit": [
        {
          "denom": "aunit",
          "amount": "11000000000000000000"
        }
      ],
      "voting_start_time": "2023-02-16T08:02:28.455657793Z",
      "voting_end_time": "2023-02-18T08:02:28.455657793Z"
    },
    {
      "proposal_id": "3",
      "content": {
        "@type": "/cosmos.distribution.v1beta1.CommunityPoolSpendProposal",
        "title": "Community Pool Spend",
        "description": "Pay me some Units!",
        "recipient": "treasurenet1wf78qmzhfsjndy3v6wsdxjfqnmwnyy2grwxmrg",
        "amount": [
          {
            "denom": "aunit",
            "amount": "100000000000000000000"
          }
        ]
      },
      "status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
      "final_tally_result": {
        "yes": "0",
        "abstain": "0",
        "no": "0",
        "no_with_veto": "0"
      },
      "submit_time": "2023-02-16T09:15:47.167996954Z",
      "deposit_end_time": "2023-02-18T09:15:47.167996954Z",
      "total_deposit": [
        {
          "denom": "aunit",
          "amount": "1000"
        }
      ],
      "voting_start_time": "0001-01-01T00:00:00Z",
      "voting_end_time": "0001-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "0"
  }
}

treasurenetd query gov proposal [proposal-id] --home --output json | jq - 通过提案的 ID 查询单个提案的详情

{
  "proposal_id": "2",
  "content": {
    "@type": "/cosmos.gov.v1beta1.TextProposal",
    "title": "Test Proposal",
    "description": "My awesome proposal"
  },
  "status": "PROPOSAL_STATUS_VOTING_PERIOD",
  "final_tally_result": {
    "yes": "0",
    "abstain": "0",
    "no": "0",
    "no_with_veto": "0"
  },
  "submit_time": "2023-02-16T08:02:28.455657793Z",
  "deposit_end_time": "2023-02-18T08:02:28.455657793Z",
  "total_deposit": [
    {
      "denom": "aunit",
      "amount": "11000000000000000000"
    }
  ],
  "voting_start_time": "2023-02-16T08:02:28.455657793Z",
  "voting_end_time": "2023-02-18T08:02:28.455657793Z"
}

treasurenetd query gov tally [proposal-id] --home -o json | jq - 获取提案投票的总数

>>>>>>> feature/1.0.1
{
  "yes": "268000000000000000000", //票数和权重成正比，权重为多少票数就是多少
  "abstain": "0",
  "no": "0",
  "no_with_veto": "0"
}

治理模块

Introduction​

相关参数​

提案的创建与投票​

提案类型​

提案流程​

交易和查询​

交易​

提交文本提案​

提交参数修改提案​

提交社区储备资金花费提案​

查询​

Introduction

相关参数

提案的创建与投票

提案类型

提案流程

交易和查询

交易

提交文本提案

提交参数修改提案

提交社区储备资金花费提案

查询