许多提案允许包含长文本,通常放在 description 键下。如果格式正确,这些内容可以包含 Markdown 语法,也可以通过 \n 实现换行。 但请注意,如果你使用命令行工具创建提案,并通过标志设置 description,文本会被转义,这可能会产生不希望出现的效果。 格式化提案往往需要反复试验,因此建议先提交到测试网。 下面展示的示例,是打包到 json 文件中并随 submit-proposal 交易上链发送的文本。关于如何提交提案的更多细节,请参阅提交治理提案一节;这里你只需要知道,这些示例展示的是一个独立于交易本身的文件内容。一般来说,提案特有的任何标志(例如标题、描述、押金、参数、接收地址)都可以放在 json 文件中,而适用于任意交易的通用标志(例如 chain-id、node-id、gas、fees)则可以保留在命令行工具中。

文本提案

文本提案用于让委托人就某项策略、计划、承诺、未来升级,或任何其他文本形式的声明达成共识。除了在 Cosmos Hub 链上留下提案结果记录外,文本提案本身不会直接对 Cosmos Hub 产生变更。 共有四个组成部分:
  1. 标题 - 提案的标识名称,通常也是区块浏览器列出提案时使用的名称
  2. 摘要 - 提案正文,用于进一步说明提议的内容以及提案相关细节
  3. 押金 - 从提交提案的账户中支付到押金中的金额(以微 ATOM,即 uatom 计)
  4. 元数据 - 通常是一个链下资源的链接

真实示例

提案 12 询问 Cosmos Hub 社区中收取 0% 佣金的验证人,是否会损害 Cosmos Hub 的成功。 你可以使用 gaiad tx gov draft-proposal 并选择 text 来创建提案文件。 你必须使用 gaiad tx gov submit-proposal <path_to_text_proposal.json> 提交该提案。
{
  "title": "Are Validators Charging 0% Commission Harmful to the Success of the Cosmos Hub?",
  "summary": "This governance proposal is intended to act purely as a signalling proposal. Throughout this history of the Cosmos Hub, there has been much debate about the impact that validators charging 0% commission has on the Cosmos Hub, particularly with respect to the decentralization of the Cosmos Hub and the sustainability for validator operations. Discussion around this topic has taken place in many places including numerous threads on the Cosmos Forum, public Telegram channels, and in-person meetups. Because this has been one of the primary discussion points in off-chain Cosmos governance discussions, we believe it is important to get a signal on the matter from the on-chain governance process of the Cosmos Hub. There have been past discussions on the Cosmos Forum about placing an in-protocol restriction on validators from charging 0% commission. https://forum.cosmos.network/t/governance-limit-validators-from-0-commission-fee/2182 This proposal is NOT proposing a protocol-enforced minimum. It is merely a signalling proposal to query the viewpoint of the bonded Atom holders as a whole. We encourage people to discuss the question behind this governance proposal in the associated Cosmos Hub forum post here: https://forum.cosmos.network/t/proposal-are-validators-charging-0-commission-harmful-to-the-success-of-the-cosmos-hub/2505 Also, for voters who believe that 0% commission rates are harmful to the network, we encourage optionally sharing your belief on what a healthy minimum commission rate for the network using the memo field of their vote transaction on this governance proposal or linking to a longer written explanation such as a Forum or blog post. The question on this proposal is “Are validators charging 0% commission harmful to the success of the Cosmos Hub?”. A Yes vote is stating that they ARE harmful to the network's success, and a No vote is a statement that they are NOT harmful.",
  "deposit": "100000uatom",
  "metadata": "ipfs://CID",
}

社区资金池支出

共有五(5)个组成部分:
  1. 标题 - 提案的标识名称,通常也是区块浏览器列出提案时使用的名称
  2. 摘要 - 提案正文,用于进一步说明提议的内容以及提案相关细节
  3. 接收地址 - 将从社区资金池获得资金的 Cosmos Hub(基于 bech32 的)地址
  4. 金额 - 接收方将收到的资金数量,以微 ATOM(uatom)计
  5. 押金 - 从提交提案的账户中支付到押金中的金额(以微 ATOM,即 uatom 计)
如果描述中写明某个地址将收到一定数量的 ATOM,那么提案程序也应该确实按这个方式执行;但实际上也可能并非如此(无论是无意还是其他原因)。请检查描述内容是否与 recipient 地址一致。

真实示例

amount 为 1000000000uatom。1,000,000 微 ATOM 等于 1 ATOM,因此如果该提案通过,recipient 地址 cosmos1xf2qwf6g6xvuttpf37xwrgp08qq984244952ze 将收到 1000 ATOM。 deposit": "1000000uatom 会导致从提案提交者的账户中使用 1 ATOM。 你可以使用 gaiad tx gov draft-proposal 工具,并选择 /cosmos.distribution.v1beta1.MsgCommunityPoolSpend 来创建提案草稿文件。 你必须使用 gaiad tx gov submit-proposal <path_to_proposal_file.json> 提交该提案。该提案不能使用 submit-legacy-proposal 提交。
{
  "messages":[
    {
  "@type": "/cosmos.distribution.v1beta1.MsgCommunityPoolSpend",
  "authority": "cosmos10d07y265gmmuvt4z0w9aw880jnsr700j6zn9kn",
  "recipient": "cosmos00af8sd0a9dfansdfoiasf0a9ssd9fa09i99990",
  "amount": [{
  "denom": "uatom",
  "amount": "10000000000"
    }]
    }
  ],
  "deposit": "100000uatom",
  "proposer": "cosmos12xpdapokdfpsodf32das75sokdaadapsokd1sa",
  "metadata": "Community Pool Spend Proposal Example",
  "title": "Activate governance discussions on the Discourse forum using community pool funds",
  "summary": "## Summary\nProposal to request for 1000 ATOM from the community spending pool to be sent to a multisig who will put funds towards stewardship of the Discourse forum to make it an authoritative record of governance decisions as well as a vibrant space to draft and discuss proposals.\n## Details\nWe are requesting 1000 ATOM from the community spending pool to activate and steward the Cosmos Hub (Discourse) forum for the next six months.\n\nOff-chain governance conversations are currently highly fragmented, with no shared public venue for discussing proposals as they proceed through the process of being drafted and voted on. It means there is no record of discussion that voters can confidently point to for context, potentially leading to governance decisions becoming delegitimized by stakeholders.\n\nThe requested amount will be sent to a multisig comprising individuals (members listed below) who can ensure that the tokens are spent judiciously. We believe stewardship of the forum requires:\n\n* **Moderation**: Format, edit, and categorize posts; Standardize titles and tags; Monitor and approve new posts; Archive posts.\n* **Facilitation**: Ask clarifying questions in post threads; Summarize discussions; Provide historical precedence to discussions.\n* **Engagement**: Circulate important posts on other social channels to increase community participation; Solicit input from key stakeholders.\n* **Guidance**: Orient and assist newcomers; Guide proposers through governance process; Answer questions regarding the forum or Cosmos ecosystem.\nThe work to steward the forum will be carried out by members of [Hypha Worker Co-op](https://hypha.coop/) and individuals selected from the community to carry out scoped tasks in exchange for ATOM from this budget.\n## Multisig Members\n* Hypha: Mai Ishikawa Sutton (Hypha Co-op)\n* Validator: Daniel Hwang (Stakefish)\n* Cosmos Hub developer: Lauren Gallinaro (Interchain Berlin)\n\nWe feel the membership of the multisig should be rotated following the six-month pilot period to preserve insight from the distinct specializations (i.e., Cosmos Hub validators and developers).\n## Timeline and Deliverables\nWe estimate the total work to take 250-300 hours over six months where we hope to produce:\n* **Moving summaries:** Provide succinct summaries of the proposals and include all publicly stated reasons why various entities are choosing to vote for/against a given proposal. These summaries will be written objectively, not siding with any one entity.\n* **Validator platforms:** Create a section of the Forum where we collate all validators' visions for Cosmos Hub governance to allow them to state their positions publicly. We will work with the smaller validators to ensure they are equally represented.\n* **Regular check-ins with the Cosmonaut DAO:** Collaborate with the future Cosmonaut DAO to ensure maximal accessibility and engagement. Community management is a critical, complementary aspect of increasing participation in governance.\n* **Announcement channel:** Create a read-only announcement channel in the Cosmos Community Discord, so that new proposals and major discussions can be easily followed.\n* **Tooling friendly posts:** Tag and categorize posts so that they can be easily ingested into existing tooling that validators have setup.\n* **Neutral moderation framework:** Document and follow transparent standards for how the forum is moderated.\n\nAt the end of the period, we will produce a report reflecting on our successes and failures, and recommendations for how the work of maintaining a governance venue can be continuously sustained (e.g., through a DAO). We see this initiative as a process of discovery, where we are learning by doing.\n\nFor more context, you can read through the discussions on this [proposal on the Discourse forum](https://forum.cosmos.network/t/proposal-draft-activate-governance-discussions-on-the-discourse-forum-using-community-pool-funds/5833).\n\n## Governance Votes\nThe following items summarize the voting options and what it means for this proposal:\n**YES** - You approve this community spend proposal to deposit 1000 ATOM to a multisig that will spend them to improve governance discussions in the Discourse forum.\n**NO** - You disapprove of this community spend proposal in its current form (please indicate why in the Cosmos Forum).\n**NO WITH VETO** - You are strongly opposed to this change and will exit the network if passed.\n**ABSTAIN** - You are impartial to the outcome of the proposal.\n## Recipient\ncosmos1xf2qwf6g6xvuttpf37xwrgp08qq984244952ze\n## Amount\n1000 ATOM\n\n***Disclosure**: Hypha has an existing contract with the Interchain Foundation focused on the testnet program and improving documentation. This work is beyond the scope of that contract and is focused on engaging the community in governance.*\n\nIPFS pin of proposal on-forum: (https://ipfs.io/ipfs/Qmaq7ftqWccgYCo8U1KZfEnjvjUDzSEGpMxcRy61u8gf2Y)",
}

旧版参数变更

旧版参数变更提案不适用于 cosmos-sdk 模块。你可以使用 submit-legacy-proposal 更新这些 CosmosHub 模块:
  • ibc(transfer、interchain-accounts)
  • provider
注意: 此处说明的变更必须使用 submit-legacy-proposal 提交。 对于 param-change 提案,可以认为它大致包含七个组成部分,其中有三个嵌套在“Changes”之下:
  1. Title - 提案的标识名称,通常也是区块浏览器列出提案时显示的名称
  2. Description - 提案正文,进一步说明要提议的内容以及与该提案相关的细节
  3. Changes - 一个包含以下内容的组成部分
  4. Subspace - 包含将被修改参数的 Cosmos Hub 模块
  5. Key - 将被修改的参数
  6. Value - 该参数将通过治理机制被修改后的值
  7. Deposit - 提交提案的账户将贡献到押金中的数量(以微 ATOM,即 uatom 为单位)
这些组成部分必须按照示例中的方式呈现。
要更新任何 cosmos-sdk 模块,你必须使用 gaiad tx gov submit-proposal,并提供一个格式正确且包含 MsgUpdateParams 的提案文件。使用 MsgUpdateParams 时请注意,所有 字段都必须始终显式指定(PUT 语义)。请务必小心,避免意外提交一个修改了超出预期参数范围的提案。 对于你不想修改的参数,可以直接从现有模块参数中复制。

真实示例

这个示例是“真实”的,因为它已经通过 Theta 测试网上链,并且可以查看到。 并非所有区块浏览器都会显示提案中编码的参数变更,因此请务必核对说明文本是否与该治理提案实际会执行的内容一致。如果说明写的是某个参数将被提高,那么程序上也应该如此设置;但实际上也可能并非如此(无论是无意还是其他原因)。
{
  "title": "Doc update test: Param change for transfer/SendEnabled",
  "description": "Testing the proposal format for enabling IBC transfers on our chain",
  "changes": [
    {
      "subspace": "transfer",
      "key": "transfer",
      "value": true
    }
  ],
  "deposit": "100000uatom"
}

Many proposals allow for long form text to be included, usually under the key description. These provide the opportunity to include markdown if formatted correctly, as well as line breaks with \n. Beware, however, that if you are using the CLI to create a proposal, and setting description using a flag, the text will be escaped which may have undesired effects. Formatting a proposal can be a trial-and-error process, which is why first submitting to the testnet is recommended. The examples shown below are of the text in a json file packaged into a submit-proposal transaction sent on-chain. More details about how to submit a proposal are in the Submitting a Governance Proposal section, but for now just be aware that the examples are the contents of a file separate from the transaction. As a general rule, any flags specific to a proposal (e.g., Title, description, deposit, parameters, recipient) can be placed in a json file, while flags general to a transaction of any kind (e.g., chain-id, node-id, gas, fees) can remain in the CLI.

Text

Text proposals are used by delegators to agree to a certain strategy, plan, commitment, future upgrade, or any other statement in the form of text. Aside from having a record of the proposal outcome on the Cosmos Hub chain, a text proposal has no direct effect on the change Cosmos Hub. There are four components:
  1. Title - the distinguishing name of the proposal, typically the way that explorers list proposals
  2. Summary - the body of the proposal that further describes what is being proposed and details surrounding the proposal
  3. Deposit - the amount that will be contributed to the deposit (in micro-ATOMs “uatom”) from the account submitting the proposal
  4. Metadata - usually a link to an off-chain resource

Real example

Proposal 12 asked if the Cosmos Hub community of validators charging 0% commission was harmful to the success of the Cosmos Hub. You can use gaiad tx gov draft-proposal and choose text to create the proposal file. You must submit the proposal using gaiad tx gov submit-proposal <path_to_text_proposal.json>.
{
  "title": "Are Validators Charging 0% Commission Harmful to the Success of the Cosmos Hub?",
  "summary": "This governance proposal is intended to act purely as a signalling proposal. Throughout this history of the Cosmos Hub, there has been much debate about the impact that validators charging 0% commission has on the Cosmos Hub, particularly with respect to the decentralization of the Cosmos Hub and the sustainability for validator operations. Discussion around this topic has taken place in many places including numerous threads on the Cosmos Forum, public Telegram channels, and in-person meetups. Because this has been one of the primary discussion points in off-chain Cosmos governance discussions, we believe it is important to get a signal on the matter from the on-chain governance process of the Cosmos Hub. There have been past discussions on the Cosmos Forum about placing an in-protocol restriction on validators from charging 0% commission. https://forum.cosmos.network/t/governance-limit-validators-from-0-commission-fee/2182 This proposal is NOT proposing a protocol-enforced minimum. It is merely a signalling proposal to query the viewpoint of the bonded Atom holders as a whole. We encourage people to discuss the question behind this governance proposal in the associated Cosmos Hub forum post here: https://forum.cosmos.network/t/proposal-are-validators-charging-0-commission-harmful-to-the-success-of-the-cosmos-hub/2505 Also, for voters who believe that 0% commission rates are harmful to the network, we encourage optionally sharing your belief on what a healthy minimum commission rate for the network using the memo field of their vote transaction on this governance proposal or linking to a longer written explanation such as a Forum or blog post. The question on this proposal is “Are validators charging 0% commission harmful to the success of the Cosmos Hub?”. A Yes vote is stating that they ARE harmful to the network's success, and a No vote is a statement that they are NOT harmful.",
  "deposit": "100000uatom",
  "metadata": "ipfs://CID",
}

Community Pool Spend

There are five (5) components:
  1. Title - the distinguishing name of the proposal, typically the way that explorers list proposals
  2. Summary - the body of the proposal that further describes what is being proposed and details surrounding the proposal
  3. Recipient - the Cosmos Hub (bech32-based) address that will receive funding from the Community Pool
  4. Amount - the amount of funding that the recipient will receive in micro-ATOMs (uatom)
  5. Deposit - the amount that will be contributed to the deposit (in micro-ATOMs “uatom”) from the account submitting the proposal
If the description says that a certain address will receive a certain number of ATOMs, it should also be programmed to do that, but it’s possible that that’s not the case (accidentally or otherwise). Check that the description aligns with the ‘recipient’ address.

Real example

The amount is 1000000000uatom. 1,000,000 micro-ATOM is equal to 1 ATOM, so recipient address cosmos1xf2qwf6g6xvuttpf37xwrgp08qq984244952ze will receive 1000 ATOM if this proposal is passed. The deposit": "1000000uatom results in 1 ATOM being used from the proposal submitter’s account. You can use the gaiad tx gov draft-proposal utility and choose /cosmos.distribution.v1beta1.MsgCommunityPoolSpend to create a draft proposal file. You must use gaiad tx gov submit-proposal <path_to_proposal_file.json> to submit the proposal. The proposal cannot be submitted using submit-legacy-proposal.
{
  "messages":[
    {
  "@type": "/cosmos.distribution.v1beta1.MsgCommunityPoolSpend",
  "authority": "cosmos10d07y265gmmuvt4z0w9aw880jnsr700j6zn9kn",
  "recipient": "cosmos00af8sd0a9dfansdfoiasf0a9ssd9fa09i99990",
  "amount": [{
  "denom": "uatom",
  "amount": "10000000000"
    }]
    }
  ],
  "deposit": "100000uatom",
  "proposer": "cosmos12xpdapokdfpsodf32das75sokdaadapsokd1sa",
  "metadata": "Community Pool Spend Proposal Example",
  "title": "Activate governance discussions on the Discourse forum using community pool funds",
  "summary": "## Summary\nProposal to request for 1000 ATOM from the community spending pool to be sent to a multisig who will put funds towards stewardship of the Discourse forum to make it an authoritative record of governance decisions as well as a vibrant space to draft and discuss proposals.\n## Details\nWe are requesting 1000 ATOM from the community spending pool to activate and steward the Cosmos Hub (Discourse) forum for the next six months.\n\nOff-chain governance conversations are currently highly fragmented, with no shared public venue for discussing proposals as they proceed through the process of being drafted and voted on. It means there is no record of discussion that voters can confidently point to for context, potentially leading to governance decisions becoming delegitimized by stakeholders.\n\nThe requested amount will be sent to a multisig comprising individuals (members listed below) who can ensure that the tokens are spent judiciously. We believe stewardship of the forum requires:\n\n* **Moderation**: Format, edit, and categorize posts; Standardize titles and tags; Monitor and approve new posts; Archive posts.\n* **Facilitation**: Ask clarifying questions in post threads; Summarize discussions; Provide historical precedence to discussions.\n* **Engagement**: Circulate important posts on other social channels to increase community participation; Solicit input from key stakeholders.\n* **Guidance**: Orient and assist newcomers; Guide proposers through governance process; Answer questions regarding the forum or Cosmos ecosystem.\nThe work to steward the forum will be carried out by members of [Hypha Worker Co-op](https://hypha.coop/) and individuals selected from the community to carry out scoped tasks in exchange for ATOM from this budget.\n## Multisig Members\n* Hypha: Mai Ishikawa Sutton (Hypha Co-op)\n* Validator: Daniel Hwang (Stakefish)\n* Cosmos Hub developer: Lauren Gallinaro (Interchain Berlin)\n\nWe feel the membership of the multisig should be rotated following the six-month pilot period to preserve insight from the distinct specializations (i.e., Cosmos Hub validators and developers).\n## Timeline and Deliverables\nWe estimate the total work to take 250-300 hours over six months where we hope to produce:\n* **Moving summaries:** Provide succinct summaries of the proposals and include all publicly stated reasons why various entities are choosing to vote for/against a given proposal. These summaries will be written objectively, not siding with any one entity.\n* **Validator platforms:** Create a section of the Forum where we collate all validators' visions for Cosmos Hub governance to allow them to state their positions publicly. We will work with the smaller validators to ensure they are equally represented.\n* **Regular check-ins with the Cosmonaut DAO:** Collaborate with the future Cosmonaut DAO to ensure maximal accessibility and engagement. Community management is a critical, complementary aspect of increasing participation in governance.\n* **Announcement channel:** Create a read-only announcement channel in the Cosmos Community Discord, so that new proposals and major discussions can be easily followed.\n* **Tooling friendly posts:** Tag and categorize posts so that they can be easily ingested into existing tooling that validators have setup.\n* **Neutral moderation framework:** Document and follow transparent standards for how the forum is moderated.\n\nAt the end of the period, we will produce a report reflecting on our successes and failures, and recommendations for how the work of maintaining a governance venue can be continuously sustained (e.g., through a DAO). We see this initiative as a process of discovery, where we are learning by doing.\n\nFor more context, you can read through the discussions on this [proposal on the Discourse forum](https://forum.cosmos.network/t/proposal-draft-activate-governance-discussions-on-the-discourse-forum-using-community-pool-funds/5833).\n\n## Governance Votes\nThe following items summarize the voting options and what it means for this proposal:\n**YES** - You approve this community spend proposal to deposit 1000 ATOM to a multisig that will spend them to improve governance discussions in the Discourse forum.\n**NO** - You disapprove of this community spend proposal in its current form (please indicate why in the Cosmos Forum).\n**NO WITH VETO** - You are strongly opposed to this change and will exit the network if passed.\n**ABSTAIN** - You are impartial to the outcome of the proposal.\n## Recipient\ncosmos1xf2qwf6g6xvuttpf37xwrgp08qq984244952ze\n## Amount\n1000 ATOM\n\n***Disclosure**: Hypha has an existing contract with the Interchain Foundation focused on the testnet program and improving documentation. This work is beyond the scope of that contract and is focused on engaging the community in governance.*\n\nIPFS pin of proposal on-forum: (https://ipfs.io/ipfs/Qmaq7ftqWccgYCo8U1KZfEnjvjUDzSEGpMxcRy61u8gf2Y)",
}

Legacy Param Change

Legacy parameter change proposals are not available for cosmos-sdk modules.You can update these CosmosHub modules using submit-legacy-proposal:
  • ibc (transfer, interchain-accounts)
  • provider
Note: The changes outlined here must be submitted using submit-legacy-proposal. For param-change proposals, there are arguably seven (7) components, though three are nested beneath ‘Changes’:
  1. Title - the distinguishing name of the proposal, typically the way that explorers list proposals
  2. Description - the body of the proposal that further describes what is being proposed and details surrounding the proposal
  3. Changes - a component containing
  4. Subspace - the Cosmos Hub module with the parameter that is being changed
  5. Key - the parameter that will be changed
  6. Value - the value of the parameter that will be changed by the governance mechanism
  7. Deposit - the amount that will be contributed to the deposit (in micro-ATOMs “uatom”) from the account submitting the proposal
The components must be presented as shown in the example.
To update any of the cosmos-sdk modules you must use gaiad tx gov submit-proposal with a correctly formatted proposal file containing a MsgUpdateParams.When using MsgUpdateParams please note that all fields must always be specified (PUT semantics). Please be careful to not accidentally submit a proposal that changes more parameters than was intended. The parameters that you do not want to change you can simply copy from existing module params.

Real example

This example is ‘real’, because it was put on-chain using the Theta testnet and can be seen. Not all explorers will show the proposed parameter changes that are coded into the proposal, so ensure that you verify that the description aligns with what the governance proposal is programmed to enact. If the description says that a certain parameter will be increased, it should also be programmed to do that, but it’s possible that that’s not the case (accidentally or otherwise).
{
  "title": "Doc update test: Param change for transfer/SendEnabled",
  "description": "Testing the proposal format for enabling IBC transfers on our chain",
  "changes": [
    {
      "subspace": "transfer",
      "key": "transfer",
      "value": true
    }
  ],
  "deposit": "100000uatom"
}