Frequently Asked Questions
Common questions about TrueEntropy, quantum random number generation, and API usage.
General
What makes TrueEntropy different from Math.random() or /dev/urandom?
Math.random() and /dev/urandom use pseudo-random number generators (PRNGs) -
deterministic algorithms seeded with system entropy. Given the seed, outputs are entirely predictable.
TrueEntropy uses real quantum measurements from IBM quantum hardware, producing values that are
fundamentally unpredictable by the laws of physics. Every response is verified against NIST SP800-22.
What is QuBitLang?
QuBitLang is the quantum programming language that powers TrueEntropy. It compiles quantum circuits and executes them on IBM quantum hardware. Every API response includes the QuBitLang circuit version and compiler details for full provenance.
Which quantum hardware do you use?
TrueEntropy runs on IBM's 156-qubit Heron processors (e.g. ibm_fez, ibm_marrakesh).
The exact backend used for each request is included in the response metadata and
X-Quantum-Backend header.
API & Integration
What's the latency of API requests?
Typical response times are 50–200ms. TrueEntropy maintains a pre-generated entropy pool so you don't wait for real-time quantum execution on every request. The quantum hardware runs continuously to keep the pool filled.
What are the rate limits?
Rate limits depend on your plan tier. See the Rate Limiting
docs for full details. The X-RateLimit-Remaining header shows your remaining quota on every response.
Can I use TrueEntropy in production?
Yes. TrueEntropy is designed for production use. All SDKs include automatic retries, rate limit
handling, and connection pooling. Use a te_live_ key for production and te_test_
for sandbox testing.
Do you have SDKs for my language?
Official SDKs are available for Python, JavaScript/Node.js, and PHP. For other languages, use the REST API directly - it's a simple JSON API that works with any HTTP client.
Security & Compliance
Is the entropy truly random?
Yes - provably so. Quantum measurement outcomes are fundamentally random according to the Born rule of quantum mechanics. There is no hidden state, no seed, and no algorithm. Each bit is the result of a Hadamard-gate superposition collapsing upon measurement. This is verified by passing all 15 NIST SP800-22 tests and 114 Dieharder tests on every response.
Can I use TrueEntropy for UKGC-licensed gambling?
Yes. TrueEntropy provides a dedicated UKGC RTS 7 Compliance Pack with all documentation needed for regulatory submissions. Contact compliance@trueentropy.net for access.
What is a provenance certificate?
Every API request generates a provenance certificate -
a cryptographically signed record containing the QuBitLang circuit, quantum backend, NIST test results,
and SHA-256 hash chain. Certificates can be publicly verified at
trueentropy.net/verify/.
Do you store the random values you generate?
No. TrueEntropy does not store the actual random values delivered to you. We store only the cryptographic hashes (in provenance certificates) so the chain of custody can be verified without exposing the values themselves.
Billing & Plans
Is there a free tier?
Yes. The free tier includes 1,000 API requests per month - enough to evaluate TrueEntropy and prototype integrations. No credit card required.
How does billing work?
Plans are billed monthly via Stripe. Usage is counted by API requests. You can monitor your usage in real-time from the dashboard.