الكود والبيانات المجمّعة ومصدر LaTeX لورقة 'Who Patches the Lightning Network? Evidence from Release Lines in Gossip, 2023-2026' (arXiv:2610.30350)
Saurabh Kumar, Bitcoin Data Labs
الورقة: arXiv:2610.30350 (HTML، PDF) · DOI 10.48550/arXiv.2610.30350 · أبحاث Bitcoin Data Labs. تُبنى على هل يحمي تنوع العملاء شبكة البرق؟ (arXiv:2610.20952)، التي تملك قواعد استنتاج العميل المستخدمة هنا.
الكود والبيانات المجمّعة ومصدر LaTeX للورقة. تصنيفات arXiv: cs.CR، والقائمة المتقاطعة cs.NI.
تاريخ قطع البيانات: 2026-10-13.
لا يحمل gossip شبكة البرق أي رقم إصدار برمجي، لذا لم يُقَس قط ما إذا كان المشغّلون يتصرفون بناءً على التنبيهات الأمنية. تستنتج الورقة خط إصدار كل عقدة عامة من LND وCore Lightning وEclair وLDK من بتات الميزات التي تعلن عنها، مقارنةً بمصدر كل إصدار، وتطبّق ذلك على لقطات gossip اليومية من مايو 2023 إلى أكتوبر 2026. تُرقّع الشبكة وفق جداول الإصدارات والمنصات، لا وفق الإفصاحات: نصف عقد LND على خط أقدم تُرقّي خلال 88 يومًا من الإصدار؛ وجاءت أكبر موجات الترقية بعد نحو يوم من إطلاق متجر تطبيقات Umbrel إصدارًا جديدًا من LND؛ ومن بين 12 إفصاحًا يمكن اختباره، رفع إفصاح Core Lightning فقط في يوليو 2026 معدل مغادرة العقد للإصدارات المتأثرة، وذلك فقط بين العقد المتأخرة بخط إصدار واحد؛ أما دعوة Core Lightning لإعادة التشغيل دون اتصال فاستجابت لها في الغالب عقد كانت بالفعل على أحدث خط. وبعد شهرين من دفعة Lightning Labs في أغسطس 2026، كانت 71% من العقد المكشوفة عند الإفصاح لا تزال تشغّل إصدارًا متأثرًا.
هل يمكن لـ gossip أن يخبرنا أي إصدار برمجي تشغّله عقدة برق؟ خط إصدارها، نعم. فمقارنة بتات الميزات التي تعلن عنها العقدة بمصدر كل إصدار من LND وCore Lightning وEclair وLDK تكشفه؛ وحيث تذكر عقد Core Lightning إصدارها، يكون الخط المستنتج مطابقًا تمامًا في 132 من 136 زوجًا من العقدة والخط.
ما مدى سرعة ترقية عقد البرق؟ نصف عقد LND تُرقّي خلال 88 يومًا من الإصدار. أما العقد الصغيرة وتلك التي تخطّت إصدارات فتتأخر كثيرًا.
هل يرقّي المشغّلون بناءً على التنبيهات الأمنية أم على إصدارات المنصات؟ تُرقّع الشبكة وفق جداول الإصدارات والمنصات، لا وفق الإفصاحات. جاءت أكبر ثلاث موجات ترقية بعد نحو يوم من إطلاق متجر تطبيقات Umbrel إصدارًا جديدًا من LND، ومنذ يونيو 2025، جاء 17% من ترقيات LND في الـ48 ساعة التي تلت إصدار منصة، وهي نوافذ تغطي 4.4% من الوقت. ومن بين 12 إفصاحًا يمكننا اختباره، سرّع إفصاح Core Lightning فقط في يوليو 2026 الترقيات، وذلك فقط بين العقد المتأخرة بخط إصدار واحد.
كم عدد العقد التي تبقى مكشوفة بعد الإفصاح؟ بعد شهرين من دفعة Lightning Labs في أغسطس 2026، كانت 71% من عقد LND المكشوفة عند الإفصاح لا تزال تشغّل إصدارًا متأثرًا.
paper/: مصدر LaTeX (main.tex، sections/، references.bib، figures/، tables/، numbers.tex)، وملف
main.pdf المُجمّع، وسكربت بناء.src/01_*.py … src/05_*.py: مراحل خط المعالجة الخمس.src/lnmetrics/: قواعد الاستنتاج المجمّدة والبيانات المرجعية: قواعد العملاء (client_fingerprint.py)، و
جدول الإصدارات مع بتات الميزات لكل إصدار (ln_release_features.json، يُقرأ بواسطة
version_fingerprint.py)، وقائمة التنبيهات مع المصدر العام لكل إفصاح (advisories.py)، وإصدارات
المنصات المؤرخة (platforms.py)، وقارئ gossip ومساعدات اللوحة (gossip.py، panel.py).data/: مخرجات JSON المجمّعة وراء كل شكل وجدول ورقم في النص.scripts/package_arxiv.py: يبني حزمة الرفع إلى arXiv.pip install -r requirements.txt
تقرأ خط المعالجة لقطات يومية من رسم بياني عام لشبكة Lightning gossip بصيغة ملفات Parquet؛ ويوثّق الملف src/lnmetrics/gossip.py
التخطيط المتوقع (gossip_daily/{nodes,policies,_quality.parquet}). بيانات gossip الأساسية
عامة؛ ولقطاتنا اليومية متاحة من المؤلف عند الطلب. وجّه خط المعالجة إليها باستخدام
export LN_PARQUET_DIR=/path/to/parquet # default: data/parquet
تقوم كل مرحلة باقتطاع مدخلاتها عند DATA_CUTOFF (src/config.py) وتكتب رسومها البيانية إلى paper/figures/، وجداولها إلى paper/tables/ وأرقامها إلى data/*.json.
python src/01_build_panel.py # node-day panel: client, release line, liveness, fleet flag (~7 min) -> data/panel/
python src/02_validate_lines.py # release-line validation and consistency checks -> Fig. 1, Table I
python src/03_upgrade_dynamics.py # adoption, time to upgrade, hazard model, platform waves -> Figs. 2-5, Table II
python src/04_advisory_exposure.py # exposure per advisory, response to disclosure, robustness -> Figs. 6-7, Tables III-V
python src/05_supporting_numbers.py # every number quoted in the text -> paper/numbers.tex
لوحة node-day (data/panel/، حوالي 1.3 GB) غير مُضمَّنة في المستودع.
يشغّل paper/build.ps1 (على Windows، باستخدام MiKTeX) التسلسل pdflatex → bibtex → pdflatex حتى تستقر المراجع؛ ويشغّله build.bat
من cmd. على الأنظمة الأخرى:
cd paper && pdflatex main && bibtex main && pdflatex main && pdflatex main
python scripts/package_arxiv.py ثم يكتب حزمة arXiv إلى dist/.
التجميعات فقط: لا تُنشر أي قائمة أو ترتيب أو تصنيف للعُقد الفردية حسب الإصدار أو المنصة أو التعرّض، لا في
الورقة ولا في data/.
يُرجى الاستشهاد بالورقة (زر Cite this repository في GitHub يعطي المدخل نفسه من CITATION.cff):
@misc{kumar2026upgradedynamics,
title = {Who Patches the Lightning Network? Evidence from Release Lines in Gossip, 2023--2026},
author = {Saurabh Kumar},
year = {2026},
eprint = {2610.30350},
archivePrefix = {arXiv},
primaryClass = {cs.CR},
doi = {10.48550/arXiv.2610.30350},
url = {https://arxiv.org/abs/2610.30350}
}
MIT (انظر LICENSE).