envio 3.3.0-alpha.7 → 3.3.0-alpha.8

package/index.d.ts

@@ -979,13 +979,24 @@ export type SvmInstructionParams = {
   readonly extraAccounts: readonly string[];
 };
 
-/** Block context for a matched instruction. */
+/** Permissive fallback shape for an instruction's `block`. The generated
+ * per-instruction type narrows this to `slot`/`hash` (always present) and
+ * `time` (always present but possibly `undefined`), plus the selected
+ * `field_selection.block_fields`. */
 export type SvmInstructionBlock = {
   /** Slot this instruction's block was matched in. */
   readonly slot: number;
-  readonly time: number;
-  /** Always empty for now — reserved for the future reorg-guard route. */
+  /** Unix block time (seconds). Absent when HyperSync/Solana doesn't report a
+   * block time for this slot. */
+  readonly time?: number;
+  /** Block hash. */
   readonly hash: string;
+  /** Block height. Select via `field_selection.block_fields`. */
+  readonly height?: number;
+  /** Parent slot. Select via `field_selection.block_fields`. */
+  readonly parentSlot?: number;
+  /** Parent block hash. Select via `field_selection.block_fields`. */
+  readonly parentHash?: string;
 };
 
 export type SvmTokenBalance = {
@@ -1016,6 +1027,7 @@ export type SvmLog = {
 export type SvmInstruction<
   Params extends SvmInstructionParams = SvmInstructionParams,
   Tx = SvmTransaction,
+  Block = SvmInstructionBlock,
 > = {
   /** Program name as declared under `programs[].name` in `config.yaml`. */
   readonly programName: string;
@@ -1041,7 +1053,12 @@ export type SvmInstruction<
   /** Present when the instruction's `include_logs` is `true`; only logs
    * scoped to this exact instruction (matching `instruction_address`). */
   readonly logs?: readonly SvmLog[];
-  readonly block: SvmInstructionBlock;
+  /** The block this instruction's slot belongs to. Carries `slot`/`hash`
+   * (always present) and `time` (always present but possibly `undefined`),
+   * plus the fields selected via this instruction's
+   * `field_selection.block_fields`; unselected fields are typed as
+   * `FieldNotSelected<...>`. */
+  readonly block: Block;
 };
 
 /** Arguments passed to handlers registered via `indexer.onInstruction`. */
@@ -1315,7 +1332,8 @@ type SvmEcosystem<Config extends IndexerConfigTypes = GlobalConfig> =
                       Config,
                       SvmInstruction<
                         SvmParamsFromProgramTable<Programs[P][I]>,
-                        Programs[P][I]["transaction"]
+                        Programs[P][I]["transaction"],
+                        Programs[P][I]["block"]
                       >
                     >,
                   ) => Promise<void>,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "envio",
-  "version": "3.3.0-alpha.7",
+  "version": "3.3.0-alpha.8",
   "type": "module",
   "description": "A latency and sync speed optimized, developer friendly blockchain data indexer.",
   "bin": "./bin.mjs",
@@ -69,10 +69,10 @@
     "tsx": "4.21.0"
   },
   "optionalDependencies": {
-    "envio-linux-x64": "3.3.0-alpha.7",
-    "envio-linux-x64-musl": "3.3.0-alpha.7",
-    "envio-linux-arm64": "3.3.0-alpha.7",
-    "envio-darwin-x64": "3.3.0-alpha.7",
-    "envio-darwin-arm64": "3.3.0-alpha.7"
+    "envio-linux-x64": "3.3.0-alpha.8",
+    "envio-linux-x64-musl": "3.3.0-alpha.8",
+    "envio-linux-arm64": "3.3.0-alpha.8",
+    "envio-darwin-x64": "3.3.0-alpha.8",
+    "envio-darwin-arm64": "3.3.0-alpha.8"
   }
 }

package/src/Api.res

@@ -9,7 +9,7 @@ let createTestIndexer: unit => unknown = () => {
       NodeJs.Path.getDirname(NodeJs.ImportMeta.importMeta),
       "TestIndexerWorker.res.mjs",
     )->NodeJs.Path.toString
-  TestIndexer.makeCreateTestIndexer(~config=Config.loadWithoutRegistrations(), ~workerPath)()->(
+  TestIndexer.makeCreateTestIndexer(~config=Config.load(), ~workerPath)()->(
     Utils.magic: TestIndexer.t<'a> => unknown
   )
 }

package/src/Api.res.mjs

@@ -10,7 +10,7 @@ let indexer = Main.getGlobalIndexer();
 
 function createTestIndexer() {
   let workerPath = Path.join(NodeJs.Path.getDirname(import.meta), "TestIndexerWorker.res.mjs");
-  return TestIndexer.makeCreateTestIndexer(Config.loadWithoutRegistrations(), workerPath)();
+  return TestIndexer.makeCreateTestIndexer(Config.load(), workerPath)();
 }
 
 export {

package/src/ChainFetching.res

@@ -11,12 +11,18 @@ type partitionQueryResponse = {
 let runContractRegistersOrThrow = async (
   ~itemsWithContractRegister: array<Internal.item>,
   ~config: Config.t,
-  ~page: option<TransactionStore.t>,
+  ~transactionStore: option<TransactionStore.t>,
+  ~blockStore: option<BlockStore.t>,
 ) => {
-  // contractRegister handlers can read event.transaction, so materialise the
-  // selected fields onto the payloads before running them. All items belong to
-  // the chain being fetched, hence its single page store and mask.
-  await ChainState.materializePageItems(~items=itemsWithContractRegister, ~page)
+  // contractRegister handlers can read event.transaction and event.block, so
+  // materialise the selected fields onto the payloads before running them. All
+  // items belong to the chain being fetched, hence its single page stores.
+  await ChainState.materializePageItems(
+    ~items=itemsWithContractRegister,
+    ~transactionStore,
+    ~blockStore,
+    ~ecosystem=config.ecosystem.name,
+  )
 
   let itemsWithDcs = []
 
@@ -44,8 +50,8 @@ let runContractRegistersOrThrow = async (
     let item = itemsWithContractRegister->Array.getUnsafe(idx)
     let eventItem = item->Internal.castUnsafeEventItem
     let contractRegister = switch eventItem {
-    | {eventConfig: {contractRegister: Some(contractRegister)}} => contractRegister
-    | {eventConfig: {contractRegister: None, name: eventName}} =>
+    | {onEventRegistration: {contractRegister: Some(contractRegister)}} => contractRegister
+    | {onEventRegistration: {contractRegister: None, eventConfig: {name: eventName}}} =>
       // Unexpected case, since we should pass only events with contract register to this function
       JsError.throwWithMessage("Contract register is not set for event " ++ eventName)
     }
@@ -113,6 +119,7 @@ let rec onQueryResponse = async (
     let {
       parsedQueueItems,
       transactionStore,
+      blockStore,
       latestFetchedBlockNumber,
       latestFetchedBlockTimestamp,
       stats,
@@ -142,7 +149,7 @@ let rec onQueryResponse = async (
 
     let numContractRegisterEvents = parsedQueueItems->Array.reduce(0, (count, item) => {
       let eventItem = item->Internal.castUnsafeEventItem
-      eventItem.eventConfig.contractRegister !== None ? count + 1 : count
+      eventItem.onEventRegistration.contractRegister !== None ? count + 1 : count
     })
     Logging.trace({
       "msg": "Finished querying",
@@ -210,7 +217,7 @@ let rec onQueryResponse = async (
       for idx in 0 to parsedQueueItems->Array.length - 1 {
         let item = parsedQueueItems->Array.getUnsafe(idx)
         let eventItem = item->Internal.castUnsafeEventItem
-        if eventItem.eventConfig.contractRegister !== None {
+        if eventItem.onEventRegistration.contractRegister !== None {
           itemsWithContractRegister->Array.push(item)
         }
         // TODO: Don't really need to keep it in the queue
@@ -234,6 +241,7 @@ let rec onQueryResponse = async (
             },
             ~query,
             ~transactionStore,
+            ~blockStore,
           )
           ChainMetadata.stage(state)
           scheduleFetch()
@@ -246,7 +254,8 @@ let rec onQueryResponse = async (
         switch await runContractRegistersOrThrow(
           ~itemsWithContractRegister,
           ~config=state->IndexerState.config,
-          ~page=transactionStore,
+          ~transactionStore,
+          ~blockStore,
         ) {
         | exception exn => IndexerState.errorExit(state, exn->ErrorHandling.make)
         | newItemsWithDcs => proceed(~newItemsWithDcs)
@@ -264,6 +273,7 @@ and applyQueryResponse = (
   ~latestFetchedBlock,
   ~query,
   ~transactionStore,
+  ~blockStore,
 ) => {
   let chainState = state->IndexerState.getChainState(~chain)
   let wasFetchingAtHead = chainState->ChainState.isFetchingAtHead
@@ -275,6 +285,7 @@ and applyQueryResponse = (
     ~newItemsWithDcs,
     ~knownHeight,
     ~transactionStore,
+    ~blockStore,
   )
 
   // In auto-exit mode, set endBlock to the first event's block when events arrive.

package/src/ChainFetching.res.mjs

@@ -17,8 +17,8 @@ import * as Stdlib_Promise from "@rescript/runtime/lib/es6/Stdlib_Promise.js";
 import * as Primitive_exceptions from "@rescript/runtime/lib/es6/Primitive_exceptions.js";
 import * as ContractRegisterContext from "./ContractRegisterContext.res.mjs";
 
-async function runContractRegistersOrThrow(itemsWithContractRegister, config, page) {
-  await ChainState.materializePageItems(itemsWithContractRegister, page);
+async function runContractRegistersOrThrow(itemsWithContractRegister, config, transactionStore, blockStore) {
+  await ChainState.materializePageItems(itemsWithContractRegister, transactionStore, blockStore, config.ecosystem.name);
   let itemsWithDcs = [];
   let onRegister = (item, contractAddress, contractName) => {
     let dc_registrationBlock = item.blockNumber;
@@ -38,9 +38,9 @@ async function runContractRegistersOrThrow(itemsWithContractRegister, config, pa
   let promises = [];
   for (let idx = 0, idx_finish = itemsWithContractRegister.length; idx < idx_finish; ++idx) {
     let item = itemsWithContractRegister[idx];
-    let match = item.eventConfig;
+    let match = item.onEventRegistration;
     let contractRegister = match.contractRegister;
-    let contractRegister$1 = contractRegister !== undefined ? contractRegister : Stdlib_JsError.throwWithMessage("Contract register is not set for event " + match.name);
+    let contractRegister$1 = contractRegister !== undefined ? contractRegister : Stdlib_JsError.throwWithMessage("Contract register is not set for event " + match.eventConfig.name);
     let errorMessage = "Event contractRegister failed, please fix the error to keep the indexer running smoothly";
     try {
       let params = {
@@ -72,10 +72,10 @@ async function runContractRegistersOrThrow(itemsWithContractRegister, config, pa
   return itemsWithDcs;
 }
 
-function applyQueryResponse(state, chain, newItems, newItemsWithDcs, knownHeight, latestFetchedBlock, query, transactionStore) {
+function applyQueryResponse(state, chain, newItems, newItemsWithDcs, knownHeight, latestFetchedBlock, query, transactionStore, blockStore) {
   let chainState = IndexerState.getChainState(state, chain);
   let wasFetchingAtHead = ChainState.isFetchingAtHead(chainState);
-  ChainState.handleQueryResult(chainState, query, newItems, newItemsWithDcs, latestFetchedBlock, knownHeight, transactionStore);
+  ChainState.handleQueryResult(chainState, query, newItems, newItemsWithDcs, latestFetchedBlock, knownHeight, transactionStore, blockStore);
   if (IndexerState.exitAfterFirstEventBlock(state) && newItems.length !== 0) {
     ChainState.setEndBlockToFirstEvent(chainState, newItems[0].blockNumber);
   }
@@ -96,6 +96,7 @@ async function onQueryResponse(state, param, stateId, scheduleFetch, schedulePro
   let latestFetchedBlockTimestamp = response.latestFetchedBlockTimestamp;
   let latestFetchedBlockNumber = response.latestFetchedBlockNumber;
   let fromBlockQueried = response.fromBlockQueried;
+  let blockStore = response.blockStore;
   let transactionStore = response.transactionStore;
   let parsedQueueItems = response.parsedQueueItems;
   let knownHeight = response.knownHeight;
@@ -104,7 +105,7 @@ async function onQueryResponse(state, param, stateId, scheduleFetch, schedulePro
   }
   Prometheus.FetchingBlockRange.increment(chain, stats["total time elapsed (s)"], Stdlib_Option.getOr(stats["parsing time (s)"], 0), parsedQueueItems.length, (latestFetchedBlockNumber - fromBlockQueried | 0) + 1 | 0);
   let numContractRegisterEvents = Stdlib_Array.reduce(parsedQueueItems, 0, (count, item) => {
-    if (item.eventConfig.contractRegister !== undefined) {
+    if (item.onEventRegistration.contractRegister !== undefined) {
       return count + 1 | 0;
     } else {
       return count;
@@ -142,7 +143,7 @@ async function onQueryResponse(state, param, stateId, scheduleFetch, schedulePro
   let newItems = [];
   for (let idx = 0, idx_finish = parsedQueueItems.length; idx < idx_finish; ++idx) {
     let item = parsedQueueItems[idx];
-    if (item.eventConfig.contractRegister !== undefined) {
+    if (item.onEventRegistration.contractRegister !== undefined) {
       itemsWithContractRegister.push(item);
     }
     newItems.push(item);
@@ -152,7 +153,7 @@ async function onQueryResponse(state, param, stateId, scheduleFetch, schedulePro
       applyQueryResponse(state, chain, newItems, newItemsWithDcs, knownHeight, {
         blockNumber: latestFetchedBlockNumber,
         blockTimestamp: latestFetchedBlockTimestamp
-      }, query, transactionStore);
+      }, query, transactionStore, blockStore);
       ChainMetadata.stage(state);
       scheduleFetch();
       return scheduleProcessing();
@@ -163,7 +164,7 @@ async function onQueryResponse(state, param, stateId, scheduleFetch, schedulePro
   }
   let newItemsWithDcs;
   try {
-    newItemsWithDcs = await runContractRegistersOrThrow(itemsWithContractRegister, IndexerState.config(state), transactionStore);
+    newItemsWithDcs = await runContractRegistersOrThrow(itemsWithContractRegister, IndexerState.config(state), transactionStore, blockStore);
   } catch (raw_exn) {
     let exn = Primitive_exceptions.internalToException(raw_exn);
     return IndexerState.errorExit(state, ErrorHandling.make(exn, undefined, undefined));