ponder 0.16.9 → 0.17.0

package/src/index.ts

@@ -1,5 +1,13 @@
-export { createConfig } from "@/config/index.js";
+export {
+  loadBalance,
+  type MergeAbis,
+  mergeAbis,
+  type ReplaceBigInts,
+  rateLimit,
+  replaceBigInts,
+} from "@ponder/utils";
 export { factory } from "@/config/address.js";
+export { createConfig } from "@/config/index.js";
 export type {
   Block,
   Log,
@@ -7,14 +15,6 @@ export type {
   TransactionReceipt,
 } from "@/types/eth.js";
 export type { Virtual } from "@/types/virtual.js";
-export {
-  type MergeAbis,
-  type ReplaceBigInts,
-  mergeAbis,
-  loadBalance,
-  rateLimit,
-  replaceBigInts,
-} from "@ponder/utils";
 
 import type { Config } from "@/config/index.js";
 import type { Prettify } from "./types/utils.js";
@@ -24,23 +24,45 @@ export type ChainConfig = Prettify<Config["chains"][string]>;
 export type BlockConfig = Prettify<Config["blocks"][string]>;
 export type DatabaseConfig = Prettify<Config["database"]>;
 
-export type { CreateConfigReturnType } from "@/config/index.js";
-export type { GetEventFilter } from "@/config/eventFilter.js";
-export type { AddressConfig, Factory } from "@/config/address.js";
-
 export {
-  onchainTable,
-  onchainView,
-  onchainEnum,
-  primaryKey,
-  hex,
-  bigint,
-} from "@/drizzle/onchain.js";
-
+  and,
+  asc,
+  avg,
+  avgDistinct,
+  between,
+  count,
+  countDistinct,
+  desc,
+  eq,
+  exists,
+  gt,
+  gte,
+  ilike,
+  inArray,
+  isNotNull,
+  isNull,
+  like,
+  lt,
+  lte,
+  max,
+  min,
+  ne,
+  not,
+  notBetween,
+  notExists,
+  notIlike,
+  notInArray,
+  notLike,
+  or,
+  relations,
+  sql,
+  sum,
+  sumDistinct,
+} from "drizzle-orm";
 export type {
   AnyPgColumn,
-  PgColumn,
   ExtraConfigColumn,
+  PgColumn,
   PgColumnBuilder,
   PgColumnBuilderBase,
   PgEnumColumnBuilder,
@@ -51,66 +73,22 @@ export type {
   PgTextConfig,
   TableConfig,
 } from "drizzle-orm/pg-core";
-
-export type {
-  OnchainTable,
-  BuildExtraConfigColumns,
-  PgColumnsBuilders,
-  PrimaryKeyBuilder,
-  OnchainEnum,
-} from "@/drizzle/onchain.js";
-
-export type { ReadonlyDrizzle } from "@/types/db.js";
-
-export { client } from "@/client/index.js";
-
-export { graphql } from "@/graphql/middleware.js";
-
-export {
-  sql,
-  eq,
-  gt,
-  gte,
-  lt,
-  lte,
-  ne,
-  isNull,
-  isNotNull,
-  inArray,
-  notInArray,
-  exists,
-  notExists,
-  between,
-  notBetween,
-  like,
-  notLike,
-  ilike,
-  notIlike,
-  not,
-  asc,
-  desc,
-  and,
-  or,
-  count,
-  countDistinct,
-  avg,
-  avgDistinct,
-  sum,
-  sumDistinct,
-  max,
-  min,
-  relations,
-} from "drizzle-orm";
-
 export {
+  alias,
   bigint as int8,
   boolean,
   char,
   cidr,
   date,
   doublePrecision,
+  except,
+  exceptAll,
+  foreignKey,
+  index,
   inet,
   integer,
+  intersect,
+  intersectAll,
   interval,
   json,
   jsonb,
@@ -124,16 +102,30 @@ export {
   text,
   time,
   timestamp,
-  uuid,
-  varchar,
-  index,
-  uniqueIndex,
-  alias,
-  foreignKey,
   union,
   unionAll,
-  intersect,
-  intersectAll,
-  except,
-  exceptAll,
+  uniqueIndex,
+  uuid,
+  varchar,
 } from "drizzle-orm/pg-core";
+export { client } from "@/client/index.js";
+export type { AddressConfig, Factory } from "@/config/address.js";
+export type { GetEventFilter } from "@/config/eventFilter.js";
+export type { CreateConfigReturnType } from "@/config/index.js";
+export type {
+  BuildExtraConfigColumns,
+  OnchainEnum,
+  OnchainTable,
+  PgColumnsBuilders,
+  PrimaryKeyBuilder,
+} from "@/drizzle/onchain.js";
+export {
+  bigint,
+  hex,
+  onchainEnum,
+  onchainTable,
+  onchainView,
+  primaryKey,
+} from "@/drizzle/onchain.js";
+export { graphql } from "@/graphql/middleware.js";
+export type { ReadonlyDrizzle } from "@/types/db.js";

package/src/indexing/addStackTrace.ts

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs";
-import type { Options } from "@/internal/options.js";
 import { codeFrameColumns } from "@babel/code-frame";
-import { type StackFrame, parse as parseStackTrace } from "stacktrace-parser";
+import { parse as parseStackTrace, type StackFrame } from "stacktrace-parser";
+import type { Options } from "@/internal/options.js";
 
 // Note: this currently works for both indexing functions and api
 // routes only because the api route dir is a subdir of the indexing function
@@ -41,7 +41,7 @@ export const addStackTrace = (error: Error, options: Options) => {
           },
           { highlightCode: true },
         );
-      } catch (err) {
+      } catch (_err) {
         // Ignore errors here.
       }
     }

package/src/indexing/client.ts

@@ -1,13 +1,3 @@
-import type { Common } from "@/internal/common.js";
-import type { Chain, IndexingBuild, SetupEvent } from "@/internal/types.js";
-import type { Event } from "@/internal/types.js";
-import type { RequestParameters, Rpc } from "@/rpc/index.js";
-import type { SyncStore } from "@/sync-store/index.js";
-import { dedupe } from "@/utils/dedupe.js";
-import { toLowerCase } from "@/utils/lowercase.js";
-import { orderObject } from "@/utils/order.js";
-import { startClock } from "@/utils/timer.js";
-import { wait } from "@/utils/wait.js";
 import {
   type Abi,
   type Account,
@@ -16,6 +6,12 @@ import {
   type ContractFunctionArgs,
   type ContractFunctionName,
   type ContractFunctionParameters,
+  createClient,
+  custom,
+  decodeFunctionData,
+  decodeFunctionResult,
+  encodeFunctionData,
+  encodeFunctionResult,
   type GetBlockReturnType,
   type GetTransactionConfirmationsParameters,
   type GetTransactionConfirmationsReturnType,
@@ -23,13 +19,17 @@ import {
   type GetTransactionReceiptParameters,
   type GetTransactionReceiptReturnType,
   type GetTransactionReturnType,
+  getAbiItem,
   type Hash,
   type Hex,
+  hexToNumber,
   type MulticallParameters,
   type MulticallReturnType,
+  multicall3Abi,
   type Prettify,
   type PublicActions,
   type PublicRpcSchema,
+  publicActions,
   type ReadContractParameters,
   type ReadContractReturnType,
   type SimulateContractParameters,
@@ -37,20 +37,24 @@ import {
   TransactionNotFoundError,
   TransactionReceiptNotFoundError,
   type Transport,
-  type Chain as ViemChain,
-  createClient,
-  custom,
-  decodeFunctionData,
-  decodeFunctionResult,
-  encodeFunctionData,
-  encodeFunctionResult,
-  getAbiItem,
-  hexToNumber,
-  multicall3Abi,
-  publicActions,
   toFunctionSelector,
   toHex,
+  type Chain as ViemChain,
 } from "viem";
+import type { Common } from "@/internal/common.js";
+import type {
+  Chain,
+  Event,
+  IndexingBuild,
+  SetupEvent,
+} from "@/internal/types.js";
+import type { RequestParameters, Rpc } from "@/rpc/index.js";
+import type { SyncStore } from "@/sync-store/index.js";
+import { dedupe } from "@/utils/dedupe.js";
+import { toLowerCase } from "@/utils/lowercase.js";
+import { orderObject } from "@/utils/order.js";
+import { startClock } from "@/utils/timer.js";
+import { wait } from "@/utils/wait.js";
 import {
   getProfilePatternKey,
   recordProfilePattern,
@@ -59,9 +63,7 @@ import {
 
 export type CachedViemClient = {
   getClient: (chain: Chain) => ReadonlyClient;
-  prefetch: (params: {
-    events: Event[];
-  }) => Promise<void>;
+  prefetch: (params: { events: Event[] }) => Promise<void>;
   clear: () => void;
   event: Event | SetupEvent | undefined;
 };
@@ -413,7 +415,7 @@ export const decodeResponse = (response: Response) => {
   // Note: I don't actually remember why we had to add the try catch.
   try {
     return JSON.parse(response);
-  } catch (error) {
+  } catch (_error) {
     return response;
   }
 };
@@ -451,7 +453,10 @@ export const createCachedViemClient = ({
     const addProfilePattern = ({
       pattern,
       hasConstant,
-    }: { pattern: ProfilePattern; hasConstant: boolean }) => {
+    }: {
+      pattern: ProfilePattern;
+      hasConstant: boolean;
+    }) => {
       const profilePatternKey = getProfilePatternKey(pattern);
       const eventName = (event as Event).eventCallback.name;
 
@@ -563,7 +568,7 @@ export const createCachedViemClient = ({
         const BASE_DURATION = 125;
         for (let i = 0; i <= RETRY_COUNT; i++) {
           try {
-            // @ts-ignore
+            // @ts-expect-error
             return await action(...args);
           } catch (error) {
             const eventName =
@@ -622,30 +627,29 @@ export const createCachedViemClient = ({
     }
 
     for (const action of nonBlockDependentActions) {
-      // @ts-ignore
+      // @ts-expect-error
       actions[action] = _publicActions[action];
     }
 
     for (const action of blockRequiredActions) {
-      // @ts-ignore
+      // @ts-expect-error
       actions[action] = _publicActions[action];
     }
 
     for (const action of retryableActions) {
-      // @ts-ignore
       actions[action] = getRetryAction(actions[action], action);
     }
 
     const actionsWithMetrics = {} as PonderActions;
 
     for (const [action, actionFn] of Object.entries(actions)) {
-      // @ts-ignore
+      // @ts-expect-error
       actionsWithMetrics[action] = async (
         ...args: Parameters<PonderActions[keyof PonderActions]>
       ) => {
         const endClock = startClock();
         try {
-          // @ts-ignore
+          // @ts-expect-error
           return await actionFn(...args);
         } finally {
           common.metrics.ponder_indexing_rpc_action_duration.observe(
@@ -661,8 +665,7 @@ export const createCachedViemClient = ({
 
   return {
     getClient(chain) {
-      const rpc =
-        indexingBuild.rpcs[indexingBuild.chains.findIndex((n) => n === chain)]!;
+      const rpc = indexingBuild.rpcs[indexingBuild.chains.indexOf(chain)]!;
 
       return createClient({
         transport: cachedTransport({
@@ -834,7 +837,7 @@ export const cachedTransport =
           method === "eth_call" &&
           params[0]?.data?.startsWith(MULTICALL_SELECTOR)
         ) {
-          let blockNumber: Hex | "latest" | undefined = undefined;
+          let blockNumber: Hex | "latest" | undefined;
           [, blockNumber] = params;
 
           const multicallRequests = decodeFunctionData({
@@ -1032,7 +1035,7 @@ export const cachedTransport =
               functionName: "aggregate3",
               result: resultsToEncode,
             });
-          } catch (e) {
+          } catch (_e) {
             return encodeFunctionResult({
               abi: multicall3Abi,
               functionName: "aggregate3",
@@ -1152,7 +1155,7 @@ export const cachedTransport =
     })({ chain: viemChain, retryCount: 0 });
 
 export const extractBlockNumberParam = (request: RequestParameters) => {
-  let blockNumber: Hex | "latest" | undefined = undefined;
+  let blockNumber: Hex | "latest" | undefined;
 
   switch (request.method) {
     case "eth_getBlockByNumber":

package/src/indexing/index.ts

@@ -1,7 +1,8 @@
 import util from "node:util";
+import type { Abi, Address } from "viem";
+import type { CachedViemClient } from "@/indexing/client.js";
 import type { IndexingCache } from "@/indexing-store/cache.js";
 import type { IndexingStore } from "@/indexing-store/index.js";
-import type { CachedViemClient } from "@/indexing/client.js";
 import type { Common } from "@/internal/common.js";
 import {
   BaseError,
@@ -49,14 +50,13 @@ import type {
 } from "@/types/eth.js";
 import type { DeepPartial } from "@/types/utils.js";
 import {
-  ZERO_CHECKPOINT,
   decodeCheckpoint,
   encodeCheckpoint,
+  ZERO_CHECKPOINT,
 } from "@/utils/checkpoint.js";
 import { dedupe } from "@/utils/dedupe.js";
 import { prettyPrint } from "@/utils/print.js";
 import { startClock } from "@/utils/timer.js";
-import type { Abi, Address } from "viem";
 import { addStackTrace } from "./addStackTrace.js";
 import type { ReadonlyClient } from "./client.js";
 
@@ -276,7 +276,7 @@ export const createIndexing = ({
 
         lastChainId = event.chain.id;
       }
-      // @ts-ignore
+      // @ts-expect-error
       indexingFunctionArg.event = event.event;
 
       const endClock = startClock();
@@ -554,7 +554,8 @@ export const createIndexing = ({
           1,
         );
         columnAccessPattern.get(event.eventCallback.name)!.count++;
-        eventCount[event.eventCallback.name]++;
+        eventCount[event.eventCallback.name] =
+          eventCount[event.eventCallback.name]! + 1;
 
         const now = performance.now();
 
@@ -719,7 +720,8 @@ export const createIndexing = ({
           { event: event.eventCallback.name },
           1,
         );
-        eventCount[event.eventCallback.name]++;
+        eventCount[event.eventCallback.name] =
+          eventCount[event.eventCallback.name]! + 1;
       }
     },
   };

package/src/indexing/profile.ts

@@ -1,6 +1,6 @@
+import type { Abi } from "viem";
 import type { Event } from "@/internal/types.js";
 import { orderObject } from "@/utils/order.js";
-import type { Abi } from "viem";
 import type { PonderActions, ProfilePattern, Request } from "./client.js";
 
 export const getProfilePatternKey = (pattern: ProfilePattern): string => {
@@ -736,7 +736,7 @@ export const recoverProfilePattern = (
   } else {
     let _result: unknown = event.event;
     for (const prop of pattern.address.value) {
-      // @ts-ignore
+      // @ts-expect-error
       _result = _result[prop];
     }
     address = _result as `0x${string}`;
@@ -751,7 +751,7 @@ export const recoverProfilePattern = (
       } else {
         let _result: unknown = event.event;
         for (const prop of arg.value) {
-          // @ts-ignore
+          // @ts-expect-error
           _result = _result[prop];
         }
         args.push(_result);

package/src/indexing-store/cache.ts

@@ -1,3 +1,13 @@
+import {
+  getTableColumns,
+  getTableName,
+  isTable,
+  or,
+  sql,
+  type Table,
+} from "drizzle-orm";
+import { getTableConfig } from "drizzle-orm/pg-core";
+import copy from "pg-copy-streams";
 import type { QB } from "@/database/queryBuilder.js";
 import { getPrimaryKeyColumns } from "@/drizzle/index.js";
 import { getColumnCasing } from "@/drizzle/kit/index.js";
@@ -18,16 +28,6 @@ import { dedupe } from "@/utils/dedupe.js";
 import { prettyPrint } from "@/utils/print.js";
 import { promiseAllSettledWithThrow } from "@/utils/promiseAllSettledWithThrow.js";
 import { startClock } from "@/utils/timer.js";
-import {
-  type Table,
-  getTableColumns,
-  getTableName,
-  isTable,
-  or,
-  sql,
-} from "drizzle-orm";
-import { getTableConfig } from "drizzle-orm/pg-core";
-import copy from "pg-copy-streams";
 import {
   getProfilePatternKey,
   recordProfilePattern,
@@ -48,10 +48,10 @@ export type IndexingCache = {
   /**
    * Returns the entry for `table` with `key`.
    */
-  get: (params: { table: Table; key: object }) =>
-    | Row
-    | null
-    | Promise<Row | null>;
+  get: (params: {
+    table: Table;
+    key: object;
+  }) => Row | null | Promise<Row | null>;
   /**
    * Sets the entry for `table` with `key` to `row`.
    */
@@ -650,7 +650,7 @@ export const createIndexingCache = ({
                   .insert(table)
                   .values(updateValues.map(({ row }) => row))
                   .onConflictDoUpdate({
-                    // @ts-ignore
+                    // @ts-expect-error
                     target: primaryKeys.map(({ js }) => table[js]!),
                     set: Object.fromEntries(
                       Object.entries(getTableColumns(table)).map(

package/src/indexing-store/index.ts

@@ -1,3 +1,14 @@
+import {
+  type Column,
+  getTableName,
+  getViewName,
+  isTable,
+  isView,
+  type QueryWithTypings,
+  type Table,
+} from "drizzle-orm";
+import { getTableConfig } from "drizzle-orm/pg-core";
+import { drizzle } from "drizzle-orm/pg-proxy";
 import type { QB } from "@/database/queryBuilder.js";
 import { onchain } from "@/drizzle/onchain.js";
 import type { Common } from "@/internal/common.js";
@@ -12,25 +23,17 @@ import {
   UndefinedTableError,
   UniqueConstraintError,
 } from "@/internal/errors.js";
-import type { Schema } from "@/internal/types.js";
-import type { IndexingErrorHandler, SchemaBuild } from "@/internal/types.js";
+import type {
+  IndexingErrorHandler,
+  Schema,
+  SchemaBuild,
+} from "@/internal/types.js";
 import type { Db } from "@/types/db.js";
 import { copy, copyOnWrite } from "@/utils/copy.js";
 import { createLock } from "@/utils/mutex.js";
 import { prettyPrint } from "@/utils/print.js";
 import { getSQLQueryRelations, isReadonlySQLQuery } from "@/utils/sql-parse.js";
 import { startClock } from "@/utils/timer.js";
-import {
-  type Column,
-  type QueryWithTypings,
-  type Table,
-  getTableName,
-  getViewName,
-  isTable,
-  isView,
-} from "drizzle-orm";
-import { getTableConfig } from "drizzle-orm/pg-core";
-import { drizzle } from "drizzle-orm/pg-proxy";
 import type { IndexingCache, Row } from "./cache.js";
 import { getPrimaryKeyCache } from "./utils.js";
 
@@ -157,7 +160,6 @@ export const createIndexingStore = ({
 
   return {
     db: {
-      // @ts-ignore
       find: storeMethodWrapper(async (table: Table, key) => {
         common.metrics.ponder_indexing_store_queries_total.inc({
           table: getTableName(table),
@@ -169,11 +171,10 @@ export const createIndexingStore = ({
         const userRow = ponderRow === null ? null : copyOnWrite(ponderRow);
         return userRow;
       }),
-      // @ts-ignore
+      // @ts-expect-error
       insert(table: Table) {
         return {
           values: (userValues: any) => {
-            // @ts-ignore
             const inner = {
               onConflictDoNothing: storeMethodWrapper(async () => {
                 common.metrics.ponder_indexing_store_queries_total.inc({
@@ -363,7 +364,7 @@ export const createIndexingStore = ({
                   }
                 },
               ),
-              // biome-ignore lint/suspicious/noThenProperty: <explanation>
+              // biome-ignore lint/suspicious/noThenProperty: The returned object is intentionally thenable for the query API.
               then: (onFulfilled, onRejected) =>
                 storeMethodWrapper(async () => {
                   common.metrics.ponder_indexing_store_queries_total.inc({
@@ -459,8 +460,9 @@ export const createIndexingStore = ({
                     );
                   }
                 })().then(onFulfilled, onRejected),
-              catch: (onRejected) => inner.then(undefined, onRejected),
-              finally: (onFinally) =>
+              catch: (onRejected): Promise<any> =>
+                inner.then(undefined, onRejected),
+              finally: (onFinally): Promise<any> =>
                 inner.then(
                   (value: any) => {
                     onFinally?.();
@@ -471,7 +473,7 @@ export const createIndexingStore = ({
                     throw reason;
                   },
                 ),
-              // @ts-ignore
+              // @ts-expect-error
             } satisfies ReturnType<
               ReturnType<IndexingStore["db"]["insert"]>["values"]
             >;
@@ -480,7 +482,7 @@ export const createIndexingStore = ({
           },
         };
       },
-      // @ts-ignore
+      // @ts-expect-error
       update(table: Table, key) {
         return {
           set: storeMethodWrapper(async (userValues: any) => {
@@ -543,7 +545,6 @@ export const createIndexingStore = ({
           }),
         };
       },
-      // @ts-ignore
       delete: storeMethodWrapper(async (table: Table, key) => {
         common.metrics.ponder_indexing_store_queries_total.inc({
           table: getTableName(table),
@@ -553,7 +554,7 @@ export const createIndexingStore = ({
         checkTableAccess(table, "delete", key, chainId);
         return indexingCache.delete({ table, key });
       }),
-      // @ts-ignore
+      // @ts-expect-error
       sql: drizzle(
         storeMethodWrapper(async (_sql, params, method, typings) => {
           const isSelectOnly = await isReadonlySQLQuery(_sql);
@@ -596,9 +597,9 @@ export const createIndexingStore = ({
 
               if (method === "all") {
                 return {
-                  // @ts-ignore
+                  // @ts-expect-error
                   ...result,
-                  // @ts-ignore
+                  // @ts-expect-error
                   rows: result.rows.map((row) => Object.values(row)),
                 };
               }