@solana/client

@solana/client يحافظ على سطح بيئة التشغيل خفيفاً. مخزن واحد، ومجموعة RPC واحدة، وسجل محفظة واحد يشغّلون المساعدات المختلفة بحيث يمكن للنسخة نفسها دعم واجهات سطر الأوامر أو البرامج النصية أو واجهات المستخدم الكاملة. تتشارك الإجراءات والمراقبات والمساعدات جميعها في ذاكرة التخزين المؤقت والاشتراكات وجلسات المحفظة من خلال هذا العميل الواحد.

التثبيت

$ 
npm install @solana/clientCopy

استخدم أي مدير حزم؛ يعمل العميل في المتصفحات أو العمال أو React أو Svelte أو بيئات التشغيل من جانب الخادم.

إنشاء عميل مرة واحدة

اختر موصلات Wallet Standard (الاكتشاف التلقائي هو أسرع طريقة للبدء)، ثم قم بإنشاء العميل. يعرض هذا الكائن الواحد المخزن والإجراءات والمراقبات والمساعدات.

import { autoDiscover, createClient } from "@solana/client";

const client = createClient({
  endpoint: "https://api.devnet.solana.com",
  websocketEndpoint: "wss://api.devnet.solana.com",
  walletConnectors: autoDiscover()
});

await client.actions.connectWallet("wallet-standard:phantom");
const balance = await client.actions.fetchBalance("Fke...address");
console.log(balance.lamports?.toString());

يتتبع مخزن العميل إعدادات الكتلة والاشتراكات والمعاملات المعلقة وجلسات المحفظة. يمكنك توفير مخزن Zustand الخاص بك إذا كنت بحاجة إلى الاستمرارية أو التنسيق متعدد علامات التبويب.

تنسيق المحفظة

تغلف الموصلات بيانات Wallet Standard الوصفية بالإضافة إلى منطق الاتصال/قطع الاتصال. سجّل المساعدات المدمجة phantom()، solflare()، backpack()، أو autoDiscover()، أو قم بتغليف مزودين مخصصين باستخدام createWalletStandardConnector. تتدفق جميع إجراءات المحفظة (الاتصال، قطع الاتصال، التوقيع، الإرسال) عبر سجل العميل بحيث يبقى كل مستهلك متزامناً.

الإجراءات والمراقبات والمساعدات

• الإجراءات تغلف عمليات القراءة والكتابة الشائعة لـ RPC أثناء تحديث المخزن (مثل fetchAccount، requestAirdrop، setCluster).
• المراقبات تقوم بتعدد إرسال اشتراكات websocket، وبث التحديثات إلى المخزن، وتمنحك مقابض إيقاف للتنظيف.
• المساعدات تعرض تدفقات عالية المستوى مثل تحويلات SOL، ومساعدات رموز SPL، واستطلاع التوقيعات، ومجموعات المعاملات.

const abortWatcher = client.watchers.watchBalance(
  { address: "Fke...address" },
  (lamports) => {
    console.log("live balance", lamports.toString());
  }
);

// Later when the component unmounts or the flow ends
abortWatcher.abort();

نمط مساعد المعاملات

يمتلك مساعد المعاملات تحديث blockhash، وتحديد دافع الرسوم، والتوقيع. يمكنك الإعداد والفحص والإرسال بأي تجربة مستخدم تفضلها.

const prepared = await client.helpers.transaction.prepare({
  authority: client.store.getState().wallet.session!,
  instructions: [instructionA, instructionB]
});

await client.helpers.transaction.simulate(prepared, {
  commitment: "processed"
});
const signature = await client.helpers.transaction.send(prepared);
console.log("submitted", signature.toString());

استخدم prepareAndSend للحصول على تدفق جاهز (محاكاة بالإضافة إلى التسجيل) أو استدعِ sign / toWire لجمع التوقيعات يدويًا قبل نقل التنسيق السلكي بنفسك.

أنماط شائعة لمطوري سولانا

• آلات الحالة Headless: شغّل العميل داخل مسارات API أو سكريبتات أو workers لإعادة استخدام منطق تنسيق المحفظة + RPC نفسه الذي يُشغّل واجهة المستخدم.
• لوحات المعلومات في الوقت الفعلي: ادمج المراقبين (الأرصدة، الحسابات، التوقيعات) مع مكتبة واجهة المستخدم المفضلة لديك؛ يتولى العميل توزيع websocket وإبطال ذاكرة التخزين المؤقت.
• المخازن المخصصة: أدخل مخزن Zustand الخاص بك لترطيب البيانات من IndexedDB/localStorage، أو مزامنة الحالة مع جلسات الخادم، أو التنسيق بين تبويبات المتصفح.
• الجسر إلى React hooks: مرّر نسخة عميل مُهيَّأة إلى @solana/react-hooks عندما تريد hooks مريحة فوق نفس بيئة التشغيل.
• قابلية الاختبار: يمكن محاكاة واجهة العميل الموحدة في اختبارات الوحدة، مما يُسهّل محاكاة استجابات RPC أو جلسات المحفظة دون الحاجة إلى محفظة متصفح.