--- name: lavarnd.up.railway.app description: lavarnd.up.railway.app provides hardware-derived entropy and randomness primitives sourced from live lava lamp image pixel sampling. It exposes four endpoints: an entropy quality metric, a random password generator, and two random hash outputs (SHA3-256 and SHA256). All outputs are single-shot, pay-per-call, and require no input parameters. host: lavarnd.up.railway.app --- # lavarnd.up.railway.app This host serves agents and applications that need unpredictable, hardware-sourced random values rather than software PRNG outputs. It is distinct from deterministic hash services because its outputs are derived from physical lava lamp pixel data, making them non-reproducible. It covers three use cases: measuring entropy quality, generating a ready-to-use password, and obtaining a random hash string for seeding or nonce purposes. ## When to use this host Use this host when an agent requires non-deterministic, hardware-sourced random values — entropy scores, random hashes, or a single strong password — and software PRNG outputs are insufficient or undesirable. Do not use it for hashing caller-supplied data (use a standard cryptographic library instead), for bulk or streaming random number generation (this is single-shot per call), for passwords with custom length or charset requirements, or for cryptographic key generation where full entropy provenance audit trails are required. If high-throughput randomness is needed, a dedicated CSPRNG service or HSM-backed API is more appropriate. ## Capabilities ### Entropy Quality Measurement Provides a quantitative measure of randomness quality by computing Shannon entropy over sampled lava lamp pixels, useful for auditing entropy sources or gating cryptographic operations. - **`fetch-lava-entropy-score`** — Computes Shannon entropy over 1,024 randomly sampled lava-lamp image pixels and returns an entropy score and total bit count indicating randomness quality. ### Hardware-Derived Random Hashes Returns unpredictable hash strings (SHA256 or SHA3-256) sourced from physical lava lamp pixel sampling, suitable as random seeds, nonces, or entropy strings. - **`fetch-lava-sha256-entropy`** — Returns a SHA256 hash derived from 512 random pixels sampled from live lava lamp images, suitable for use as an entropy or randomness string. - **`fetch-lava-sha3-256`** — Returns a SHA3-256 hash derived from 512 random pixels sampled from live lava lamp images, providing hardware-entropy-based randomness. ### Random Password Generation Generates a single 16-character high-entropy password derived from lava lamp pixel randomness, returning the password, its length, and the character set used. - **`fetch-lava-password`** — Generates a 16-character high-entropy password derived from cryptographically-random pixels, returning the password string, its length, and the character set used. ## Workflows ### Entropy-Gated Seed Acquisition *Use when an agent needs to verify that hardware entropy quality is sufficient before consuming a random hash as a seed or nonce.* 1. **`fetch-lava-entropy-score`** — Measure current entropy quality; proceed only if the returned entropy score meets the agent's minimum threshold. 2. **`fetch-lava-sha3-256`** — Retrieve a hardware-derived SHA3-256 hash to use as a seed or nonce, now that entropy quality has been confirmed. ### Entropy-Gated Password Generation *Use when an agent needs to confirm randomness quality before issuing a hardware-derived password to a user or system.* 1. **`fetch-lava-entropy-score`** — Check that the current entropy score is above an acceptable threshold before generating a password. 2. **`fetch-lava-password`** — Generate a 16-character password from lava lamp entropy, confident that the underlying randomness quality is adequate. ## Skill reference ### `fetch-lava-entropy-score` **Lava Entropy Score** — Computes Shannon entropy over 1,024 randomly sampled lava-lamp image pixels and returns an entropy score and total bit count indicating randomness quality. *Use when:* Use when an agent needs a hardware-derived randomness quality metric, such as seeding a PRNG, auditing entropy sources, or verifying unpredictability before a cryptographic operation. *Not for:* Do not use for generating random numbers directly or for bulk entropy data streams; this endpoint returns a single entropy measurement per call. **Returns:** Returns a JSON object with entropy (Shannon entropy score as a float) and bits (total entropy in bits as a float) computed from 1,024 sampled lava-lamp image pixels. **Example:** `GET https://lavarnd.up.railway.app/lava-entropy` --- ### `fetch-lava-password` **Lava PixelPass Password Generator** — Generates a 16-character high-entropy password derived from cryptographically-random pixels, returning the password string, its length, and the character set used. *Use when:* Use when an agent or user needs a single strong, randomly generated password and wants the raw password string along with its length and allowed character set returned as structured JSON. *Not for:* Do not use for bulk password generation or for passwords requiring custom length or charset constraints — this endpoint returns a fixed 16-character password with a predefined charset. **Returns:** Returns a JSON object with a 16-character random password string, its length (16), and the charset string defining all possible characters used. **Example:** `GET https://lavarnd.up.railway.app/lava-password` --- ### `fetch-lava-sha3-256` **LavaLamp SHA3-256** — Returns a SHA3-256 hash derived from 512 random pixels sampled from live lava lamp images, providing hardware-entropy-based randomness. *Use when:* Use when an agent needs a single unpredictable SHA3-256 hash sourced from physical entropy (lava lamp pixel sampling) rather than a software PRNG or deterministic hash. *Not for:* Do not use for hashing specific input data; this endpoint produces a random hash from lava lamp entropy, not a hash of caller-supplied content. Not suitable for bulk or streaming random number generation. **Returns:** Returns a JSON object with a single field sha3_256 containing a 64-character hex SHA3-256 hash generated from live lava lamp entropy. **Example:** `GET https://lavarnd.up.railway.app/lava-sha3-256` --- ### `fetch-lava-sha256-entropy` **LavaLamp SHA256** — Returns a SHA256 hash derived from 512 random pixels sampled from live lava lamp images, suitable for use as an entropy or randomness string. *Use when:* Use when an agent needs a hardware-entropy-derived random value or unpredictable seed string, sourced from physical lava lamp randomness rather than a software PRNG. *Not for:* Do not use for cryptographic key generation requiring auditable entropy provenance, or for high-throughput random number generation — this is a single-shot, pay-per-call endpoint. **Returns:** Returns a JSON object with a single 'sha256' field containing a 64-character hex string derived from live lava lamp pixel entropy. **Example:** `GET https://lavarnd.up.railway.app/lava-sha256` ---