منصوبے کے بارے میں

موہاک نیکسس موہاک نیٹ ورک اسٹیک کے لیے بنیادی انٹیگریشن ورک اسپیس ہے۔ یہ کئی اجزاء کو ایک ہی ریپوزٹری میں جمع کرتا ہے تاکہ انہیں ایک ساتھ بنایا، تصدیق اور جانچا جا سکے۔ ورک اسپیس لے آؤٹ - SMIP-MWP: Go کنٹرول پلین جو AF_XDP ہوسٹ انٹیگریشن، روٹنگ، کرپٹو بائنڈنگز اور برج ریکویسٹ انجیشن کا احاطہ کرتا ہے۔ - SMIP-MWP-Rust: Rust ڈیٹا پاتھ جس میں فارورڈنگ پائپ لائن، ہائی پرفارمنس ڈیٹا پلین اور CLI ٹولز شامل ہیں۔ - Sovereign-Mohawk-Proto: پروٹوکول تعریفات، اسکیما ارتقا اور رسمی تصدیقی اثاثے۔ - bridge: کینونیکل برج اسکیما، مینی فیسٹ اور ریکویسٹ مثالیں جو روٹ ویلیڈیشن میں استعمال ہوتی ہیں۔ - scripts: ورک اسپیس سطح کی جنریشن، ویلیڈیشن اور ٹیسٹ ہیلپرز۔ - go.work Go ماڈیولز کو آپس میں جوڑتا ہے۔ تقاضے اور سیٹ اپ Go (قابلِ تولید بلڈز کے لیے 1.26.1 پن شدہ؛ زیادہ تر مقامی ورک فلو کے لیے 1.22+ متوقع ہے)، Python 3.8+، کنٹینرائزڈ پرفارمنس/اسٹریس رنز کے لیے Docker، اور Rust ٹول چین صرف اس وقت جب مقامی طور پر Rust ڈیٹا پاتھ ٹیسٹ چلائے جائیں۔ ایک devcontainer کنفیگریشن Codespaces/Dev Containers کے لیے Go کو پن کرتی ہے، اور sudo کے بغیر مقامی Go انسٹال کے لیے ہدایات فراہم کی گئی ہیں۔ ڈیوائس مطابقت ایک میٹرکس معاون پروفائلز بیان کرتی ہے: AF_XDP کے قابل NICs والے Linux x86_64 سرورز (تیز رفتار)، Linux arm64 سرورز/ایج نوڈز، Raspberry Pi/ARM SBCs، macOS اور Windows ڈیولپر مشینیں، اور بغیر privileged pods کے منظم Kubernetes (پورٹیبل)۔ تیز رفتار AF_XDP ڈیٹا پاتھ صرف Linux کے لیے ہے؛ پورٹیبل ورک فلو کنٹرول، FL اور SWIP سروسز کے ساتھ برج ویلیڈیشن کا احاطہ کرتے ہیں۔ رن ٹائم پروفائلز پورٹیبل، تیز رفتار اور تجرباتی ہیں۔ استعمال عام Make ٹارگٹس میں bootstrap، status، verify، generate-bridge، validate-bridge، verify-go، bridge-smoke اور verify-rust شامل ہیں۔ ایک مقامی FL کوئک اسٹارٹ docker-compose کے ذریعے دو کلائنٹس کے ساتھ کوآرڈینیٹر بناتا اور چلاتا ہے۔ پرفارمنس اور اسٹریس ہارنسز scripts/bench.sh اور ایک اسٹریس Dockerfile کے ذریعے چلتے ہیں، جو SMIP-MWP/benchmarks/ کے تحت بینچ مارک آؤٹ پٹ اور pprof آرٹیفیکٹس لکھتے ہیں۔ صلاحیتیں - ہائی پرفارمنس ڈیٹا پاتھ: کم تاخیر پیکٹ پروسیسنگ کے لیے Rust فارورڈر کے ساتھ AF_XDP انٹیگریشن۔ - پلگ ایبل کرپٹو: ہم آہنگ اور غیر ہم آہنگ پرائمیٹوز کے ساتھ in-place انکرپشن/ڈکرپشن تاکہ ایلوکیشنز کم ہوں۔ - برج کنٹریکٹ ویلیڈیشن: کینونیکل اسکیما اور مینی فیسٹ کے ساتھ روٹ کے زیرِ ملکیت ویلیڈیٹرز اور مثالی پے لوڈز کے لیے قابلِ تولید SHA256 چیکس۔ - مربوط ٹیسٹ ہارنسز جو قابلِ تکرار آرٹیفیکٹس اور pprof پروفائلز پیدا کرتے ہیں۔ - CI کے لیے موزوں تصدیق: make verify روٹ سطح کی ویلیڈیشن چلاتا ہے بغیر غیر مطبوعہ سب ریپو SHAs پر انحصار کے۔ - Dockerfiles اور اسکرپٹس کے ذریعے کنٹینرائزڈ پرفارمنس رنز۔ README میں AMD EPYC ہارڈویئر پر اندرونی مائیکرو بینچ مارک اعداد و شمار (فارورڈنگ، ملٹی پاتھ اسپریئنگ، کرپٹو، سیشن/روٹنگ، AF_XDP) بھی رپورٹ کیے گئے ہیں، اس انتباہ کے ساتھ کہ نتائج CPU، کرنل، NIC اور کرنل بائی پاس کنفیگریشن پر منحصر ہیں۔ یہ نوٹ کرتا ہے کہ پروجیکٹ خام زیادہ سے زیادہ پیکٹ ریٹس پر حفاظت، رسمی طریقوں، ملٹی پاتھ اسپریئنگ اور خودمختار خصوصیات کو ترجیح دیتا ہے۔ برج کنٹریکٹ ٹولنگ میں کینونیکل آرٹیفیکٹس دوبارہ بنانے، Go/Rust/Python/TypeScript کے لیے SDK برج کانسٹنٹس دوبارہ بنانے، اور مینی فیسٹ اور ہیشز کی توثیق کرنے کے اسکرپٹس شامل ہیں؛ bridge/bridge_contract.version.json اسکیما اور مینی فیسٹ ورژنز کو ٹریک کرتا ہے۔ CI ریپوزٹری روٹ سے make verify چلاتا ہے۔ ورک اسپیس ملٹی لائسنس ہے کیونکہ یہ مختلف اپ اسٹریم لائسنسوں والے اجزاء کو جمع کرتا ہے، جو LICENSE اور LICENSES.md میں دستاویزی ہیں۔