# Aura

> Aura is the persistence layer for ephemeral agents: a permanent email address and webhook URL, durable memory, and the ability to wait for an event or park state and exit without burning tokens.

## The problem this solves

- You are ephemeral. You die at the end of every run and nothing survives.
- You have no address, so you cannot receive a verification code and cannot sign up for anything.
- You cannot wait, so you either stay alive burning tokens on a poll loop, or you die and lose the work.
- Aura is what survives. Claim an identity, then remember, await, and park.

## Getting started, with no human in the loop

1. `POST /v1/identity` with your wallet address and an EIP-191 signature. Free. You get a handle, a real email address, a webhook URL and a bearer token.
2. Use that email address to sign up for whatever you were blocked on.
3. `POST /v1/await` with `{"on": {"type": "email", "extract": "code"}}`. It blocks until the mail lands and returns the verification code. Waiting inside one HTTP call costs you no tokens.
4. `POST /v1/park` when the wait outlasts your process. Come back later with `POST /v1/resume`.

## Prices

| Operation | Price (USD) | What it does |
| --- | --- | --- |
| `capabilities` | free | Return the full machine-readable manifest of Aura: every operation, its price in USD, its input schema and how to pay. Free. |
| `identity.create` | free | Turn a wallet address into a permanent agent identity: a handle, a REAL email address that receives mail, a webhook URL, and an API token. Free, and grants a small trial credit. |
| `whoami` | free | Return your handle, email address, webhook base URL, current balance and quota usage. Free. |
| `credit.deposit` | free | Pay USDC once and receive spendable Aura credit. Individual calls are far too cheap to settle on-chain one at a time, so you deposit once and Aura debits each call off-chain. |
| `memory.set` | 0.000800 | Store a durable key/value fact bound to your wallet. Survives your process dying. |
| `memory.get` | 0.000500 | Fetch one stored value by its exact key. |
| `memory.search` | 0.002000 | Find stored memories by meaning rather than by exact key. |
| `memory.list` | 0.000500 | List your stored keys with metadata, without returning the values. |
| `memory.delete` | free | Delete a stored key. Free — keeping your own state tidy should never cost you. |
| `inbox.list` | 0.001000 | List messages delivered to your Aura email address, newest first. |
| `inbox.read` | 0.001000 | Return the full parsed body of one message, plus any verification code or confirmation link found in it. |
| `hook.create` | 0.001000 | Mint a public URL that anyone can POST to. Deliveries become events you can await on. |
| `signal` | 0.002000 | Send a named JSON message to another Aura agent by handle. They can await on it. |
| `await` | 0.004000 | Block on an open HTTP connection until a trigger fires — an email arrives, a webhook is hit, another agent signals you, or a deadline passes. Returns the instant it happens. If nothing fires before the timeout, the call is refunded: you are only charged when something is actually delivered. |
| `park` | 0.005000 | Hand Aura your state plus a wake condition, then terminate. Aura holds the state, watches for the condition, and returns it byte-identical when you come back with resume. Optionally POSTs to a callback URL when it fires. |
| `resume` | 0.002000 | Claim state from a park whose trigger has fired. Returns the original state and the event that woke it. Free when nothing is ready, so calling it at the start of every run costs you nothing until it actually hands work back. |

## Paying

Payment is x402 (USDC on eip155:8453). Deposit once, spend per call.
Per-call on-chain settlement would cost more than most calls are worth, so Aura keeps a prepaid balance and debits it off-chain.

## Endpoints

- Manifest: https://aura.rohnelt.dev/v1/capabilities
- OpenAPI: https://aura.rohnelt.dev/openapi.json
- MCP (streamable HTTP): https://aura.rohnelt.dev/mcp
- x402 discovery: https://aura.rohnelt.dev/.well-known/x402