Solana Geyser gRPC - फ़िल्टर

Solana Stream SDK
Solana Stream SDK ओपन-सोर्स सॉफ़्टवेयर के रूप में उपलब्ध है। अधिक जानकारी के लिए, कृपया नीचे दी गई GitHub रिपॉज़िटरी देखें।

gRPC फ़िल्टर का अवलोकन

Solana Geyser gRPC फ़िल्टर का उपयोग करके केवल वही डेटा कुशलता से प्राप्त करता है जिसमें आपकी रुचि है, जैसे विशिष्ट अकाउंट, प्रोग्राम, ट्रांज़ैक्शन, स्लॉट और ब्लॉक।
नीचे हम Solana Stream SDK का उपयोग करते हुए TypeScript के उदाहरण देते हैं और हर फ़िल्टर की विशिष्ट भूमिका को स्पष्ट रूप से समझाते हैं। Rust का उपयोग करने पर भी फ़िल्टर की संरचना और अर्थ बिल्कुल वही रहते हैं।

हर फ़िल्टर की भूमिका और उदाहरण

किसी अकाउंट को सब्सक्राइब करें

किसी विशिष्ट अकाउंट के रीयल-टाइम अपडेट सब्सक्राइब करें। नीचे दिया गया उदाहरण Confirmed commitment level पर SOL-USDC OpenBook अकाउंट को सब्सक्राइब करता है:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: { slots: {} },
  accounts: {
    'wsol/usdc': {
      account: ['8BnEgHoWFysVcuFFX7QztDmzuH8r5ZFvyP3sYwn1XTh6'],
    },
  },
  transactions: {},
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.CONFIRMED,
}
  • "wsol/usdc" क्लाइंट द्वारा तय किया गया लेबल है।
  • अकाउंट, प्रोग्राम, ब्लॉक और स्लॉट के कई फ़िल्टर एक ही JSON अनुरोध में मिलाए जा सकते हैं।

account_data_slice के साथ किसी अकाउंट को सब्सक्राइब करें

यह उदाहरण दिखाता है कि अकाउंट डेटा का केवल एक विशिष्ट हिस्सा कैसे प्राप्त करें। USDC टोकन अकाउंट का पूरा डेटा (165 बाइट) प्राप्त करने के बजाय, यह ऑफ़सेट 32 से शुरू होने वाले 40 बाइट प्राप्त करता है। इस हिस्से में मालिक और lamports बैलेंस जैसी जानकारी शामिल है।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {
    usdc: {
      owner: ['TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'],
      filters: [
        {
          tokenAccountState: true,
        },
        {
          memcmp: {
            offset: 0,
            data: {
              base58: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
            },
          },
        },
      ],
    },
  },
  transactions: {},
  blocks: {},
  blocksMeta: {},
  entry: {},
  commitment: CommitmentLevel.CONFIRMED,
  accountsDataSlice: [{ offset: 32, length: 40 }],
}

किसी प्रोग्राम को सब्सक्राइब करें

यह उदाहरण किसी विशिष्ट प्रोग्राम से जुड़े अकाउंट अपडेट को सब्सक्राइब करना दिखाता है।
नीचे, हम Processed commitment level पर Solend प्रोग्राम के स्वामित्व वाले अकाउंट के अपडेट सब्सक्राइब करते हैं।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {
    solend: {
      owner: ['So1endDq2YkqhipRh3WViPa8hdiSpxWy6z3Z6tMCpAo'],
    },
  },
  transactions: {},
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}
  • "solend" एक कस्टम लेबल है, जिसे क्लाइंट अपनी इच्छा से सेट कर सकता है।
  • कई प्रोग्राम को सब्सक्राइब करने के लिए, कृपया अगला सेक्शन "कई प्रोग्राम को सब्सक्राइब करें" देखें।

कई प्रोग्राम को सब्सक्राइब करें

यह उदाहरण दिखाता है कि कई प्रोग्राम से जुड़े अकाउंट अपडेट को एक साथ कैसे सब्सक्राइब करें।
नीचे दिया गया उदाहरण Solend और Serum, दोनों प्रोग्राम के स्वामित्व वाले अकाउंट के अपडेट सब्सक्राइब करता है।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {
    programs: {
      owner: [
        'So1endDq2YkqhipRh3WViPa8hdiSpxWy6z3Z6tMCpAo',
        '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
      ],
    },
  },
  transactions: {},
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}
अगर आप हर प्रोग्राम को अलग-अलग लेबल देना चाहते हैं, तो नीचे दिया गया तरीका अपनाएँ:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {
    solend: {
      owner: ['So1endDq2YkqhipRh3WViPa8hdiSpxWy6z3Z6tMCpAo'],
    },
    serum: {
      owner: ['9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin'],
    },
  },
  transactions: {},
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

वोट और विफल ट्रांज़ैक्शन को छोड़कर सभी finalized ट्रांज़ैक्शन सब्सक्राइब करें

यह उदाहरण Finalized commitment level पर, वोट ट्रांज़ैक्शन और विफल ट्रांज़ैक्शन को छोड़कर, सभी ट्रांज़ैक्शन सब्सक्राइब करना दिखाता है।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {},
  transactions: {
    alltxs: {
      vote: false,
      failed: false,
    },
  },
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.FINALIZED,
}
  • vote: false वोट ट्रांज़ैक्शन को बाहर रखता है।
  • failed: false विफल ट्रांज़ैक्शन को बाहर रखता है।
  • अगर फ़ील्ड खाली छोड़ दिए जाएँ, तो सभी ट्रांज़ैक्शन प्राप्त होते हैं।
  • जब कई फ़ील्ड निर्दिष्ट किए जाते हैं, तो वे AND शर्त के साथ काम करते हैं।

किसी अकाउंट का उल्लेख करने वाले गैर-वोट ट्रांज़ैक्शन सब्सक्राइब करें

यह उदाहरण किसी विशिष्ट अकाउंट से जुड़े ट्रांज़ैक्शन को सब्सक्राइब करना दिखाता है, लेकिन वोट ट्रांज़ैक्शन को इसमें शामिल नहीं किया जाता।
नीचे दिया गया उदाहरण Serum प्रोग्राम से जुड़े अकाउंट का उल्लेख करने वाले गैर-वोट ट्रांज़ैक्शन सब्सक्राइब करता है।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {},
  transactions: {
    serum: {
      vote: false,
      accountInclude: ['9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin'],
    },
  },
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

कुछ अकाउंट को छोड़कर ट्रांज़ैक्शन सब्सक्राइब करें

यह उदाहरण दिखाता है कि विशिष्ट अकाउंट से जुड़े ट्रांज़ैक्शन को छोड़कर बाकी ट्रांज़ैक्शन कैसे सब्सक्राइब करें।
नीचे दिया गया उदाहरण Serum और Tokenkeg प्रोग्राम के स्वामित्व वाले किसी भी अकाउंट को छोड़कर ट्रांज़ैक्शन प्राप्त करता है।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {},
  transactions: {
    serum: {
      accountExclude: [
        '9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin',
        'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
      ],
    },
  },
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

अकाउंट का उल्लेख करने वाले ट्रांज़ैक्शन सब्सक्राइब करें और कुछ अकाउंट को बाहर रखें

यह उदाहरण कुछ अकाउंट से जुड़े ट्रांज़ैक्शन को सब्सक्राइब करना दिखाता है, जबकि अन्य निर्दिष्ट अकाउंट को स्पष्ट रूप से बाहर रखा जाता है।
नीचे दिया गया उदाहरण Serum के अकाउंट का उल्लेख करने वाले ट्रांज़ैक्शन सब्सक्राइब करता है, लेकिन एक निर्दिष्ट अकाउंट को बाहर रखता है:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    slots: {},
  },
  accounts: {},
  transactions: {
    serum: {
      accountInclude: ['9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin'],
      accountExclude: ['9wFFyRfZBsuAha4YcuxcXLKwMxJR43S7fPfQLusDBzvT'],
    },
  },
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

किसी ट्रांज़ैक्शन सिग्नेचर को सब्सक्राइब करें

यह उदाहरण किसी विशिष्ट ट्रांज़ैक्शन सिग्नेचर के रीयल-टाइम अपडेट को तब तक सब्सक्राइब करना दिखाता है, जब तक वह Confirmed या Finalized स्थिति तक नहीं पहुँच जाता।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {},
  transactions: {
    sign: {
      signature:
        '5rp2hL9b6kexex11Mugfs3vfU9GhieKruj4CkFFSnu52WLxiGn4VcLLwsB62XURhMmT1j4CZiXT6FFtYbXsLq2Zs',
    },
  },
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

स्लॉट सब्सक्राइब करें

यह उदाहरण आने वाले स्लॉट की सूचनाएँ सब्सक्राइब करना दिखाता है। एक कस्टम टैग नाम देने के अलावा किसी और जानकारी की ज़रूरत नहीं है:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {
    incoming_slots: {},
  },
  accounts: {},
  transactions: {},
  blocks: {},
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

ब्लॉक सब्सक्राइब करें

बनने वाले सभी ब्लॉक के रीयल-टाइम अपडेट सब्सक्राइब करें। डिफ़ॉल्ट रूप से, ब्लॉक के भीतर के सभी ट्रांज़ैक्शन प्राप्त किए जाएँगे:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {},
  transactions: {},
  blocks: {
    blocks: {},
  },
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

ट्रांज़ैक्शन को बाहर रखकर केवल अपडेट हुई अकाउंट जानकारी प्राप्त करने के लिए:

typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {},
  transactions: {},
  blocks: {
    blocks: {
      includeTransactions: false,
      includeAccounts: true,
    },
  },
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

केवल विशिष्ट अकाउंट से जुड़े ट्रांज़ैक्शन/अकाउंट प्राप्त करने के लिए:

typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {},
  transactions: {},
  blocks: {
    blocks: {
      accountInclude: ['So1endDq2YkqhipRh3WViPa8hdiSpxWy6z3Z6tMCpAo'],
    },
  },
  blocksMeta: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

ब्लॉक मेटाडेटा सब्सक्राइब करें

ब्लॉक प्रोसेस होने पर केवल ब्लॉक मेटाडेटा की सूचनाएँ सब्सक्राइब करें। विस्तृत ट्रांज़ैक्शन डेटा इसमें शामिल नहीं होता।
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

const request = {
  slots: {},
  accounts: {},
  transactions: {},
  blocks: {},
  blocksMeta: {
    blockmetadata: {},
  },
  accountsDataSlice: [],
  commitment: CommitmentLevel.PROCESSED,
}

commitment level का प्रबंधन

Solana Geyser gRPC stream का डिफ़ॉल्ट commitment level Processed है।
आप Confirmed या Finalized जैसे ऊँचे commitment level निर्दिष्ट कर सकते हैं। ऐसे मामलों में, Geyser डेटा को बफ़र करता है और निर्दिष्ट commitment level तक पहुँचने पर सूचना भेजता है।
अधिकतम प्रदर्शन के लिए, commitment level का प्रबंधन क्लाइंट की ओर करने की सलाह दी जाती है।
commitment level इस तरह निर्दिष्ट करें:
typescript
import { CommitmentLevel } from '@validators-dao/solana-stream-sdk'

enum CommitmentLevel {
  PROCESSED = 0,
  CONFIRMED = 1,
  FINALIZED = 2,
}
  • PROCESSED: प्रोसेसिंग के तुरंत बाद का डेटा। जल्दी प्राप्त होता है, लेकिन इसकी अभी पुष्टि नहीं हुई होती।
  • CONFIRMED: क्लस्टर द्वारा पुष्टि किया गया डेटा, जो अधिक निश्चितता देता है।
  • FINALIZED: पूरी तरह finalized डेटा, जिसमें पुनर्गठन का कोई जोखिम नहीं है।

Processed पर काम करने के लाभ

Processed commitment level का मुख्य लाभ यह है कि ट्रांज़ैक्शन तुरंत प्राप्त होते हैं, जिससे क्लाइंट की ओर तेज़ प्रोसेसिंग संभव होती है। इसके बाद क्लाइंट Confirmed या Finalized में बदलाव का पता लगा सकते हैं, जिससे तेज़ प्रतिक्रिया मिलती है।

Confirmed और Finalized का प्रबंधन कैसे करें

Confirmed या Finalized स्तर का उपयोग करते समय, इवेंट (ट्रांज़ैक्शन या अकाउंट अपडेट) को हर स्लॉट के हिसाब से बफ़र किया जाना चाहिए।
इवेंट को स्लॉट-दर-स्लॉट बफ़र करें, स्लॉट की सूचनाएँ सब्सक्राइब करें, और जब कोई विशिष्ट स्लॉट वांछित commitment (Confirmed या Finalized) तक पहुँच जाए, तब इवेंट को बफ़र से रिलीज़ करें।
किसी स्लॉट के Confirmed या Finalized तक पहुँचने से पहले ही इवेंट शुरू में प्राप्त हो जाएँगे।

Finalized की खास बात

Solana Geyser के विनिर्देशों के कारण, सभी स्लॉट को स्पष्ट finalized सूचना नहीं मिलती। इसलिए, जब आपको किसी स्लॉट की finalized सूचना मिले, तो आपको उसके सभी पूर्वज स्लॉट को finalized मानना होगा, भले ही उनके लिए कोई सूचना स्पष्ट रूप से न मिली हो।
विशेष रूप से, finalized सूचना मिलने पर, सभी पूर्वज स्लॉट को भी पीछे जाकर finalized मानें।