Sobilo34/nebgov

★ 0Forks 0GitHub ↗Compare

Project website ↗

README

NebGov

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.

License: MIT CI


What It Does

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

Packages

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

Quick Start

See docs/quick-start.md for a full walkthrough.

# Build all contracts
cargo build --release --target wasm32-unknown-unknown

# Install JS dependencies
pnpm install

# Run the frontend locally
pnpm dev

Architecture

See docs/architecture.md for the full design overview.

propose() → Governor → [voting period] → queue() → Timelock → execute()
                ↓
          Token Votes (snapshot voting power)

Contributing

See CONTRIBUTING.md to get started.

Issues are labeled by complexity:

  • complexity: trivial
  • complexity: medium
  • complexity: high

Ecosystem Integrations


License

MIT

Contributors

DeborahOlaboyeUchechukwu-EkeziesanmipaulAkanimoh12DIFoundationlegend4tech

Issues