Documentation
Build, run and verify agent actions.
Your AI agents act. Verdock proves what really happened. Install Verdock, set limits, connect an agent and verify a signed receipt offline.
On this page
Install and verify in four commands#
pip install verdock
verdock init
verdock check refund 3500 --currency USD --counterparty c1
verdock verify .verdock/receipts.ndjson --public-key $(verdock keys)Python 3.10 or newer. No runtime dependencies. The core runs with no account and no network. The Node package gives the same commands: npx verdock demo --scene all.
Get started#
- QuickstartInstall, write a policy, check an action and verify the receipt.
- Offline installPut Verdock on a machine with no internet and check the files first.
- Your first hourSign up for the test workspace, set limits, make a key and call the API.
Concepts#
- Every action meets policy firstWhere Verdock sits and what it decides before, during and after an action.
- Limits and manifestsLimits that live outside the model, and per agent manifests that only narrow.
- Maker and checker approvalsTwo people sign, each with their own key.
- Approval expiry and the Stop switchApprovals last 30 minutes, bind to the exact action, and one agent can be stopped.
- Held queue and exceptionsWhat waits, and the only things a person needs to look at.
- Outcome checks and reconciliationVERIFIED, MISMATCH, UNKNOWN and PENDING, and why UNKNOWN is never retried.
- Receipts and the offline verifierSigned, hash chained lines anyone can check.
- Selective disclosureProve an action happened without publishing who it happened to.
- Authorized exchangeSend a report to another party only when policy allows it.
- Online and offline usageWhat runs where, and how offline usage is counted.
Guides#
- Connect an agentGateway, Python, npm and MCP.
- Stripe adapterDecide, send once, read back and sign, in test mode.
- Razorpay adapterThe same flow for payouts in INR.
- Air gapped installAgents and internal systems inside one boundary, with a signed export.
- Verify a bank review packCheck each of the five answers against evidence.
Reference#
- CLIEvery command and flag in the Python and Node packages.
- Python APIPolicy, guard, receipts, outcomes, invariants and the rest.
- Node APIThe exports of the npm package.
- HTTP APIThe workspace API and the gateway.
- Receipt formatMembers, signed bytes and the chain.
- Policy fileThe schema, the YAML subset and the policy hash.
- Failure reasonsEvery reason a verifier returns.
Security and data#
- What leaves your machineThe exact fields, and what never leaves.
- Data policyWhere your data stays and the only two things that can leave.
- Security overviewFive layers between an agent and your systems.
- Bank reviewThe five questions a bank asks, with the evidence for each.