> ## Documentation Index
> Fetch the complete documentation index at: https://seilabs-docs-evm-cookbook.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Proposals

> Complete guide to Sei governance proposals. Learn about different proposal types and how to submit them.

This guide shows how to create and submit governance proposals on Sei. It covers the proposal types, their requirements, and the submission commands.

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

## Proposal types & submission

### Text proposals

Text proposals are non-binding proposals for community discussion. Use them to collect community input and build consensus 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 theme={null}
seid tx gov submit-proposal \
  --title "Community Initiative Proposal" \
  --description "Detailed description of the initiative..." \
  --type Text \
  --deposit 3500000000usei \
  --from mykey \
  --chain-id pacific-1
```

### Parameter change proposals

Parameter change proposals modify network parameters without a software upgrade.

**Common changes**

* Governance parameters
* Staking parameters
* Fee structures

**Prerequisites**

* Valid JSON format
* Complete documentation of the change
* Impact assessment
* Testing results

```bash theme={null}
seid tx gov submit-proposal param-change proposal.json \
  --deposit 3500000000usei \
  --from mykey \
  --chain-id pacific-1
```

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

```json theme={null}
{
  "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

Software upgrade proposals coordinate network-wide software upgrades. The upgrade executes automatically at a specified block height.

**Common uses**

* Protocol upgrades
* Security patches
* New features
* Performance improvements

**Prerequisites**

* Upgrade height specification
* Binary release information
* Migration documentation
* Validator coordination

```bash theme={null}
seid tx gov submit-proposal software-upgrade v2.1.0 \
  --upgrade-height 15000000 \
  --upgrade-info "https://github.com/sei-protocol/sei-chain/releases/v2.1.0" \
  --title "Sei v2.1.0 Upgrade" \
  --description "Network upgrade to v2.1.0 with enhanced performance" \
  --deposit 3500000000usei \
  --from mykey \
  --chain-id pacific-1
```

## Expedited proposals

Expedited proposals are a fast-track process for urgent network changes that need immediate attention. They have higher deposit and approval requirements, and a shorter timeline.

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

```bash theme={null}
seid tx gov submit-proposal software-upgrade emergency-patch \
  --upgrade-height 15100000 \
  --upgrade-info "https://github.com/sei-protocol/sei-chain/releases/emergency-patch" \
  --title "Emergency Security Patch" \
  --description "Critical security fix requiring immediate deployment" \
  --deposit 7000000000usei \
  --expedited \
  --from mykey \
  --chain-id pacific-1
```

## Proposal management

### Query & monitor

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

### Voting

```bash theme={null}
# Vote on a proposal
seid tx gov vote [proposal-id] [vote-option] \
  --from mykey \
  --chain-id pacific-1

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

### Deposit management

```bash theme={null}
# Add deposit to proposal
seid tx gov deposit [proposal-id] [amount] \
  --from mykey \
  --chain-id pacific-1

# Example: Add 1000 SEI to proposal 42
seid tx gov deposit 42 1000000000usei \
  --from mykey \
  --chain-id pacific-1
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.