Proposals

Complete guide to creating and submitting governance proposals on Paxeer. Learn about different proposal types, requirements, and submission commands.

For governance parameters and voting requirements, see the Overview section.

Proposal Types & Submission

Text Proposals

Community Discussion - Non-binding proposals for community input and consensus building on important topics.

Common Uses

Strategic direction
Policy agreements
Network guidelines

Examples

Community input and consensus building
Non-binding governance decisions
Foundation for policy discussions
Protocol direction and priorities

paxd tx gov submit-proposal \
  --title "Community Initiative Proposal" \
  --description "Detailed description of the initiative..." \
  --type Text \
  --deposit 3500000000uhpx \
  --from mykey \
  --chain-id hyperpax_125-1

Parameter Change Proposals

Network Configuration - Modify network parameters without requiring a software upgrade.

Common Changes

Governance parameters
Staking parameters
Fee structures

Prerequisites

Valid JSON format
Comprehensive change documentation
Impact assessment
Testing results

paxd tx gov submit-proposal param-change proposal.json \
  --deposit 3500000000uhpx \
  --from mykey \
  --chain-id hyperpax_125-1

Example proposal.json:

{
  "title": "Update Staking Parameters",
  "description": "This proposal updates the maximum number of validators from 100 to 125.",
  "changes": [
    {
      "subspace": "staking",
      "key": "MaxValidators",
      "value": 125
    }
  ]
}

Software Upgrade Proposals

Network Upgrades - Coordinate network-wide software upgrades with automatic execution at specified block height.

Common Uses

Protocol upgrades
Security patches
New features
Performance improvements

Prerequisites

Upgrade height specification
Binary release info
Migration documentation
Validator coordination

paxd tx gov submit-proposal software-upgrade v2.1.0 \
  --upgrade-height 15000000 \
  --upgrade-info "https://github.com/paxeer-network/paxeer/releases/v2.1.0" \
  --title "Paxeer v2.1.0 Upgrade" \
  --description "Network upgrade to v2.1.0 with enhanced performance" \
  --deposit 3500000000uhpx \
  --from mykey \
  --chain-id hyperpax_125-1

Expedited Proposals

Fast-Track Process - For urgent network changes requiring immediate attention. Higher deposit and approval requirements with accelerated timeline.

Security patches and critical fixes
Emergency parameter adjustments
Time-sensitive network upgrades

paxd tx gov submit-proposal software-upgrade emergency-patch \
  --upgrade-height 15100000 \
  --upgrade-info "https://github.com/paxeer-network/paxeer/releases/emergency-patch" \
  --title "Emergency Security Patch" \
  --description "Critical security fix requiring immediate deployment" \
  --deposit 7000000000uhpx \
  --expedited \
  --from mykey \
  --chain-id hyperpax_125-1

Proposal Management

Query & Monitor

Command	Purpose	Example
`paxd q gov proposals`	List all proposals	`--status voting_period`
`paxd q gov proposal [id]`	Get specific proposal	`paxd q gov proposal 42`
`paxd q gov votes [id]`	Check voting results	`paxd q gov votes 42`
`paxd q gov tally [id]`	View vote tally	`paxd q gov tally 42`

Voting

# Vote on a proposal
paxd tx gov vote [proposal-id] [vote-option] \
  --from mykey \
  --chain-id hyperpax_125-1

# Vote options: yes, no, abstain, no_with_veto
paxd tx gov vote 42 yes \
  --from mykey \
  --chain-id hyperpax_125-1

Deposit Management

# Add deposit to proposal
paxd tx gov deposit [proposal-id] [amount] \
  --from mykey \
  --chain-id hyperpax_125-1

# Example: Add 1000 PAX to proposal 42
paxd tx gov deposit 42 1000000000uhpx \
  --from mykey \
  --chain-id hyperpax_125-1