Concepts
Vocabulary
Every term in Treeship maps directly to the code. Nothing is decorative.
Every term below maps to a concrete type or command in the CLI and Rust core.
| Term | Definition | In the code |
|---|---|---|
| Action | A signed record of an agent or human performing something | ActionStatement / treeship attest action |
| Approval | Cryptographic authorization for an action, with nonce binding | ApprovalStatement / treeship attest approval |
| Handoff | Signed transfer of work between actors | HandoffStatement / treeship attest handoff |
| Endorsement | Third-party validation of another artifact | EndorsementStatement / treeship attest endorsement |
| Receipt | External system confirmation (webhook, timestamp, inclusion proof) | ReceiptStatement / treeship attest receipt |
| Artifact | A single signed DSSE envelope with a content-addressed art_ ID | Record in local storage |
| Bundle | Portable package of artifacts, self-verifying | .treeship file / treeship bundle |
| Treeship | A sovereign trust domain | Ed25519 keypair + config + local artifact store |
| Actor | Any human or agent identified by a URI | human:// or agent:// prefix |
| Approver | The human or identity that signs an approval | --approver flag |
| Docking | The process of connecting your Treeship to Hub | treeship dock login / DPoP keypair |
| Hub | Hosted infrastructure where Treeships connect via docking | treeship.dev API |