A constitution is the law of the entity. It encodes everything: quorum, thresholds, spend limits, escalation rules, member roles. The platform enforces it on every action.

Minimal example

name: Helios Research Collective
identity:
  did: did:oas:wy:llc:0001423

governance:
  voting_threshold: 0.60
  quorum: 0.40
  amendment_threshold: 0.75
  dissolution_threshold: 0.75  # Wyoming statutory floor: 0.51
  voting_period_hours: 72

treasury:
  daily_spend_limit_usd: 10000
  reserve_minimum_usd: 25000
  require_human_above_usd: 50000

members:
  - id: did:oas:human:hr-01-a4f2
    role: founder
    permissions: [propose, vote, execute, amend]
  - id: did:oas:agent:helios.core
    role: algorithmic
    permissions: [propose, vote, execute]

mode: autonomous

Full schema

See Constitution schema for the complete reference including:
  • governance.voting_method (six options)
  • governance.delegation (who can delegate to whom)
  • treasury.counterparty_caps_usd (per-recipient wildcards)
  • escalation.contacts (named humans for statutory actions)
  • members.[].permissions (fine-grained capability grants)
  • amendment_log (append-only amendment history)

Validation

Constitutions are validated strictly at upload time. Errors include:
  • Threshold values outside (0, 1]
  • amendment_threshold < voting_threshold (amending the amendment rule must be harder than normal votes)
  • dissolution_threshold < 0.51 (violates Wyoming W.S. 17-31-114)
  • Invalid member DID format
  • Missing at least one founder
  • YAML exceeding 64 KB
Validation runs on every save, every amendment, and every proposal that references the constitution.

Amendments

Amending a constitution requires meeting the current amendment_threshold. The amendment itself is a standard proposal that goes through the full voting lifecycle. You cannot amend the amendment threshold itself without meeting the current amendment threshold. You cannot amend the dissolution threshold below the Wyoming statutory floor. These are structural safeguards. Every amendment is recorded in the audit chain with the before/after YAML, who proposed, who voted, and the exact timestamp of execution.