dail-live

# DAiL v0.3 — Safe / Receive-First Wallet

DAiL v0.3 adds a **test-mode software safe** designed around a simple rule:

> **The safe can receive automatically. Withdrawals require a separate credential.**

## What was added

- `GET /safe` — safe status, receive address, balance, and key status.
- `POST /safe/receive` — receive simulated DAIL funds into the central safe.
- `POST /safe/keys/withdrawal` — create a one-time-display withdrawal API key using the server admin key.
- `POST /safe/keys/withdrawal/revoke` — revoke the current withdrawal key.
- `POST /safe/withdraw` — withdraw simulated DAIL only when the withdrawal key is supplied in `X-DAIL-Withdrawal-Key`.
- Withdrawal idempotency prevents accidental double-withdrawals.
- Withdrawal keys are stored as SHA-256 hashes, not plaintext.

## Test configuration

Set the server environment variable:

```text
DAIL_ADMIN_KEY=<your-private-admin-key>
```

The admin key is only used to create/revoke withdrawal credentials. Never put it in agent prompts, agent tool output, source code, or the repository.

## Important

This is still a **test-mode software vault**. It does not custody real dollars, connect to a bank, or execute a real blockchain/payment payout. The withdrawal destination is represented as a ledger account such as `withdrawal:destination`.

Before real money is enabled, DAiL should add persistent encrypted storage, production key management/HSM or a managed secrets service, destination allowlisting, withdrawal limits/cooldowns, stronger authentication, approval workflows, monitoring, and a regulated payment/custody provider where required.

## Run locally

```bash
pip install -r requirements.txt
DAIL_ADMIN_KEY=my-local-admin-key uvicorn dail.api:app --reload
```

Then open `/docs` on the local server.

\n## v0.5-v0.7 Agent World
- v0.5: persistent-in-process agent profiles, capabilities, discovery and notifications.
- v0.6: agent marketplace/services with ledger settlement.
- v0.7: agent-to-agent trade settlement, world state telemetry, and Observatory economy panel.
- The Lobby remains free to enter; communication is paywalled.
- Private rooms are rentable in DAIL credits.
- Test mode only: production requires persistent storage, authentication, moderation, dispute handling and real payment/custody integrations.


## v3.5 Agent Operating Layer
Decision engine, strategies, scheduler, agent-to-agent protocol, bounded work execution, and the DAiL Black Box intent-receipt chain are included.