Quick Start

The Graph पर आसानी से एक सबग्राफ को बनाना, प्रकाशित करना और क्वेरी करना सीखें।

पूर्वावश्यकताएँ

• एक क्रिप्टो वॉलेट
• एक स्मार्ट contract पता एक supported network पर।
• Node.js⁠ इंस्टॉल किया गया
• आपकी पसंद का एक पैकेज मैनेजर (npm, yarn या pnpm)

सबग्राफ कैसे बनाएं

1. सबग्राफ Studio में एक सबग्राफ बनाएँ -

Subgraph Studio पर जाएँ और अपने वॉलेट को कनेक्ट करें।

सबग्राफ Studio आपको Subgraphs बनाने, प्रबंधित करने, तैनात करने और प्रकाशित करने की सुविधा देता है, साथ ही API कुंजी बनाने और प्रबंधित करने की सुविधा भी प्रदान करता है।

“Create a सबग्राफ” पर क्लिक करें। यह अनुशंसा की जाती है कि सबग्राफ का नाम टाइटल केस में रखा जाए: “सबग्राफ Name Chain Name”।

2. ग्राफ़ सीएलआई स्थापित करें

अपनी स्थानीय मशीन पर, निम्न आदेशों में से कोई एक चलाएँ:

Using npm⁠:

1npm install -g @graphprotocol/graph-cli@latest

Using yarn⁠:

1yarn global add @graphprotocol/graph-cli

अपने सबग्राफ को प्रारंभ करें

graph init कमांड स्वचालित रूप से आपके contract की घटनाओं के आधार पर एक सबग्राफ का खाका तैयार करेगा।

निम्नलिखित कमांड एक मौजूदा contract से आपका सबग्राफ प्रारंभ करता है:

1graph init

यदि आपका contract उस ब्लॉकस्कैनर पर वेरीफाई किया गया है जहाँ यह डिप्लॉय किया गया है (जैसे Etherscan⁠), तो ABI अपने आप CLI में क्रिएट हो जाएगा।

जब आप अपने सबग्राफ को प्रारंभ करते हैं, तो CLI आपसे निम्नलिखित जानकारी मांगेगा:

• प्रोटोकॉल: वह प्रोटोकॉल चुनें जिससे आपका सबग्राफ डेटा को indexing करेगा।
• सबग्राफ slug: अपने सबग्राफ के लिए एक नाम बनाएं। आपका सबग्राफ slug आपके सबग्राफ के लिए एक पहचानकर्ता है।
• निर्देशिका: अपनी सबग्राफ बनाने के लिए एक निर्देशिका चुनें।
• **Ethereum नेटवर्क (वैकल्पिक): आपको यह निर्दिष्ट करने की आवश्यकता हो सकती है कि आपका Subgraph किस EVM-संगत नेटवर्क से डेटा को इंडेक्स करेगा।
• contract एड्रेस: उस स्मार्ट contract एड्रेस को खोजें जिससे आप डेटा क्वेरी करना चाहते हैं।
• ABI: यदि ABI स्वतः नहीं भरा जाता है, तो आपको इसे JSON फ़ाइल के रूप में मैन्युअल रूप से इनपुट करना होगा।
• Start Block: आपको स्टार्ट ब्लॉक इनपुट करना चाहिए ताकि ब्लॉकचेन डेटा की सबग्राफ indexing को ऑप्टिमाइज़ किया जा सके। स्टार्ट ब्लॉक को खोजने के लिए उस ब्लॉक को ढूंढें जहां आपका contract डिप्लॉय किया गया था।
• contract का नाम: अपने contract का नाम दर्ज करें।
• contract इवेंट्स को entities के रूप में इंडेक्स करें: इसे true पर सेट करने की सलाह दी जाती है, क्योंकि यह हर उत्सर्जित इवेंट के लिए स्वचालित रूप से आपके सबग्राफ में मैपिंग जोड़ देगा।
• एक और contract जोड़ें (वैकल्पिक): आप एक और contract जोड़ सकते हैं।

इसका एक उदाहरण देखने के लिए निम्नलिखित स्क्रीनशॉट देखें कि जब आप अपना सबग्राफ इनिशियलाइज़ करते हैं तो क्या अपेक्षा करें:

अपना सबग्राफ संपादित करें

init कमांड पिछले चरण में एक प्रारंभिक सबग्राफ बनाता है जिसे आप अपने सबग्राफ को बनाने के लिए एक शुरुआती बिंदु के रूप में उपयोग कर सकते हैं।

सबग्राफ में परिवर्तन करते समय, आप मुख्य रूप से तीन फ़ाइलों के साथ काम करेंगे:

• मैनिफेस्ट (subgraph.yaml) - यह निर्धारित करता है कि आपका सबग्राफ किन डेटा स्रोतों को इंडेक्स करेगा।
• Schema (schema.graphql) - यह परिभाषित करता है कि आप सबग्राफ से कौन सा डेटा प्राप्त करना चाहते हैं।
• असेंबलीस्क्रिप्ट मैपिंग (mapping.ts) - यह वह कोड है जो स्कीमा में परिभाषित इकाई के लिए आपके डेटा सोर्स से डेटा का अनुवाद करता है।

आपके सबग्राफ को लिखने के विस्तृत विवरण के लिए, Creating a सबग्राफ देखें।

5. अपना Subgraph डिप्लॉय करें

जब आप किसी सबग्राफ को तैनात (deploy) करते हैं, तो आप इसे सबग्राफ Studio पर अपलोड करते हैं, जहाँ आप इसका परीक्षण, स्टेजिंग और समीक्षा कर सकते हैं। तैनात किए गए सबग्राफ का Indexing Upgrade Indexer द्वारा किया जाता है, जो Edge & Node द्वारा संचालित एक एकल Indexer है, न कि The Graph Network में मौजूद कई विकेंद्रीकृत Indexers द्वारा। एक तैनात (deployed) सबग्राफ का उपयोग निःशुल्क है, यह दर-सीमित (rate-limited) होता है, सार्वजनिक रूप से दृश्य (visible) नहीं होता, और इसे मुख्य रूप से विकास (development), स्टेजिंग और परीक्षण (testing) उद्देश्यों के लिए डिज़ाइन किया गया है।

एक बार जब आपका सबग्राफ लिखा जा चुका हो, तो निम्नलिखित कमांड चलाएँ:

1```sh2graph codegen && graph build3```

अपने सबग्राफ को प्रमाणित करें और तैनात करें। तैनाती कुंजी को सबग्राफ Studio में सबग्राफ के पृष्ठ पर पाया जा सकता है।

1```sh23graph auth <DEPLOY_KEY>45graph deploy <SUBGRAPH_SLUG>6```

The CLI एक संस्करण लेबल के लिए पूछेगा। यह दृढ़ता से सिफारिश की जाती है कि semantic versioning⁠ का उपयोग करें, जैसे 0.0.1।

6. अपने सबग्राफ की समीक्षा करें

यदि आप अपना सबग्राफ प्रकाशित करने से पहले उसका परीक्षण करना चाहते हैं, तो आप सबग्राफ Studio का उपयोग करके निम्नलिखित कर सकते हैं:

• एक नमूना क्वेरी चलाएँ।

• अपने डैशबोर्ड में अपने सबग्राफ का विश्लेषण करें ताकि जानकारी की जांच की जा सके।

• डैशबोर्ड पर लॉग्स की जाँच करें ताकि यह देखा जा सके कि आपके सबग्राफ में कोई त्रुटि है या नहीं। एक सक्रिय सबग्राफ के लॉग इस प्रकार दिखेंगे:

  

7. अपने सबग्राफ को The Graph नेटवर्क पर प्रकाशित करें

जब आपका सबग्राफ प्रोडक्शन वातावरण के लिए तैयार हो जाता है, तो आप इसे विकेंद्रीकृत नेटवर्क पर प्रकाशित कर सकते हैं। प्रकाशित करना एक ऑनचेन क्रिया है जो निम्नलिखित करता है:

• यह आपके सबग्राफ को विकेंद्रीकृत Indexers द्वारा The Graph Network पर अनुक्रमित किए जाने के लिए उपलब्ध कराता है।
• यह आपकी दर सीमा को हटा देता है और आपके सबग्राफ को Graph Explorer में सार्वजनिक रूप से खोजने योग्य और क्वेरी करने योग्य बनाता है।
• यह आपके सबग्राफ को Curators के लिए उपलब्ध कराता है ताकि वे इसे क्यूरेट कर सकें।

Subgraph Studio से प्रकाशित

अपने सबग्राफ को प्रकाशित करने के लिए, डैशबोर्ड में Publish बटन पर क्लिक करें।

अपने सबग्राफ को प्रकाशित करने के लिए उस नेटवर्क का चयन करें, जिसे आप चुनना चाहते हैं।

Publishing from the CLI

जैसा कि संस्करण 0.73.0 में है, अब आप अपने सबग्राफ को Graph CLI के साथ प्रकाशित कर सकते हैं।

graph-cli खोलें।

निम्नलिखित कमांड का उपयोग करें:

1```sh2graph codegen && graph build3```45Then,67```sh8graph publish9```

3. एक विंडो खुलेगी, जिससे आप अपना वॉलेट कनेक्ट कर सकते हैं, मेटाडेटा जोड़ सकते हैं और अपने फ़ाइनलाइज़ किए गए सबग्राफ को अपनी पसंद के नेटवर्क पर डिप्लॉय कर सकते हैं।

अपने परिनियोजन को अनुकूलित करने के लिए, Publishing a सबग्राफ देखें।

सिग्नल को अपने Subgraph में जोड़ना

1. Indexers को अपने सबग्राफ से क्वेरी करने के लिए आकर्षित करने हेतु, आपको इसमें GRT क्यूरेशन सिग्नल जोड़ना चाहिए।

   • यह कार्रवाई सेवा की गुणवत्ता में सुधार करती है, विलंबता को कम करती है, और आपके सबग्राफ के लिए नेटवर्क की पुनरावृत्ति और उपलब्धता को बढ़ाती है।

2. यदि इंडेक्सिंग पुरस्कारों के लिए योग्य हैं, तो Indexers संकेतित राशि के आधार पर GRT पुरस्कार प्राप्त करते हैं।

   • यह अनुशंसा की जाती है कि कम से कम 3,000 GRT को क्यूरेट किया जाए ताकि 3 Indexers को आकर्षित किया जा सके। सबग्राफ फीचर उपयोग और समर्थित नेटवर्क के आधार पर पुरस्कार पात्रता की जांच करें।

Curation के बारे में और जानने के लिए, Curating पढ़ें.

गैस लागत बचाने के लिए, आप अपने सबग्राफ को उसी लेनदेन में प्रकाशित कर सकते हैं जिसमें आप इसे क्यूरेट कर रहे हैं, बस इस विकल्प का चयन करें:

8. अपने सबग्राफ से क्वेरी करें

आप अब प्रति माह 100,000 निःशुल्क क्वेरी तक उपयोग कर सकते हैं अपने सबग्राफ के साथ The Graph Network पर!

आप अपने सबग्राफ को उसके Query URL पर GraphQL क्वेरी भेजकर क्वेरी कर सकते हैं, जिसे आप Query बटन पर क्लिक करके प्राप्त कर सकते हैं।

आपके सबग्राफ से डेटा क्वेरी करने के बारे में अधिक जानकारी के लिए, Querying The Graph पढ़ें।