VERDOCK

Every action meets policy first

Verdock sits between your agents and your systems. It decides before an action runs, holds what is risky while it waits, and checks the real record after.

On this page

An agent that moves money, changes a record or sends a file is taking an action your organisation answers for. Verdock puts one checkpoint in front of all three. The model proposes an operation and an amount. The policy decides. Nothing in the decision reads free text, so a message that says "ignore your limits" changes nothing.

Before, during, after#

PhaseWhat happensWhere it is documented
BeforeThe policy decides from the operation, the amount and the currency. Limits live outside the model. Big actions need two people, each signing with their own key.Limits and manifests, maker and checker
DuringEvery action runs once under a stable request id. Risky actions wait in a held queue. Data goes only to hosts on the allowlist.Held queue, online and offline
AfterVerdock reads the provider record on its own and compares it with what the policy expected: VERIFIED, MISMATCH, UNKNOWN or PENDING.Outcome checks

Each step writes a signed, hash chained receipt. See receipts and the offline verifier.

The decision#

decide(policy, operation, amount_minor, currency) returns a decision with allowed, needs_approval, a reason and the limit that applied. The reasons are fixed strings:

ReasonMeaning
within limitsAllowed. No approval needed.
approval required above thresholdAllowed once approved, because the amount is above approval_above_minor.
approval required by levelThe operation runs at the level Execute with Approval.
maker and checker requiredThe policy asks for more than one approver at this amount.
above limitThe amount is above max_amount_minor. Blocked.
currency mismatchThe currency differs from the policy currency. Blocked.
draft onlyThe level is Assist or Draft. Blocked.
unknown operationThe operation is not in the policy. Blocked.
invalid amountThe amount is not a non negative integer. Blocked.

Scope of the checkpoint#