وثائق مشغلي Kora

ما هو مشغل عقدة Kora؟

بصفتك مشغل عقدة Kora، فإنك تدير خدمة دفع ترعى رسوم معاملات سولانا لمستخدميك. تقبل عقدتك مدفوعات رموز SPL وتستخدم SOL الخاص بك لدفع رسوم الشبكة الفعلية، مما يتيح معاملات بدون رسوم لتطبيقك.

لماذا تدير عقدة Kora؟

تجربة مستخدم أفضل: يتعامل مستخدموك دون الحاجة إلى SOL (تأهيل مبسط، احتفاظ أفضل بالمستخدمين، وما إلى ذلك)
مصدر دخل: اجمع الرسوم بالرموز التي يفضلها نشاطك التجاري (USDC، BONK، إلخ)

البدء السريع

تريد التجربة محلياً أولاً؟ قم بتشغيل عقدة Kora محلية في دقائق معدودة: ← دليل البدء السريع المحلي

المفاهيم الأساسية

بصفتك مشغل عقدة Kora، فأنت مسؤول عن تشغيل خدمة دفع آمنة تمكّن المعاملات بدون رسوم لمستخدميك. لعقدتك أربع مسؤوليات رئيسية:

1. التحقق من صحة المعاملات

قم بتكوين عقدتك لقبول المعاملات التي تلبي متطلبات نشاطك التجاري فقط عبر kora.toml:

قوائم الرموز المسموحة: حدد رموز SPL التي تقبلها كدفعة (تدعم SPL وToken-2022)
قوائم البرامج المسموحة: ضع قائمة بيضاء ببرامج سولانا التي يمكن للمستخدمين التفاعل معها
حدود المعاملات: حدد الرسوم القصوى التي أنت على استعداد لدفعها وحدود التوقيعات
قوائم الحسابات المحظورة: امنع التفاعل مع العناوين الإشكالية
أوراكل التسعير: قم بتكوين Jupiter أو التسعير التجريبي لحساب الرسوم
رموز الدفع: حدد نوع الرموز التي ستقبلها كدفعة
سياسات دافع الرسوم: تحكم في العمليات التي يمكن لدافع الرسوم الخاص بك تنفيذها (التحويلات، الحرق، الموافقات، إلخ)
امتدادات Token-2022: احظر امتدادات محددة لـ Token-2022 لتعزيز الأمان
التخزين المؤقت: فعّل التخزين المؤقت في Redis لتحسين الأداء من خلال تقليل استدعاءات RPC
حدود الاستخدام: حدد حدود المعاملات لكل محفظة لمنع إساءة الاستخدام، وضمان الاستخدام العادل، أو مكافأة المستخدمين بمعاملات مدعومة حتى حد معين

→ مرجع تكوين Kora.toml الكامل → نموذج kora.toml

تحتاج عقدتك إلى أزواج مفاتيح سولانا للتوقيع على المعاملات كدافع للرسوم. بالنسبة لعمليات النشر الإنتاجية، تدعم Kora تكوينات متعددة الموقعين لتحسين الموثوقية وتوزيع قفل الحساب. ضع في اعتبارك تطبيق تدوير المفاتيح وضوابط الوصول والنسخ الاحتياطية واستراتيجيات أخرى لأمن الموقعين. خيارات التوقيع المتاحة:

المفتاح الخاص المحلي: تخزين المفتاح الخاص مباشرة في بيئة الخادم (كملف base58 أو .json أو مصفوفة u8)
Turnkey: إدارة المفاتيح الخاصة بسهولة. إنشاء المحافظ والتوقيع على المعاملات وأتمتة الإجراءات على السلسلة.
Privy: بنية تحتية سهلة للعملات المشفرة. إنشاء محافظ بعلامة بيضاء بشكل آمن والتوقيع على المعاملات.
HashiCorp Vault: إدارة الأسرار وحماية البيانات الحساسة

→ دليل تكوين الموقعين الكامل

3. دفع رسوم المعاملات

حافظ على رصيد SOL كافٍ لتغطية رسوم الشبكة لحجم المعاملات المتوقع:

مراقبة الرصيد: تتبع رصيد SOL وإعداد تنبيهات الرصيد المنخفض (توفر Kora مقاييس Prometheus المدمجة - انظر المراقبة)
الأتمتة: تنفيذ إجراءات إعادة شحن SOL التلقائية لبيئات الإنتاج
تخطيط السعة: التخطيط لحالة الاستخدام المتوقعة وحجم المستخدمين وما إلى ذلك.

من المهم أن تفهم كيف تقدر Kora الرسوم وكيفية تكوين عقدتك لتعظيم إيراداتك. راجع دليل تقدير الرسوم لمزيد من التفاصيل.

4. مراقبة العمليات

تتبع مقاييس الأمان والأداء والأعمال لعقدتك بشكل مستمر:

مراقبة الأمان: الأنماط غير المعتادة والتحققات الفاشلة وانتهاكات حدود المعدل
التنبيهات التشغيلية: صحة النظام وتحذيرات الرصيد والأحداث الأمنية
التتبع المالي: تكاليف SOL مقابل إيرادات الرموز وتحليل الربحية
مراقبة رصيد الموقعين: تتبع رصيد الموقعين وإعداد تنبيهات الرصيد المنخفض

توفر Kora نقطة نهاية /metrics اختيارية تقدم بيانات الأداء في الوقت الفعلي بتنسيق Prometheus.

← دليل مرجعي لمراقبة Kora

5. تحسين الأداء (اختياري)

للنشر عالي الحركة، قم بتفعيل التخزين المؤقت لـ Redis لتقليل استدعاءات RPC وتحسين أوقات الاستجابة:

التخزين المؤقت للحسابات: تخزين بيانات حسابات سولانا مؤقتاً مع مدة صلاحية قابلة للتكوين (TTL)
الاحتياطي التلقائي: التراجع بسلاسة إلى استدعاءات RPC المباشرة في حال عدم توفر Redis
إدارة التخزين المؤقت: إمكانيات انتهاء الصلاحية التلقائية والتحديث الإجباري للعمليات الحرجة

واجهة سطر أوامر Kora

حزمة kora-cli هي ملف تنفيذي Rust جاهز للإنتاج يوفر كل ما تحتاجه لتشغيل عقدة دافع Kora. يتم توزيعه كملف تنفيذي مستقل يمكنك تثبيته عمومياً أو نشره في الحاويات.

خيارات التثبيت

التثبيت العمومي (موصى به للتطوير)

cargo install kora-cli

أو البناء من المصدر (موصى به للمساهمة)

git clone https://github.com/solana-foundation/kora.git
cd kora
just install

الاستخدام الأساسي

يعرض خادم Kora RPC نقطة نهاية JSON-RPC (افتراضياً: http://localhost:8080). قم بتشغيله باستخدام الأمر kora rpc:

# Run with specified kora.toml and signers.toml
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Help
kora rpc --help

لمزيد من المعلومات حول استخدام واجهة سطر أوامر Kora، راجع دليل واجهة سطر الأوامر.

يمكن للتطبيقات الوصول إلى خادم Kora RPC عبر مجموعة Kora TS SDK

التكوين

يجب تكوين كل عقدة Kora RPC بما لا يقل عن:

نقطة نهاية Solana RPC (محددة عبر العلامة --rpc-url أو متغير البيئة RPC_URL) [افتراضياً: http://127.0.0.1:8899]
تكوين موقّع(ي) سولانا (محدد عبر العلامة --signers-config signers.toml)
ملف تكوين، kora.toml (محدد عبر العلامة --config path/to/kora.toml)

kora.toml

قبل النشر، ستحتاج إلى إنشاء وتكوين ملف kora.toml لتحديد:

تحديد المعدل والمصادقة
عنوان وجهة الدفع
توفر طرق RPC
قواعد التحقق من صحة المعاملات
سياسات الأمان (قائمة بيضاء أو سوداء لرموز SPL والبرامج والحسابات وامتدادات الرموز، إلخ.)
نماذج تسعير الرسوم
سياسات معززة لدافع الرسوم (الحماية من سلوك الموقعين غير المرغوب فيه)
جمع المقاييس
تكوين التخزين المؤقت لـ Redis (اختياري)

signers.toml

ستحتاج أيضًا إلى إنشاء ملف signers.toml لتحديد:

الموقّع (الموقّعون) لعقدتك
استراتيجية اختيار الموقّع
إعدادات كل موقّع والمفاتيح المطبقة

النشر على Railway

المزيد من أدلة التكامل قريبًا

هل تحتاج إلى مساعدة؟

منصة Solana Stack Exchange - اطرح أسئلة/شارك تعلمك (تأكد من استخدام وسم kora)
قضايا GitHub - أبلغ عن الأخطاء أو احصل على المساعدة
قم بتشغيل kora rpc --help لعرض جميع الخيارات والإعدادات المتاحة