---
title: Proposals
description: >-
  Learn how to create, submit, and manage governance proposals on Paxeer,
  including text, parameter change, and software upgrade types.
keywords:
  - paxeer governance
  - proposals
  - governance submission
  - blockchain governance
  - proposal commands
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

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

<Info>For governance parameters and voting requirements, see the [Overview](/learn/general-governance) section.</Info>

## 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

```bash
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

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

<Info>**Example `proposal.json`:**</Info>

```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

```bash
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

```bash
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

```bash
# 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

```bash
# 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
```