التثبيت

تبحث عن الإصدار التجريبي؟ راجع تثبيت الإصدار التجريبي للحصول على صور Docker و kora-cli@2.2.0-beta.7.

ابدأ مع Kora من خلال تثبيت أداة سطر الأوامر لتشغيل عقدة Kora أو حزمة TypeScript SDK لتطبيقات العملاء التي تتفاعل مع عقدة Kora.

متطلبات النظام

لواجهة سطر الأوامر (الخادم)

• Rust: الإصدار 1.86 أو أحدث (غير مطلوب لـ Docker)

لحزمة TypeScript SDK (العميل)

• Node.js: إصدار LTS أو أحدث
• TypeScript: أحدث إصدار

التبعيات الاختيارية

• واجهة سطر أوامر سولانا: مفيدة لتوليد المفاتيح والاختبار
• Docker: للنشر في حاويات

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

واجهة سطر أوامر Kora هي الطريقة الأساسية لتشغيل وإدارة عقد Kora. اختر طريقة التثبيت المفضلة لديك:

الخيار 1: التثبيت من Cargo

قم بالتثبيت مباشرةً من crates.io باستخدام Cargo:

cargo install kora-cli

الخيار 2: البناء من الكود المصدري

استنسخ وقم ببناء أحدث إصدار مستقر من الكود المصدري:

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

ملاحظة: فرع main في Kora هو فرع تكامل وقد يحتوي على تغييرات لم يتم إصدارها أو تجريبية. قم دائماً بالتحقق من أحدث وسم إصدار مستقر. راجع صفحة الإصدارات للحصول على أحدث إصدار مستقر.

سيؤدي هذا إلى بناء وتثبيت الملف التنفيذي kora في دليل Cargo bin المحلي الخاص بك.

الخيار 3: Docker

اسحب صورة Docker الرسمية من سجل حاويات GitHub:

docker pull ghcr.io/solana-foundation/kora:latest

قم بالتشغيل مع ربط ملفات التكوين الخاصة بك:

docker run -v $(pwd)/kora.toml:/app/kora.toml \
  -v $(pwd)/signers.toml:/app/signers.toml \
  -p 8080:8080 \
  ghcr.io/solana-foundation/kora:latest \
  rpc start --signers-config /app/signers.toml

التحقق من التثبيت

تحقق من تثبيت Kora CLI بشكل صحيح:

kora --version

TypeScript SDK

قم بتثبيت Kora TypeScript SDK لتطبيقات العميل:

pnpm add @solana/kora

التبعيات النظيرة

يتطلب Kora حزمة @solana/kit والعديد من حزم Kit plugin كتبعيات نظيرة. معظم مديري الحزم (pnpm v7+، npm v7+) يقومون بتثبيت التبعيات النظيرة تلقائيًا، لذلك عادةً ما تحتاج فقط إلى:

pnpm add @solana/kora @solana/kit

إذا كان مدير الحزم الخاص بك لا يقوم بتثبيت التبعيات النظيرة تلقائيًا، قم بتثبيتها يدويًا:

pnpm add @solana/kit @solana-program/token @solana-program/compute-budget \
  @solana/kit-plugin-instruction-plan @solana/kit-plugin-payer @solana/kit-plugin-rpc

متطلبات الإصدار

• KoraClient (مستقل): يعمل مع @solana/kit v5.0+
• koraPlugin() (قابل للتركيب): يتطلب @solana/kit v5.4+ لنمط createEmptyClient().use()
• createKitKoraClient() (عميل Kit): يتطلب @solana/kit v6.1+ لتركيب الإضافات الكامل

راجع نظرة عامة على JSON-RPC API للحصول على أمثلة تفصيلية لاستخدام العميل.

التحقق من تثبيت SDK

تحقق من تثبيت SDK الخاص بك باختبار اتصال بسيط:

import { KoraClient } from "@solana/kora";

async function testConnection() {
  const client = new KoraClient({ rpcUrl: "http://localhost:8080" }); // Replace with your Kora server URL

  try {
    const config = await client.getConfig();
    console.log("✅ Successfully connected to Kora server");
  } catch (error) {
    console.error("❌ Connection failed:", error.message);
  }
}

testConnection();

استكشاف الأخطاء وإصلاحها

مشاكل CLI

"kora: command not found": تأكد من أن ~/.cargo/bin موجود في PATH الخاص بك:

echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

فشل البناء: قم بتحديث Rust إلى أحدث إصدار مستقر:

rustup update stable

مشاكل SDK

تحذيرات التبعيات النظيرة: قم بتثبيت تبعيات سولانا المطلوبة المذكورة أعلاه.

أخطاء TypeScript: تأكد من أن إصدار TypeScript الخاص بك هو 4.5+ وقم بتثبيت تعريفات الأنواع:

pnpm add -D @types/node

رفض الاتصال: تأكد من أن خادم Kora يعمل ويمكن الوصول إليه عند نقطة النهاية المحددة.