QFabric: Quantum Network Emulation on FABRIC (QKD and entanglement over a P4 data plane) ( public )

FABRIC Infrastructure

QFabric is a programmable quantum-network emulation platform built on the FABRIC testbed, for studying quantum network protocols as distributed systems: separate processes on separate FABRIC VMs, talking over real links.

How it works

  • Quantum channel (P4/BMv2): fiber attenuation is emulated as probabilistic drop of custom EtherType 0x7101 photon frames, P(loss) = 1 − 10−αL/10, applied per photon of a pulse so decoy-state sources ride the same path.
  • Classical channel: raw EtherType 0x7102 frames through the same switch, with an authenticated (HMAC) option.
  • Shared logical clock: a central time authority runs every node on one modeled clock, so each message lands exactly at its modeled delay and every run carries a delivery certificate.

Protocols

  • BB84 and decoy-state BB84
  • E91 / BBM92 with a CHSH test
  • n-node entanglement swapping (repeater chains)
  • A distributed gate: teleportation and non-local CNOT

All run on an unmodified SeQUeNCe 1.0, with full key distillation: Cascade, key verification, Toeplitz privacy amplification, finite-key bounds and decoy (GLLP) accounting.

What is modeled

Quantum states are statistical models (a Werner register), not photonics, and delays are modeled, not measured.

Cross-validation

The measured result, a QFabric simulation, SeQUeNCe and NetSquid run on the same slice and are checked for agreement. Missing backends are reported as SKIPPED, never a pass.

Notebooks

  • fabric/: set up the slice, run, sweep, analyse
  • sequence/: the distributed runtime and E91
  • concepts/: eavesdropper, reconciliation, repeaters, security depth, distributed computing

Required FABRIC project permissions

  • Required: VM.NoLimitCPU and VM.NoLimitDisk, or the umbrella VM.NoLimit. The slice is three VMs at one site (4 cores, 8 GB RAM, 20/20/40 GB disk, NIC_Basic, site-local L2), above FABRIC's default limits of 2 cores and 10 GB disk per VM.
  • Optional: Slice.Multisite, only for the cross-site mode.
  • Not used: SmartNIC, GPU, FPGA, NVMe or storage components; public IPs (Net.FABNetv4Ext / v6Ext); extended slice lifetime.

License: Apache-2.0. Source: github.com/kthare10/qfabric. See README.md, docs/ASSUMPTIONS.md, docs/SPEC.md and docs/ROADMAP.md.

Views
412
Downloads
65 active (100 retired)
Versions
2
Last Updated
Oct. 29, 2026, 3:20 p.m.

kthare10/qfabric

Version Created URN Downloads Actions
v1.0.0.1 7b83478 Oct. 29, 2026, 3:18 p.m. urn:git:contents:github:e28467ed-6daa-4d40-b26f-691675f1e04d 21 download
2026-09-28 Sept. 28, 2026, 3:58 a.m. urn:fabric:contents:renci:5ad91d34-3da7-4897-8c0f-fff8179b5a4f 44 download
Northeastern University — boyles.i@northeastern.edu
University of North Carolina at Chapel Hill — kthare10@email.unc.edu