2025-12-22 19:37:41 +01:00
|
|
|
# amduat-api registry (draft)
|
|
|
|
|
|
|
|
|
|
This directory mirrors the core `vendor/amduat/registry/` model for the
|
|
|
|
|
**amduatd HTTP API contract**.
|
|
|
|
|
|
|
|
|
|
## Goal
|
|
|
|
|
|
|
|
|
|
- Keep a stable, machine-readable API contract in-repo.
|
|
|
|
|
- Seed that contract into the daemon's single ASL store root at startup.
|
|
|
|
|
- Advertise the store-backed contract `ref` via `GET /v1/meta`.
|
|
|
|
|
|
|
|
|
|
The daemon remains thin: the contract bytes are data, and the store-backed `ref`
|
|
|
|
|
acts as the version identifier.
|
|
|
|
|
|
|
|
|
|
## Files
|
|
|
|
|
|
|
|
|
|
- `api-contract.schema.md` — JSONL manifest schema for API contracts.
|
|
|
|
|
- `api-contract.jsonl` — manifest of published contracts.
|
|
|
|
|
- `amduatd-api-contract.v1.json` — contract bytes (v1).
|
2026-02-07 19:46:59 +01:00
|
|
|
- `amduatd-api-contract.v2.json` — draft contract bytes (v2, PEL-only writes).
|
2025-12-22 19:37:41 +01:00
|
|
|
|
2026-01-21 19:51:26 +01:00
|
|
|
Receipt note:
|
|
|
|
|
- `/v1/pel/run` accepts optional receipt v1.1 fields (executor fingerprint, run id,
|
|
|
|
|
limits, logs, determinism, rng seed, signature) and emits `receipt_ref` when
|
|
|
|
|
provided.
|
