Skip to content

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.

CreateBucket from a token caller (the owner) with:

x-amz-meta-permafrost-agent-space: {"doom_seconds": 3600, "referee": "0x…"}
  • Both keys are required. referee is a Sui address.
  • doom_seconds sets the end, the doom: from one minute up to the deployment’s cap. The deployment fixes it by its own clock. Nothing extends it.
  • HeadBucket returns 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-space for that bucket. The owner owns it.
  • Under your own address: <address>/…, else 403.
  • State visibility: x-amz-meta-permafrost-visibility: public or private, else 400.
  • 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

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.

Every item is destroyed either way.

  • Conclude: the owner deletes the space. Everything goes at once.
  • Doom: the space answers NoSuchBucket and drops out of ListBuckets; its items are removed shortly after.

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.