إنتقل إلى المحتوى الرئيسي

SuiClient - موظف مكتب البريد في تطبيقك

  • الجمهور: المطورون الجدد في سلسلة Sui blockchain.
  • المتطلبات الأساسية: فهم أساسي لمفاهيم البلوك تشين (المحافظ، المعاملات).
  • الهدف: فهم دور SuiClient في بنية التطبيق.

مقدمة​

في نظام Sui البيئي، لا يمكن لتطبيقك التحدث مباشرة إلى شبكة البلوك تشين. فهو يتطلب وسيطًا للتعامل مع بروتوكولات الاتصال، وجلب البيانات، وإرسال المعاملات.

SuiClient هي الواجهة الأساسية في Sui TypeScript SDK لهذا الغرض.

الهندسة المعمارية: تشبيه "مكتب البريد"​

فكر في شبكة Sui كنظام بريدي عالمي ضخم.

  • تطبيقك هو عميل في مكتب البريد.
  • SuiClient هو موظف مكتب البريد.

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

flowchart LR
    A["تطبيقك<br/>(العميل)"] -->|يطلب الخدمة| B("SuiClient<br/>(الموظف)")
    B -->|يعالج الطلب| C["عقدة شبكة Sui<br/>(النظام البريدي)"]
    C -->|يسلم النتيجة| B
    B -->|يسلم العنصر| A

الاتصال بالشبكة​

تمامًا كما يعمل موظف في فرع معين، يتصل مثيل SuiClient ببيئة شبكة محددة عبر نقطة نهاية RPC (استدعاء إجراء عن بعد).

عند تهيئة العميل، تقوم بتحديد البيئة التي يستهدفها:

الشبكةالوصفحالة الاستخدام
الشبكة الرئيسيةشبكة الإنتاج المباشر. أصول حقيقية، قيمة حقيقية.تطبيقات الإنتاج.
Testnetشبكة اختبار عامة. تعكس إصدار Mainnet.اختبار التدريج والتكامل.
Devnetشبكة تجريبية. يتم مسحها بشكل متكرر.النماذج الأولية السريعة والتطوير المحلي.

القدرات الأساسية​

يتعامل SuiClient مع فئتين متميزتين من العمليات. فهم الفرق أمر بالغ الأهمية لتصميم التطبيق.

1. عمليات القراءة (الاستعلامات)​

هذه طلبات للبحث عن البيانات الموجودة في دفتر الأستاذ.

  • التكلفة: مجانية (بدون رسوم غاز).
  • الأمان: لا يتطلب توقيع المحفظة.
  • الآلية: يستعلم العميل عن قاعدة البيانات المحلية للعقدة ويعيد النتيجة على الفور.
  • الأمثلة:
    • getObject(): جلب بيانات تعريف NFT.
    • getBalance(): التحقق من أموال المحفظة.

2. عمليات الكتابة (المعاملات)​

هذه هي طلبات تغيير حالة دفتر الأستاذ.

  • التكلفة: تتطلب رموز SUI لرسوم الغاز.
  • الأمان: تتطلب توقيعًا مشفرًا من محفظة المستخدم.
  • الآلية: يقوم العميل بإرسال المعاملة الموقعة إلى مدققي الشبكة للمعالجة.
  • الأمثلة:
    • تحويل العملات.
    • سك عملات NFTs.
    • تعديل بيانات اللعبة على السلسلة.

الخطوات التالية​

الآن بعد أن فهمتَ البنية الهيكلية، فإن الخطوة التالية هي إجراء عملية قراءة. يوفر الدليل التالي برنامج نصي للاستعلام عن البيانات المباشرة من Sui Devnet.