@sentio/sdk 1.23.0 → 1.24.0

package/src/core/event-tracker.ts

@@ -0,0 +1,66 @@
+import { BaseContext } from './context'
+import { DataDescriptor, EventTrackingResult } from '@sentio/sdk'
+
+export interface Event {
+  // The unique identifier of main identity associate with an event
+  // .e.g user id / toekn address / account address / contract address id
+  //
+  distinctId: string
+  payload?: Record<string, string>
+}
+
+export interface TrackerOptions {
+  totalByDay?: boolean
+  unique?: boolean
+  distinctByDays?: number[]
+}
+
+// Track Event with an identity associate with it
+export class EventTracker {
+  static DEFAULT_OPTIONS: TrackerOptions = {
+    totalByDay: true,
+    unique: true,
+  }
+
+  static register(eventName: string, options?: TrackerOptions) {
+    const tracker = new EventTracker(eventName, { ...EventTracker.DEFAULT_OPTIONS, ...options })
+    global.PROCESSOR_STATE.eventTrackers.push(tracker)
+    return tracker
+  }
+
+  eventName: string
+  options: TrackerOptions
+  protected constructor(eventName: string, options: TrackerOptions) {
+    this.eventName = eventName
+    this.options = options
+  }
+
+  trackEvent(ctx: BaseContext, event: Event) {
+    const res: EventTrackingResult = {
+      metadata: ctx.getMetaData(DataDescriptor.fromPartial({ name: this.eventName }), {}),
+      distinctEntityId: event.distinctId,
+      attributes: JSON.stringify({}),
+      runtimeInfo: undefined,
+    }
+    ctx.events.push(res)
+  }
+}
+
+export class AccountEventTracker extends EventTracker {
+  static DEFAULT_OPTIONS: TrackerOptions = {
+    totalByDay: true,
+    unique: true,
+    distinctByDays: [1, 7, 30],
+  }
+
+  static register(eventName?: string, options?: TrackerOptions) {
+    if (eventName) {
+      ;['user', eventName].join('.')
+    } else {
+      eventName = 'user'
+    }
+    const tracker = new AccountEventTracker(eventName, { ...AccountEventTracker.DEFAULT_OPTIONS, ...options })
+    global.PROCESSOR_STATE.eventTrackers.push(tracker)
+    return tracker
+  }
+}

package/src/core/index.ts

@@ -1,6 +1,7 @@
 export { BigDecimal } from './big-decimal'
 export { ContractContext, ContractView, BoundContractView, SolanaContext } from './context'
 export { CounterBinding, Meter, GaugeBinding, Counter, Gauge, MetricDescriptorOptions } from './meter'
+export { EventTracker, AccountEventTracker } from './event-tracker'
 export { type Numberish, toBigInteger, toMetricValue } from './numberish'
 
 export { BindOptions, SolanaBindOptions } from './bind-options'

package/src/core/solana-processor.ts

@@ -80,11 +80,7 @@ export class SolanaBaseProcessor {
   ): ProcessResult {
     const ctx = new SolanaContext(this.contractName, this.address, slot)
     handler(parsedInstruction, ctx, accounts)
-    return {
-      gauges: ctx.gauges,
-      counters: ctx.counters,
-      logs: ctx.logs,
-    }
+    return ctx.getProcessResult()
   }
 
   public isBind() {

package/src/core/sui-processor.ts

@@ -39,11 +39,7 @@ export class SuiBaseProcessor {
     if (txn) {
       this.transactionHanlder(txn, ctx)
     }
-    return {
-      gauges: ctx.gauges,
-      counters: ctx.counters,
-      logs: ctx.logs,
-    }
+    return ctx.getProcessResult()
   }
 
   public startSlot(startSlot: Long | number) {