@sentio/sdk 1.7.12 → 1.7.15

package/src/service.ts

@@ -0,0 +1,434 @@
+import { Block, Log } from '@ethersproject/abstract-provider'
+import { CallContext, ServerError, Status } from 'nice-grpc'
+
+import {
+  BlockBinding,
+  ContractConfig,
+  HandlerType,
+  LogFilter,
+  LogHandlerConfig,
+  O11yResult,
+  ProcessBlocksRequest,
+  ProcessBlocksResponse,
+  ProcessConfigRequest,
+  ProcessConfigResponse,
+  ProcessInstructionsRequest,
+  ProcessInstructionsResponse,
+  ProcessLogsRequest,
+  ProcessLogsResponse,
+  ProcessorServiceImplementation,
+  ProcessTransactionsRequest,
+  ProcessTransactionsResponse,
+  StartRequest,
+  TemplateInstance,
+} from './gen/processor/protos/processor'
+
+import { Empty } from './gen/google/protobuf/empty'
+import Long from 'long'
+import { TextDecoder } from 'util'
+
+const DEFAULT_MAX_BLOCK = Long.ZERO
+
+export class ProcessorServiceImpl implements ProcessorServiceImplementation {
+  private eventHandlers: ((event: Log) => Promise<O11yResult>)[] = []
+  private blockHandlers: ((block: Block) => Promise<O11yResult>)[] = []
+
+  // map from chain id to list of processors
+  // private blockHandlers = new Map<string, ((block: Block) => Promise<O11yResult>)[]>()
+  // private processorsByChainId = new Map<string, BaseProcessor<BaseContract, BoundContractView<BaseContract, any>>>()
+
+  private started = false
+  private contractConfigs: ContractConfig[]
+  private templateInstances: TemplateInstance[]
+
+  private readonly shutdownHandler?: () => void
+
+  constructor(shutdownHandler?: () => void) {
+    this.shutdownHandler = shutdownHandler
+  }
+
+  async getConfig(request: ProcessConfigRequest, context: CallContext): Promise<ProcessConfigResponse> {
+    if (!this.started) {
+      throw new ServerError(Status.UNAVAILABLE, 'Service Not started.')
+    }
+    return {
+      // TODO project setting
+      config: undefined,
+      contractConfigs: this.contractConfigs,
+      templateInstances: this.templateInstances,
+    }
+  }
+
+  async configure() {
+    this.eventHandlers = []
+    this.templateInstances = []
+    // this.processorsByChainId.clear()
+    this.contractConfigs = []
+
+    this.templateInstances = [...global.PROCESSOR_STATE.templatesInstances]
+
+    // Part 1, prepare EVM processors
+    for (const processor of global.PROCESSOR_STATE.processors) {
+      // If server favor incremental update this need to change
+      // Start basic config for contract
+      const chainId = processor.getChainId()
+      // this.processorsByChainId.set(chainId, processor)
+
+      const contractConfig: ContractConfig = {
+        processorType: 'user_processor',
+        contract: {
+          name: processor.config.name,
+          chainId: chainId.toString(),
+          address: processor.config.address,
+          abi: '',
+        },
+        blockConfigs: [],
+        logConfigs: [],
+        startBlock: processor.config.startBlock,
+        endBlock: DEFAULT_MAX_BLOCK,
+        instructionConfig: undefined,
+      }
+      if (processor.config.endBlock) {
+        contractConfig.endBlock = processor.config.endBlock
+      }
+
+      // Step 1. Prepare all the block handlers
+      for (const blockHandler of processor.blockHandlers) {
+        const handlerId = this.blockHandlers.push(blockHandler) - 1
+        contractConfig.blockConfigs.push({
+          handlerId: handlerId,
+        })
+      }
+
+      // Step 2. Prepare all the event handlers
+      for (const eventsHandler of processor.eventHandlers) {
+        // associate id with filter
+        const handlerId = this.eventHandlers.push(eventsHandler.handler) - 1
+        const logConfig: LogHandlerConfig = {
+          handlerId: handlerId,
+          filters: [],
+        }
+
+        for (const filter of eventsHandler.filters) {
+          if (!filter.topics) {
+            throw new ServerError(Status.INVALID_ARGUMENT, 'Topic should not be null')
+          }
+          const logFilter: LogFilter = {
+            topics: [],
+          }
+
+          for (const ts of filter.topics) {
+            let hashes: string[] = []
+            if (Array.isArray(ts)) {
+              hashes = hashes.concat(ts)
+            } else if (ts) {
+              hashes.push(ts)
+            }
+            logFilter.topics.push({ hashes: hashes })
+          }
+          logConfig.filters.push(logFilter)
+        }
+        contractConfig.logConfigs.push(logConfig)
+      }
+
+      // Finish up a contract
+      this.contractConfigs.push(contractConfig)
+    }
+
+    // Part 2, prepare solana constractors
+    for (const solanaProcessor of global.PROCESSOR_STATE.solanaProcessors) {
+      const contractConfig: ContractConfig = {
+        processorType: 'user_processor',
+        contract: {
+          name: solanaProcessor.contractName,
+          chainId: 'SOL:mainnet', // TODO set in processor
+          address: solanaProcessor.address,
+          abi: '',
+        },
+        blockConfigs: [],
+        logConfigs: [],
+        startBlock: solanaProcessor.config.startSlot,
+        endBlock: DEFAULT_MAX_BLOCK,
+        instructionConfig: {
+          innerInstruction: solanaProcessor.processInnerInstruction,
+          parsedInstruction: solanaProcessor.fromParsedInstruction != null ? true : false,
+          rawDataInstruction: solanaProcessor.decodeInstruction != null ? true : false,
+        },
+      }
+      this.contractConfigs.push(contractConfig)
+    }
+  }
+
+  async start(request: StartRequest, context: CallContext): Promise<Empty> {
+    if (this.started) {
+      return {}
+    }
+    for (const instance of request.templateInstances) {
+      const template = global.PROCESSOR_STATE.templates[instance.templateId]
+      if (!template) {
+        throw new ServerError(Status.INVALID_ARGUMENT, 'Invalid template contract:' + instance)
+      }
+      if (!instance.contract) {
+        throw new ServerError(Status.INVALID_ARGUMENT, 'Contract Empty from:' + instance)
+      }
+      template.bind({
+        name: instance.contract.name,
+        address: instance.contract.address,
+        network: Number(instance.contract.chainId),
+        startBlock: instance.startBlock,
+        endBlock: instance.endBlock,
+      })
+    }
+    await this.configure()
+    this.started = true
+    return {}
+  }
+
+  async stop(request: Empty, context: CallContext): Promise<Empty> {
+    console.log('Server Shutting down in 5 seconds')
+    if (this.shutdownHandler) {
+      setTimeout(this.shutdownHandler, 5000)
+    }
+    return {}
+  }
+
+  async processLogs(request: ProcessLogsRequest, context: CallContext): Promise<ProcessLogsResponse> {
+    if (!this.started) {
+      throw new ServerError(Status.UNAVAILABLE, 'Service Not started.')
+    }
+
+    const resp: O11yResult = {
+      gauges: [],
+      counters: [],
+    }
+
+    const promises: Promise<O11yResult>[] = []
+    for (const l of request.logBindings) {
+      if (!l.log) {
+        throw new ServerError(Status.INVALID_ARGUMENT, "Log can't be null")
+      }
+      // const jsonString = Buffer.from(l.log.raw.buffer).toString("utf-8")
+      // const jsonString = String.fromCharCode.apply(null, l.log.raw)
+
+      try {
+        const jsonString = Utf8ArrayToStr(l.log.raw)
+        const log: Log = JSON.parse(jsonString)
+        const handler = this.eventHandlers[l.handlerId]
+        const promise = handler(log).catch((e) => {
+          throw new ServerError(Status.INTERNAL, 'error processing log: ' + jsonString + '\n' + e.toString())
+        })
+
+        promises.push(promise)
+      } catch (e) {
+        throw new ServerError(Status.INTERNAL, 'error parse log: ' + l)
+      }
+    }
+
+    const results = await Promise.all(promises)
+    for (const res of results) {
+      resp.counters = resp.counters.concat(res.counters)
+      resp.gauges = resp.gauges.concat(res.gauges)
+    }
+
+    let updated = false
+    if (
+      global.PROCESSOR_STATE.templatesInstances &&
+      this.templateInstances.length != global.PROCESSOR_STATE.templatesInstances.length
+    ) {
+      await this.configure()
+      updated = true
+    }
+
+    recordRuntimeInfo(resp, HandlerType.LOG)
+    return {
+      result: resp,
+      configUpdated: updated,
+    }
+  }
+
+  async processTransactions(
+    request: ProcessTransactionsRequest,
+    context: CallContext
+  ): Promise<ProcessTransactionsResponse> {
+    if (!this.started) {
+      throw new ServerError(Status.UNAVAILABLE, 'Service not started.')
+    }
+
+    throw new ServerError(Status.UNIMPLEMENTED, 'Processing transaction is not suppored.')
+  }
+
+  async processInstructions(
+    request: ProcessInstructionsRequest,
+    context: CallContext
+  ): Promise<ProcessInstructionsResponse> {
+    if (!this.started) {
+      throw new ServerError(Status.UNAVAILABLE, 'Service not started.')
+    }
+
+    const result: O11yResult = {
+      gauges: [],
+      counters: [],
+    }
+
+    // Only have instruction handlers for solana processors
+    if (global.PROCESSOR_STATE.solanaProcessors) {
+      const processorPromises: Promise<void>[] = []
+      for (const instruction of request.instructions) {
+        if (!instruction) {
+          throw new ServerError(Status.INVALID_ARGUMENT, 'instruction cannot be null')
+        }
+
+        processorPromises.push(
+          new Promise((resolve, _) => {
+            for (const processor of global.PROCESSOR_STATE.solanaProcessors) {
+              if (processor.address === instruction.programAccountId) {
+                let res: O11yResult | null
+                if (instruction.parsed) {
+                  res = processor.handleInstruction(JSON.parse(new TextDecoder().decode(instruction.parsed)))
+                } else if (instruction.instructionData) {
+                  res = processor.handleInstruction(instruction.instructionData)
+                } else {
+                  continue
+                }
+                if (res) {
+                  try {
+                    res.gauges.forEach((g) => {
+                      if (g.metadata) {
+                        g.metadata.blockNumber = instruction.slot
+                      }
+                      result.gauges.push(g)
+                    })
+                    res.counters.forEach((c) => {
+                      if (c.metadata) {
+                        c.metadata.blockNumber = instruction.slot
+                      }
+                      result.counters.push(c)
+                    })
+                  } catch (e) {
+                    console.error('error processing instruction ' + e.toString())
+                  }
+                } else {
+                  console.warn(
+                    `Failed to decode the instruction: ${instruction.instructionData} with slot: ${instruction.slot}`
+                  )
+                }
+              }
+            }
+            resolve()
+          })
+        )
+      }
+
+      await Promise.all(processorPromises)
+    }
+
+    recordRuntimeInfo(result, HandlerType.INSTRUCTION)
+    return {
+      result,
+    }
+  }
+
+  async processBlocks(request: ProcessBlocksRequest, context: CallContext): Promise<ProcessBlocksResponse> {
+    if (!this.started) {
+      throw new ServerError(Status.UNAVAILABLE, 'Service Not started.')
+    }
+
+    const promises = request.blockBindings.map((binding) => this.processBlock(binding))
+    const results = await Promise.all(promises)
+
+    const res = O11yResult.fromPartial({})
+
+    for (const r of results) {
+      res.counters = res.counters.concat(r.counters)
+      res.gauges = res.gauges.concat(r.gauges)
+    }
+
+    recordRuntimeInfo(res, HandlerType.BLOCK)
+    return {
+      result: res,
+    }
+  }
+
+  async processBlock(binding: BlockBinding): Promise<O11yResult> {
+    if (!binding.block) {
+      throw new ServerError(Status.INVALID_ARGUMENT, "Block can't be empty")
+    }
+    const jsonString = Utf8ArrayToStr(binding.block.raw)
+
+    const block: Block = JSON.parse(jsonString)
+
+    const resp: O11yResult = {
+      gauges: [],
+      counters: [],
+    }
+
+    const promises: Promise<O11yResult>[] = []
+    for (const handlerId of binding.handlerIds) {
+      const promise = this.blockHandlers[handlerId](block).catch((e) => {
+        throw new ServerError(Status.INTERNAL, 'error processing block: ' + block.number + '\n' + e.toString())
+      })
+      promises.push(promise)
+    }
+    const allRes = await Promise.all(promises)
+    for (const res of allRes) {
+      resp.counters = resp.counters.concat(res.counters)
+      resp.gauges = resp.gauges.concat(res.gauges)
+    }
+    return resp
+  }
+}
+
+// https://ourcodeworld.com/articles/read/164/how-to-convert-an-uint8array-to-string-in-javascript
+/* eslint-disable */
+function Utf8ArrayToStr(array: Uint8Array) {
+  let out, i, len, c
+  let char2, char3
+
+  out = ''
+  len = array.length
+  i = 0
+  while (i < len) {
+    c = array[i++]
+    switch (c >> 4) {
+      case 0:
+      case 1:
+      case 2:
+      case 3:
+      case 4:
+      case 5:
+      case 6:
+      case 7:
+        // 0xxxxxxx
+        out += String.fromCharCode(c)
+        break
+      case 12:
+      case 13:
+        // 110x xxxx   10xx xxxx
+        char2 = array[i++]
+        out += String.fromCharCode(((c & 0x1f) << 6) | (char2 & 0x3f))
+        break
+      case 14:
+        // 1110 xxxx  10xx xxxx  10xx xxxx
+        char2 = array[i++]
+        char3 = array[i++]
+        out += String.fromCharCode(((c & 0x0f) << 12) | ((char2 & 0x3f) << 6) | ((char3 & 0x3f) << 0))
+        break
+    }
+  }
+
+  return out
+}
+
+function recordRuntimeInfo(results: O11yResult, handlerType: HandlerType) {
+  results.gauges.forEach((e) => {
+    e.runtimeInfo = {
+      from: handlerType,
+    }
+  })
+
+  results.counters.forEach((e) => {
+    e.runtimeInfo = {
+      from: handlerType,
+    }
+  })
+}

package/src/solana/builtin/index.ts

@@ -0,0 +1,2 @@
+export * from './spl-token-processor'
+export * from './wormhole-processor'

package/src/solana/builtin/spl-token-processor.ts

@@ -0,0 +1,164 @@
+import { SolanaBaseProcessor } from '../../solana-processor'
+import { SolanaContext } from '../../context'
+import { Instruction } from '@project-serum/anchor'
+import { Approve, Burn, CloseAccount, FreezeAccount, InitializeAccount, InitializeAccount2, InitializeAccount3, InitializeMint, InitializeMultisig, MintTo, Revoke, ThawAccount, Transfer } from './types';
+import { SolanaBindOptions } from '../../bind-options';
+
+export class SPLTokenProcessor extends SolanaBaseProcessor {
+  static bind(options: SolanaBindOptions): SPLTokenProcessor {
+    if (options && !options.name) {
+      options.name = 'SPL Token Program'
+    }
+    return new SPLTokenProcessor(options)
+  }
+  
+  fromParsedInstruction: (instruction: { type: string, info: any }) => Instruction | null = (instruction: { type: string, info: any }) => {
+    const instructionType = instruction.type
+    if (!instructionType) {
+      return null
+    }
+    return {
+      name: instruction.type,
+      data: {
+        ...instruction.info,
+      },
+    }
+  }
+
+  public onInitializeMint(
+    handler: (data: InitializeMint, ctx: SolanaContext) => void
+  ): SPLTokenProcessor {
+    this.onInstruction('initializeMint', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as InitializeMint, ctx)
+      }
+    })
+    return this
+  }
+
+  public onInitializeAccount(
+    hanlder: (data: InitializeAccount, ctx: SolanaContext) => void
+  ): SPLTokenProcessor {
+    this.onInstruction('initializeAccount', (ins: Instruction, ctx) => {
+      if (ins) {
+        hanlder(ins.data as InitializeAccount, ctx)
+      }
+    })
+    return this
+  }
+
+  public onInitializeAccount2(
+    hanlder: (data: InitializeAccount2, ctx: SolanaContext) => void
+  ): SPLTokenProcessor {
+    this.onInstruction('initializeAccount2', (ins: Instruction, ctx) => {
+      if (ins) {
+        hanlder(ins.data as InitializeAccount2, ctx)
+      }
+    })
+    return this
+  }
+
+  public onInitializeAccount3(
+    hanlder: (data: InitializeAccount3, ctx: SolanaContext) => void
+  ): SPLTokenProcessor {
+    this.onInstruction('initializeAccount3', (ins: Instruction, ctx) => {
+      if (ins) {
+        hanlder(ins.data as InitializeAccount3, ctx)
+      }
+    })
+    return this
+  }
+
+  public onInitializeMultisig(
+    handler: (data: InitializeMultisig, ctx: SolanaContext) => void
+  ): SPLTokenProcessor {
+    this.onInstruction('initializeMultisig', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as InitializeMultisig, ctx)
+      }
+    })
+    return this
+  }
+
+  public onTransfer(handler: (data: Transfer, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('transfer', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as Transfer, ctx)
+      }
+    })
+    return this
+  }
+
+  public onApprovend(handler: (data: Approve, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('approve', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as Approve, ctx)
+      }
+    })
+    return this
+  }
+
+  public onRevoke(handler: (data: Revoke, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('revoke', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as Revoke, ctx)
+      }
+    })
+    return this
+  }
+
+  public onSetAuthority(handler: (data: any, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('setAuthority', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as any, ctx)
+      }
+    })
+    return this
+  }
+
+  public onMintTo(handler: (data: MintTo, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('mintTo', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as MintTo, ctx)
+      }
+    })
+    return this
+  }
+
+  public onBurn(handler: (data: Burn, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('burn', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as Burn, ctx)
+      }
+    })
+    return this
+  }
+
+  public onCloseAccount(handler: (data: CloseAccount, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('closeAccount', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as CloseAccount, ctx)
+      }
+    })
+    return this
+  }
+
+  public onFreezeAccount(handler: (data: FreezeAccount, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('freezeAccount', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as FreezeAccount, ctx)
+      }
+    })
+    return this
+  }
+
+  public onThawAccount(handler: (data: ThawAccount, ctx: SolanaContext) => void): SPLTokenProcessor {
+    this.onInstruction('thawAccount', (ins: Instruction, ctx) => {
+      if (ins) {
+        handler(ins.data as ThawAccount, ctx)
+      }
+    })
+    return this
+  }
+  // Todo(pcxu): auto gen this file
+}