Kora

Kora هي البنية التحتية لتوقيع معاملاتك على سولانا. قم بتفعيل المعاملات بدون رسوم حيث يدفع المستخدمون الرسوم بأي عملة—USDC أو BONK أو العملة الأصلية لتطبيقك—أو تعامل مع أي توقيع معاملات يتطلب موقّعاً موثوقاً.

لماذا Kora؟

• تجربة مستخدم أفضل: لن يحتاج المستخدمون أبداً إلى SOL
• التحكم في الإيرادات: اجمع الرسوم بعملة USDC أو عملتك الخاصة أو أي شيء آخر
• جاهز للإنتاج: التحقق الآمن والحد من المعدل والمراقبة مدمجة
• سهولة التكامل: واجهة برمجة تطبيقات JSON-RPC وSDK بلغة TypeScript
• نشر مرن: Railway أو Docker أو أي منصة سحابية

البنية المعمارية

• اللغة: Rust مع SDK بلغة TypeScript
• البروتوكول: JSON-RPC 2.0
• الموقّعون: مفتاح سولانا الخاص، Turnkey، Privy
• المصادقة: مفتاح API أو HMAC أو بدون مصادقة
• النشر: خيارات نشر مرنة (Docker، Railway، إلخ)

الميزات

• قواعد التحقق القابلة للتخصيص وقوائم السماح
• دعم كامل لـ Token-2022 مع تصفية الامتدادات
• التخزين المؤقت في Redis لتحسين الأداء
• الحد من المعدل والحماية من الإنفاق
• إدارة آمنة للمفاتيح (Turnkey، Privy، Vault)
• مصادقة HMAC ومفتاح API
• مقاييس ومراقبة Prometheus
• سياسات محسّنة لحماية دافع الرسوم

البدء السريع

تثبيت Kora:

cargo install kora-cli

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

kora rpc [OPTIONS] # --help for full list of options

← دليل البدء السريع - قم بتشغيل Kora محلياً في دقائق

← دليل مشغل العقدة - قم بتشغيل نظام دفع الرسوم

SDK لـ TypeScript

توفر Kora واجهة JSON-RPC بسيطة مع ثلاثة خيارات للعميل:

// Option 1: Standalone client
import { KoraClient } from "@solana/kora";
const kora = new KoraClient({ rpcUrl: "http://localhost:8080" });
const signed = await kora.signTransaction({ transaction });

// Option 2: Kit client (recommended) — handles planning, fees, signing, and sending
import { createKitKoraClient } from "@solana/kora";
import { address } from "@solana/kit";
const client = await createKitKoraClient({
  endpoint: "http://localhost:8080",
  rpcUrl: "https://api.mainnet-beta.solana.com",
  feeToken: address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"),
  feePayerWallet: userSigner
});

← مرجع واجهة برمجة التطبيقات - طرق JSON-RPC وSDK بلغة TypeScript

التطوير المحلي

المتطلبات الأساسية

• Rust 1.86+ أو
• Solana CLI 2.2+
• Node.js 20+ وpnpm (لـ SDK)

التثبيت

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

البناء

just build

تشغيل الخادم

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

kora rpc [OPTIONS]

أو للتشغيل مع تكوين اختبار، قم بتنفيذ:

just run

الاختبار المحلي

وقم بتشغيل جميع الاختبارات:

just test-all

المجتمع والدعم

• لديك أسئلة؟ اسأل على Solana Stack Exchange (استخدم وسم kora)
• لديك مشاكل؟ أبلغ عنها على GitHub Issues

موارد أخرى

• Kora CLI Crates.io - حزمة Rust لتشغيل عقدة Kora
• @solana/kora NPM Package - مجموعة أدوات TypeScript للتفاعل مع عقدة Kora

المصدر

• مستودع GitHub

تم بناؤه وصيانته بواسطة مؤسسة سولانا.

مرخص بموجب MIT. راجع LICENSE للحصول على التفاصيل.