@validators-dao/solana-stream-sdk 0.1.1 → 0.2.0

package/README.md

@@ -16,23 +16,168 @@ pnpm add @validators-dao/solana-stream-sdk
 
 ## Usage
 
+Example of using the GeyserClient to subscribe to Solana Pump Fun transactions and accounts:
+
 ```typescript
 import {
   GeyserClient,
   bs58,
   CommitmentLevel,
+  SubscribeRequestAccountsDataSlice,
   SubscribeRequestFilterAccounts,
+  SubscribeRequestFilterBlocks,
+  SubscribeRequestFilterBlocksMeta,
+  SubscribeRequestFilterEntry,
+  SubscribeRequestFilterSlots,
   SubscribeRequestFilterTransactions,
-  // ... other exports
 } from '@validators-dao/solana-stream-sdk'
+import 'dotenv/config'
+
+interface SubscribeRequest {
+  accounts: {
+    [key: string]: SubscribeRequestFilterAccounts
+  }
+  slots: {
+    [key: string]: SubscribeRequestFilterSlots
+  }
+  transactions: {
+    [key: string]: SubscribeRequestFilterTransactions
+  }
+  transactionsStatus: {
+    [key: string]: SubscribeRequestFilterTransactions
+  }
+  blocks: {
+    [key: string]: SubscribeRequestFilterBlocks
+  }
+  blocksMeta: {
+    [key: string]: SubscribeRequestFilterBlocksMeta
+  }
+  entry: {
+    [key: string]: SubscribeRequestFilterEntry
+  }
+  commitment?: CommitmentLevel | undefined
+  accountsDataSlice: SubscribeRequestAccountsDataSlice[]
+  ping?: any
+}
+
+// const PUMP_FUN_MINT_AUTHORITY = 'TSLvdd1pWpHVjahSpsvCXUbgwsL3JAcvokwaKt1eokM'
+const PUMP_FUN_PROGRAM_ID = '6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P'
+
+const tran: SubscribeRequestFilterTransactions = {
+  accountInclude: [PUMP_FUN_PROGRAM_ID],
+  accountExclude: [],
+  accountRequired: [],
+}
+
+const request: SubscribeRequest = {
+  accounts: {
+    pumpfun: {
+      account: [],
+      owner: [],
+      filters: [],
+    },
+  },
+  slots: {},
+  transactions: { elsol: tran },
+  transactionsStatus: {},
+  blocks: {},
+  blocksMeta: {},
+  entry: {},
+  accountsDataSlice: [],
+  commitment: CommitmentLevel.PROCESSED,
+}
+
+const geyser = async () => {
+  console.log('Starting geyser client...')
+  const maxRetries = 2000000
+
+  const createClient = () => {
+    const token = process.env.X_TOKEN || ''
+    console.log('X_TOKEN:', token)
+    if (token === '') {
+      throw new Error('X_TOKEN environment variable is not set')
+    }
+    const endpoint = `https://grpc-ams-3.erpc.global`
+    console.log('Connecting to', endpoint)
+
+    // @ts-ignore ignore
+    return new GeyserClient(endpoint, token, undefined)
+  }
+
+  const connect = async (retries: number = 0): Promise<void> => {
+    if (retries > maxRetries) {
+      throw new Error('Max retries reached')
+    }
+
+    try {
+      const client = createClient()
+      const version = await client.getVersion()
+      console.log('version: ', version)
+      const stream = await client.subscribe()
+      stream.on('data', async (data: any) => {
+        if (data.transaction !== undefined) {
+          const transaction = data.transaction
+          const txnSignature = transaction.transaction.signature
+          const tx = bs58.encode(new Uint8Array(txnSignature))
+          console.log('tx:', tx)
+          return
+        }
+        if (data.account === undefined) {
+          return
+        }
+        // console.log('data:', JSON.stringify(data, null, 2))
+
+        const accounts = data.account
+        const rawPubkey = accounts.account.pubkey
+        const rawTxnSignature = accounts.account.txnSignature
+        const pubkey = bs58.encode(new Uint8Array(rawPubkey))
+        const txnSignature = bs58.encode(new Uint8Array(rawTxnSignature))
+        console.log('pubkey:', pubkey)
+        console.log('txnSignature:', txnSignature)
+      })
+
+      stream.on('error', async (e: any) => {
+        console.error('Stream error:', e)
+        console.log(`Reconnecting ...`)
+        await connect(retries + 1)
+      })
+
+      await new Promise<void>((resolve, reject) => {
+        stream.write(request, (err: any) => {
+          if (!err) {
+            resolve()
+          } else {
+            console.error('Request error:', err)
+            reject(err)
+          }
+        })
+      }).catch((reason) => {
+        console.error(reason)
+        throw reason
+      })
+    } catch (error) {
+      console.error(`Connection failed. Retrying ...`, error)
+      await connect(retries + 1)
+    }
+  }
+
+  await connect()
+}
+
+const main = async () => {
+  try {
+    await geyser()
+  } catch (error) {
+    console.log(error)
+  }
+}
+
+main()
+```
 
-// Create a Geyser client for streaming Solana data
-const client = new GeyserClient('https://your-geyser-endpoint')
+Please ensure you have the `X_TOKEN` environment variable set with your gRPC token for authentication.
 
-// Use bs58 for base58 encoding/decoding
-const decoded = bs58.decode('base58string')
-const encoded = bs58.encode(buffer)
-```
+Please note that the url endpoint in the example is for demonstration purposes. You should replace it with the actual endpoint you are using.
 
 ## Features
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@validators-dao/solana-stream-sdk",
   "description": "Solana Stream SDK by Validators DAO",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,8 +31,8 @@
     "format": "prettier --write ."
   },
   "dependencies": {
-    "@triton-one/yellowstone-grpc": "^4.0.2",
-    "bs58": "^6.0.0"
+    "@triton-one/yellowstone-grpc": "4.0.2",
+    "bs58": "6.0.0"
   },
   "devDependencies": {
     "prettier": "3.5.3",