An Extensible Quantum Network Simulator Built on ns-3: Q2NS Design and Evaluation

Abstract

As quantum networking hardware remains costly and not yet widely accessible, simulation tools are essential for the design and evaluation of quantum network architectures and protocols. However, designing a scalable and computationally efficient quantum network simulator is intrinsically challenging: i) quantum dynamics must be emulated on classical computing platforms while capturing the stateful and non-local nature of entanglement, a quantum resource without any classical networking analog; ii) quantum networking is inherently hybrid, as protocol execution also fundamentally depends on classical signaling. This makes a tight and faithful co-simulation of quantum operations and classical message exchanges a core requirement. In this light, we present Q2NS, a modular and extensible quantum network simulator, built on top of ns-3, designed to seamlessly integrate quantum-network primitives with ns-3's established classical protocol stack. Q2NS adopts a modular architecture that decouples protocol control logic from node- and channel-level operations, enabling rapid prototyping and adaptation across heterogeneous and evolving Quantum Internet scenarios. Q2NS natively supports multiple quantum state representations through a unified interface, allowing interchangeable state-vector, density-matrix, and stabilizer backends. We validate Q2NS through realistic use-case studies and comprehensive benchmarks, demonstrating superior computational efficiency over representative state-of-the-art alternatives, while preserving modeling flexibility. Finally, we provide a dedicated visualization tool that jointly captures physical and entanglement-enabled connectivity and supports entangled-state manipulations, facilitating an intuitive interpretation of entanglement dynamics and protocol behavior. Q2NS offers a flexible, open, and scalable simulation platform for advancing Quantum Internet research.

This work has been funded by the European Union under Horizon Europe ERC-CoG grant QNattyNet ("Quantum-Native Communication Networks: from Quantum Message to Quantum Functioning"), n.101169850. Details at https://qnattynet.quantuminternet.it

References in corpus (28)

• The Quantum Internet
• The density-matrix renormalization group in the age of matrix product states
• Quantum cryptography: Public key distribution and coin tossing
• Quantum sensing
• Area laws for the entanglement entropy - a review
• Efficient classical simulation of slightly entangled quantum computations
• A Practical Introduction to Tensor Networks: Matrix Product States and Projected Entangled Pair States
• Dynamical Decoupling of Open Quantum Systems
• Measurement-based quantum computation with cluster states
• Dynamical suppression of decoherence in two-state quantum systems
• Multi-party entanglement in graph states
• Distributed Quantum Computation over Noisy Channels
• Simulating quantum computation by contracting tensor networks
• The computational complexity of PEPS
• Experimental quantum key distribution beyond the repeaterless secret key capacity
• Robust dynamical decoupling
• Distributed Quantum Computing: a Survey
• A quantum network stack and protocols for reliable entanglement-based networks
• SeQUeNCe: A Customizable Discrete-Event Simulator of Quantum Networks
• Quantum network routing and local complementation
• Quantum++: A modern C++ quantum computing library
• NetQASM -- A low-level instruction set architecture for hybrid quantum-classical programs in a quantum internet
• Fast Stabiliser Simulation with Quadratic Form Expansions
• Intra-QLAN Connectivity: beyond the Physical Topology
• QKDNetSim+: Improvement of the Quantum Network Simulator for NS-3
• Quantum Internet Architecture: unlocking Quantum-Native Routing via Quantum Addressing
• Entanglement-Based Artificial Topology: Neighboring Remote Network Nodes
• Graph state extraction from two-dimensional cluster states