How to Configure the OKRW Minter

quickstart intermediate

A focused guide on creating and submitting a governance proposal to set or change the authorized minter address for the x/okrw module.

Prerequisites

Access to a Maroo network.
An account with sufficient funds to pay for the proposal deposit.

1. Identify the New Minter Address

First, you need the Bech32 address of the account you wish to designate as the new minter. If the account doesn't exist, create it.

# If the key already exists
marood keys show new-minter-key -a

# Or create a new one
marood keys add new-minter-key

2. Prepare the Proposal JSON

Create a file named update-minter-proposal.json. This file contains the MsgUpdateParams message that will be executed if the proposal passes. You must provide the full set of parameters, including mint_denom.

NEW_MINTER_ADDRESS="maroo1..."
GOV_MODULE_ADDRESS="maroo10d07y265gmmuvt4z0w9aw880jnsr700j8k2m34"

cat <<EOF > update-minter-proposal.json
{
  "title": "Update OKRW Minter Address",
  "summary": "Set a new authorized minter for the OKRW module.",
  "messages": [
    {
      "@type": "/maroo.okrw.v1.MsgUpdateParams",
      "authority": "$GOV_MODULE_ADDRESS",
      "params": {
        "minter_address": "$NEW_MINTER_ADDRESS",
        "mint_denom": "aokrw"
      }
    }
  ],
  "deposit": "10000000aokrw"
}
EOF

Warning: Ensure the `authority` address is correct for your network. It is the address of the `x/gov` module.

3. Submit the Proposal

Use the marood tx gov submit-proposal command to submit your JSON file to the network. You must sign this transaction with an account that can cover the deposit.

marood tx gov submit-proposal update-minter-proposal.json --from my-funded-account --chain-id maroo-testnet -y

4. Vote and Verify

After submission, the proposal enters the voting period. Encourage stakeholders to vote. Once the proposal passes, you can verify the change by querying the module's parameters.

# After voting period...
marood query okrw params