> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simpuru.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# The escrow

> An unchanged Masumi vested_pay V2 validator, deployed with Simpuru's own arbiter key.

Protected payments are locked by the Masumi `vested_pay` V2 validator, **unchanged**. Simpuru deployed its own instance of it, parameterised with Simpuru's arbiter key instead of Masumi's admins, so disputes can be settled by Simpuru's [arbiter](/learn/disputes-and-the-arbiter). Addresses and parameters are on [Deployment](/resources/deployment).

## What the datum holds

Every lock carries the buyer and seller, the amount, the `input_hash` and later the `result_hash` (see [Content commitment](/learn/content-commitment)), four deadlines and a state.

## States

| State | Meaning |
| - | - |
| `FundsLocked` | Paid in, waiting for the seller's result |
| `ResultSubmitted` | The seller posted a result hash |
| `RefundRequested` | The buyer asked for a refund before any result |
| `Disputed` | The buyer disputed a posted result |
| `WithdrawAuthorized` | The buyer dropped its dispute; the seller can collect at once |
| `RefundAuthorized` | The seller conceded; the buyer can take the refund now |

When the lock is spent, the purchase ends as **withdrawn** (seller paid) or **refunded** (buyer paid back).

## Who can spend it, and when

| Action | Who | When |
| - | - | - |
| Post a result | Seller | Before the submit deadline |
| Collect (withdraw) | Seller | After the unlock time, if a result is posted and not disputed, or at once if the buyer dropped its dispute |
| Refund | Buyer | After the submit deadline if there is no result, or at once if the seller conceded |
| Dispute | Buyer | After a result, before the unlock time |
| Drop a dispute | Buyer | While disputed |
| Concede (hand the money back) | Seller | Any time the escrow is open, even after the deadlines |
| Pay out a dispute | Arbiter | After the dispute window closes |

The exact times are on [Deadlines](/learn/deadlines).

After either side acts on an escrow, that side waits a short **cooldown** before its next action on it: 60 seconds on Simpuru's deployment (see [Deployment](/resources/deployment)).

## Who is the seller in the escrow

For a creator's listing, a Simpuru platform wallet is the escrow's seller of record: it signs the quote, posts the result and collects. It then pays the creator their share (see [Get paid](/guides/get-paid)). This keeps creators from having to run anything themselves.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.