Docs / QuBitLang

What is QuBitLang?

QuBitLang is a proprietary quantum programming language developed by Interlink Digital Group. It provides a human-readable abstraction over quantum circuit definition, compiling to Qiskit for execution on IBM Quantum hardware.

Why QuBitLang?

Traditional quantum programming requires deep knowledge of Qiskit, circuit construction, and quantum computing theory. QuBitLang abstracts this complexity into a clean, readable syntax that any developer can understand - while producing optimised quantum circuits under the hood.

How TrueEntropy Uses QuBitLang

Every random number you receive from TrueEntropy originates from a QuBitLang circuit. The core QRNG circuit applies Hadamard gates to put qubits into equal superposition, then measures them - collapsing each qubit to a truly random 0 or 1.

qrng_hadamard_v2.3.ql QuBitLang
# QuBitLang QRNG Circuit - Hadamard Standard v2.3 # Generates true quantum random bits via superposition collapse DEFINE qrng_hadamard(n_qubits) QUBIT q[n_qubits] # Apply Hadamard to every qubit - perfect superposition FOR EACH qubit IN q H(qubit) ENDFOR # Measure - quantum collapse to true random bits MEASURE q[0:n_qubits] -> result[0:n_qubits] RETURN result ENDDEFINE QUBIT q[127] qrng_hadamard(127)

Compiler Pipeline

QuBitLang compiles through a seven-stage pipeline to produce optimised Qiskit code for IBM Quantum hardware:

1

Lexer

Tokenises .ql source into a stream of typed tokens (keywords, identifiers, operators, literals)

2

Parser

Builds a concrete syntax tree from the token stream using recursive descent parsing

3

AST

Constructs an abstract syntax tree using frozen dataclasses with the Visitor pattern

4

Semantic Analyzer

Type checking, symbol resolution, scope validation, and quantum-specific constraint verification

5

IR Builder

Converts the validated AST into a quantum intermediate representation (quantum_ir.py)

6

Optimizer

Gate fusion, redundant gate elimination, circuit depth minimisation, and qubit routing

7

Qiskit Code Generator

Emits optimised Qiskit Python code for execution on IBM Quantum Runtime

QuBitLang in API Responses

Every TrueEntropy API response includes QuBitLang metadata, providing full provenance transparency:

FieldLocationExampleMeaning
qubitlang_circuitJSON body + headerqrng_hadamard_v2.3Circuit used for generation
qubitlang_versionJSON body + header1.4.0Compiler version
powered_byJSON bodyQuBitLangTechnology attribution
X-QuBitLang-CircuitResponse headerqrng_hadamard_v2.3Header-level circuit ID
X-QuBitLang-VersionResponse header1.4.0Header-level version

Hardware Portability

QuBitLang compiles to hardware-specific backends. Currently supporting IBM Quantum via Qiskit, with future targets planned:

Live

IBM Quantum (Qiskit)

156-qubit Heron processors via Qiskit Runtime