Hall
The four doors

One question per door.

Every call the agent asks the vault to make walks four doors, in order. Each door answers one question. The first door that says no decides the answer, and the transaction reverts with that door's reason. Here is what each door stops, what it lets through and who can change it.

Doors4
OrderLock · list · counter · room
Written byThe owner
AuditedNot yet

Owner only
Door 1 · Is the vault open?

The lock

A kill switch the owner holds. One transaction locks the vault, and from then on it refuses everything the agent asks for, including the release of moves already in the waiting room. Locking never touches the owner's own powers: withdrawals, policy changes and owner calls keep working, so you can lock first and sort things out after.

StopsEvery agent move and every release, at once
Lets throughNothing the agent asks for, until the owner unlocks
Held movesStay queued. They can still be cancelled, and their expiry keeps running
Changed byThe owner: freeze() and unfreeze()

Address + selector
Door 2 · Is this call on the list?

The guest list

The agent may call only the contracts you named, and on each only the functions you named. Entries are matched by contract address and 4-byte selector, never by a name a contract gives itself. A plain ETH send with no calldata is its own entry, so you decide which addresses may receive ETH.

StopsUnlisted contracts and functions, unlimited approvals (approve or increaseAllowance for the maximum, setApprovalForAll), calls to the vault or its factory, unreadable calldata
Lets throughA listed contract with a listed function, like the Uniswap router's exactInputSingle
SizeUp to 128 entries per vault
Changed byThe owner: setAllowed(target, selectors, on)

A listed function can still do everything that function does. If a router lets the caller pick who receives a swap's output, so can the agent. The counter below is what bounds the damage; list only what the agent needs.


Move · hour · day
Door 3 · Does it fit the caps?

The counter

Every move is counted against three caps for its asset: per move, per clock hour and per UTC day. ETH counts the value sent with the call. A token counts the amount in transfer, approve, increaseAllowance, or transferFrom out of the vault, when the call goes to that token's own contract. A runaway loop fills the hour, then the day, and stops.

StopsOne oversized move, a run of moves past the hour or day cap, and any amount of an asset with no caps set
Lets throughNormal activity under the caps, with no prompt and no delay
WindowsThe clock hour and the UTC day, by block time
Changed byThe owner: setLimits and clearLimits, up to 32 assets

The windows are calendar windows, so moves either side of a boundary count in different windows: up to twice the hour cap can pass in a few minutes around the top of an hour. The day cap still holds across the day.


1 minute to 30 days
Door 4 · Is it big enough to wait?

The waiting room

A move that fits the caps but is above your threshold isn't refused. It waits for the delay you chose, and in that time you can cancel it. Once the delay is over, the agent or you can release it. At release it walks the lock, the list and the counter again, and it is counted then, not when it was queued.

HoldsAny move above the hold threshold for its asset
Released byThe agent or the owner, after the delay
Cancelled byThe owner or the agent, at any time before release
Expires7 days after it becomes ready, if nobody releases it
One call, start to finish

What happens when the agent asks.

  1. The agent sends execute(target, value, data) to the vault, signed with its own key. No other key can.
  2. Door 1. If the vault is locked, it reverts: frozen.
  3. Door 2. If the target and selector aren't listed, or the call is an unlimited approval or aims at the vault or factory, it reverts.
  4. Door 3. If the amount is over the per-move cap or what's left of the hour or day, it reverts.
  5. Door 4. If the amount is above the threshold, the vault queues it and returns its number. Otherwise the vault makes the call now and counts it.

Agents can ask first: the vault's check function, the API's /api/check and the MCP tool check_policy all give the same answer without sending anything.

The policy

Written by a person, read by the chain.

All four doors read one policy stored in the vault. Only the owner writes it, and each change bumps a revision number that is logged with the change, so anyone can tell which policy was in force for any move.

  • · The owner is a person's wallet. It can always withdraw any asset, locked or not, and can make calls from the vault directly.
  • · The agent key is a separate address the agent signs with. It can only ask, and it can never be the owner.
  • · Changes to the list, caps, delay and agent key are owner-only, and several can go out as one transaction.
  • · Handover takes two steps: the owner offers the vault, the new wallet accepts.
  • · No admin can change a vault. The factory's admin can only lift the deposit caps once, for everyone, or give the role up.
Why a hall

A house keeps its rules at the doors.

A hall is where a household decides who comes in, what they may carry and when the doors shut for the night. Hall puts the same three ideas between an agent and a wallet.

Every way in has a door

The agent has one way to move funds: asking the vault. Every request walks all four doors. There is no side entrance for the agent key.

In the contract: execute and release are the only agent paths, and both run the same checks.

Several doors, not one wall

A trick that gets past one door still meets the next. An injected instruction that finds a listed function still meets the caps, and a big move still waits.

In the contract: the doors are independent checks in a fixed order.

Built for how agents fail

Loops that repeat a bad move, instructions slipped in through a web page, unlimited approvals and a leaked agent key are the cases the doors and the tests are written against.

In the tests: fuzzed day caps, unlisted calls, reentrancy and an owner who can always withdraw.