SuiClient - आपके ऐप का डाकघर क्लर्क

• लक्षित दर्शक: Sui ब्लॉकचेन में नए डेवलपर्स।
• पूर्वापेक्षाएँ: ब्लॉकचेन अवधारणाओं (वॉलेट, लेनदेन) की बुनियादी समझ।
• लक्ष्य: ऐप आर्किटेक्चर में SuiClient की भूमिका को समझना।

---

परिचय

Sui इकोसिस्टम में, आपका ऐप सीधे ब्लॉकचेन नेटवर्क से बात नहीं कर सकता। इसके लिए संचार प्रोटोकॉल, डेटा प्राप्त करने, और लेनदेन सबमिट करने को संभालने के लिए एक मध्यस्थ की आवश्यकता होती है।

SuiClient इस उद्देश्य के लिए Sui TypeScript SDK में प्राथमिक इंटरफ़ेस है।

आर्किटेक्चर: "डाकघर" की उपमा

सुई नेटवर्क को एक विशाल, वैश्विक डाक प्रणाली के रूप में सोचें।

• आपका ऐप काउंटर पर एक ग्राहक है।
• SuiClient डाकघर का क्लर्क है।

आप सिस्टम के साथ इंटरैक्ट करने के लिए क्लर्क पर निर्भर करते हैं। आप खुद मेल छाँट नहीं सकते या डिलीवरी ट्रक नहीं चला सकते; आपको क्लर्क के माध्यम से अनुरोध करना होगा।

छवि

कोड

flowchart LR
A["आपका ऐप<br/>(ग्राहक)"] -->|सेवा का अनुरोध करता है| B("SuiClient<br/>(क्लर्क)")
B -->|अनुरोध को संसाधित करता है| C["Sui नेटवर्क नोड<br/>(डाक प्रणाली)"]
    C -->|परिणाम प्रदान करता है| B
B -->|आइटम सौंपता है| A

नेटवर्क से कनेक्ट करना

जैसे एक क्लर्क एक विशिष्ट शाखा में काम करता है, वैसे ही एक SuiClient इंस्टेंस एक RPC (रिमोट प्रोसीजर कॉल) एंडपॉइंट के माध्यम से एक विशिष्ट नेटवर्क वातावरण से जुड़ता है।

जब आप क्लाइंट को इनिशियलाइज़ करते हैं, तो आप परिभाषित करते हैं कि यह किस वातावरण को लक्षित करता है:

नेटवर्क	विवरण	उपयोग का मामला
मेननेट	लाइव प्रोडक्शन नेटवर्क। वास्तविक संपत्ति, वास्तविक मूल्य।	प्रोडक्शन ऐप्स।
टेस्टनेट	सार्वजनिक परीक्षण नेटवर्क। मेननेट संस्करण को दर्शाता है।	स्टेजिंग और एकीकरण परीक्षण।
डेवनैट	प्रयोगात्मक नेटवर्क। बार-बार मिटाया जाता है।	त्वरित प्रोटोटाइपिंग और स्थानीय विकास।

मुख्य क्षमताएँ

SuiClient दो अलग-अलग श्रेणियों के संचालन को संभालता है। ऐप डिज़ाइन के लिए अंतर को समझना महत्वपूर्ण है।

1. रीड ऑपरेशंस (क्वेरीज़)

ये लेज़र पर मौजूदा डेटा को देखने के अनुरोध हैं।

• लागत: निःशुल्क (कोई गैस शुल्क नहीं)।
• सुरक्षा: कोई वॉलेट हस्ताक्षर आवश्यक नहीं।
• प्रणाली: क्लाइंट नोड के स्थानीय डेटाबेस को क्वेरी करता है और तुरंत परिणाम लौटाता है।
• उदाहरण:
  • getObject(): एनएफटी मेटाडेटा प्राप्त करना।
  • getBalance(): वॉलेट की शेष राशि की जाँच करना।

2. लिखने के ऑपरेशन (लेनदेन)

ये लेज़र की स्थिति को बदलने के लिए अनुरोध हैं।

• लागत: गैस शुल्क के लिए SUI टोकन की आवश्यकता होती है।
• सुरक्षा: उपयोगकर्ता के वॉलेट से एक क्रिप्टोग्राफिक हस्ताक्षर की आवश्यकता होती है।
• प्रणाली: क्लाइंट हस्ताक्षरित लेनदेन को प्रसंस्करण के लिए नेटवर्क वैलिडेटर्स को सबमिट करता है।
• उदाहरण:
  • कॉइन ट्रांसफर करना।
  • एनएफटी बनाना।
  • ऑन-चेन गेम डेटा को संशोधित करना।

---

अगले कदम

अब जब आप आर्किटेक्चर को समझ गए हैं, तो अगला कदम एक रीड ऑपरेशन करना है। अगली गाइड Sui Devnet से लाइव डेटा क्वेरी करने के लिए एक स्क्रिप्ट प्रदान करती है।