إنتقل إلى المحتوى الرئيسي

مشغّلو العقد: قائمة فحص 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_limit50000000حد الغاز للمعاملات المحاكاة على هذه العقدة. تحاكي المحافظ وSDK قبل الإرسال، والحد المرتفع يتيح محاكاة استدعاءات العقود الكبيرة
مساحات أسماء api في JSON-RPCeth,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. حالتها محفوظة ولا تحتاج إلى إعادة مزامنة.

  1. نزّل الأرشيف المذكور في البيان وتحقق من SHA-256 له.
  2. أوقف العقدة.
  3. استبدل qorechaind وانسخ مجلد lib/ كاملًا (الخطوة 1).
  4. افحص [wasm] memory_cache_size (الخطوة 2) وقرّر بشأن simulation_gas_limit ومساحات أسماء JSON-RPC وquery_gas_limit (الخطوتان 4 و5).
  5. شغّل العقدة وراقب السجل. يُتوقع تحذير عن مجلد العقود أو ذاكرة التخزين المؤقت إن لم تغيّرهما.
  6. تأكد أنها تتابع السلسلة:
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)متوقع على الشبكة الرئيسية

الصفحات ذات الصلة​