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

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

---

परिचय

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

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

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

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

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

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

छवि

कोड

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

ASCII

┌──────────────┐ सेवा का अनुरोध करता है ┌──────────────┐अनुरोध को संसाधित करता है┌──────────────────┐
│   आपका ऐप    │──────────────────────► │  SuiClient   │──────────────────────► │  Sui नेटवर्क नोड │
│   (ग्राहक)   │◄────────────────────── │   (क्लर्क)   │◄────────────────────── │   (डाक प्रणाली)  │
└──────────────┘      आइटम सौंपता है    └──────────────┘     परिणाम प्रदान करता है└──────────────────┘

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

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

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

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

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

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

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

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

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

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

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

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

---

अगले कदम

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