Submitting Proposals

This section describes how to submit governance proposals on Nibiru.

Any NIBI holder, whether bonded or unbonded, can submit proposals by sending a TxGovProposal transaction. This is possible using the nibid CLI. Each proposal type corresponds to a subcommand of nibid tx gov submit-proposal.

Table of Contents

• Proposal Types
  • Whitelisting an oracle address with add-oracle
  • Create a virtual pool
• Querying a proposal

Proposal Types

Proposal Type	Description
add-oracle	Whitelists an account as a price feed, enabling it send post-price messages.
cancel-software-upgrade	Cancels a software upgrade.
community-pool-spend	Details a proposal for use of community funds, together with how many coins are proposed to be spent, and to which recipient account.
create-pool	Creates a new Nibi-Perps trading pair by initializing a virtual AMM pool.
ibc-upgrade	Updates the IBC client state in-place. An upgraded_client_state.json can be client-breaking.
param-change	Change module parameters.
software-upgrade	Upgrade the protocol code.
update-client	Substitutes the current IBC client for a new one. This proposal is useful for updating the light client in the case of misbehavior. See ADR-026 of IBC-Go for more info.

Whitelisting an oracle address with add-oracle

# parameters
nibid tx gov submit-proposal add-oracle [proposal-file] --deposit [deposit] [flags]

# example
nibid tx gov submit-proposal add-oracle /path/to/proposal.json --deposit 1000unibi --from validator

An JSON file the add-oracle proposal:

{
 "title": "add Delphi oracle",
 "description": "Whitelists Delphi to post prices for BTC",
 "oracles": ["nibi1zaavvzxez0elundtn32qnk9lkm8kmcsz44g7xl"],
 "pairs": ["ubtc:unusd"]
}

Create a virtual pool

# parameters
nibid tx gov submit-proposal create-pool proposalFile --deposit deposit [flags]

# example
nibid tx gov submit-proposal create-pool /path/to/proposal.json --deposit 1000unibi --from validator

Here's an example of a valid JSON file for the create-pool proposal.

{
    "title": "Create vpool for BTC:NUSD",
    "description": "We want to allow leveraged BTC perp trading.",
    "pair": "ubtc:unusd",
    "quote_asset_reserve": "1000000",
    "base_asset_reserve": "1000000",
    "trade_limit_ratio": "0.1",
    "fluctuation_limit_ratio": "0.01",
    "max_oracle_spread_ratio": "0.1",
    "maintenance_margin_ratio": "0.0625"
}

Querying a proposal

One can use the following command to query for proposals:

# parameters
nibid query gov proposal [proposal-id]

# example
nibid query gov proposal 1