Proposals

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

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

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

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

seid tx gov submit-proposal param-change proposal.json \
  --deposit 3500000000usei \
  --from mykey \
  --chain-id pacific-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

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

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

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

# 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

# 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

Getting Started

Core Architecture

Network Tools & Providers

Governance

Interoperability

Sei Giga Upgrade

Resources

Proposal types & submission

Text proposals

Parameter change proposals

Software upgrade proposals

Expedited proposals

Proposal management

Query & monitor

Voting

Deposit management

​Proposal types & submission

​Text proposals

​Parameter change proposals

​Software upgrade proposals

​Expedited proposals

​Proposal management

​Query & monitor

​Voting

​Deposit management

Proposal types & submission

Text proposals

Parameter change proposals

Software upgrade proposals

Expedited proposals

Proposal management

Query & monitor

Voting

Deposit management