collaborative-randomness

Keygen

Generate a fresh ML-DSA-65 signing key pair and an ECDH P-256 encryption key pair. Returns publicKey, secretKey (signing), encryptionPublicKey, encryptionSecretKey — all base64. Store these securely; the server never retains them.

Create Room

Create a new collaborative randomness room (or retrieve an existing one with the same words). The room collects entropy seeds from multiple participants before generating a verifiable result. Optionally supply publicKey + secretKey (from keygen) to associate your identity and benefit from plan limits — both are required together to prove ownership.

Get Room

Fetch the current state of a room by its roomHash. Returns all submitted seeds (with their hashes), the server commitment if already generated, and any stream entries. No secret word required.

Submit Seed

Submit an entropy seed to a room under your participant name. The seed is hashed (SHA-512) and the hash is immediately public; the raw seed is revealed only after the room is generated. Requires the room secret word. Optionally sign the seed with your ML-DSA-65 secretKey for verifiable authorship.

Generate Result

Lock the room and generate the verifiable result. The server adds its own random seed, combines all participant seeds, computes SHA-512(serverSeed|name|place|animal|thing|secretWord|...participantSeeds) as the commitment, and reveals all seeds. After this no more seeds can be submitted. Requires secret word and at least one submitted seed.

Generate Numbers

Generate a batch of verifiable random numbers from a room that has already been generated. Each number is derived as SHA-512(commitment|sequenceNumber|nonce) and can be independently verified with a single shell command. Returns the numbers as unsigned 32-bit integers alongside hex digests and verification commands.

Delete Room

Permanently delete a room and all its seeds, stream entries, and participant keys. This is irreversible. Requires the room secret word.

Create Mailbox

Create a Tiny Mailbox (or retrieve an existing one with the same words). A mailbox is a shareable address where visitors can announce themselves with their encryption public keys. Optionally supply publicKey + secretKey (from keygen) to associate your identity for plan tracking — both are required together to prove ownership.

Get Mailbox

Fetch basic info about a mailbox (creation time). No secret word required.

Get Mailbox Visitors

List active visitors in a mailbox (those who announced themselves within the last 30 minutes). Each visitor entry includes their publicKeyHash, publicKey, and encryptionPublicKey — the information needed to send them encrypted messages.

Delete Mailbox

Permanently delete a mailbox and all its visitors and messages. This is irreversible. Requires the mailbox secret word.