Governance Overview

​

The components

• Constitution — the YAML document defining rules
• Proposals — formal requests to change state
• Voting — how members cast and count votes
• Escalation Engine — constitutional enforcement before any action
• Amendments — changing the constitution itself

​

Guiding principles

1. The constitution is the law of the entity. Nothing overrides it, including administrators.
2. No optimistic state. Chain transactions must confirm before local state updates.
3. Statutory floors never waive. Dissolution always requires a human; this cannot be configured away.
4. Every action writes to the audit chain. Discoverable, hash-chained, Ed25519-signed.
5. Proposals are idempotent. Retry-safe; double-votes impossible.

​

Voting methods

1. One-person-one-vote — each member gets one
2. Token-weighted — weight ∝ token balance at snapshot
3. Quadratic — weight = √tokens
4. Delegation — proxy-voting supported
5. Conviction — weight grows over time maintaining position
6. Multi-sig — N-of-M signer model

​

Proposal classes

• spend — financial disbursements
• membership — member additions/removals
• amend — constitution changes (always requires amendment_threshold)
• custom — arbitrary action with audit-trail

​

Examples

# Create a spend proposal via CLI
orgs proposal create \
  --entity helios-research \
  --kind spend \
  --amount 12500 \
  --to aws-bedrock \
  --description "Q2 compute reservation"

# Vote
orgs proposal vote prop-2026-04-12-0031 approve

# Execute (after threshold met)
orgs proposal execute prop-2026-04-12-0031

// Via SDK
const proposal = await orgs.proposals.create({
  entity: "helios-research",
  kind: "spend",
  amountUsd: 12500,
  to: "aws-bedrock",
  description: "Q2 compute reservation",
});