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.

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