Skip to main content

Module guardianship

Module guardianship 

Source
Expand description

Guardianship approval escrow — M-of-N co-signature for proxy actions.

Supported agency, not warden control. When an agent acting on behalf of a principal (a proxy / supporter) writes a protected record, the write does not auto-commit. It is held in escrow as a GuardianshipProposal; designated guardians co-sign with immutable GuardianshipVote records. The current status is a derived projection over the votes (latest vote per guardian) — replay-safe, so duplicated / reordered / replayed co-signatures never change the outcome. On reaching the approval threshold the actual escrowed record commits through the normal signed vault path.

The escrow protects the principal from an ill-considered or erring supporter — a co-guardian objection halts the escrow (a protective veto). That guards the principal’s agency against a rogue proxy; it is not a warden overriding the principal, who is not the actor here.

Merge discipline mirrors the rest of wellfare-core: proposals and votes are immutable append-only records merged by stable id; status is derived, never a mutated field.

Structs§

GuardianshipProposal
A proxy write held pending M-of-N guardian co-signature.
GuardianshipVote
A guardian’s immutable co-signature (approve) or objection (deny) on a proposal.
ProposalStatus
Derived status of a proposal — a pure projection over the votes, never a stored field.

Enums§

ProposalState
Terminal / in-flight state of a proposal.

Functions§

build_proposal_envelope
Builds the envelope.
build_vote_envelope
Builds the envelope.
derive_status
Derive the status of a proposal from its votes.
parse_proposal_summary
summary.
parse_vote_summary
summary.
proposal_record_id
record ID.
proposal_summary
summary.
vote_record_id
record ID.
vote_summary
summary.