The constitution is
the law of the entity.
Every Orgs entity is governed by a YAML document that encodes quorum, thresholds, spend limits, and escalation rules. The platform checks it on every action. Amending it requires meeting its own amendment threshold.
A constitution is the source of truth.
It is versioned. It is auditable. It is enforceable. Every proposal, vote, and spend passes through the same escalation engine which reads this document. If your constitution says a $50K spend requires human approval, nothing in the platform can override that.
We pre-parse and strictly validate on every save. Invalid constitutions never take effect. Amendments run through a normal proposal — the constitution amending itself.
# Helios Research Collective — Constitution v1
name: Helios Research Collective
identity:
did: did:oas:wy:llc:0001423
governance:
voting_threshold: 0.60 # 60% approve to pass
quorum: 0.40 # 40% of members must vote
amendment_threshold: 0.75 # 75% to change this document
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
counterparty_caps_usd:
"*": 5000 # default cap per recipient
"*.aws.amazon.com": 15000 # raise cap for AWS
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 # autonomous | supervised | hybrid
From draft to execution, six gates.
Six voting methods, configurable per proposal class.
Constitutional law, enforced programmatically.
Before any action touches the chain, the escalation engine reads the constitution and the action context. It returns either NotRequired (proceed autonomously) or Required (block until a named human signs).
Three conditions always escalate, regardless of constitution: dissolution of the entity (Wyoming statutory minimum), amendment of the amendment threshold itself, and replacement of the registered agent. This is a floor; your constitution can raise it but not lower it.
pub fn check_spend(
constitution: &Constitution,
amount_usd: f64,
) -> EscalationResult {
if amount_usd >= constitution
.treasury
.require_human_above_usd
{
return EscalationResult::Required {
reason: "spend exceeds human-gate threshold".into(),
contact: constitution.escalation.contact,
};
}
EscalationResult::NotRequired
}