Every entity’s constitution follows this strictly-validated schema.

Top-level fields

name: string                    # required, 1-128 chars
identity:
  did: string                   # required, did:oas:wy:llc:xxxx format
  created_at: ISO-8601 datetime # auto-populated
  version: integer              # auto-incremented on amendment

governance:
  voting_threshold: 0.0 to 1.0       # % of votes cast to pass
  quorum: 0.0 to 1.0                 # % of total members that must vote
  amendment_threshold: 0.0 to 1.0    # must be >= voting_threshold
  dissolution_threshold: 0.51 to 1.0 # Wyoming statutory floor 0.51
  voting_period_hours: 1 to 720      # 1hr to 30 days
  voting_method: string              # 1p1v | token | quadratic | delegation | conviction | multisig

treasury:
  daily_spend_limit_usd: >= 0
  reserve_minimum_usd: >= 0
  require_human_above_usd: >= 0
  counterparty_caps_usd:
    "*": >= 0                   # default cap per recipient
    "domain.com": >= 0          # domain-specific cap
  approved_banks: [string]      # bank identifiers allowed to disburse

members:
  - id: string                  # DID
    role: founder | member | algorithmic | observer
    permissions: [string]       # subset of: propose, vote, execute, amend, admin
    weight: 1 (default)         # for weighted voting
    joined_at: ISO-8601 datetime

escalation:
  contacts:                     # required: at least one contact
    - did: string
      email: string
      purposes: [string]        # dissolution | amendment | statutory

mode: autonomous | supervised | hybrid

Field semantics

governance.voting_threshold

Percentage of cast votes required to pass a proposal. 0.60 = 60%. Must be > 0. Applies to standard proposals (not amendments or dissolution).

governance.quorum

Percentage of total members that must participate for a vote to be valid. 0.40 = 40%. If quorum is not met, the proposal is rejected regardless of vote tallies.

governance.amendment_threshold

Percentage required to change the constitution itself. Must be >= voting_threshold. Changes to this field itself require meeting the current amendment threshold.

governance.dissolution_threshold

Percentage required to dissolve the entity. Wyoming statutory floor is 0.51 — the platform enforces this regardless of YAML value. You can set higher; you cannot set lower.

treasury.daily_spend_limit_usd

Maximum combined USD disbursement per 24-hour rolling window. Applies to all treasury actions. Enforced pre-flight.

treasury.reserve_minimum_usd

Minimum USD balance after any spend. A proposal that would bring balance below this amount is rejected by the escalation engine.

treasury.counterparty_caps_usd

Per-recipient spend caps. Supports wildcards: "*" is the default cap; "aws.amazon.com" raises the cap specifically for AWS. Most specific match wins.

members[].permissions

Fine-grained capability grants:
  • propose — create proposals
  • vote — cast votes
  • execute — trigger execution of approved proposals
  • amend — propose constitution amendments
  • admin — manage membership (always requires constitution-level approval)

Validation errors

Full list documented in Constitution.

Version history

Every amendment bumps identity.version and writes the full YAML delta to the audit chain. Historical versions are queryable.