Governance Params Management

# Check transaction status
pocketd query tx --type=hash <TRANSACTION_HASH> --network=beta

# Verify updated parameters
./tools/scripts/params/gov_params.sh query tokenomics --env beta

Step 6: Update and Merge Pull Request

Get your PR approved.

Please ensure you have an approval on the PR from one of the repository maintainers.

In order to keep the repository up to date with the current onchain parameters, please comment on the pull request with the transaction hash and merge the pull request opened in Step 1: Open a Pull Request: https://dev.poktroll.com/protocol/governance/gov_params_mgmt#step-1-open-a-pull-request

Troubleshooting

Common Issues

Module Not Found

❌ Failed to query parameters for module 'unknown_module'

Check available modules list with:

./tools/scripts/params/gov_params.sh help

Authority Mismatch

Error: unauthorized: invalid authority

Verify authority address matches environment configuration.

Network Connection

Error: Failed to query parameters

Check network connectivity and node endpoint.

Invalid JSON Format

Error: invalid character in JSON

Validate JSON syntax before submission.

Common Use Cases & Examples

Updating Minimum Supplier Stake

# Query current minimum stake
./tools/scripts/params/gov_params.sh query supplier --env beta

# Generate update template
./tools/scripts/params/gov_params.sh update supplier --env beta

# Submit the transaction

View All Parameters

Check all parameters in beta:

./tools/scripts/params/gov_params.sh query-all --env beta

Complete Tokenomics Update Example

1

Query current state

./tools/scripts/params/gov_params.sh query tokenomics --env beta

2

Generate template

./tools/scripts/params/gov_params.sh update tokenomics --env beta --output-dir ./governance

3

Edit the generated file

For example:

# vim ./governance/tokenomics_params_beta_20241230_143022.json

4

Submit transaction

pocketd tx authz exec ./governance/tokenomics_params_beta_20241230_143022.json \
  --from=pnf_beta --network=beta --yes --fees=200upokt

5

Verify changes

./tools/scripts/params/gov_params.sh query tokenomics --env beta