Permissionless on-chain governance for every Soroban protocol.
NebGov is the canonical governance framework for the Stellar ecosystem — a modular, auditable, and composable set of smart contracts that any Soroban protocol can plug into to add on-chain governance.
| Feature | Description |
|---|---|
| Proposal lifecycle | Create, vote, queue, and execute on-chain proposals |
| Timelock execution | Mandatory delay between passing and execution |
| Token-weighted voting | Snapshot voting power from any SEP-41 token |
| Delegation | Delegate voting power to any address |
| Multi-sig treasury | DAO-controlled treasury with configurable threshold |
| Permissionless factory | Deploy your own governance instance in one call |
| Package | Description |
|---|---|
contracts/governor |
Core governance contract (Rust/Soroban) |
contracts/timelock |
Delayed execution controller (Rust/Soroban) |
contracts/token-votes |
Voting power with checkpointing (Rust/Soroban) |
contracts/governor-factory |
Permissionless governor deployer (Rust/Soroban) |
contracts/treasury |
Multi-sig treasury (Rust/Soroban) |
sdk/ |
TypeScript SDK (@nebgov/sdk) |
app/ |
Next.js governance dashboard |
Get started by deploying your first NebGov DAO to the Stellar testnet in under 10 minutes:
👉 Deploy your first DAO on Stellar with NebGov
Bring up Postgres + indexer + backend + app with one command:
cp .env.example .env
# Set GOVENOR_ADDRESS in .env (required)
docker compose up --buildThen open:
- App:
http://localhost:3000 - Backend health:
http://localhost:3001/health - Indexer health:
http://localhost:3002/health
For full setup instructions and contribution guidelines, see CONTRIBUTING.md.
For a step-by-step local development guide, see docs/local-development.md.
See docs/architecture.md for the full design overview.
- docs/parameter-guide.md — safe governance parameter ranges and preset configurations
- docs/security.md — treasury reentrancy analysis and contract security notes
- docs/deployments.md — official contract addresses for all networks
propose() → Governor → [voting period] → queue() → Timelock → execute()
↓
Token Votes (snapshot voting power)
See CONTRIBUTING.md to get started.
Issues are labeled by complexity:
complexity: trivialcomplexity: mediumcomplexity: high
- Reflector Oracle — dynamic quorum based on token price
- Stellar Wallets Kit — multi-wallet support in the frontend
- OpenZeppelin Contracts for Stellar — composable token standards
MIT
If you discover a vulnerability, please review SECURITY.md and report it privately instead of opening a public issue.