GET /get-random

Base URL: https://vrf-core-production.up.railway.app/

What it does

Generates:

• a seed (32 bytes, hex)
• a VRF output (hex, produced by the core VRF implementation)
• optionally a public key and a commitment

This endpoint is useful for off-chain randomness experiments and proof verification with /verify-random.

It is not the same format as the on-chain commit/reveal payloads (use GET /payloads for that).

Query parameters

• seed (optional, hex, 32 bytes): if provided and valid, it will be used; otherwise the server generates a random 32-byte seed.
• proof (optional, boolean): If true, include public_key.
• commit (optional, boolean): If true, include commitment.

Example

curl -s "https://vrf-core-production.up.railway.app/get-random?proof=true&commit=true"

Response

{
  "seed": "<hex>",
  "randomness": "<hex>",
  "public_key": "<hex>",
  "commitment": "<hex>"
}

Field notes

• public_key is included only when proof=true.
• commitment is included only when commit=true.
• /commit here is sha256(seed) (not sha256(seed || salt) used by the on-chain contract workflow).