Open source

Aegis Governance

On-chain governance for node networks. A network of operators and token holders decides how a shared grant pool is spent, and no single party can reach into the funds. We built it from the LFG Aegis Node spec and released it so any node network can fork it.

Reference implementation v0.1 · MIT licensed · forkable
Talk to the team See how it works
Aegis Governance
What it is

Governance that pays out only when the network agrees

Aegis implements burn-to-propose economics, one-node-one-vote, an operational-node requirement to participate, quorum and majority thresholds, vote delegation, and a grant treasury that releases funds only when a proposal passes. It started as the LFG Aegis Node governance spec and was generalized so any node network can fork it, set its own parameters, and run it.

What is in the box

AegisGovernor

The full proposal lifecycle: submit, support, vote, execute. It holds every tunable rule for the network.

NodeRegistry

Nodes as NFTs, so identity is trustless, plus attested liveness and uptime. This is the trust boundary, and we keep it isolated on purpose.

GrantTreasury

Custodies the grant pool and pays out only on the governor's instruction. No single party can reach the funds directly.

How a proposal moves

Four stages

01

Submit

A proposer burns governance token, priced in USD: the node-operator rate or the higher plain-holder rate. The proposal opens as Pending.

02

Support

Operational nodes second the proposal, each burning a small amount. Once the support threshold is met, it goes Active and the active-node count is snapshotted as the quorum denominator.

03

Vote

During the voting window, each operational node that clears the trailing-uptime bar casts one vote. The node's owner or a delegate may cast it.

04

Execute

A proposal that meets both quorum and majority succeeds. Funding proposals release from the treasury. Critical proposals are signaling-only in this build.

Every dollar figure is stored in whole USD and converted to token at action time through a price oracle, so the economics track the spec even as the token price moves.

Defaults

Spec defaults, all configurable

Every threshold lives in one parameters struct and is editable on-chain. These defaults match the original LFG Aegis spec. Each one is a lever a forking network can tune.

Propose (node operator)$5,000 burned
Propose (plain holder)$20,000 burned
Support a proposal$50 burned per node
Support threshold250 nodes to go Active
Voting window7 days
Uptime bar to vote80% trailing uptime
Quorum25% of active nodes participating
Majority51% of votes cast
SettlementUSD-denominated, token-settled via price oracle
The dApp

A full web app for the whole flow

View the grant pool and parameters, browse proposals with live state, second and vote with your nodes, create proposals, and execute. Reads work with no wallet against a local RPC. Sending transactions uses an injected wallet. Each proposal carries a full document, published to IPFS and rendered as sanitized Markdown.

Built to fork

  • Solidity contracts on Hardhat with OpenZeppelin, plus a React and ethers dApp.
  • Switchable branding: one swappable layer for colors, fonts, logo, and names.
  • Every parameter editable on-chain, with the trade-offs documented.
Where it stands

What we are honest about

The hard problem is isolated, not solved

Proving a node is actually doing work is the central challenge in node governance. Today the registry accepts attestations from a trusted role. Making that role trust-minimized is the open research problem, and we keep it in one place on purpose so it can be hardened without touching the rest.

Scope of this build

Funding proposals release from the treasury on success. Critical proposals pass or fail but are signaling-only for now. The threat model and the path to harden the attestor are written down in the project's node-verification docs.

Running a node network? Let's talk governance.

Talk to the team