摘要
本文指定了 Cosmos SDK 的治理模块，该模块首次在 2016 年 6 月的
提案提交： 用户可以提交带有押金的提案。一旦达到最低押金，提案将进入投票期。最低押金可以通过在押金期内收集来自不同用户（包括提案人）的押金来达成。
投票： 参与者可以对已达到最低押金并进入投票期的提案进行投票。
继承与惩罚： 如果委托人没有投票，他们将继承其验证人的投票。
领取押金： 对提案进行押金的用户可以在提案被接受或拒绝后取回押金。如果提案被否决，或未进入投票期（在押金期内未达到最低押金），则押金将被销毁。
该模块已在 Cosmos Hub（即
目录
以下规范使用 ATOM 作为原生质押代币。通过将 ATOM 替换为链的原生质押代币，该模块可以适配任何权益证明（Proof-Of-Stake）区块链。
概念
免责声明：这项工作仍在进行中，机制可能会发生变化。
治理过程分为几个步骤，具体如下：
投票： 一旦押金达到一定值（MinDeposit），提案将被确认并开始投票。持有质押的 Atom 的用户可以通过发送 TxGovVote 交易来对提案进行投票。
执行： 在一段时间后，投票结果将被统计，根据结果，提案中的消息将被执行。
提案提交
提交提案的权利
每个账户都可以通过发送 MsgSubmitProposal 交易来提交提案。一旦提案提交，它将通过唯一的 proposalID 进行标识。
提案消息
提案包括一个 sdk.Msgs 数组，这些消息在提案通过后会自动执行。消息由治理 ModuleAccount 本身执行。诸如 x/upgrade 等模块，如果希望某些消息仅由治理执行，应在相应的消息服务器中添加白名单，允许治理模块在达到法定人数后执行这些消息。治理模块使用 MsgServiceRouter 来检查这些消息是否正确构造并具有相应的执行路径，但不会执行完整的有效性检查。
押金
为了防止垃圾信息，提案必须提交时附带由 MinDeposit 参数定义的押金。
当提案提交时，必须附带一个严格为正数的押金，但可以低于 MinDeposit。提案提交者不需要单独支付整个押金。新创建的提案将存储在一个非活动提案队列中，并保持在该队列中，直到其押金超过 MinDeposit。其他代币持有者可以通过发送 Deposit 交易来增加提案的押金。如果提案在押金结束时间（即不再接受押金的时间）之前没有达到 MinDeposit，则提案将被销毁：提案将从状态中删除，押金将被销毁（见 x/gov EndBlocker）。当提案押金在押金结束时间之前（即使在提案提交时）超过 MinDeposit 阈值时，提案将移入活动提案队列并开始投票期。
押金将被保存在托管账户中，并由治理 ModuleAccount 持有，直到提案被最终确认（通过或拒绝）。
押金退款与销毁
当提案最终确定时，押金的币会根据提案的最终计票结果进行退款或销毁：
如果提案被通过或拒绝但未被否决，每个押金将自动退还给各自的存款者（从治理 ModuleAccount 转账）。
当提案被否决且否决票超过三分之一时，押金将从治理 ModuleAccount 中销毁，提案信息及其押金信息将从状态中移除。
所有退款或销毁的押金都将从状态中移除。在销毁或退款押金时，将触发事件。
投票
参与者
参与者是有权对提案投票的用户。在 Cosmos Hub 上，参与者是绑定的 Atom 持有者。未绑定的 Atom 持有者和其他用户无权参与治理，但可以提交和存入提案。
请注意，当参与者同时持有绑定和未绑定的 Atom 时，他们的投票权仅根据绑定的 Atom 数量来计算
投票期
Once a proposal reaches MinDeposit, it immediately enters Voting period. We define 一旦提案达到 MinDeposit，它将立即进入投票期。我们将投票期定义为从投票开始到投票结束的时间间隔。投票期的初始值为 2 周。
选项集
提案的选项集是指参与者在投票时可以选择的选项集。
初始的选项集包括以下选项：
NoWithVeto 计作 No ，但同时也附加一个否决投票。Abstain 选项允许选民表示他们既不打算支持也不打算反对提案，但接受投票结果。
备注：在 UI 中，对于紧急提案，我们也许应该添加一个“非紧急”选项，这样可以投出 NoWithVeto 投票。
加权投票
为了在链上表示加权投票，我们使用以下 Protobuf 消息。
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1beta1/gov.proto#L34-L47
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1beta1/gov.proto#L181-L201 为了使加权投票有效，options 字段中不得包含重复的投票选项，所有选项的权重之和必须等于 1。
法定人数
法定人数定义为为了使提案结果有效，必须对其进行投票的最小投票权比例。
加速提案
可以加速提案，使提案使用更短的投票时长和默认更高的计票阈值。如果加速提案未能在较短的投票时长内满足阈值，则该提案将转换为常规提案，并在常规投票条件下重新开始投票。
阈值
阈值定义为提案接受所需的最小支持票比例（不包括弃权票）。
最初，阈值设置为 50% 的支持票，排除弃权票。如果超过 1/3 的所有投票为否决票（NoWithVeto），则存在否决的可能。注意，这两个值都来自链上的 TallyParams 参数，且可以由治理修改。这意味着，提案只有在以下条件都满足时才会被接受：
在投票结束时，支持票的比例（不包括弃权票）超过 1/2。
对于加速提案，默认情况下，阈值高于常规提案，即为 66.7%。
继承
如果委托人未投票，则会继承其验证人的投票。
如果委托人在验证人之前投票，则不会继承验证人的投票。
如果委托人在验证人之后投票，则会用自己的投票覆盖验证人的投票。如果提案是紧急的，可能会在委托人有机会反应并覆盖验证人的投票之前，投票就已经结束。对此没有问题，因为提案需要超过 2/3 的总投票权才能通过，在投票期结束时进行统计。因为即使只有 1/3 + 1 的验证人投票权也可能合谋来审查交易，已经假设这些范围超过此阈值时不存在合谋。
验证人未投票的惩罚
目前，验证人未投票不会受到惩罚。
治理地址
以后可能会添加只能由某些模块签名交易的权限密钥。对于 MVP，治理地址将是创建账户时生成的主要验证人地址。该地址对应的 PrivKey 与负责签署共识消息的 CometBFT PrivKey 不同。因此，验证人无需使用敏感的 CometBFT PrivKey 来签署治理交易。
可销毁参数
有三个参数定义了提案的存款是否应当被销毁或退还给存款人：
BurnVoteVeto：如果提案被否决，则销毁提案存款。
BurnVoteQuorum：如果提案投票未达到法定人数，则销毁提案存款。
BurnProposalDepositPrevote：如果提案未进入投票阶段，则销毁提案存款。
Note: 这些参数可以通过治理进行修改。
状态
宪法(Constitution)
宪法存储在创世状态中。它是一个字符串字段，旨在描述特定区块链的目的及其预期规范。以下是一些宪法字段可能的使用方式示例：
定义链与“物理世界”实体（如基金会或公司）之间的关系。
由于这是一个更偏向于社会功能而非技术功能的特性，我们接下来将讨论一些在创世宪法中可能有用的项目：
是否存在对治理的限制？
如果社区决定不再希望某个“大户”存在，是否可以通过治理削减其钱包？（例如：Juno 提案 4 和 16）
治理是否可以“社会性地削减”使用未经批准的 MEV（最大可提取价值）的验证人？（例如：commonwealth.im/osmosis）
在经济紧急情况下，验证人应该做什么？
2022年5月的 Terra 崩盘中，验证人选择运行一个未经治理批准的新二进制文件，因为治理代币已经被通货膨胀到几乎无价值。
链的具体目的是什么？
最好的例子是 Cosmos Hub，其中不同的创始团队对网络的目的有不同的解释。
这个创世条目“宪法”并不是为现有链设计的，现有链可能只需要通过它们的治理系统批准一份宪法。相反，这主要是为新链设计的。它将使验证人在操作节点时有一个更清晰的目的和期望。同样，对于社区成员来说，宪法将为他们提供一些关于“链团队”和验证人预期的指导。
这个宪法设计为不可变，仅在创世文件中存在，但随着时间的推移，可能会通过向 Cosmos SDK 提交拉取请求来改变，允许通过治理来修改宪法。希望修改原始宪法的社区应使用治理机制并通过“信号提案”来进行修改。
Cosmos 链宪法的理想使用场景
作为链的开发者，你决定为关键用户群体提供清晰的指导：
你使用宪法在创世文件中不可变地存储一些 Markdown 内容，以便在遇到困难问题时，宪法可以为社区提供指导。
提案(Proposals)
Proposal 对象用于统计投票结果，并跟踪提案的整体状态。它们包含一个任意 sdk.Msg 数组，Governance 模块会尝试解析并在提案通过后执行这些消息。
Proposal 通过唯一 id 进行标识，并包含一系列时间戳，以跟踪提案的生命周:submit_time：提交时间。deposit_end_time：存款截止时间。voting_start_time：投票开始时间。voting_end_time：投票结束时间。
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/gov.proto#L51-L99 一个提案通常需要的不仅仅是一组消息来解释其目的，还需要更深入的论证，并提供一个让相关参与者讨论和辩论的渠道。因此，大多数情况下，建议采用支持链上治理流程的链下系统。
为了适应这一需求，Proposal 包含一个特殊的 metadata 字段，该字段是一个字符串，可用于为提案添加背景信息。metadata 字段允许不同的网络自定义使用方式，但通常该字段应包含一个 URL，或使用 IPFS 等系统的 CID（内容标识符）。
为了支持跨网络的互操作性，SDK 建议 metadata 采用以下 JSON 模板格式：
Copy {
"title": "...",
"description": "...",
"forum": "...", // a link to the discussion platform (i.e. Discord)
"other": "..." // any extra data that doesn't correspond to the other fields
} 这样可以更方便地支持多个网络。
metadata 的最大长度由应用开发者决定，并作为配置参数传递给 gov keeper。在 SDK 中，默认的最大长度为 255 个字符。
编写使用 Governance 的模块
在区块链或各个模块中，可能会有许多需要通过 Governance 进行管理的方面，例如更改各种参数。这一过程相对简单：编写消息类型 (message types) 和 MsgServer 实现。在 keeper 中添加 authority 字段，并在构造函数中用 governance module account 进行初始化：goCopyEditgovKeeper.GetGovernanceAccount().GetAddress()。在 msg_server.go 方法中，检查消息的签名者是否与 authority 匹配，以防止未经授权的用户执行该消息。
参数和基础类型
Parameters（参数）定义了投票运行的规则。在任何时间点，系统只能有一个 Active Parameter Set（活动参数集）。如果 Governance 需要更改参数集（无论是修改参数值，还是添加/删除参数字段），则必须创建一个新的 Parameter Set，并将之前的参数集设为 Inactive（非活动）。
DepositParams
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/gov.proto#L152-L162 VotingParams
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/gov.proto#L164-L168 TallyParams
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/gov.proto#L170-L182 参数存储在全局 GlobalParams KVStore 中。
此外，我们引入了一些基础类型：
Copy type Vote byte
const (
VoteYes = 0x1
VoteNo = 0x2
VoteNoWithVeto = 0x3
VoteAbstain = 0x4
)
type ProposalType string
const (
ProposalTypePlainText = "Text"
ProposalTypeSoftwareUpgrade = "SoftwareUpgrade"
)
type ProposalStatus byte
const (
StatusNil ProposalStatus = 0x00
StatusDepositPeriod ProposalStatus = 0x01 // Proposal is submitted. Participants can deposit on it but not vote
StatusVotingPeriod ProposalStatus = 0x02 // MinDeposit is reached, participants can vote
StatusPassed ProposalStatus = 0x03 // Proposal passed and successfully executed
StatusRejected ProposalStatus = 0x04 // Proposal has been rejected
StatusFailed ProposalStatus = 0x05 // Proposal passed but failed execution
) Deposit
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/gov.proto#L38-L49 ValidatorGovInfo
此类型在计票时用于临时映射。
Copy type ValidatorGovInfo struct {
Minus sdk.Dec
Vote Vote
} 存储
:::note Stores 是 multi-store 中的 KVStores。用于查找存储的键是列表中的第一个参数。:::
我们将使用一个 KVStore Governance 来存储四种映射关系：
从 proposalID|'proposal' 映射到 Proposal。
从 proposalID|'addresses'|address 映射到 Vote。此映射允许我们通过对 proposalID:addresses 进行范围查询，以获取所有对该提案投票的地址及其投票内容。
从 ParamsKey|'Params' 映射到 Params。此映射允许查询所有 x/gov 参数。
从 VotingPeriodProposalKeyPrefix|proposalID 映射到单个字节。此映射以极低的 gas 成本判断某个提案是否处于投票期。
为了便于伪代码描述，以下是用于在存储中读写的两个函数：
load(StoreKey, Key): 在 multi-store 中，查找 StoreKey 处的 store，并检索存储在 Key 处的项目。
store(StoreKey, Key, Value): 在 multi-store 中，查找 StoreKey 处的 store，并将 Value 写入 Key 处。
提案处理队列
存储:
ProposalProcessingQueue：一个队列 queue[proposalID]，其中包含所有已达到 MinDeposit 的 ProposalID。在每个 EndBlock 期间，所有投票期已结束的提案都会被处理。处理已完成的提案时，应用程序会：统计投票结果。计算每个验证人的投票。检查验证人集合中的所有验证人是否已投票。如果提案被接受，则退还 deposit。执行提案的 content Handler。
ProposalProcessingQueue 的伪代码：
Copy in EndBlock do
for finishedProposalID in GetAllFinishedProposalIDs(block.Time)
proposal = load(Governance, <proposalID|'proposal'>) // proposal is a const key
validators = Keeper.getAllValidators()
tmpValMap := map(sdk.AccAddress)ValidatorGovInfo
// Initiate mapping at 0. This is the amount of shares of the validator's vote that will be overridden by their delegator's votes
for each validator in validators
tmpValMap(validator.OperatorAddr).Minus = 0
// Tally
voterIterator = rangeQuery(Governance, <proposalID|'addresses'>) //return all the addresses that voted on the proposal
for each (voterAddress, vote) in voterIterator
delegations = stakingKeeper.getDelegations(voterAddress) // get all delegations for current voter
for each delegation in delegations
// make sure delegation.Shares does NOT include shares being unbonded
tmpValMap(delegation.ValidatorAddr).Minus += delegation.Shares
proposal.updateTally(vote, delegation.Shares)
_, isVal = stakingKeeper.getValidator(voterAddress)
if (isVal)
tmpValMap(voterAddress).Vote = vote
tallyingParam = load(GlobalParams, 'TallyingParam')
// Update tally if validator voted
for each validator in validators
if tmpValMap(validator).HasVoted
proposal.updateTally(tmpValMap(validator).Vote, (validator.TotalShares - tmpValMap(validator).Minus))
// Check if proposal is accepted or rejected
totalNonAbstain := proposal.YesVotes + proposal.NoVotes + proposal.NoWithVetoVotes
if (proposal.Votes.YesVotes/totalNonAbstain > tallyingParam.Threshold AND proposal.Votes.NoWithVetoVotes/totalNonAbstain < tallyingParam.Veto)
// proposal was accepted at the end of the voting period
// refund deposits (non-voters already punished)
for each (amount, depositor) in proposal.Deposits
depositor.AtomBalance += amount
stateWriter, err := proposal.Handler()
if err != nil
// proposal passed but failed during state execution
proposal.CurrentStatus = ProposalStatusFailed
else
// proposal pass and state is persisted
proposal.CurrentStatus = ProposalStatusAccepted
stateWriter.save()
else
// proposal was rejected
proposal.CurrentStatus = ProposalStatusRejected
store(Governance, <proposalID|'proposal'>, proposal) 旧版提案(Legacy Proposal)
:::warnin 旧版提案已被弃用。请使用新的提案流程，并授予治理模块执行消息的权限。 :::
Legacy Proposal 是治理提案的旧实现方式。与可以包含任意消息的现代 Proposal 相比，Legacy Proposal 仅允许提交一组预定义的提案类型。这些提案由特定类型定义，并由 gov v1beta1 路由器中注册的处理程序（Handlers）处理。
消息
提案提交
任何账户都可以通过 MsgSubmitProposal 交易提交提案。
所有传递到 MsgSubmitProposal 消息的 sdk.Msgs 必须在应用的 MsgServiceRouter 中注册。这些消息必须有一个签名者，即 gov 模块账户。最后，metadata 的长度不得超过传递给 gov keeper 的 maxMetadataLen 配置值。initialDeposit 必须是严格正数，并符合 MinDeposit 参数的接受 denom。
状态修改：
从发送者账户减少 InitialDeposit 的余额。
如果达到了 MinDeposit：
将 proposalID 推送到 ProposalProcessingQueue。
将 InitialDeposit 从提案者转移到治理模块账户 ModuleAccount。
存款
一旦提案提交，如果 Proposal.TotalDeposit 小于 ActiveParam.MinDeposit，ATOM 持有者可以通过发送 MsgDeposit 交易来增加提案的存款。
存款被接受的条件是：
存入的硬币符合 MinDeposit 参数接受的 denom
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/tx.proto#L134-L147 状态修改：
将发送者的存款添加到 proposal.Deposits 中
增加 proposal.TotalDeposit，加入发送者的存款
如果达到了 MinDeposit：
将 proposalID 推送到 ProposalProcessingQueueEnd
将存款从提案者转移到治理模块账户 ModuleAccount
投票
一旦达到了 ActiveParam.MinDeposit，投票期开始。从此，已绑定的 Atom 持有者可以发送 MsgVote 交易，对提案进行投票。
Copy https://github.com/cosmos/cosmos-sdk/blob/v0.47.0-rc1/proto/cosmos/gov/v1/tx.proto#L92-L108 状态修改 ：
:::note 该消息的燃气费用必须考虑到在 EndBlocker 中对投票的后续统计。:::
事件
治理模块会触发以下事件：
EndBlocker
Handlers
MsgSubmitProposal
[0] 仅当投票期在提交过程中开始时，才会触发该事件。
MsgVote
MsgVoteWeighted
MsgDeposit
[0] 只有在提交过程中投票期开始时，才会触发该事件。
参数
治理模块包含以下参数：
[{"denom":"uatom","amount":"10000000"}]
"172800000000000" (17280s)
"172800000000000" (17280s)
[{"denom":"uatom","amount":"50000000"}]
burn_proposal_deposit_prevote
min_initial_deposit_ratio
NOTE : 治理模块包含与其他模块不同的对象类型参数。如果只希望更改部分参数，只需要包含这些参数，而不必包含整个参数对象结构。
客户端
CLI
用户可以使用CLI查询和与gov模块交互。
Query
查询命令允许用户查询 gov 状态。
Copy simd query gov --help deposit
deposit 命令允许用户查询来自特定存款人的特定提案的存款。
Copy simd query gov deposit [proposal-id] [depositer-addr] [flags] 示例:
Copy simd query gov deposit 1 cosmos1.. 示例输出:
Copy amount:
- amount: "100"
denom: stake
depositor: cosmos1..
proposal_id: "1" deposits
The deposits 命令允许用户查询特定提案的所有存款。
Copy simd query gov deposits [proposal-id] [flags] 示例:
Copy simd query gov deposits 1 示例输出:
Copy deposits:
- amount:
- amount: "100"
denom: stake
depositor: cosmos1..
proposal_id: "1"
pagination:
next_key: null
total: "0" param
param 命令允许用户查询 gov 模块的特定参数。
Copy simd query gov param [param-type] [flags] 示例:
Copy simd query gov param voting 示例输出:
Copy voting_period: "172800000000000" params
params 命令允许用户查询 gov 模块的所有参数。
Copy simd query gov params [flags] 示例:
Copy simd query gov params 示例输出:
Copy deposit_params:
max_deposit_period: 172800s
min_deposit:
- amount: "10000000"
denom: stake
params:
expedited_min_deposit:
- amount: "50000000"
denom: stake
expedited_threshold: "0.670000000000000000"
expedited_voting_period: 86400s
max_deposit_period: 172800s
min_deposit:
- amount: "10000000"
denom: stake
min_initial_deposit_ratio: "0.000000000000000000"
proposal_cancel_burn_rate: "0.500000000000000000"
quorum: "0.334000000000000000"
threshold: "0.500000000000000000"
veto_threshold: "0.334000000000000000"
voting_period: 172800s
tally_params:
quorum: "0.334000000000000000"
threshold: "0.500000000000000000"
veto_threshold: "0.334000000000000000"
voting_params:
voting_period: 172800s proposal
proposal 命令允许用户查询指定的提案。
Copy simd query gov proposal [proposal-id] [flags] 示例:
Copy simd query gov proposal 1 示例输出:
Copy deposit_end_time: "2022-03-30T11:50:20.819676256Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "1"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T11:50:20.819676256Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: null proposals
proposals 命令允许用户查询所有提案，并可选择使用过滤器进行筛选。
Copy simd query gov proposals [flags] 示例:
Copy simd query gov proposals 示例输出:
Copy pagination:
next_key: null
total: "0"
proposals:
- deposit_end_time: "2022-03-30T11:50:20.819676256Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "1"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T11:50:20.819676256Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: null
- deposit_end_time: "2022-03-30T14:02:41.165025015Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "2"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T14:02:41.165025015Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: null proposer
proposer 命令允许用户查询特定提案的提案人。
Copy simd query gov proposer [proposal-id] [flags] 示例:
Copy simd query gov proposer 1 示例输出:
Copy proposal_id: "1"
proposer: cosmos1.. tally
tally 命令允许用户查询特定提案投票的计票结果。
Copy simd query gov tally [proposal-id] [flags] 示例:
Copy simd query gov tally 1 示例输出:
Copy abstain: "0"
"no": "0"
no_with_veto: "0"
"yes": "1" vote
vote 命令允许用户查询特定提案的投票记录。
Copy simd query gov vote [proposal-id] [voter-addr] [flags] 示例:
Copy simd query gov vote 1 cosmos1.. 示例输出:
Copy option: VOTE_OPTION_YES
options:
- option: VOTE_OPTION_YES
weight: "1.000000000000000000"
proposal_id: "1"
voter: cosmos1.. votes
votes 命令允许用户查询特定提案的所有投票记录。
Copy simd query gov votes [proposal-id] [flags] 示例:
Copy simd query gov votes 1 示例输出:
Copy pagination:
next_key: null
total: "0"
votes:
- option: VOTE_OPTION_YES
options:
- option: VOTE_OPTION_YES
weight: "1.000000000000000000"
proposal_id: "1"
voter: cosmos1.. Transactions
tx 命令允许用户与 gov 模块交互。
deposit
deposit 命令允许用户为指定提案存入代币。
Copy simd tx gov deposit [proposal-id] [deposit] [flags] 示例:
Copy simd tx gov deposit 1 10000000stake --from cosmos1.. draft-proposal
Copy simd tx gov draft-proposal submit-proposal
submit-proposal 命令允许用户提交一个治理提案，并附带一些消息和元数据。消息、元数据和存款信息都在一个 JSON 文件中定义。
Copy simd tx gov submit-proposal [path-to-proposal-json] [flags] 示例:
Copy simd tx gov submit-proposal /path/to/proposal.json --from cosmos1.. proposal.json 文件包含以下内容：
Copy {
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1...", // The gov module module address
"to_address": "cosmos1...",
"amount":[{"denom": "stake","amount": "10"}]
}
],
"metadata": "AQ==",
"deposit": "10stake",
"title": "Proposal Title",
"summary": "Proposal Summary"
} :::note 默认情况下，metadata、summary 和 title 的字符限制为 255 个字符，但可以通过应用程序开发者进行覆盖。 :::
:::tip 当未指定 metadata 时，title 的字符限制为 255 个字符，而 summary 的字符数限制为 title 长度的 40 倍。 :::
submit-legacy-proposal
submit-legacy-proposal 命令允许用户提交治理遗留提案，并附带初始存款。
Copy simd tx gov submit-legacy-proposal [command] [flags] 示例:
Copy simd tx gov submit-legacy-proposal --title="Test Proposal" --description="testing" --type="Text" --deposit="100000000stake" --from cosmos1.. 示例 (param-change):
Copy simd tx gov submit-legacy-proposal param-change proposal.json --from cosmos1..
Copy {
"title": "Test Proposal",
"description": "testing, testing, 1, 2, 3",
"changes": [
{
"subspace": "staking",
"key": "MaxValidators",
"value": 100
}
],
"deposit": "10000000stake"
} cancel-proposal
一旦提案被取消，从提案的存款中，deposits * proposal_cancel_ratio 将被销毁或发送到 ProposalCancelDest 地址。如果 ProposalCancelDest 为空，则存款将被销毁。剩余的存款将返回给存款人。
Copy simd tx gov cancel-proposal [proposal-id] [flags] 示例:
Copy simd tx gov cancel-proposal 1 --from cosmos1... vote
vote 命令允许用户对给定的治理提案提交投票。
Copy simd tx gov vote [command] [flags] 示例:
Copy simd tx gov vote 1 yes --from cosmos1.. weighted-vote
weighted-vote 命令允许用户对给定的治理提案提交加权投票。
Copy simd tx gov weighted-vote [proposal-id] [weighted-options] [flags] 示例:
Copy simd tx gov weighted-vote 1 yes=0.5,no=0.5 --from cosmos1.. gRPC
用户可以使用 gRPC 端点查询 gov 模块。
Proposal
TProposal 端点允许用户查询给定的提案。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Proposal 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Proposal 示例输出:
Copy {
"proposal": {
"proposalId": "1",
"content": {"@type":"/cosmos.gov.v1beta1.TextProposal","description":"testing, testing, 1, 2, 3","title":"Test Proposal"},
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2021-09-16T19:40:08.712440474Z",
"depositEndTime": "2021-09-18T19:40:08.712440474Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"votingStartTime": "2021-09-16T19:40:08.712440474Z",
"votingEndTime": "2021-09-18T19:40:08.712440474Z",
"title": "Test Proposal",
"summary": "testing, testing, 1, 2, 3"
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Proposal 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/Proposal 示例输出:
Copy {
"proposal": {
"id": "1",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ==",
"title": "Test Proposal",
"summary": "testing, testing, 1, 2, 3"
}
} Proposals
Proposals 端点允许用户查询所有提案，并可选择使用过滤器。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Proposals 示例:
Copy grpcurl -plaintext \
localhost:9090 \
cosmos.gov.v1beta1.Query/Proposals 示例输出:
Copy {
"proposals": [
{
"proposalId": "1",
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z"
},
{
"proposalId": "2",
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2022-03-28T14:02:41.165025015Z",
"depositEndTime": "2022-03-30T14:02:41.165025015Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10"
}
],
"votingStartTime": "0001-01-01T00:00:00Z",
"votingEndTime": "0001-01-01T00:00:00Z"
}
],
"pagination": {
"total": "2"
}
}
使用 v1:
Copy cosmos.gov.v1.Query/Proposals 示例:
Copy grpcurl -plaintext \
localhost:9090 \
cosmos.gov.v1.Query/Proposals 示例输出:
Copy {
"proposals": [
{
"id": "1",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ==",
"title": "Proposal Title",
"summary": "Proposal Summary"
},
{
"id": "2",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T14:02:41.165025015Z",
"depositEndTime": "2022-03-30T14:02:41.165025015Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10"
}
],
"metadata": "AQ==",
"title": "Proposal Title",
"summary": "Proposal Summary"
}
],
"pagination": {
"total": "2"
}
} Vote
Vote 端点允许用户查询给定提案的投票。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Vote 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1","voter":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Vote 示例输出:
Copy {
"vote": {
"proposalId": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1000000000000000000"
}
]
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Vote 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1","voter":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1.Query/Vote 示例输出:
Copy {
"vote": {
"proposalId": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
} Votes
Votes 端点允许用户查询给定提案的所有投票。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Votes 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Votes 示例输出:
Copy {
"votes": [
{
"proposalId": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1000000000000000000"
}
]
}
],
"pagination": {
"total": "1"
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Votes 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/Votes 示例输出:
Copy {
"votes": [
{
"proposalId": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
],
"pagination": {
"total": "1"
}
} Params
Params 端点允许用户查询 gov 模块的所有参数。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Params 示例:
Copy grpcurl -plaintext \
-d '{"params_type":"voting"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Params 示例输出:
Copy {
"votingParams": {
"votingPeriod": "172800s"
},
"depositParams": {
"maxDepositPeriod": "0s"
},
"tallyParams": {
"quorum": "MA==",
"threshold": "MA==",
"vetoThreshold": "MA=="
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Params 示例 :
Copy grpcurl -plaintext \
-d '{"params_type":"voting"}' \
localhost:9090 \
cosmos.gov.v1.Query/Params 示例输出:
Copy {
"votingParams": {
"votingPeriod": "172800s"
}
} Deposit
Deposit 端点允许用户查询给定存款人针对给定提案的存款。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Deposit 示例:
Copy grpcurl -plaintext \
'{"proposal_id":"1","depositor":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Deposit 示例输出:
Copy {
"deposit": {
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Deposit 示例:
Copy grpcurl -plaintext \
'{"proposal_id":"1","depositor":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1.Query/Deposit 示例输出:
Copy {
"deposit": {
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
} deposits
Deposits 端点允许用户查询给定提案的所有存款。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/Deposits 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/Deposits 示例输出:
Copy {
"deposits": [
{
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"total": "1"
}
} 使用 v1:
Copy cosmos.gov.v1.Query/Deposits 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/Deposits 示例输出:
Copy {
"deposits": [
{
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"total": "1"
}
} TallyResult
TallyResult 端点允许用户查询给定提案的计票结果。
使用遗留的 v1beta1：
Copy cosmos.gov.v1beta1.Query/TallyResult 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/TallyResult 示例输出:
Copy {
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
}
} 使用 v1:
Copy cosmos.gov.v1.Query/TallyResult 示例:
Copy grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/TallyResult 示例输出:
Copy {
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
}
} REST
用户可以使用 REST 端点查询 gov 模块。
proposal
proposals 端点允许用户查询给定的提案。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id} 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1 示例输出:
Copy {
"proposal": {
"proposal_id": "1",
"content": null,
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z"
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id} 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals/1 示例输出:
Copy {
"proposal": {
"id": "1",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ==",
"title": "Proposal Title",
"summary": "Proposal Summary"
}
} proposals
proposals 端点还允许用户查询所有提案，并可选择使用过滤器。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals 示例输出:
Copy {
"proposals": [
{
"proposal_id": "1",
"content": null,
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z"
},
{
"proposal_id": "2",
"content": null,
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T14:02:41.165025015Z",
"deposit_end_time": "2022-03-30T14:02:41.165025015Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10"
}
],
"voting_start_time": "0001-01-01T00:00:00Z",
"voting_end_time": "0001-01-01T00:00:00Z"
}
],
"pagination": {
"next_key": null,
"total": "2"
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals 示例输出:
Copy {
"proposals": [
{
"id": "1",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ==",
"title": "Proposal Title",
"summary": "Proposal Summary"
},
{
"id": "2",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T14:02:41.165025015Z",
"deposit_end_time": "2022-03-30T14:02:41.165025015Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10"
}
],
"voting_start_time": null,
"voting_end_time": null,
"metadata": "AQ==",
"title": "Proposal Title",
"summary": "Proposal Summary"
}
],
"pagination": {
"next_key": null,
"total": "2"
}
} voter vote
votes 端点允许用户查询给定提案的投票。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter} 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1/votes/cosmos1.. 示例输出:
Copy {
"vote": {
"proposal_id": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id}/votes/{voter} 示例：
Copy curl localhost:1317/cosmos/gov/v1/proposals/1/votes/cosmos1.. 示例输出:
Copy {
"vote": {
"proposal_id": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
],
"metadata": ""
}
} votes
votes 端点允许用户查询给定提案的所有投票。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id}/votes 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1/votes 示例输出:
Copy {
"votes": [
{
"proposal_id": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id}/votes 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals/1/votes 示例输出:
Copy {
"votes": [
{
"proposal_id": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
],
"metadata": ""
}
],
"pagination": {
"next_key": null,
"total": "1"
}
} params
params 端点允许用户查询 gov 模块的所有参数。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/params/{params_type} 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/params/voting 示例输出:
Copy {
"voting_params": {
"voting_period": "172800s"
},
"deposit_params": {
"min_deposit": [
],
"max_deposit_period": "0s"
},
"tally_params": {
"quorum": "0.000000000000000000",
"threshold": "0.000000000000000000",
"veto_threshold": "0.000000000000000000"
}
} 使用 v1:
Copy /cosmos/gov/v1/params/{params_type} 示例:
Copy curl localhost:1317/cosmos/gov/v1/params/voting 示例输出:
Copy {
"voting_params": {
"voting_period": "172800s"
},
"deposit_params": {
"min_deposit": [
],
"max_deposit_period": "0s"
},
"tally_params": {
"quorum": "0.000000000000000000",
"threshold": "0.000000000000000000",
"veto_threshold": "0.000000000000000000"
}
} deposits
deposits 端点允许用户查询给定存款人针对给定提案的存款。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor} 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1/deposits/cosmos1.. 示例输出:
Copy {
"deposit": {
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id}/deposits/{depositor} 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals/1/deposits/cosmos1.. 示例输出:
Copy {
"deposit": {
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
} proposal deposits
deposits 端点允许用户查询给定提案的所有存款。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1/deposits 示例输出:
Copy {
"deposits": [
{
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id}/deposits 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals/1/deposits 示例输出:
Copy {
"deposits": [
{
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
} tally
tally 端点允许用户查询给定提案的计票结果。
使用遗留的 v1beta1：
Copy /cosmos/gov/v1beta1/proposals/{proposal_id}/tally 示例:
Copy curl localhost:1317/cosmos/gov/v1beta1/proposals/1/tally 示例输出:
Copy {
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
}
} 使用 v1:
Copy /cosmos/gov/v1/proposals/{proposal_id}/tally 示例:
Copy curl localhost:1317/cosmos/gov/v1/proposals/1/tally 示例输出:
Copy {
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
}
} 元数据
gov 模块有两个元数据位置，用户可以在这些位置提供有关其链上操作的进一步上下文。默认情况下，所有元数据字段的长度为 255 个字符，可以以 JSON 格式存储元数据，具体存储在链上或链外，取决于所需的数据量。在这里，我们提供了关于 JSON 结构的建议以及数据应存储的位置。在做出这些建议时，有两个重要因素。首先，gov 和 group 模块之间需要保持一致，注意所有组所提出的提案数量可能非常庞大。其次，客户端应用程序，如区块浏览器和治理界面，需要对跨链元数据结构的一致性有信心。
提案
Copy {
"title": "",
"authors": [""],
"summary": "",
"details": "",
"proposal_forum_url": "",
"vote_option_context": "",
} :::note authors 字段是一个字符串数组，用于允许在元数据中列出多个作者。在 v0.46 中，authors 字段是一个逗号分隔的字符串。前端建议支持这两种格式，以确保向后兼容。:::
投票
Copy {
"justification": "",
} 未来改进
当前位置文档仅描述了治理模块的最小可行产品。未来的改进可能包括：
BountyProposals ：如果接受，BountyProposal 创建一个开放的赏金任务。BountyProposal 指定完成任务后将提供多少 Atoms，这些 Atoms 将从储备池中提取。在 BountyProposal 被治理接受后，任何人都可以提交一个 SoftwareUpgradeProposal，该提案包含代码以领取赏金。请注意，一旦 BountyProposal 被接受，储备池中的相应资金将被锁定，以确保支付始终得到履行。为了将 SoftwareUpgradeProposal 与一个开放的赏金任务关联，SoftwareUpgradeProposal 的提交者将使用 Proposal.LinkedProposal 属性。如果与开放赏金任务关联的 SoftwareUpgradeProposal 被治理接受，保留的资金将自动转移给提交者。
复杂委托 ：委托者可以选择除其验证者之外的其他代表。最终，代表链将始终以验证者为终点，但委托者可以在继承验证者投票之前继承其选定代表的投票。换句话说，只有当他们指定的其他代表没有投票时，他们才会继承验证者的投票。
更好的提案审查流程 ：proposal.Deposit 将分为两部分，一部分用于防止垃圾邮件（与 MVP 中相同），另一部分用于奖励第三方审计员。
