| GET /seed | Latest seed + age_ms |
| GET /seed?token=… | + frame_jpeg (base64 JPEG) |
| GET /seed/history | ?n=10 last seeds |
| GET /seed/stream | SSE — live feed |
determinoss generates cryptographic seeds from the physical chaos of a lava lamp —
inspired by Cloudflare's LavaRand system. A webcam films the lamp 24/7.
Each frame is compared to the previous one: the pixel-by-pixel difference (delta) is hashed with
SHA-256, producing a 256-bit seed that is unpredictable and physically grounded.
Static frames (no movement) are discarded. Only genuine visual entropy makes it into the pool. The last 100 seeds are kept in memory and served via REST API or real-time SSE stream.
Pass ?token=… to GET /seed to also receive the current lava lamp frame as a
base64-encoded JPEG (frame_jpeg field). Display it with
img.src = "data:image/jpeg;base64," + frame_jpeg.
The token is the same as the live view password.
Webcam captures the lava lamp at ~1 fps via ffmpeg
Per-pixel delta between consecutive frames is computed
SHA-256(delta) produces a 64-char hex seed
Seed is pushed to the server and exposed via API
