Topological State-Aware Simulation Framework for Inter-Satellite Twin-Field QKD Networks (Simulation Artifacts)

This repository contains the official simulation framework, exported datasets, and figure generation tools accompanying the manuscript: "Topological State-Aware Simulation Framework for Inter-Satellite Twin-Field QKD Networks", submitted to IEEE QCE 2026. Overview To bridge the gap between abstract quantum protocols and practical space deployments, this artifact provides a strictly modular simulation framework for Twin-Field Quantum Key Distribution (TF-QKD) over dynamic Inter-Satellite Links (ISLs). It departs from standard monolithic architectures to evaluate composable finite-key security under non-IID orbital turbulence. The simulation framework integrates three core layers: Rigorous Physical Substrate: Models orbital pass geometries, diffraction, atmospheric slant-paths, and stochastic pointing jitter. Topological Control Layer: A public-only acceptance gate built using Cellular Sheaves, discrete Hodge Laplacians, and Topological Data Analysis (TDA) via Persistent Homology. Finite-Key Security Ledger: A mathematically strict Generalized Entropy Accumulation Theorem (GEAT) continuous LP solver with stochastic binomial noise injection to prevent floating-point vulnerabilities. Repository Contents simulator: The core Python engine for discrete-time TF-QKD and orbital simulation. data_paper: The exact exported JSON telemetry, provenance metadata, and ledger data used in the manuscript's evaluation. tools/: Python scripts to fully reproduce the topological diagnostics (Persistent Landscapes, Phase Portraits) and the GEAT finite-size ablation figures. By structurally separating quantum execution from topological gating, this framework demonstrates how to rescue TF-QKD from finite-size entropy collapse, establishing algorithmic topological state-awareness as a fundamental prerequisite for space-based quantum networks.