إصدار SX — عفريت الخادم
إصدار SX (تجربة الخادم - Server eXperience) هو العقدة الخفيفة بلا واجهة: عفريت إضافةً إلى سطر أوامر إدارة كامل، مبني للخوادم والأتمتة. الثنائي هو lightnode-sx. إصدارات العقدة الخفيفة على خط خاص بها، منفصل عن إصدار السلسلة: تحمل قناتا الشبكتين كلتيهما 3.1.14 (13 نوفمبر 2026). تشير هذه الصفحة إلى المواضع التي تتطلب فيها ميزة ما الإصدار 3.1.11 أو أحدث.
التثبيت
الثنائيات الجاهزة هي الطريق الأسهل. عميل العقدة الخفيفة ثنائي ساكن واحد بحجم نحو 13 ميغابايت، بلا مكتبات أصلية يجب تثبيتها: تتوفر بناءات لينكس (amd64، arm64)، وماك macOS (Intel، Apple Silicon)، وويندوز (amd64، arm64) لكلا الإصدارين، أي 12 ثنائيًا إجمالًا لكل إصدار. توقّع العقدة معاملاتها بنفسها، لذا لا حاجة إلى أي شيء آخر (ولا سيما qorechaind) لتسجيل عقدة وتشغيلها.
تحقَّق من المجموع الاختباري قبل تشغيله. يحمل بيان الإصدار على https://download.qore.host/<net>/lightnode/latest.json قيمة sha256 لكل ثنائي، وحقل checksums.url يشير إلى ملف SHA256SUMS يغطي الإصدار بأكمله، وقيمة checksums.sha256 لذلك الملف نفسه. تحقَّق مما حمَّلته: فهو الفارق بين تشغيل الثنائي الذي بُني فعلًا وتشغيل أيًّا كان ما هبط على ذلك الرابط. خذ الإصدار من البيان، وخذ الثنائي وملف SHA256SUMS الخاص به من المسار نفسه الذي يحمل رقم الإصدار:
NET=mainnet # or testnet
V=$(curl -fsS https://download.qore.host/$NET/lightnode/latest.json | jq -r .version) # 3.1.14 on both networks today
F=lightnode-sx-linux-amd64 # see the artifact list in latest.json
curl -fsSLO https://download.qore.host/$NET/lightnode/v$V/$F
curl -fsSLO https://download.qore.host/$NET/lightnode/v$V/SHA256SUMS
grep " $F\$" SHA256SUMS | sha256sum -c - # macOS: shasum -a 256 -c -
chmod +x $F
استخدم ملف SHA256SUMS الذي يحمل رقم الإصدار (.../v$V/SHA256SUMS) مع الثنائي الذي يحمل رقم الإصدار. أما .../lightnode/SHA256SUMS غير المرقَّم فيتبع البيان، وقد يتأخر بضع ساعات عن إصدار جديد، فقد يفشل فحص ثنائي مرقَّم مقابله.
على ويندوز، قارن ناتج certutil -hashfile lightnode-sx-<platform>.exe SHA256 بقيمة البيان. يقبل البيانان الإصدار 3.1.9 وما بعده (minCompatible: 3.1.9). المصدر عام على github.com/qorechain/qorechain-lightnode (Apache 2.0). يُرفَق بناء Android بإصدار GitHub بوصفه معاينة؛ وهو لا يسجّل ولا يكسب مكافآت.
يمكنك أيضًا بناء الثنائي من المصدر أو تشغيله عبر Docker.
البناء من المصدر
تتطلب العقدة الخفيفة Go 1.26.1. تشفيرها ما بعد الكمّي هو تطبيق بلغة Go خالصة (بلا CGO، بلا مكتبة أصلية)، لذا فإن البناء المتقاطع لأي من المنصات الست المدعومة يعمل بنفس الطريقة التي يعمل بها أي ثنائي Go آخر:
go build -o build/lightnode-sx ./cmd/lightnode-sx/
ابنِ من وسم الإصدار الذي يسميه البيان (git checkout v3.1.14 اليوم). ينتج هذا build/lightnode-sx. شغِّله مباشرة، أو انسخه إلى PATH الخاص بك. قبل التسجيل، تحقَّق من سلامة حزمة التوقيع ما بعد الكمّي عبر selftest.
Docker
الصور المنشورة عامة ويمكن سحبها دون مصادقة: ghcr.io/qorechain/qorechain-lightnode-sx وghcr.io/qorechain/qorechain-lightnode-ux، لكل منهما الوسمان latest وv<version> (مثلًا v3.1.14). يستخدمهما ملف docker-compose.yml في الفرع main من مستودع المصدر، ويعود إلى البناء من المصدر (Dockerfile.sx وDockerfile.ux) عندما يتعذّر الوصول إلى السجل. لتثبيت إصدار بعينه، غيّر وسم image: في ملف compose؛ ولبناء الصورة من وسم إصدار بدلًا من ذلك، نفّذ git checkout v<version> ثم docker compose build. تنتقل المفاتيح والإعدادات ووحدة تخزين البيانات كما هي عند التحديث.
git clone https://github.com/qorechain/qorechain-lightnode
cd qorechain-lightnode
export QORE_LIGHTNODE_KEYRING_PASSPHRASE='...' # node keyring (node key + operator key)
export QORECHAIN_RPC_ADDR=https://rpc.qore.host # testnet: https://rpc-testnet.qore.host
docker compose pull # fetches the released image
# Once: the same setup as outside Docker, written into the data volume.
docker compose run --rm lightnode-sx onboard
docker compose run --rm lightnode-sx keys add-operator --recover
docker compose run --rm lightnode-sx register --delegate-to qorvaloper1...
docker compose up -d lightnode-sx
docker compose run --rm lightnode-sx status
أبقِ QORECHAIN_RPC_ADDR مُصدَّرًا مع كل أمر docker compose: فهو يتجاوز rpc_addr من ملف الإعدادات. منذ 3.1.10 يضبط ملف compose قيمته الافتراضية على RPC الشبكة الرئيسية https://rpc.qore.host، لذا يجب على عقدة شبكة الاختبار أن تصدّر https://rpc-testnet.qore.host وإلا ستتابع الشبكة الرئيسية. تحفظ حاوية SX بياناتها، بما فيها حلقة المفاتيح، في وحدة تخزين مسمّاة مركَّبة عند /root/.qorechain-lightnode.
توقّع العقدة توقيعًا أصليًا داخل الحاوية، لذا لا حاجة إلى أي شيء آخر. ولا تزال صورة SX تحمل qorechaind منشورًا (v3.2.0، لـ linux/amd64 فقط، يُفحص مقابل بصمة مثبَّتة) من أجل البديل الاحتياطي qorechaind: يركِّب docker-compose.yml المجلد ~/.qorechaind (أو QORECHAIND_HOME) عند /root/.qorechaind ويمرّر QORE_LIGHTNODE_QORECHAIND_PASSPHRASE لذلك المسار. أما العقدة التي يوجد مفتاح مشغِّلها في حلقة مفاتيحها الخاصة فلا تستخدم أيًّا منهما.
التحديث
-
العقدة الخفيفة 3.1.11 وما بعدها، خارج Docker. كل 6 ساعات تقرأ العقدة
https://download.qore.host/<net>/lightnode/latest.jsonلشبكتها هي (الشبكة الرئيسية لـqorechain-vladi، وشبكة الاختبار لـqorechain-diana، ولا شيء للسلاسل الأخرى). البيان مجرد تلميح. لا تثبّت العقدة إصدارًا إلا إذا تحققت كل الشروط التالية:- أن يكون
v<version>/SHA256SUMS.sigتوقيع Ed25519 صالحًا، صادرًا عن مفتاح الإصدار المدمج في الثنائي، على الشبكة والإصدار ومحتوياتSHA256SUMS؛ - أن يطابق الثنائي، المجلوب من المسار المرقَّم الخاص بالقناة نفسها (لا تُتبَع روابط البيان)، مجموعه الاختباري الموقَّع؛
- أن يعمل الثنائي الجديد ويُبلّغ بالضبط عن
v<version>.
ثم تحتفظ بالثنائي السابق باسم
<name>.oldوتعيد التشغيل في مكانها: العملية نفسها على لينكس وmacOS (فتبقى خدمة systemd قائمة)، أما على ويندوز فيبدأ الثنائي الجديد ويخرج القديم (اضبط الخدمة على إعادة التشغيل عند الخروج). - أن يكون
-
الإعدادات.
[update] mode = "auto"(الافتراضي، وكذلك لملف إعدادات بلا هذا القسم) يعلن ويثبّت؛ و"notify"يعلن فقط؛ و"off"لا يفحص. يدويًا:lightnode-sx update --check، ثمlightnode-sx update، ثم أعد تشغيل العقدة. -
رؤية الإعلان. تسجّل العقدة وجود إصدار أحدث وتقدّمه على واجهة API للوحة التحكم المحلية عند
GET /api/update(الحقولnetworkوmodeوcurrentوlatestوmin_compatibleوnotesوupdate_availableوmandatoryوcan_installوblockedوlast_checkوlast_error)؛ وتعرض لوحة UX شريطًا. -
حاوية أو مجلد غير قابل للكتابة. تكتفي العقدة بالإعلان: حدّث الصورة أو الملف بنفسك.
-
العقدة الخفيفة 3.1.11 وما بعدها تثبّت الإصدارات الجديدة بنفسها خلال 6 ساعات من نشرها (جرى التحقق على عقدة اختبار في شبكة الاختبار).
-
العقدة الخفيفة 3.1.10 وما قبلها لا تحدّث نفسها. ثبّت الإصدار 3.1.14 يدويًا مرة واحدة: نزّل الثنائي المرقَّم من مسار البيان (راجع التثبيت)، وتحقق منه، واستبدل الملف وأعد التشغيل. بعد ذلك تتبع العقدة قناتها.
-
Docker. تُبلَّغ عقدة Docker بوجود إصدار جديد (في السجل وعبر
GET /api/update) لكنها لا تستبدل نفسها أبدًا؛ والسحب هو التحديث:docker compose pull && docker compose up -d(أبقِQORECHAIN_RPC_ADDRمُصدَّرًا). والبديل هو البناء من وسم المصدر الجديد.
التهيئة
تقرأ العقدة الخفيفة ملف إعدادات TOML. افتراضيًا تبحث عن config.toml في الدليل الرئيسي (~/.qorechain-lightnode/config.toml). عادةً لا تكتب هذا الملف يدويًا — يُنشئه لك معالج onboard — لكن من المفيد فهم الخيارات.
ينطبق علمان دائمان على كل أمر:
--config <path>— أشِر إلى ملف إعدادات في موقع غير افتراضي.--home <dir>— تجاوز الدليل الرئيسي المستخدَم للبيانات والمفاتيح (الافتراضي~/.qorechain-lightnode).
أكثر خيارات التهيئة صلةً، على مستوى الاستخدام:
| الخيار | ما يتحكم به |
|---|---|
chain_id | معرّف الشبكة (qorechain-vladi على الشبكة الرئيسية، qorechain-diana على شبكة الاختبار). يقرؤه onboard من نقطة نهاية RPC؛ وإذا تعذّر الوصول إلى نقطة النهاية أثناء onboard، تبقى القيمة الافتراضية qorechain-diana ويجب أن تضبطه بنفسك. تُوقَّع المعاملات لهذه السلسلة. |
rpc_addr | نقطة نهاية RPC للسلسلة التي يتصل بها العفريت. اتركها فارغة للتشغيل في الوضع المحلي فقط. |
primary_addr / witness_addrs | نقطة نهاية RPC الأساسية، ونقاط نهاية الشهود التي تُثبَت الترويسة المُبلَّغ عنها في مقابلها — راجع لماذا تشغِّل عقدة خفيفة. وجود شاهد واحد مميّز وقابل للوصول على الأقل هو ما ينقل قيمة assurance (المسجَّلة على مستوى debug) من trusted-single-source إلى corroborated-across-sources. |
trust_period / max_clock_drift | مقبولان للتوافق لكنهما غير مستخدمين حاليًا. تأتي ثقة الترويسة من تثبيت الأساسي/الشهود الموصوف أعلاه. |
data_dir | حيث تخزِّن العقدة قاعدة بياناتها وترويساتها. |
keyring_backend / key_name | خلفية حلقة المفاتيح (file أو os، أو test لشبكات التطوير المحلية فقط) واسم المفتاح ما بعد الكمّي الذي توقّع به العقدة. يضبط onboard قيمة key_name على المفتاح الذي ينشئه (validator)؛ ويغيّرها keys add-operator إلى operator-pqc عندما يشتق المفتاح أو يستعيده من كلمات الحساب. تتطلب خلفية file وجود QORE_LIGHTNODE_KEYRING_PASSPHRASE في البيئة. |
operator_address | الحساب الذي تنتمي إليه هذه العقدة (qor1...)؛ يُتحقَّق منه عند التحميل. يملؤه keys add-operator. مطلوب لـ register وstatus والنبضات. راجع محفظة المشغِّل. |
api_addr | نقطة نهاية REST. يكتبها onboard في config.toml (الشبكة الرئيسية https://api.qore.host، وشبكة الاختبار https://api-testnet.qore.host). وعند تركها فارغة تُشتق من rpc_addr (يصبح المنفذ 26657 هو 1317؛ وتصبح مضيفات rpc. وrpc-testnet. هي api. وapi-testnet.؛ فمثلًا https://rpc-testnet.qore.host يعطي https://api-testnet.qore.host)، لذا لا حاجة إليها إلا لنقاط نهاية لا تتبع أيًّا من هذه الاصطلاحات. وحتى 3.1.12 كان التعيين من rpc. إلى api. وحده موجودًا، فقد تردّ عقدة على شبكة الاختبار بـ api_addr فارغ بـ "404 page not found" عند الترخيص والتسجيل وstatus؛ اضبط api_addr يدويًا في تلك الإصدارات، أو حدّث. |
[heartbeat] | مفعَّل افتراضيًا (enabled). interval_blocks (طابِق heartbeat_interval للسلسلة، أي 1000)، وcheck_interval (الافتراضي 60s) وgas (الافتراضي 300000، وهو سقف حد الغاز لنبضة القلب؛ ومع التوقيع الأصلي يبلغ الرسم 0.25 uqor لكل وحدة غاز). ابتداءً من 3.1.13 تضبط العقدة حد الغاز لكل نبضة قلب على ما استخدمته النبضة السابقة زائد 25%، مقرَّبًا إلى أعلى لأقرب 1,000 وحدة غاز، ولا يتجاوز gas أبدًا؛ وتستخدم أول نبضة قلب بعد البدء، وأول نبضة بعد رفض بسبب نفاد الغاز، السقف. المقيس على شبكة الاختبار: الحد 216,000، والمستخدم 165,774، والرسم 54,000 uqor (0.054 QOR) لكل نبضة قلب بدلًا من 75,000 uqor. يجب أن يحتفظ حساب المشغِّل برصيد QOR قابل للإنفاق فوق حصة 1,000 QOR لدفع هذه الرسوم. تُستخدم فقط مع البديل الاحتياطي qorechaind: fees (الافتراضي 50000uqor)، وqorechaind_path (الفارغ يعني qorechaind على PATH)، وqorechaind_home (الفارغ يعني ~/.qorechaind)، وkeyring_backend، وkey_name (مفتاح qorechaind الذي يحمل حساب المشغِّل؛ افتراضيًا key_name على المستوى الأعلى). |
[delegation] | auto_claim (متوقف افتراضيًا: يطالب بمكافآت العقدة الخفيفة المتراكمة إلى حساب المشغِّل عبر الموقِّع؛ ولا تعيد العقدة التفويض أبدًا من الخادم)، وفترة الفحص، والحد الأدنى للمكافأة للمطالبة، وrebalance_enabled (مفعَّل افتراضيًا) وmin_reputation (تحذيرات فقط؛ لا تنقل العقدة الحصة أبدًا). ابتداءً من 3.1.11 يفعّل rebalance_enabled تحذيرات لمدقِّق مفوَّض إليه يكون مسجونًا أو خارج المجموعة النشطة، وللحصة المربوطة التي تقل عن min_delegated_stake (1,000 QOR)؛ وينطبق min_reputation (الافتراضي 0.5) حيث تقدّم الشبكة درجات سمعة لكل مدقِّق، وهي شبكة الاختبار اليوم. يُقبل validators وsplit_weights لكن لا يُعمل بهما حاليًا. |
[update] | mode: auto (الافتراضي، وكذلك عند غياب القسم) أو notify (إعلان فقط) أو off. العقدة الخفيفة 3.1.11 وما بعدها. راجع التحديث. |
[telemetry] | ما إذا كان القياس عن بُعد مفعَّلًا وفترات تحديث المُدققين والشبكة والجسر واقتصاد الرمز. |
[dashboard] | واجهة API للوحة التحكم المحلية. يقدّمها إصدار UX دائمًا؛ ولا يقدّمها إصدار SX إلا مع enabled = true. bind_addr (الافتراضي 127.0.0.1:8420) وtoken (عند ضبطه، يتطلب كل مسار /api و/ws الترويسة Authorization: Bearer <token>). راجع إصدار UX. |
log_level / log_format | مستوى تفصيل التسجيل (debug, info, warn, error) والصيغة (text أو json). مفاتيح على المستوى الأعلى: ضعها قبل أول [table]. |
متغيرات البيئة
| المتغير | الاستخدام |
|---|---|
QORE_LIGHTNODE_KEYRING_PASSPHRASE | عبارة مرور حلقة مفاتيح العقدة (keyring_backend = "file")، التي تحمل المفتاح ما بعد الكمّي للعقدة ومفتاح حساب المشغِّل. مطلوبة لكل أمر يفتح حلقة المفاتيح ولـ start؛ ترفض العقدة عبارة فارغة. |
QORE_LIGHTNODE_QORECHAIND_PASSPHRASE | للبديل الاحتياطي qorechaind فقط: عبارة مرور حلقة مفاتيح qorechaind التي تحمل مفتاح المشغِّل؛ تُمرَّر إلى qorechaind عبر الدخل القياسي، ولا تظهر أبدًا في سطر أوامر. |
QORECHAIN_RPC_ADDR | يتجاوز rpc_addr (وprimary_addr عندما كان مساويًا لـ rpc_addr). يضبطه docker-compose.yml. |
يُرفَض أي شاهد على نفس المضيف الذي عليه العنوان الأساسي — إذ إن نقطة نهاية مخترَقة ستوافق ببساطة على نفسها، فلا تُثبِت شيئًا. كما يُرفَض شاهد نصّي غير مشفَّر عبر http:// على مضيف بعيد، لأن أي مهاجم قادر على إعادة كتابة ذلك الاتصال يمكنه الرد كأنه كل شاهد في آن واحد؛ أما http:// على العنوان المحلي (loopback) فمقبول. وجِّه الشهود إلى نقاط نهاية RPC لديك أسباب مستقلة للثقة بها.
تفعِّل إعدادات التفويض الافتراضية تنبيهات الحصة وتترك auto_claim متوقفًا؛ راجع المكافآت والمراقبة لما تفعله هذه.
التشغيل الأول: onboard
عند أول إطلاق، سيتوقف start ويوجِّهك إلى معالج التهيئة الأولية إن لم يوجد ملف إعدادات بعد. اضبط عبارة مرور حلقة المفاتيح أولًا — يرفض onboard البدء بدونها، فلا يولّد أبدًا مفتاحًا لا يستطيع تخزينه — ثم شغِّل المعالج:
export QORE_LIGHTNODE_KEYRING_PASSPHRASE='choose-a-passphrase'
lightnode-sx onboard
يرشدك onboard خلال الإعداد في أربع خطوات:
- الاختبار الذاتي لـ PQC — يشغِّل دورة Dilithium-5 الكاملة (نفس فحوص
selftest). إذا فشلت حزمة PQC، يرفض المعالج المتابعة. - نقطة نهاية RPC للسلسلة — الصق رابط RPC الخاص بـ QoreChain (الشبكة الرئيسية
https://rpc.qore.host، شبكة الاختبارhttps://rpc-testnet.qore.host)، أو اتركه فارغًا للتشغيل في الوضع المحلي فقط. إذا قدّمت رابطًا، يختبره المعالج حيًّا ويقرأ منه معرّف السلسلة. - مفتاح العقدة — يسمّيه المعالج «المفتاح الخاص للمُدقق»، لكنه مفتاح Dilithium-5 الخاص بالعقدة الخفيفة نفسها، وليس مفتاح مُدقق. الصق مفتاحًا خاصًا بصيغة Dilithium-5 مرمَّزًا بالست عشري، أو اكتب
g(أوgenerate) لسك زوج مفاتيح جديد على هذه العقدة. - الحفظ — يكتب
config.toml(مع نقطة النهاية ومعرّف السلسلة) ويخزِّن المفتاح في حلقة المفاتيح تحت الاسمvalidator(أوvalidator-<hex>إن كان ذلك الاسم مأخوذًا)، ويضبطkey_nameعليه.
إذا تركت نقطة النهاية فارغة، يبدأ العفريت في الوضع المحلي فقط: تُمارَس حزمة PQC بالكامل، لكن العقدة لا تتزامن مع أي سلسلة. أعد تشغيل onboard بمجرد أن تكون نقطة نهاية سلسلتك جاهزة لتوجيه العقدة إليها.
يكتب onboard دائمًا فوق الإعدادات النشطة. استخدم --config للكتابة إلى مسار غير افتراضي، أو --non-interactive للفشل السريع بدلًا من المطالبة (مفيد في CI).
لا يعرف onboard أي حساب هو حسابك. قبل تشغيل register، أضف حساب المشغِّل باستخدام keys add-operator. يملأ هذا الأمر operator_address نيابةً عنك. وإذا تعذّر الوصول إلى نقطة النهاية أثناء onboard، فتحقق أيضًا من أن chain_id في config.toml هو qorechain-vladi (الشبكة الرئيسية) أو qorechain-diana (شبكة الاختبار)، وأن api_addr مضبوط (يكتبه onboard؛ وقد تردّ عقدة على شبكة الاختبار بالإصدار 3.1.12 أو أقدم بـ api_addr فارغ بـ "404 page not found").
التشغيل: start
بمجرد أن تكتب التهيئة الأولية ملف إعدادات، ابدأ العفريت:
build/lightnode-sx start
يزامن العفريت الترويسات، ويتعقب التفويضات، ويقدم القياس عن بُعد حتى يُقاطَع. إذا أردت عمدًا البدء دون ملف إعدادات (محلي فقط، بلا RPC للسلسلة)، مرِّر --skip-onboarding-check.
التحقق من حزمة PQC: selftest
يمكنك في أي وقت التأكد من أن حزمة ما بعد الكمّي تعمل:
lightnode-sx selftest
يشغِّل selftest خمسة فحوص مقابل Dilithium-5 (ML-DSA-87) ويكتمل في أقل من ثانية:
- توليد المفاتيح — توليد زوج مفاتيح جديد.
- التوقيع — توقيع رسالة اختبارية.
- التحقق (توقيع صالح) — تأكيد أن التوقيع يتحقق بالمفتاح العام المطابق.
- رفض التوقيع المعبوث به — اقلب بايتًا من التوقيع؛ يجب أن يرفضه التحقق.
- رفض الرسالة المعبوث بها — اقلب بايتًا من الرسالة؛ يجب أن يرفضها التحقق.
إذا فشل أي فحص، يخرج الثنائي بقيمة غير صفرية مع مخرجات تشخيصية. هذا هو الاختبار نفسه الذي يشغِّله معالج التهيئة الأولية كخطوته الأولى، وهو مفيد للتحقق قبل النشر ولتشخيصات الدعم.
محفظة المشغِّل
مفتاح Dilithium-5 الخاص بالعقدة ليس محفظة. على QoreChain يُرفَق مفتاح ما بعد كمّي بحساب؛ ولا ينشئ حسابًا. لهذا لا يعرض keys list أي عنوان له. عنوان المشغِّل الخاص بك هو حساب qor1… عادي يحمل الترخيص والتفويض، ويدفع الرسوم، ويتلقى مكافآت العقدة الخفيفة. يجب أن يكون حسابًا تحتفظ أنت بكلمات الاسترداد الخاصة به (كلماتك الخاصة، أو Keplr، أو qorechaind)؛ والأفضل حساب مخصَّص. لا يمكن لمحفظة احتجازية على لوحة التحكم أن تشغّل عقدة ما لم تُصدِّر بذرتها. راجع حساب المشغِّل.
خزِّن مفتاح حساب المشغِّل في حلقة مفاتيح العقدة:
# The account the licence is for: type its recovery words, then Enter
lightnode-sx keys add-operator --recover
# Or create a new account; its 24 words are shown once
lightnode-sx keys add-operator
يقوم keys add-operator بما يلي:
- يشتق مفتاح الحساب من الكلمات تمامًا كما يفعل
qorechaindوKeplr (m/44'/118'/0'/0/0)، ويخزّنه في حلقة المفاتيح باسمoperator، ويكتب الحساب فيoperator_addressداخلconfig.toml. وإذا كانoperator_addressمضبوطًا بالفعل على حساب مختلف، فإنه يرفض؛ - يختار المفتاح ما بعد الكمّي الذي توقّع به العقدة، ويخزّنه باسم
operator-pqcويضبطkey_nameعليه. إذا كان للحساب مفتاح ما بعد كمّي بالفعل — يسجّله عادةً محفظة من الكلمات نفسها — فإنه يُعاد بناء ذلك المفتاح من الكلمات (باشتقاقات wallet-adapter ولوحة التحكم، وهي نفسها التي يستخدمهاqorechaind tx pqc recover-key). وإذا لم يكن للحساب مفتاح، يُشتق مفتاح من الكلمات، فتستعيد الكلمات أيضًا مفتاح العقدة. وإذا كان المفتاح المسجَّل على الحساب هو بالفعل المفتاح الحالي للعقدة، فيُحتفظ به. وإذا تعذّرت إعادة إنتاج مفتاح الحساب من الكلمات، يرفض الأمر وينصح بحساب مخصَّص؛ - يسمّي مصدر الترخيص للشبكة المستخدمة: الشراء من لوحة التحكم على الشبكة الرئيسية، والطلب الذاتي المجاني على شبكة الاختبار؛
- بدون
--recover، ينشئ حسابًا جديدًا ويعرض كلماته الـ 24 مرة واحدة. دوّنها؛ فهي النسخة الاحتياطية الوحيدة. موّل الحساب واشترِ الترخيص لعنوانه قبل التسجيل.
تحمي عبارة مرور حلقة المفاتيح (QORE_LIGHTNODE_KEYRING_PASSPHRASE) هذا المفتاح كما تحمي مفتاح العقدة. ثم سجِّل:
lightnode-sx register --delegate-to qorvaloper1...
يتحقق register من الترخيص، ويُرفِق المفتاح ما بعد الكمّي ما لم يكن للحساب مفتاح بالفعل، ويفوِّض التفويض الناقص فقط إذا حدّدت مدقِّقًا عبر --delegate-to، ثم يسجّل العقدة؛ وتُؤكَّد كل خطوة في كتلة قبل التالية. راجع التسجيل والترخيص للتفاصيل وللبديل الاحتياطي register --print المخصَّص للمشغّلين الذين يحتفظون بمفتاح الحساب في حلقة مفاتيح qorechaind.
الحمايات المضافة في 3.1.14
- استيراد المفتاح لا يظهر في قائمة العمليات. يقرأ
keys import <name>المفتاح الخاص بالصيغة الست عشرية من الإدخال القياسي أو من--key-file <file>. ويُرفض المفتاح المكتوب كوسيط ثانٍ. ويعيد--unsafe-argvالصيغة القديمة مع تحذير. - يُكتب مخزن المفاتيح بصورة ذرية. يُستبدل
keystore/keys.encفي خطوة واحدة وتُحفظ النسخة السابقة باسمkeystore/keys.enc.bak. بعد الإعداد، احتفظ بنسخة احتياطية منkeys.enc(أو من كلمات الاسترداد) في مكان خارج الجهاز. - مطالبة تلقائية محدودة. تفحص العقدة مرة كل 10 دقائق على الأكثر (تُرفع أي قيمة أقل لـ
compound_intervalإلى10m) وترسل مطالبة واحدة على الأكثر كل 6 ساعات. - اتصالات لوحة التحكم محدودة. يقبل WebSocket الخاص بلوحة التحكم 32 اتصالًا على الأكثر.
- ردود السلسلة محدودة. يُحدَّد كل رد REST من السلسلة بحد أقصى 4 MiB. وعند البدء تحذّر العقدة إذا كان
api_addrبصيغةhttp://العادية نحو جهاز آخر: استخدمhttps://.
أوامر الإدارة
يتضمن سطر أوامر SX أوامر لفحص حالة العقدة وإدارة المفاتيح. ومنذ 3.1.7 يملك ثنائي UX (lightnode-ux) الأوامر نفسها.
| الأمر | الغرض |
|---|---|
onboard | معالج التشغيل الأول التفاعلي. |
start | تشغيل العفريت. |
selftest | تشغيل الاختبار الذاتي لـ PQC. |
status | عرض حالة مزامنة العقدة والعميل الخفيف (معرّف السلسلة، أحدث ارتفاع، حالة اللحاق بالركب) إضافةً إلى الأسطر Signer (أصلي أو qorechaind) وOperator وLicence وRegistration. |
keys create <name> | إنشاء مفتاح Dilithium-5 جديد للعقدة وطباعة مفتاحه العام. |
keys list | سرد المفاتيح في حلقة المفاتيح (الاسم، النوع، العنوان إن وُجد، المفتاح العام). |
keys show <name> | طباعة نوع المفتاح ومفتاحه العام الكامل. |
keys import <name> [--key-file <file>] | استيراد مفتاح خاص مرمَّز بالست عشري. منذ 3.1.14 يُقرأ المفتاح من الإدخال القياسي أو من --key-file <file>. ويُرفض المفتاح المعطى كوسيط ثانٍ لأنه سيظهر في قائمة العمليات وفي سجل الصدفة؛ ويعيد --unsafe-argv الصيغة القديمة مع تحذير. |
keys export <name> [--out <file>] | تصدير مفتاح خاص بالست عشري. يكتب --out الملف الذي يقرؤه qorechaind --pqc-key (بلا سطر جديد في النهاية، بالوضع 0600). |
keys add-operator [--recover] | تخزين مفتاح حساب المشغِّل (جديد، أو مُستعاد من كلماته عبر الدخل القياسي) واختيار المفتاح ما بعد الكمّي؛ ويملأ operator_address. راجع محفظة المشغِّل. |
register [--delegate-to <qorvaloper>] [--print] | تسجيل العقدة على السلسلة: المفتاح ما بعد الكمّي، والتفويض الناقص، والتسجيل، وتُؤكَّد كلٌّ منها في كتلة. يطبع --print أوامر qorechaind بدلًا من ذلك — راجع التسجيل والترخيص. |
validators | سرد المُدققين المربوطين. |
delegation | عرض تفويضات حساب المشغِّل، كما يعكسها العفريت قيد التشغيل في قاعدة البيانات المحلية. |
rewards | عرض مكافآت الستيكينغ المعلَّقة لحساب المشغِّل (لا مكافآت العقدة الخفيفة؛ راجع المكافآت والمراقبة). |
network | عرض القياس عن بُعد للشبكة (الترويسات المتزامنة الأخيرة) من قاعدة البيانات المحلية. |
update [--check] | العقدة الخفيفة 3.1.11 وما بعدها. يخبرك --check ما إذا كان هناك إصدار أحدث؛ وبدونه يتحقق من الإصدار ويثبّته ويحتفظ بالثنائي السابق باسم <name>.old. أعد تشغيل العقدة بعد ذلك. راجع التحديث. |
version | طباعة إصدار الثنائي. |
لتفاصيل الستيكينغ والمكافآت والمراقبة راجع المكافآت والمراقبة. للتسجيل على السلسلة، راجع التسجيل والترخيص.