مشغّلو العقد: قائمة فحص v3.2.8
يعمل الإصدار v3.2.8 على شبكة الاختبار qorechain-diana منذ 12 نوفمبر 2026 (الارتفاع 9,929,500). وتشغّل الشبكة الرئيسية qorechain-vladi الإصدار v3.2.7 منذ 12 نوفمبر 2026 (الارتفاع 4,164,600، مقترح الحوكمة 16) ولم تطبّق v3.2.8، لذا لا ينطبق أي شيء في هذه الصفحة على عقدة في الشبكة الرئيسية اليوم.
هذه الصفحة هي القائمة المختصرة بما يفحصه مشغّل العقدة ويغيّره من أجل v3.2.8: المكتبات المشتركة في الحزمة، وإعدادات بيئة تشغيل العقود، وقيم app.toml الافتراضية الجديدة، ومسار REST جديد واحد، وخطوات ترقية عقدة ما زالت على v3.2.7. للدليل الكامل للعقدة راجع تشغيل عقدة.
لماذا يهم هذا. يشغّل v3.2.8 العقود الذكية على مكتبة جديدة لبيئة تشغيل العقود ويحاسب على الذاكرة وتحميل الشيفرة اللذين يستخدمهما استدعاء العقد. العقدة التي تُبقي مجلد المكتبات القديم، أو تعمل بذاكرة عقود قليلة جدًا، لن تبدأ أو ستتأخر عن السلسلة. أما بقية القائمة فأعمال إعداد صغيرة.
1. انسخ مجلد lib/ كاملًا
تحتوي حزمة الإصدار على qorechaind ومجلد lib/ فيه أربع مكتبات مشتركة:
| المكتبة | الدور |
|---|---|
libqorepqc.so | التحقق من التوقيعات ما بعد الكمومية |
libqoresvm.so | بيئة تشغيل SVM |
libwasmvm.x86_64.so | مكتبة بيئة تشغيل العقود الأصلية (upstream) |
libwasmvmqore_v1.x86_64.so | جديدة في v3.2.8: مكتبة بيئة تشغيل العقود الخاصة بـ QoreChain |
انسخ المجلد كاملًا لا ملفات منفردة. يظل السطر COPY lib/ ... في Dockerfile أو الأمر cp -r lib/* ... على خادم فعلي يعمل حين يضيف إصدار لاحق مكتبة جديدة، أما قائمة ملفات مسمّاة فلا.
tar -xzf qorechaind-v3.2.8-b3-linux-amd64.tar.gz
sudo cp qorechaind /usr/local/bin/qorechaind
sudo cp -r lib/. /opt/qorechain/lib/
وجّه المحمِّل (loader) إلى المجلد الذي نسخت إليه (قيمة LD_LIBRARY_PATH أو مدخل ld.so.conf.d الذي تستخدمه أصلًا) ثم أعد التشغيل. الأوامر أعلاه نمط عام؛ استخدم مسارات تثبيتك أنت.
2. ذاكرة التخزين المؤقت للعقود: 256 MiB على الأقل
تُبقي بيئة تشغيل العقود الشيفرات المترجمة في الذاكرة. في app.toml يجب أن يكون الإعداد memory_cache_size في قسم [wasm] 256 MiB أو أكثر:
[wasm]
memory_cache_size = 256
تُرفع أي قيمة أقل من 256 إلى 256 عند بدء العقدة، وتسجّل العقدة تحذيرًا. خطّط للذاكرة الإضافية على الأجهزة الصغيرة.
3. مجلد العقود صار <home>/wasm
تُحفظ شيفرة العقود المترجمة الآن في <home>/wasm، حيث <home> هو المجلد الذي تبدأ به العقدة (--home). العقدة التي ما زالت شيفرة عقودها في الموقع القديم تواصل استخدامه وتسجّل تحذيرًا. يمكنك نقل المجلد عند الملاءمة؛ أوقف العقدة أولًا.
4. القيم الافتراضية الجديدة في app.toml
العقدة التي تُهيَّأ بـ v3.2.8 تكتب هذه القيم الافتراضية. أما ملفات app.toml الموجودة فلا يُعاد كتابتها، فتحتفظ العقدة المرقّاة بقيمها القديمة إلى أن تغيّرها.
| الإعداد | القيمة الافتراضية الجديدة | ما يفعله |
|---|---|---|
simulation_gas_limit | 50000000 | حد الغاز للمعاملات المحاكاة على هذه العقدة. تحاكي المحافظ وSDK قبل الإرسال، والحد المرتفع يتيح محاكاة استدعاءات العقود الكبيرة |
مساحات أسماء api في JSON-RPC | eth,net,web3 | لا تُخدَّم مساحة txpool افتراضيًا لأنها تنشر المعاملات المعلّقة في العقدة. أضف txpool بنفسك فقط إن احتجتها |
simulation_gas_limit = 50000000
[json-rpc]
api = "eth,net,web3"
5. حد غاز الاستعلامات
تعمل استعلامات العقود بحد غاز محلي للعقدة يتحكم فيه قسم [wasm] في app.toml. يوصي فريق السلسلة بضبطه على 0 (بلا حد) على المدققين:
[wasm]
query_gas_limit = 0
يغيّر هذا الإعداد ما تجيب به عقدتك أنت عن استعلامات العقود فقط، ولا يغيّر ما يجب أن تحتويه أي كتلة. وهو توصية فريق السلسلة للمدققين؛ أما العقدة التي تخدم استعلامات عامة فقد تفضّل حدًا محدودًا.
6. مسار جديد: GET /qorechain/svm/v1/params
يضيف v3.2.8 مسار قراءة فقط لمعاملات وحدة SVM. تخدمه العقد التي تعمل بـ v3.2.8 (شبكة الاختبار) ويجيب بـ HTTP 501 على الشبكة الرئيسية حيث لم يُطبَّق الإصدار.
curl -s https://api-testnet.qore.host/qorechain/svm/v1/params
الإجابة من شبكة الاختبار في 12 نوفمبر 2026:
{"params":{"max_program_size":"10485760","max_account_data_size":"10485760","compute_budget_max":"1400000","lamports_per_byte":"3480","rent_exemption_multi":"2.000000000000000000","enabled":false,"svm_slot_offset":"0","default_sig_scheme":0,"max_cpi":4,"max_custody_uqor":"10000000000","max_custody_hard_uqor":"1000000000000","max_account_excess_uqor":"10000000000"}}
| الحقل | المعنى |
|---|---|
enabled | هل مسار معاملات SVM مفتوح. القيمة false على شبكة الاختبار منذ الترقية، فتُرفض كتابات SVM إلى أن تفتحه الحوكمة مجددًا |
max_program_size، max_account_data_size | حدود الحجم بالبايت (10,485,760 لكل منهما) |
compute_budget_max | أكبر ميزانية حوسبة يستطيع طلبها معاملة (1,400,000) |
lamports_per_byte، rent_exemption_multi | مدخلات سعر التخزين |
svm_slot_offset، default_sig_scheme، max_cpi | إزاحة ترقيم الفتحات (slots)، ومخطط التوقيع الافتراضي، وحد عمق الاستدعاء بين البرامج |
max_custody_uqor، max_custody_hard_uqor، max_account_excess_uqor | حدود QOR الأصلي الذي يستطيع حساب SVM حمله، بوحدة uqor |
اقرأ enabled قبل إظهار زر إرسال SVM؛ راجع تطوير SVM. أما المسار GET /qorechain/svm/v1/cluster_info فمسار منفصل يعيد هوية المجموعة (cluster).
7. افحص ملف البيان (manifest)
ملف البيان هو المرجع في معرفة أي ملف تنفيذي يجب تثبيته:
curl -s https://download.qore.host/testnet/latest.json | jq '{version, minCompatible, upgradeType, upgradeHeight, binary: .binary.url}'
في 12 نوفمبر 2026 أجاب بـ version تساوي 3.2.8 وminCompatible تساوي 3.2.8 وupgradeType تساوي height وupgradeHeight تساوي 9929500 والملف التنفيذي qorechaind-v3.2.8-b3-linux-amd64.tar.gz. تأكد أن version تساوي minCompatible قبل أن تثق بـ binary.url، وتحقق من الأرشيف مقابل sha256 في الملف نفسه. وبيان الشبكة الرئيسية في https://download.qore.host/mainnet/latest.json ويذكر v3.2.6 إلى أن يُعلن عن ترقية للشبكة الرئيسية.
8. رقِّ عقدة ما زالت على v3.2.7
انقضى ارتفاع الترقية على شبكة الاختبار، فالعقدة التي ما زالت على v3.2.7 تتوقف عند الارتفاع 9,929,500 مع الرسالة UPGRADE "v3.2.8" NEEDED. حالتها محفوظة ولا تحتاج إلى إعادة مزامنة.
- نزّل الأرشيف المذكور في البيان وتحقق من SHA-256 له.
- أوقف العقدة.
- استبدل
qorechaindوانسخ مجلدlib/كاملًا (الخطوة 1). - افحص
[wasm] memory_cache_size(الخطوة 2) وقرّر بشأنsimulation_gas_limitومساحات أسماء JSON-RPC وquery_gas_limit(الخطوتان 4 و5). - شغّل العقدة وراقب السجل. يُتوقع تحذير عن مجلد العقود أو ذاكرة التخزين المؤقت إن لم تغيّرهما.
- تأكد أنها تتابع السلسلة:
curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
curl -s https://api-testnet.qore.host/qorechain/svm/v1/params | jq '.params.enabled'
تبدأ العقدة الجديدة المنضمة إلى شبكة الاختبار من الملف التنفيذي v3.2.8 مباشرة؛ راجع الاتصال بشبكة الاختبار للمزامنة بالحالة (state sync) والأقران، وتشغيل عقدة لسجل الترقيات.
الحدود والأخطاء
| ما تراه | المعنى | ما تفعله |
|---|---|---|
UPGRADE "v3.2.8" NEEDED وتتوقف العقدة عند الارتفاع 9,929,500 | العقدة ما زالت على الملف التنفيذي v3.2.7 | القسم 8 |
| خطأ عند البدء عن مكتبة مشتركة مفقودة | لم يُنسخ lib/ كاملًا، أو المحمِّل لا يشير إليه | القسم 1 |
تحذير بأن memory_cache_size رُفع | القيمة المضبوطة أقل من 256 MiB | اضبط 256 أو أكثر |
| تحذير عن مجلد العقود | شيفرة العقود ما زالت في الموقع القديم | انقلها إلى <home>/wasm عند الملاءمة |
501 من /qorechain/svm/v1/params | العقدة ليست على v3.2.8 (الشبكة الرئيسية على v3.2.7) | متوقع على الشبكة الرئيسية |