Skip to content

EMS quickstart

Request signed entropy from the Light Rider cloud in a few minutes.

1. Get an API key

Create or copy an API key from the EMS account page. Keep it private.

2. Install the official Python SDK

bash
pip install lightrider

Python 3.9 or newer is required.

3. Configure the cloud client

bash
export LR_EMS_ENDPOINT="https://ems.lightriderinc.com"
export LR_EMS_API_KEY="lr_..."
python
from lightrider import EntropyClient, Policy

with EntropyClient() as client:
    client.fetch_verifier()
    response = client.get_bytes(32, policy=Policy.QUANTUM_VERIFIED)

print(response.bytes_.hex())
print(response.receipt.quality_score)
print(response.receipt.contributing_sources)

fetch_verifier() pins the active signing key. Later calls reject invalid receipts before returning bytes.

REST example

bash
curl -X POST https://ems.lightriderinc.com/v1/entropy/request \
  -H "Authorization: Bearer $LR_EMS_API_KEY" \
  -H "content-type: application/json" \
  -d '{"bytes":32,"policy":"quantum_verified"}'

The response contains bytes_hex and a signed receipt.

Limits

  • Request size: 1 to 65,536 bytes.
  • Authentication: Authorization: Bearer <key>.
  • Default policy: highest_quality.

Next: Policies, Multi-source extraction, and Receipts.