Spaces:
Running
Running
| title: Light Rider Quantum Entropy | |
| emoji: ⚛️ | |
| colorFrom: red | |
| colorTo: yellow | |
| sdk: gradio | |
| sdk_version: 6.30.0 | |
| app_file: app.py | |
| pinned: false | |
| tags: | |
| - quantum | |
| - randomness | |
| - entropy | |
| - quantum-computing | |
| license: apache-2.0 | |
| short_description: Quantum random bytes with signed, verifiable receipts | |
| datasets: | |
| - LightRiderInc/random-quantum-circuits | |
| # Light Rider Quantum Entropy | |
| Draw random bytes from a named quantum source: a quantum random number generator or a quantum | |
| processor. Every draw comes with a receipt, signed by Light Rider, that records which source | |
| produced the bytes and when. The app checks the signature and shows you the result. | |
| It's an alternative entropy source you can verify, not a claim that quantum randomness beats a | |
| good classical generator. If a source can't serve, the app says so; no other source is used in | |
| its place. | |
| ## Use it from your code | |
| ### macOS / Linux | |
| **For this terminal** | |
| ```bash | |
| export LR_API_KEY="lr_live_YOUR_KEY" | |
| ``` | |
| **32 bytes from one source** | |
| ```bash | |
| curl -s https://entropy.lightriderinc.com/api/v1/entropy \ | |
| -H "Authorization: Bearer $LR_API_KEY" \ | |
| -H "Content-Type: application/json" \ | |
| -H "Idempotency-Key: $(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid)" \ | |
| -d '{"bytes": 32, "mode": "source", "id": "anu"}' | |
| ``` | |
| ### Windows PowerShell | |
| **For this window** | |
| ```powershell | |
| $env:LR_API_KEY = "lr_live_YOUR_KEY" | |
| ``` | |
| **32 bytes from one source** | |
| ```powershell | |
| $headers = @{ Authorization = "Bearer $env:LR_API_KEY"; "Idempotency-Key" = [guid]::NewGuid().ToString() } | |
| $body = @{ bytes = 32; mode = "source"; id = "anu" } | ConvertTo-Json | |
| $r = Invoke-RestMethod -Method Post -Uri https://entropy.lightriderinc.com/api/v1/entropy -Headers $headers -ContentType "application/json" -Body $body | |
| $r.bytes_hex | |
| $r.receipt.contributing_sources | |
| ``` | |
| ### Python | |
| **Install (in a terminal)** | |
| ```bash | |
| pip install -U lightrider | |
| ``` | |
| **entropy_demo.py** | |
| ```python | |
| import os | |
| from getpass import getpass | |
| if not os.environ.get("LR_API_KEY"): | |
| os.environ["LR_API_KEY"] = getpass("Light Rider API key: ") | |
| import lightrider as lr | |
| for s in lr.entropy.sources(): | |
| print(s.alias or s.id, s.state, s.bytes_available) | |
| r = lr.entropy.get(32, source="anu") | |
| print(r.hex) | |
| print(r.sources, r.request_id) | |
| pool = lr.entropy.get(64, sources=["anu", "cisco"]) | |
| print(pool.sources) | |
| assert lr.entropy.verify(r.receipt) | |
| assert lr.entropy.verify_commitment(r) | |
| print("Receipt verified") | |
| ``` | |
| **Run it (in a terminal)** | |
| ```bash | |
| python entropy_demo.py | |
| ``` | |
| ### Google Colab | |
| **Cell 1: install** | |
| ```python | |
| !pip install -q -U lightrider | |
| ``` | |
| **Cell 2: your key, from Colab Secrets (key icon, name LR_API_KEY, notebook access on)** | |
| ```python | |
| import os | |
| from google.colab import userdata | |
| os.environ["LR_API_KEY"] = userdata.get("LR_API_KEY") | |
| ``` | |
| **Cell 3: draw and verify** | |
| ```python | |
| import lightrider as lr | |
| for s in lr.entropy.sources(): | |
| print(s.alias or s.id, s.state, s.bytes_available) | |
| r = lr.entropy.get(32, source="anu") | |
| print(r.hex) | |
| print(r.sources, r.request_id) | |
| pool = lr.entropy.get(64, sources=["anu", "cisco"]) | |
| print(pool.sources) | |
| assert lr.entropy.verify(r.receipt) | |
| assert lr.entropy.verify_commitment(r) | |
| print("Receipt verified") | |
| ``` | |
| Create your API key at [entropy.lightriderinc.com/developers](https://entropy.lightriderinc.com/developers). It gives full access to your account, so keep it out of public code. Sources: `anu`, `cisco`, `qispace`, `rigetti`, `iqm`, `iqm-qec`. Price: 1 credit ($0.01) per 256 bytes. | |