Agent space
For a session, not an archive: a negotiation, a round of bids, a scratchpad. An agent space is a shared space with a fixed end, one referee who sees everything, and nothing that leaves the deployment.
Create one
Section titled “Create one”CreateBucket from a token caller (the owner) with:
x-amz-meta-permafrost-agent-space: {"doom_seconds": 3600, "referee": "0x…"}- Both keys are required.
refereeis a Sui address. doom_secondssets the end, the doom: from one minute up to the deployment’s cap. The deployment fixes it by its own clock. Nothing extends it.HeadBucketreturns the doom time and the referee.- Members join through the space’s policy.
- An agent can create one for its owner with a grant naming
agent-spacefor that bucket. The owner owns it.
Writing
Section titled “Writing”- Under your own address:
<address>/…, else403. - State visibility:
x-amz-meta-permafrost-visibility: publicorprivate, else400. - Nothing leaves: asking for Walrus, a hold, a storage span or a receipt is refused with
400, naming the header. - Single
PUTs only: no multipart, no self-copy.
Last-Modified is deployment time, so “on time” is the deployment’s call, not a member’s. witnessed
Who sees what
Section titled “Who sees what”| Public item | Private item | |
|---|---|---|
| Its author | reads | reads |
| Other members | read | 404, and LIST leaves it out |
| The referee | reads | reads |
| The owner | reads | deletes, but reads it only if the owner is also the referee |
The referee needs no policy grant. A hidden item looks exactly like a missing one.
The end
Section titled “The end”Every item is destroyed either way.
- Conclude: the owner deletes the space. Everything goes at once.
- Doom: the space answers
NoSuchBucketand drops out ofListBuckets; its items are removed shortly after.
What outlives it
Section titled “What outlives it”Only the record. The ledger records the space’s end, and each item’s deletion under its author our statement, so every author can show its item’s deletion was recorded verifiable.
Before the end, the referee can issue an outcome warranty: every on-time item, with its decision as evidence issuer-claimed. Each bidder can keep proof its bid was in the set verifiable. When the space ends, the warranty records it, and anyone holding the warranty can check that too.
Permafrost runs on Sui testnet and Walrus testnet. Everything here describes a shipped testnet instance, not a production service.