envio 3.3.0-alpha.4 → 3.3.0-alpha.6

package/src/Prometheus.res.mjs

@@ -389,39 +389,28 @@ let ProcessStartTimeSeconds = {
   set: set$3
 };
 
-let gauge$4 = makeOrThrow$1("envio_indexing_addresses", "The number of addresses indexed on chain. Includes both static and dynamic addresses.", chainIdLabelsSchema);
+let gauge$4 = makeOrThrow$1("envio_indexing_concurrency", "The number of executing concurrent queries to the chain data-source.", chainIdLabelsSchema);
 
-function set$4(addressesCount, chainId) {
-  handleInt$1(gauge$4, chainId, addressesCount);
+function set$4(concurrency, chainId) {
+  handleInt$1(gauge$4, chainId, concurrency);
 }
 
-let IndexingAddresses = {
+let IndexingConcurrency = {
   gauge: gauge$4,
   set: set$4
 };
 
-let gauge$5 = makeOrThrow$1("envio_indexing_concurrency", "The number of executing concurrent queries to the chain data-source.", chainIdLabelsSchema);
+let gauge$5 = makeOrThrow$1("envio_indexing_partitions", "The number of partitions used to split fetching logic by addresses and block ranges.", chainIdLabelsSchema);
 
-function set$5(concurrency, chainId) {
-  handleInt$1(gauge$5, chainId, concurrency);
+function set$5(partitionsCount, chainId) {
+  handleInt$1(gauge$5, chainId, partitionsCount);
 }
 
-let IndexingConcurrency = {
+let IndexingPartitions = {
   gauge: gauge$5,
   set: set$5
 };
 
-let gauge$6 = makeOrThrow$1("envio_indexing_partitions", "The number of partitions used to split fetching logic by addresses and block ranges.", chainIdLabelsSchema);
-
-function set$6(partitionsCount, chainId) {
-  handleInt$1(gauge$6, chainId, partitionsCount);
-}
-
-let IndexingPartitions = {
-  gauge: gauge$6,
-  set: set$6
-};
-
 let counter = makeOrThrow("envio_indexing_idle_seconds", "The time the indexer source syncing has been idle. A high value may indicate the source sync is a bottleneck.", chainIdLabelsSchema);
 
 let IndexingIdleTime = {
@@ -440,51 +429,51 @@ let IndexingQueryTime = {
   counter: counter$2
 };
 
-let gauge$7 = makeOrThrow$1("envio_indexing_buffer_size", "The current number of items in the indexing buffer.", chainIdLabelsSchema);
+let gauge$6 = makeOrThrow$1("envio_indexing_buffer_size", "The current number of items in the indexing buffer.", chainIdLabelsSchema);
 
-function set$7(bufferSize, chainId) {
-  handleInt$1(gauge$7, chainId, bufferSize);
+function set$6(bufferSize, chainId) {
+  handleInt$1(gauge$6, chainId, bufferSize);
 }
 
 let IndexingBufferSize = {
-  gauge: gauge$7,
-  set: set$7
+  gauge: gauge$6,
+  set: set$6
 };
 
-let gauge$8 = PromClient.Gauge.makeGauge({
+let gauge$7 = PromClient.Gauge.makeGauge({
   name: "envio_indexing_target_buffer_size",
   help: "The indexer-wide target buffer size shared across all chains. The actual number of items in the queue may exceed this value, but the indexer always tries to keep the buffer filled up to this target."
 });
 
-function set$8(targetBufferSize) {
-  gauge$8.set(targetBufferSize);
+function set$7(targetBufferSize) {
+  gauge$7.set(targetBufferSize);
 }
 
 let IndexingTargetBufferSize = {
-  gauge: gauge$8,
-  set: set$8
+  gauge: gauge$7,
+  set: set$7
 };
 
-let gauge$9 = makeOrThrow$1("envio_indexing_buffer_block", "The highest block number that has been fully fetched by the indexer.", chainIdLabelsSchema);
+let gauge$8 = makeOrThrow$1("envio_indexing_buffer_block", "The highest block number that has been fully fetched by the indexer.", chainIdLabelsSchema);
 
-function set$9(blockNumber, chainId) {
-  handleInt$1(gauge$9, chainId, blockNumber);
+function set$8(blockNumber, chainId) {
+  handleInt$1(gauge$8, chainId, blockNumber);
 }
 
 let IndexingBufferBlockNumber = {
-  gauge: gauge$9,
-  set: set$9
+  gauge: gauge$8,
+  set: set$8
 };
 
-let gauge$10 = makeOrThrow$1("envio_indexing_end_block", "The block number to stop indexing at. (inclusive)", chainIdLabelsSchema);
+let gauge$9 = makeOrThrow$1("envio_indexing_end_block", "The block number to stop indexing at. (inclusive)", chainIdLabelsSchema);
 
-function set$10(endBlock, chainId) {
-  handleInt$1(gauge$10, chainId, endBlock);
+function set$9(endBlock, chainId) {
+  handleInt$1(gauge$9, chainId, endBlock);
 }
 
 let IndexingEndBlock = {
-  gauge: gauge$10,
-  set: set$10
+  gauge: gauge$9,
+  set: set$9
 };
 
 let sourceLabelsSchema = S$RescriptSchema.schema(s => ({
@@ -525,18 +514,18 @@ let SourceRequestCount = {
   addSeconds: addSeconds
 };
 
-let gauge$11 = makeOrThrow$1("envio_source_known_height", "The latest known block number reported by the source. This value may lag behind the actual chain height, as it is updated only when queried.", sourceLabelsSchema);
+let gauge$10 = makeOrThrow$1("envio_source_known_height", "The latest known block number reported by the source. This value may lag behind the actual chain height, as it is updated only when queried.", sourceLabelsSchema);
 
-function set$11(sourceName, chainId, blockNumber) {
-  handleInt$1(gauge$11, {
+function set$10(sourceName, chainId, blockNumber) {
+  handleInt$1(gauge$10, {
     source: sourceName,
     chainId: chainId
   }, blockNumber);
 }
 
 let SourceHeight = {
-  gauge: gauge$11,
-  set: set$11
+  gauge: gauge$10,
+  set: set$10
 };
 
 let counter$4 = makeOrThrow("envio_reorg_detected_total", "Total number of reorgs detected", chainIdLabelsSchema);
@@ -550,43 +539,43 @@ let ReorgCount = {
   increment: increment$5
 };
 
-let gauge$12 = makeOrThrow$1("envio_reorg_detected_block", "The block number where reorg was detected the last time. This doesn't mean that the block was reorged, this is simply where we found block hash to be different.", chainIdLabelsSchema);
+let gauge$11 = makeOrThrow$1("envio_reorg_detected_block", "The block number where reorg was detected the last time. This doesn't mean that the block was reorged, this is simply where we found block hash to be different.", chainIdLabelsSchema);
 
-function set$12(blockNumber, chain) {
-  handleInt$1(gauge$12, chain, blockNumber);
+function set$11(blockNumber, chain) {
+  handleInt$1(gauge$11, chain, blockNumber);
 }
 
 let ReorgDetectionBlockNumber = {
-  gauge: gauge$12,
-  set: set$12
+  gauge: gauge$11,
+  set: set$11
 };
 
-let gauge$13 = PromClient.Gauge.makeGauge({
+let gauge$12 = PromClient.Gauge.makeGauge({
   name: "envio_reorg_threshold",
   help: "Whether indexing is currently within the reorg threshold"
 });
 
-function set$13(isInReorgThreshold) {
-  gauge$13.set(isInReorgThreshold ? 1 : 0);
+function set$12(isInReorgThreshold) {
+  gauge$12.set(isInReorgThreshold ? 1 : 0);
 }
 
 let ReorgThreshold = {
-  gauge: gauge$13,
-  set: set$13
+  gauge: gauge$12,
+  set: set$12
 };
 
-let gauge$14 = PromClient.Gauge.makeGauge({
+let gauge$13 = PromClient.Gauge.makeGauge({
   name: "envio_rollback_enabled",
   help: "Whether rollback on reorg is enabled"
 });
 
-function set$14(enabled) {
-  gauge$14.set(enabled ? 1 : 0);
+function set$13(enabled) {
+  gauge$13.set(enabled ? 1 : 0);
 }
 
 let RollbackEnabled = {
-  gauge: gauge$14,
-  set: set$14
+  gauge: gauge$13,
+  set: set$13
 };
 
 let timeCounter$3 = PromClient.Counter.makeCounter({
@@ -635,62 +624,62 @@ let RollbackHistoryPrune = {
   increment: increment$7
 };
 
-let gauge$15 = makeOrThrow$1("envio_rollback_target_block", "The block number reorg was rollbacked to the last time.", chainIdLabelsSchema);
+let gauge$14 = makeOrThrow$1("envio_rollback_target_block", "The block number reorg was rollbacked to the last time.", chainIdLabelsSchema);
 
-function set$15(blockNumber, chain) {
-  handleInt$1(gauge$15, chain, blockNumber);
+function set$14(blockNumber, chain) {
+  handleInt$1(gauge$14, chain, blockNumber);
 }
 
 let RollbackTargetBlockNumber = {
-  gauge: gauge$15,
-  set: set$15
+  gauge: gauge$14,
+  set: set$14
 };
 
-let gauge$16 = PromClient.Gauge.makeGauge({
+let gauge$15 = PromClient.Gauge.makeGauge({
   name: "envio_processing_max_batch_size",
   help: "The maximum number of items to process in a single batch."
 });
 
-function set$16(maxBatchSize) {
-  gauge$16.set(maxBatchSize);
+function set$15(maxBatchSize) {
+  gauge$15.set(maxBatchSize);
 }
 
 let ProcessingMaxBatchSize = {
-  gauge: gauge$16,
-  set: set$16
+  gauge: gauge$15,
+  set: set$15
 };
 
-let gauge$17 = makeOrThrow$1("envio_progress_block", "The block number of the latest block processed and stored in the database.", chainIdLabelsSchema);
+let gauge$16 = makeOrThrow$1("envio_progress_block", "The block number of the latest block processed and stored in the database.", chainIdLabelsSchema);
 
-function set$17(blockNumber, chainId) {
-  handleInt$1(gauge$17, chainId, blockNumber);
+function set$16(blockNumber, chainId) {
+  handleInt$1(gauge$16, chainId, blockNumber);
 }
 
 let ProgressBlockNumber = {
-  gauge: gauge$17,
-  set: set$17
+  gauge: gauge$16,
+  set: set$16
 };
 
-let gauge$18 = makeOrThrow$1("envio_progress_events", "The number of events processed and reflected in the database.", chainIdLabelsSchema);
+let gauge$17 = makeOrThrow$1("envio_progress_events", "The number of events processed and reflected in the database.", chainIdLabelsSchema);
 
-function set$18(processedCount, chainId) {
-  handleFloat$1(gauge$18, chainId, processedCount);
+function set$17(processedCount, chainId) {
+  handleFloat$1(gauge$17, chainId, processedCount);
 }
 
 let ProgressEventsCount = {
-  gauge: gauge$18,
-  set: set$18
+  gauge: gauge$17,
+  set: set$17
 };
 
-let gauge$19 = makeOrThrow$1("envio_progress_latency", "The latency in milliseconds between the latest processed event creation and the time it was written to storage.", chainIdLabelsSchema);
+let gauge$18 = makeOrThrow$1("envio_progress_latency", "The latency in milliseconds between the latest processed event creation and the time it was written to storage.", chainIdLabelsSchema);
 
-function set$19(latencyMs, chainId) {
-  handleInt$1(gauge$19, chainId, latencyMs);
+function set$18(latencyMs, chainId) {
+  handleInt$1(gauge$18, chainId, latencyMs);
 }
 
 let ProgressLatency = {
-  gauge: gauge$19,
-  set: set$19
+  gauge: gauge$18,
+  set: set$18
 };
 
 let effectLabelsSchema = S$RescriptSchema.object(s => s.f("effect", S$RescriptSchema.string));
@@ -710,15 +699,15 @@ let EffectCalls = {
   activeCallsCount: activeCallsCount
 };
 
-let gauge$20 = makeOrThrow$1("envio_effect_cache", "The number of items in the effect cache.", effectLabelsSchema);
+let gauge$19 = makeOrThrow$1("envio_effect_cache", "The number of items in the effect cache.", effectLabelsSchema);
 
-function set$20(count, effectName) {
-  handleInt$1(gauge$20, effectName, count);
+function set$19(count, effectName) {
+  handleInt$1(gauge$19, effectName, count);
 }
 
 let EffectCacheCount = {
-  gauge: gauge$20,
-  set: set$20
+  gauge: gauge$19,
+  set: set$19
 };
 
 let counter$7 = makeOrThrow("envio_effect_cache_invalidations", "The number of effect cache invalidations.", effectLabelsSchema);
@@ -732,18 +721,18 @@ let EffectCacheInvalidationsCount = {
   increment: increment$8
 };
 
-let gauge$21 = makeOrThrow$1("envio_effect_queue", "The number of effect calls waiting in the rate limit queue.", effectLabelsSchema);
+let gauge$20 = makeOrThrow$1("envio_effect_queue", "The number of effect calls waiting in the rate limit queue.", effectLabelsSchema);
 
 let timeCounter$6 = makeOrThrow("envio_effect_queue_wait_seconds", "The time spent waiting in the rate limit queue.", effectLabelsSchema);
 
-function set$21(count, effectName) {
-  handleInt$1(gauge$21, effectName, count);
+function set$20(count, effectName) {
+  handleInt$1(gauge$20, effectName, count);
 }
 
 let EffectQueueCount = {
-  gauge: gauge$21,
+  gauge: gauge$20,
   timeCounter: timeCounter$6,
-  set: set$21
+  set: set$20
 };
 
 let loadLabelsSchema = S$RescriptSchema.schema(s => ({
@@ -846,7 +835,6 @@ export {
   IndexingKnownHeight,
   Info,
   ProcessStartTimeSeconds,
-  IndexingAddresses,
   IndexingConcurrency,
   IndexingPartitions,
   IndexingIdleTime,

package/src/SimulateDeadInputTracker.res

@@ -0,0 +1,85 @@
+// Lives on IndexerState and is fed each processed batch, so ChainState and the
+// fetch loop carry no simulate-specific state.
+
+// Match a provided item to a processed one by its (chain, block, logIndex)
+// coordinate rather than object identity, so matching survives any copy or
+// transform of the item between the source and the batch.
+let itemKey = (item: Internal.item): string =>
+  switch item {
+  | Internal.Event({chain, blockNumber, logIndex}) =>
+    `${chain
+      ->ChainMap.Chain.toChainId
+      ->Int.toString}:${blockNumber->Int.toString}:${logIndex->Int.toString}`
+  | _ => "" // non-event items are never a provided simulate input
+  }
+
+// `index` is the item's position in its chain's `simulate` array, reported back
+// so a user finds it without echoing its fields.
+type entry = {chainId: int, index: int, key: string}
+
+type t = {mutable unprocessed: array<entry>}
+
+let makeFromConfig = (config: Config.t): option<t> => {
+  let entries =
+    config.chainMap
+    ->ChainMap.values
+    ->Array.flatMap(chainConfig =>
+      switch chainConfig.sourceConfig {
+      | Config.CustomSources(sources) =>
+        sources->Array.flatMap(source =>
+          source.simulateItems
+          ->Option.getOr([])
+          ->Array.mapWithIndex(
+            (item, index) => {
+              chainId: chainConfig.id,
+              index,
+              key: itemKey(item),
+            },
+          )
+        )
+      | _ => []
+      }
+    )
+  switch entries {
+  | [] => None
+  | _ => Some({unprocessed: entries})
+  }
+}
+
+let recordProcessed = (t: t, ~batch: Batch.t) => {
+  let processedKeys = batch.items->Array.map(itemKey)->Utils.Set.fromArray
+  t.unprocessed = t.unprocessed->Array.filter(entry => !(processedKeys->Utils.Set.has(entry.key)))
+}
+
+// Unrouted item indices grouped by chain, in the order chains were first seen.
+let unroutedByChain = (t: t): array<(int, array<int>)> => {
+  let indicesByChain = Dict.make()
+  let chainOrder = []
+  t.unprocessed->Array.forEach(entry => {
+    let key = entry.chainId->Int.toString
+    if indicesByChain->Dict.get(key)->Option.isNone {
+      chainOrder->Array.push(entry.chainId)->ignore
+    }
+    indicesByChain->Utils.Dict.push(key, entry.index)
+  })
+  chainOrder->Array.map(chainId => (chainId, indicesByChain->Dict.getUnsafe(chainId->Int.toString)))
+}
+
+let failureMessage = (t: t): option<string> =>
+  switch t->unroutedByChain {
+  | [] => None
+  | byChain =>
+    let count = byChain->Array.reduce(0, (acc, (_chainId, indices)) => acc + indices->Array.length)
+    let itemWord = count === 1 ? "item" : "items"
+    let lines =
+      byChain
+      ->Array.map(((chainId, indices)) =>
+        `  - chain ${chainId->Int.toString}: ${indices
+          ->Array.map(index => index->Int.toString)
+          ->Array.join(", ")}`
+      )
+      ->Array.join("\n")
+    Some(
+      `simulate: ${count->Int.toString} ${itemWord} you passed to simulate never reached a handler, so nothing ran for them. Each was filtered out before the handler — usually a non-wildcard srcAddress that isn't indexed for the contract, or a where/block filter that excluded the event. Unrouted items, by index in each chain's simulate array:\n${lines}`,
+    )
+  }

package/src/SimulateDeadInputTracker.res.mjs

@@ -0,0 +1,73 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Utils from "./Utils.res.mjs";
+import * as ChainMap from "./ChainMap.res.mjs";
+import * as Stdlib_Array from "@rescript/runtime/lib/es6/Stdlib_Array.js";
+import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+
+function itemKey(item) {
+  if (item.kind === 0) {
+    return item.chain.toString() + `:` + item.blockNumber.toString() + `:` + item.logIndex.toString();
+  } else {
+    return "";
+  }
+}
+
+function makeFromConfig(config) {
+  let entries = ChainMap.values(config.chainMap).flatMap(chainConfig => {
+    let sources = chainConfig.sourceConfig;
+    if (sources.TAG === "CustomSources") {
+      return sources._0.flatMap(source => Stdlib_Option.getOr(source.simulateItems, []).map((item, index) => ({
+        chainId: chainConfig.id,
+        index: index,
+        key: itemKey(item)
+      })));
+    } else {
+      return [];
+    }
+  });
+  if (entries.length !== 0) {
+    return {
+      unprocessed: entries
+    };
+  }
+}
+
+function recordProcessed(t, batch) {
+  let processedKeys = new Set(batch.items.map(itemKey));
+  t.unprocessed = t.unprocessed.filter(entry => !processedKeys.has(entry.key));
+}
+
+function unroutedByChain(t) {
+  let indicesByChain = {};
+  let chainOrder = [];
+  t.unprocessed.forEach(entry => {
+    let key = entry.chainId.toString();
+    if (Stdlib_Option.isNone(indicesByChain[key])) {
+      chainOrder.push(entry.chainId);
+    }
+    Utils.Dict.push(indicesByChain, key, entry.index);
+  });
+  return chainOrder.map(chainId => [
+    chainId,
+    indicesByChain[chainId.toString()]
+  ]);
+}
+
+function failureMessage(t) {
+  let byChain = unroutedByChain(t);
+  if (byChain.length === 0) {
+    return;
+  }
+  let count = Stdlib_Array.reduce(byChain, 0, (acc, param) => acc + param[1].length | 0);
+  let itemWord = count === 1 ? "item" : "items";
+  let lines = byChain.map(param => `  - chain ` + param[0].toString() + `: ` + param[1].map(index => index.toString()).join(", ")).join("\n");
+  return `simulate: ` + count.toString() + ` ` + itemWord + ` you passed to simulate never reached a handler, so nothing ran for them. Each was filtered out before the handler — usually a non-wildcard srcAddress that isn't indexed for the contract, or a where/block filter that excluded the event. Unrouted items, by index in each chain's simulate array:\n` + lines;
+}
+
+export {
+  makeFromConfig,
+  recordProcessed,
+  failureMessage,
+}
+/* Utils Not a pure module */

package/src/SimulateDeadInputTracker.resi

@@ -0,0 +1,12 @@
+type t
+
+// Builds a tracker from the run's config, seeded with every item each simulate
+// source provided. None when no chain has a simulate source.
+let makeFromConfig: Config.t => option<t>
+
+// Drop the batch's items from the not-yet-routed set, matched by event coordinate.
+let recordProcessed: (t, ~batch: Batch.t) => unit
+
+// The error to fail the run with when items never reached a handler, listing them
+// by chain and index within that chain's `simulate` array. None when all routed.
+let failureMessage: t => option<string>

package/src/SimulateItems.res

@@ -231,46 +231,6 @@ let deriveSrcAddress = (
   }
 }
 
-// A non-wildcard event is gated by `clientAddressFilter` on srcAddress ownership,
-// so a simulate item whose srcAddress isn't indexed on this chain would be
-// silently dropped (handler never runs). Fail loudly instead.
-//
-// `config` must already have handler registrations applied, otherwise an event
-// made wildcard purely through `indexer.onEvent({ wildcard: true })` reads back
-// as non-wildcard and gets wrongly rejected.
-let validateSrcAddresses = (
-  ~simulateItems: array<JSON.t>,
-  ~config: Config.t,
-  ~chainConfig: Config.chain,
-  ~indexingAddresses: array<Internal.indexingAddress>,
-): unit => {
-  let known = Utils.Set.make()
-  indexingAddresses->Array.forEach(ia => known->Utils.Set.add(ia.address->Address.toString)->ignore)
-  simulateItems->Array.forEach(rawJson => {
-    let raw = rawJson->(Utils.magic: JSON.t => rawSimulateItem)
-    switch (raw->getContract, raw->getEvent) {
-    | (Some(contractName), Some(eventName)) =>
-      switch findEventConfig(~config, ~contractName, ~eventName) {
-      | Some(eventConfig) if !eventConfig.isWildcard =>
-        let item = rawJson->(Utils.magic: JSON.t => Envio.evmSimulateItem)
-        let srcAddress = deriveSrcAddress(
-          ~providedSrcAddress=item.srcAddress,
-          ~eventConfig,
-          ~chainConfig,
-        )
-        if !(known->Utils.Set.has(srcAddress->Address.toString)) {
-          JsError.throwWithMessage(
-            `simulate: ${contractName}.${eventName} resolved to address ${srcAddress->Address.toString}, which isn't indexed on chain ${chainConfig.id->Int.toString}. ` ++
-            `Provide a "srcAddress" configured or registered for ${contractName} on this chain, or use a wildcard event.`,
-          )
-        }
-      | _ => ()
-      }
-    | _ => ()
-    }
-  })
-}
-
 let parse = (~simulateItems: array<JSON.t>, ~config: Config.t, ~chainConfig: Config.chain): array<
   Internal.item,
 > => {
@@ -281,8 +241,11 @@ let parse = (~simulateItems: array<JSON.t>, ~config: Config.t, ~chainConfig: Con
   let currentLogIndex = ref(0)
 
   let items = []
+  // Coordinate "block:logIndex" -> the index of the first item that claimed it,
+  // used to reject two items resolving to the same (block, logIndex).
+  let seenCoordinates = Dict.make()
 
-  simulateItems->Array.forEach(rawJson => {
+  simulateItems->Array.forEachWithIndex((rawJson, itemIndex) => {
     let raw = rawJson->(Utils.magic: JSON.t => rawSimulateItem)
 
     switch (raw->getContract, raw->getEvent) {
@@ -306,8 +269,14 @@ let parse = (~simulateItems: array<JSON.t>, ~config: Config.t, ~chainConfig: Con
       }
       let params = paramsJson->S.convertOrThrow(eventConfig.simulateParamsSchema)
 
+      // An explicit logIndex advances the auto-increment counter past itself, so a
+      // later item that omits logIndex picks up after it instead of colliding.
       let logIndex = switch item.logIndex {
-      | Some(li) => li
+      | Some(li) =>
+        if li >= currentLogIndex.contents {
+          currentLogIndex := li + 1
+        }
+        li
       | None =>
         let li = currentLogIndex.contents
         currentLogIndex := li + 1
@@ -345,6 +314,18 @@ let parse = (~simulateItems: array<JSON.t>, ~config: Config.t, ~chainConfig: Con
       // Update currentBlock for subsequent items
       currentBlock := blockNumber
 
+      // A simulate item must land on a distinct (block, logIndex): event ordering
+      // and the dead-input tracker both key on it. Catch explicit duplicates and
+      // explicit-vs-auto-increment collisions here, naming both offending indices.
+      let coordinate = `${blockNumber->Int.toString}:${logIndex->Int.toString}`
+      switch seenCoordinates->Dict.get(coordinate) {
+      | Some(firstIndex) =>
+        JsError.throwWithMessage(
+          `simulate: items at index ${firstIndex->Int.toString} and ${itemIndex->Int.toString} on chain ${chainId->Int.toString} both resolve to block ${blockNumber->Int.toString}, logIndex ${logIndex->Int.toString}. Give each item a distinct logIndex (or omit logIndex so they auto-increment).`,
+        )
+      | None => seenCoordinates->Dict.set(coordinate, itemIndex)
+      }
+
       items
       ->Array.push(
         Internal.Event({