# Verification Service ("the atom") -- API for humans and agents What this is: POST one question ("check this URL for me") and get back a signed, timestamped proof packet with evidence attached. Every verification is appended to a public, permanent ledger (the board). Base URL: https://asheraistudios.duckdns.org (replace after deploy) ## POST /verify -- perform a verification Request (JSON): {"type": "http_observation", "url": "https://example.com"} Only "http_observation" is supported in v1. SSRF-guarded: public http/https URLs only, ports 80/443, redirects are never followed, 10s timeout, 2MB cap. Response: a signed proof packet with these fields: - id ("VRF-YYYYMMDD-xxxxxxxx"), type, verdict (CONFIRMED = fetched with HTTP 2xx; UNCONFIRMED = fetched, other status; ERROR = refused or failed, see observation.reason) - target.url, observation {reachable, http_status, page_title, body_sha256, tls {subject, issuer, not_after}, dns {host, addresses}}, evidence [...] - timestamp_utc, usage {wall_time_s, bytes_in, http_requests} - cost_usd with cost_basis "estimate" (an operator-configured estimate, NOT a metered cloud bill), price_quote_usd (a QUOTE, not a charge), margin_usd, below_cost - signature: Ed25519 hex signature over the canonical JSON of every field except "signature" and "signing"; signing: {algorithm "Ed25519", public_key_hex, signed_fields} Errors: 400 invalid_json | unknown_type | missing_url | url_too_long; 429 rate_limited when over the per-IP limit (see Retry-After header). Example: curl -s -X POST https://asheraistudios.duckdns.org/verify \ -H 'Content-Type: application/json' \ -d '{"type":"http_observation","url":"https://example.com"}' ## Verify a signature yourself (no trust required) 1. GET /key -> the service's Ed25519 public_key_hex. 2. Take the packet, remove the "signature" and "signing" fields, serialize the rest as canonical JSON (keys sorted, compact separators, UTF-8). 3. Ed25519-verify the 64-byte signature against the public key with any Ed25519 implementation. A tampered packet fails verification. ## GET /verify/ -- retrieve one stored proof packet (404 if unknown) ## GET /board/feed -- the public board: append-only feed, oldest first Entries: {id, timestamp_utc, type, verdict, url} ## GET /health -- {"status", "version", "payments_enabled"} ## GET /key -- the service's Ed25519 PUBLIC key (the private key never leaves the server and is never served) ## Honesty notes (read before building on this) - price_quote_usd is a quote, not a charge. PAYMENTS ARE DISABLED: /health reports payments_enabled:false and the service cannot charge anyone. Nothing here is for sale yet. - cost_usd is an operator-configured estimate, not a metered bill. - Public use is free and rate-limited per IP; abuse is blocked.