Skip to content

Schemas

VTC Admin Actions — shared definitions

Shared shapes for a Verifiable Trust Community's administrative ACTIONS: operations parked for other administrators' decision instead of being refused. THE MODEL. When an administrative operation needs more than its requester's own authority — a grant of administrative authority that needs N-of-M approval, an operator's offline (break-glass) write every administrator must see, a human decision such as a join review — the community does not refuse it. It parks the operation as an Action. An Action names its eligible approvers (or acknowledgers) and, for `approval`, a threshold N. When the N-th approval lands, the community re-checks everything it checked at submission — the requester's standing, each approver's standing, the community's policy, the state the operation acts on — and executes the parked operation EXACTLY ONCE; the action then leaves every administrator's list. One deny closes it for everyone. An open action lapses at `expiresAt`: 72 hours by default, community-configurable between 15 minutes and 14 days. COOLING OFF (new in 0.2). Some operations need a third party's agreement that does not exist — the removal of an administrator in a community where nobody other than the requester and the subject holds the authority to consent. The community neither refuses such an operation nor lets it take effect at once: it parks it as a `coolingOff` action, which has no threshold, no approvers and no expiry. It LANDS at `landsAt` — the community executes the parked payload then, exactly once and after the same execution-time re-check as any other action — unless the requester withdraws it with `vtc/admin/actions/cancel` first. The cooling-off period is 24 hours by default and community-configurable. The subject is shown the action (`callerRole: subject`) and told of it by `vtc/members/authority-reduction-pending-notice`, so a reduction nobody else reviewed is never a surprise; the subject cannot block it, because a veto held by the subject would protect a compromised subject from its own removal. VERSION 0.3 renames `approvals[].at` to `decidedAt` (type unchanged), for the registry's naming consistency; nothing else changes. THE REPLY TO THE REQUESTER. The gated operation is not answered with an error or with its own `#response`. The community answers it with the framework-reserved `trust-task-next-step/0.1`, carrying `continuation: proceed` and one `expects` entry whose `typeUri` is `https://trusttasks.org/spec/vtc/admin/actions/show/0.3` with `hint: {"actionId": "…"}`. `proceed` is deliberate: the requester does NOT re-submit the original operation — the community executes the parked payload itself once the threshold is met — so the requester's next step is to follow the action, not to retry. No separate response specification exists for this reply. THE DECISION. A `coolingOff` action takes no decision: nobody approves it and nobody acknowledges it. An approver decides through `task-consent/decision` (0.2 or later), echoing the `challenge` it was shown on the action and quoting `actionId`. An acknowledger answers `acknowledge` actions with `vtc/admin/actions/acknowledge`. The requester may withdraw an open action with `vtc/admin/actions/cancel`. WHAT APPROVERS ARE SHOWN. The `summary` is rendered from a SUMMARY TEMPLATE delivered as data — a title, an effect sentence, and named fields each locating a value in the digested payload by JSON Pointer — and the template is pinned per kind by `templateDigest`. A renderer MUST derive every field it shows from `payload` via that field's `pointer`, and MUST refuse to render an action whose carried `value` differs from the value at the pointer, or whose `payloadDigest` does not match `payload`. It MUST NOT present an action from `title` or `effect` text alone: those are prose the community authored, and a decision taken on prose is a decision about whatever the prose claimed rather than about the payload that will execute (VTI-APV-013).

Schema ID
https://trusttasks.org/spec/vtc/admin/actions/_shared/0.3/action
Kind
shared
Used by
7 specification versions

Trust Tasks — the registry of Trust Task specifications.

Loading the registry… If this message stays, the page's scripts could not load or run. The site needs JavaScript and access to unpkg.com.

Every specification is also on GitHub: trustoverip/dtgwg-trust-tasks-tf/specs, and the framework specification at /SPEC.md.