@ensnode/ponder-metadata 0.0.0-next-20260102143513

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NameHash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# Ponder Metadata API
+
+Ponder Metadata API is a Hono middleware for making Ponder app metadata available to clients.

package/dist/index.d.ts

@@ -0,0 +1,365 @@
+import * as ponder from 'ponder';
+import { ReadonlyDrizzle } from 'ponder';
+import { MiddlewareHandler } from 'hono';
+import { EnsRainbow } from '@ensnode/ensrainbow-sdk';
+import { PublicClient } from 'viem';
+
+/**
+ * Internal ponder metadata type.
+ * Copied from https://github.com/ponder-sh/ponder/blob/32634897bf65e92a85dc4cccdaba70c9425d90f3/packages/core/src/database/index.ts#L94-L102
+ */
+type PonderAppMeta = {
+    is_locked: 0 | 1;
+    is_dev: 0 | 1;
+    heartbeat_at: number;
+    build_id: string;
+    table_names: Array<string>;
+    version: string;
+    is_ready: 0 | 1;
+};
+/**
+ * Get DB schema for _ponder_meta table.
+ * Akin to https://github.com/ponder-sh/ponder/blob/32634897bf65e92a85dc4cccdaba70c9425d90f3/packages/core/src/database/index.ts#L129-L141
+ *
+ * @param databaseNamespace A namespace for the database.
+ * @returns A table schema for _ponder_meta table.
+ * */
+declare const getPonderMetaTableSchema: (databaseNamespace: string) => ponder.PgTableWithColumns<{
+    name: "_ponder_meta";
+    schema: undefined;
+    columns: {
+        key: ponder.PgColumn<{
+            name: "key";
+            tableName: "_ponder_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: "app";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: "app";
+        }>;
+        value: ponder.PgColumn<{
+            name: "value";
+            tableName: "_ponder_meta";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: PonderAppMeta;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: PonderAppMeta;
+        }>;
+    };
+    dialect: "pg";
+}> | ponder.PgTableWithColumns<{
+    name: "_ponder_meta";
+    schema: string;
+    columns: {
+        key: ponder.PgColumn<{
+            name: "key";
+            tableName: "_ponder_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: "app";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: "app";
+        }>;
+        value: ponder.PgColumn<{
+            name: "value";
+            tableName: "_ponder_meta";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: PonderAppMeta;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: PonderAppMeta;
+        }>;
+    };
+    dialect: "pg";
+}>;
+type PonderMetaTableSchema = ReturnType<typeof getPonderMetaTableSchema>;
+/**
+ * Get ponder metadata for the app.
+ *
+ * @param namespace A namespace for the database (e.g. "public").
+ * @param db Drizzle DB Client instance.
+ * @returns ponder metadata for the app.
+ * @throws Error if ponder metadata not found.
+ */
+declare function queryPonderMeta(namespace: string, db: ReadonlyDrizzle<Record<string, unknown>>): Promise<PonderMetaTableSchema["$inferSelect"]["value"]>;
+
+/**
+ * Basic information about a block.
+ */
+interface BlockInfo {
+    /** block number */
+    number: number;
+    /** block unix timestamp */
+    timestamp: number;
+}
+/**
+ * Ponder Status type
+ *
+ * It's a type of value returned by the `GET /status` endpoint on ponder server.
+ *
+ * Akin to:
+ * https://github.com/ponder-sh/ponder/blob/8c012a3/packages/client/src/index.ts#L13-L18
+ */
+interface PonderStatus {
+    [chainName: string]: {
+        /** @var id Chain ID */
+        id: number;
+        /** @var block Last Indexed Block data */
+        block: BlockInfo;
+    };
+}
+/**
+ * Indexing status for a chain.
+ */
+interface ChainIndexingStatus {
+    /** Chain ID of the indexed chain */
+    chainId: number;
+    /**
+     * First block required to be indexed during the historical sync.
+     */
+    firstBlockToIndex: BlockInfo;
+    /**
+     * Latest block synced into indexer's RPC cache.
+     */
+    lastSyncedBlock: BlockInfo | null;
+    /**
+     * Last block processed & indexed by the indexer.
+     */
+    lastIndexedBlock: BlockInfo | null;
+    /**
+     * Latest safe block available on the chain.
+     */
+    latestSafeBlock: BlockInfo;
+}
+
+type PonderEnvVarsInfo = Record<string, unknown>;
+/**
+ * Helper type which describes public clients grouped by chain name
+ */
+type PublicClientsByChainName<ChainName extends string = string> = Record<ChainName, PublicClient>;
+interface PonderMetadataMiddlewareOptions<AppInfo, EnvVars extends PonderEnvVarsInfo> {
+    /** Database access object (readonly Drizzle) */
+    db: ReadonlyDrizzle<Record<string, unknown>>;
+    /** Application info */
+    app: AppInfo;
+    /** Environment settings info */
+    env: EnvVars;
+    /** Query methods */
+    query: {
+        /** Fetches Ponder Status object for Ponder application */
+        ponderStatus(): Promise<PonderStatus>;
+        /** Fetches prometheus metrics for Ponder application */
+        prometheusMetrics(): Promise<string>;
+        /** Fetches the first block do be indexed for a requested chain ID */
+        firstBlockToIndexByChainId(chainId: number, publicClient: PublicClient): Promise<BlockInfo>;
+        /** Fetches ENSRainbow version information */
+        ensRainbowVersion?(): Promise<EnsRainbow.VersionInfo>;
+    };
+    /** Public clients for fetching data from each chain */
+    publicClients: PublicClientsByChainName;
+}
+interface PonderMetadataMiddlewareResponse<AppInfo, EnvVarsInfo extends PonderEnvVarsInfo, RuntimeInfo> {
+    /** Application info */
+    app: AppInfo;
+    /** Dependencies info */
+    deps: {
+        /** Ponder application version */
+        ponder: string;
+        /** Node.js runtime version */
+        nodejs: string;
+    };
+    /** Environment settings info */
+    env: EnvVarsInfo;
+    /** Runtime status info */
+    runtime: RuntimeInfo;
+}
+
+/**
+ * Ponder Metadata types definition.
+ */
+interface PonderMetadataModule {
+    /** Application info */
+    AppInfo: {
+        /** Application name */
+        name: string;
+        /** Application version */
+        version: string;
+    };
+    /** Environment Variables info */
+    EnvVars: {
+        /** Database schema */
+        DATABASE_SCHEMA: string;
+    } & PonderEnvVarsInfo;
+    /** Runtime info */
+    RuntimeInfo: {
+        /**
+         * Application build id
+         * https://github.com/ponder-sh/ponder/blob/626e524/packages/core/src/build/index.ts#L425-L431
+         **/
+        codebaseBuildId: string;
+        /** Chain indexing statuses by chain ID */
+        chainIndexingStatuses: {
+            [chainId: number]: ChainIndexingStatus;
+        };
+        /** ENSRainbow version info */
+        ensRainbow?: EnsRainbow.VersionInfo;
+    };
+}
+type MetadataMiddlewareResponse = PonderMetadataMiddlewareResponse<PonderMetadataModule["AppInfo"], PonderMetadataModule["EnvVars"], PonderMetadataModule["RuntimeInfo"]>;
+declare function ponderMetadata<AppInfo extends PonderMetadataModule["AppInfo"], EnvVars extends PonderMetadataModule["EnvVars"]>({ app, db, env, query, publicClients, }: PonderMetadataMiddlewareOptions<AppInfo, EnvVars>): MiddlewareHandler;
+
+declare module "parse-prometheus-text-format" {
+    interface PrometheusMetric {
+        name: string;
+        help: string;
+        type: string;
+        metrics: Array<{
+            value: string;
+            labels?: Record<string, string>;
+        }>;
+    }
+    export default function parsePrometheusTextFormat(text: string): Array<PrometheusMetric>;
+}
+
+declare class PrometheusMetrics {
+    private readonly metrics;
+    private constructor();
+    static parse(maybePrometheusMetricsText: string): PrometheusMetrics;
+    /**
+     * Gets all metrics of a specific name
+     * @param name Metric name
+     * @returns Array of metrics or undefined if not found
+     * @example
+     * ```ts
+     * const metrics = parser.get('ponder_historical_total_indexing_seconds');
+     * // Returns: [
+     * //   { value: 251224935, labels: { network: "1" } },
+     * //   { value: 251224935, labels: { network: "8453" } }
+     * // ]
+     * ```
+     */
+    get(name: string): Array<{
+        value: number;
+        labels?: Record<string, string>;
+    }> | undefined;
+    /**
+     * Gets a single metric value, optionally filtered by labels
+     * @param name Metric name
+     * @param labelFilter Optional label key-value pairs to match
+     * @returns Metric value or undefined if not found
+     * @example
+     * ```ts
+     * // Get simple value
+     * parser.getValue('ponder_historical_start_timestamp_seconds') // Returns: 1740391265
+     *
+     * // Get value with label filter
+     * parser.getValue('ponder_historical_total_indexing_seconds', { network: '1' }) // Returns: 251224935
+     * ```
+     */
+    getValue(name: string, labelFilter?: Record<string, string>): number | undefined;
+    /**
+     * Gets a label value from a metric
+     * @param name Metric name
+     * @param label Label name to retrieve
+     * @returns Label value or undefined if not found
+     * @example
+     * ```ts
+     * parser.getLabel('ponder_version_info', 'version') // Returns: "0.9.18"
+     * parser.getLabel('ponder_settings_info', 'ordering') // Returns: "omnichain"
+     * ```
+     */
+    getLabel(name: string, label: string): string | undefined;
+    /**
+     * Gets all unique label values for a metric
+     * @param name Metric name
+     * @param label Label name to retrieve
+     * @returns Array of unique label values
+     * @example
+     * ```ts
+     * // Get all network IDs
+     * parser.getLabels('ponder_historical_total_indexing_seconds', 'network')
+     * // Returns: ['1', '8453']
+     * ```
+     */
+    getLabels(name: string, label: string): string[];
+    /**
+     * Gets help text for a metric
+     * @param name Metric name
+     * @returns Help text or undefined if not found
+     * @example
+     * ```ts
+     * parser.getHelp('ponder_historical_start_timestamp_seconds')
+     * // Returns: "Timestamp at which historical indexing started"
+     * ```
+     */
+    getHelp(name: string): string | undefined;
+    /**
+     * Gets metric type
+     * @param name Metric name
+     * @returns Metric type or undefined if not found
+     * @example
+     * ```ts
+     * parser.getType('ponder_version_info') // Returns: "gauge"
+     * parser.getType('ponder_postgres_query_total') // Returns: "counter"
+     * ```
+     */
+    getType(name: string): string | undefined;
+    /**
+     * Gets all metric names
+     * @returns Array of metric names
+     * @example
+     * ```ts
+     * parser.getMetricNames()
+     * // Returns: [
+     * //   'ponder_version_info',
+     * //   'ponder_settings_info',
+     * //   'ponder_historical_start_timestamp_seconds',
+     * //   'ponder_historical_total_indexing_seconds'
+     * // ]
+     * ```
+     */
+    getMetricNames(): string[];
+}
+
+export { type BlockInfo, type ChainIndexingStatus, type MetadataMiddlewareResponse, type PonderMetadataMiddlewareResponse, type PonderStatus, PrometheusMetrics, ponderMetadata, queryPonderMeta };

package/dist/index.js

@@ -0,0 +1,309 @@
+// src/db-helpers.ts
+import { pgSchema, pgTable } from "drizzle-orm/pg-core";
+import { eq } from "ponder";
+var getPonderMetaTableSchema = (databaseNamespace) => {
+  if (databaseNamespace === "public") {
+    return pgTable("_ponder_meta", (t) => ({
+      key: t.text().primaryKey().$type(),
+      value: t.jsonb().$type().notNull()
+    }));
+  }
+  return pgSchema(databaseNamespace).table("_ponder_meta", (t) => ({
+    key: t.text().primaryKey().$type(),
+    value: t.jsonb().$type().notNull()
+  }));
+};
+async function queryPonderMeta(namespace, db) {
+  const PONDER_META = getPonderMetaTableSchema(namespace);
+  const [ponderAppMeta] = await db.select({ value: PONDER_META.value }).from(PONDER_META).where(eq(PONDER_META.key, "app")).limit(1);
+  if (!ponderAppMeta) {
+    throw new Error("Ponder metadata not found");
+  }
+  return ponderAppMeta.value;
+}
+
+// src/middleware.ts
+import { HTTPException } from "hono/http-exception";
+
+// src/prometheus-metrics.ts
+import parsePrometheusTextFormat from "parse-prometheus-text-format";
+function parsePrometheusText(text) {
+  return parsePrometheusTextFormat(text).map((metric) => ({
+    name: metric.name,
+    help: metric.help || "",
+    type: metric.type.toLowerCase(),
+    metrics: metric.metrics.map((m) => ({
+      value: Number(m.value),
+      ...m.labels && Object.keys(m.labels).length > 0 ? { labels: m.labels } : {}
+    }))
+  }));
+}
+var PrometheusMetrics = class _PrometheusMetrics {
+  constructor(metrics) {
+    this.metrics = metrics;
+  }
+  static parse(maybePrometheusMetricsText) {
+    return new _PrometheusMetrics(parsePrometheusText(maybePrometheusMetricsText));
+  }
+  /**
+   * Gets all metrics of a specific name
+   * @param name Metric name
+   * @returns Array of metrics or undefined if not found
+   * @example
+   * ```ts
+   * const metrics = parser.get('ponder_historical_total_indexing_seconds');
+   * // Returns: [
+   * //   { value: 251224935, labels: { network: "1" } },
+   * //   { value: 251224935, labels: { network: "8453" } }
+   * // ]
+   * ```
+   */
+  get(name) {
+    const metric = this.metrics.find((m) => m.name === name);
+    return metric == null ? void 0 : metric.metrics;
+  }
+  /**
+   * Gets a single metric value, optionally filtered by labels
+   * @param name Metric name
+   * @param labelFilter Optional label key-value pairs to match
+   * @returns Metric value or undefined if not found
+   * @example
+   * ```ts
+   * // Get simple value
+   * parser.getValue('ponder_historical_start_timestamp_seconds') // Returns: 1740391265
+   *
+   * // Get value with label filter
+   * parser.getValue('ponder_historical_total_indexing_seconds', { network: '1' }) // Returns: 251224935
+   * ```
+   */
+  getValue(name, labelFilter) {
+    var _a;
+    const metrics = this.get(name);
+    if (!metrics || metrics.length === 0) {
+      return void 0;
+    }
+    if (!labelFilter) {
+      return (_a = metrics[0]) == null ? void 0 : _a.value;
+    }
+    const metric = metrics.find(
+      (m) => m.labels && Object.entries(labelFilter).every(([k, v]) => {
+        var _a2;
+        return ((_a2 = m.labels) == null ? void 0 : _a2[k]) === v;
+      })
+    );
+    return metric == null ? void 0 : metric.value;
+  }
+  /**
+   * Gets a label value from a metric
+   * @param name Metric name
+   * @param label Label name to retrieve
+   * @returns Label value or undefined if not found
+   * @example
+   * ```ts
+   * parser.getLabel('ponder_version_info', 'version') // Returns: "0.9.18"
+   * parser.getLabel('ponder_settings_info', 'ordering') // Returns: "omnichain"
+   * ```
+   */
+  getLabel(name, label) {
+    return this.getLabels(name, label)[0];
+  }
+  /**
+   * Gets all unique label values for a metric
+   * @param name Metric name
+   * @param label Label name to retrieve
+   * @returns Array of unique label values
+   * @example
+   * ```ts
+   * // Get all network IDs
+   * parser.getLabels('ponder_historical_total_indexing_seconds', 'network')
+   * // Returns: ['1', '8453']
+   * ```
+   */
+  getLabels(name, label) {
+    const metrics = this.get(name);
+    if (!metrics) return [];
+    return [
+      ...new Set(metrics.map((m) => {
+        var _a;
+        return (_a = m.labels) == null ? void 0 : _a[label];
+      }).filter((v) => v !== void 0))
+    ];
+  }
+  /**
+   * Gets help text for a metric
+   * @param name Metric name
+   * @returns Help text or undefined if not found
+   * @example
+   * ```ts
+   * parser.getHelp('ponder_historical_start_timestamp_seconds')
+   * // Returns: "Timestamp at which historical indexing started"
+   * ```
+   */
+  getHelp(name) {
+    var _a;
+    return (_a = this.metrics.find((m) => m.name === name)) == null ? void 0 : _a.help;
+  }
+  /**
+   * Gets metric type
+   * @param name Metric name
+   * @returns Metric type or undefined if not found
+   * @example
+   * ```ts
+   * parser.getType('ponder_version_info') // Returns: "gauge"
+   * parser.getType('ponder_postgres_query_total') // Returns: "counter"
+   * ```
+   */
+  getType(name) {
+    var _a;
+    return (_a = this.metrics.find((m) => m.name === name)) == null ? void 0 : _a.type;
+  }
+  /**
+   * Gets all metric names
+   * @returns Array of metric names
+   * @example
+   * ```ts
+   * parser.getMetricNames()
+   * // Returns: [
+   * //   'ponder_version_info',
+   * //   'ponder_settings_info',
+   * //   'ponder_historical_start_timestamp_seconds',
+   * //   'ponder_historical_total_indexing_seconds'
+   * // ]
+   * ```
+   */
+  getMetricNames() {
+    return this.metrics.map((m) => m.name);
+  }
+};
+
+// src/middleware.ts
+function ponderMetadata({
+  app,
+  db,
+  env,
+  query,
+  publicClients
+}) {
+  return async function ponderMetadataMiddleware(ctx) {
+    const indexedChainNames = Object.keys(publicClients);
+    const ponderStatus = await query.ponderStatus();
+    const metrics = PrometheusMetrics.parse(await query.prometheusMetrics());
+    const chainIndexingStatuses = {};
+    for (const indexedChainName of indexedChainNames) {
+      const publicClient = publicClients[indexedChainName];
+      if (!publicClient || typeof publicClient.chain === "undefined") {
+        throw new HTTPException(500, {
+          message: `No public client found for "${indexedChainName}" chain name`
+        });
+      }
+      const publicClientChainId = publicClient.chain.id;
+      const fetchBlockMetadata = async (blockNumber) => {
+        const block = await publicClient.getBlock({
+          blockNumber: BigInt(blockNumber)
+        });
+        if (!block) {
+          throw new Error(
+            `Failed to fetch block metadata for block number ${blockNumber} on chain ID "${publicClientChainId}"`
+          );
+        }
+        return {
+          number: Number(block.number),
+          timestamp: Number(block.timestamp)
+        };
+      };
+      const latestSafeBlockData = await publicClient.getBlock();
+      if (!latestSafeBlockData) {
+        throw new HTTPException(500, {
+          message: `Failed to fetch latest safe block for chain ID "${publicClientChainId}"`
+        });
+      }
+      const latestSafeBlock = {
+        number: Number(latestSafeBlockData.number),
+        timestamp: Number(latestSafeBlockData.timestamp)
+      };
+      const chain = indexedChainName;
+      const lastSyncedBlockHeight = metrics.getValue("ponder_sync_block", {
+        chain
+      });
+      let lastSyncedBlock = null;
+      if (lastSyncedBlockHeight) {
+        try {
+          lastSyncedBlock = await fetchBlockMetadata(lastSyncedBlockHeight);
+        } catch (error) {
+          console.error("Failed to fetch block metadata for last synced block", error);
+        }
+      }
+      const firstBlockToIndex = await query.firstBlockToIndexByChainId(
+        publicClientChainId,
+        publicClient
+      );
+      const ponderStatusForChain = Object.values(ponderStatus).find(
+        (ponderStatusEntry) => ponderStatusEntry.id === publicClientChainId
+      );
+      let lastIndexedBlock = null;
+      if (ponderStatusForChain) {
+        if (firstBlockToIndex.number < ponderStatusForChain.block.number) {
+          lastIndexedBlock = ponderStatusForChain.block;
+        }
+      }
+      chainIndexingStatuses[publicClientChainId] = {
+        chainId: publicClientChainId,
+        lastSyncedBlock,
+        lastIndexedBlock,
+        latestSafeBlock,
+        firstBlockToIndex
+      };
+    }
+    let ponderAppBuildId;
+    try {
+      ponderAppBuildId = (await queryPonderMeta(env.DATABASE_SCHEMA, db)).build_id;
+    } catch (error) {
+      console.error("Failed to fetch ponder metadata", error);
+    }
+    let ensRainbowVersionInfo;
+    if (query.ensRainbowVersion) {
+      try {
+        ensRainbowVersionInfo = await query.ensRainbowVersion();
+      } catch (error) {
+        console.error("Failed to fetch ENSRainbow version", error);
+      }
+    }
+    const response = {
+      app,
+      deps: {
+        ponder: formatTextMetricValue(metrics.getLabel("ponder_version_info", "version")),
+        nodejs: formatTextMetricValue(metrics.getLabel("nodejs_version_info", "version"))
+      },
+      env,
+      runtime: {
+        codebaseBuildId: formatTextMetricValue(ponderAppBuildId),
+        chainIndexingStatuses,
+        ensRainbow: ensRainbowVersionInfo
+      }
+    };
+    validateResponse(response);
+    return ctx.json(response);
+  };
+}
+function validateResponse(response) {
+  const { chainIndexingStatuses } = response.runtime;
+  if (Object.keys(chainIndexingStatuses).length === 0) {
+    throw new HTTPException(500, {
+      message: "No chain indexing status found"
+    });
+  }
+  if (Object.values(chainIndexingStatuses).some((n) => n.firstBlockToIndex === null)) {
+    throw new HTTPException(500, {
+      message: "Failed to fetch first block to index for some chains"
+    });
+  }
+}
+function formatTextMetricValue(value) {
+  return value ?? "unknown";
+}
+export {
+  PrometheusMetrics,
+  ponderMetadata,
+  queryPonderMeta
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/db-helpers.ts","../src/middleware.ts","../src/prometheus-metrics.ts"],"sourcesContent":["import { pgSchema, pgTable } from \"drizzle-orm/pg-core\";\nimport { eq, type ReadonlyDrizzle } from \"ponder\";\n\n/**\n * Internal ponder metadata type.\n * Copied from https://github.com/ponder-sh/ponder/blob/32634897bf65e92a85dc4cccdaba70c9425d90f3/packages/core/src/database/index.ts#L94-L102\n */\ntype PonderAppMeta = {\n  is_locked: 0 | 1;\n  is_dev: 0 | 1;\n  heartbeat_at: number;\n  build_id: string;\n  table_names: Array<string>;\n  version: string;\n  is_ready: 0 | 1;\n};\n\n/**\n * Get DB schema for _ponder_meta table.\n * Akin to https://github.com/ponder-sh/ponder/blob/32634897bf65e92a85dc4cccdaba70c9425d90f3/packages/core/src/database/index.ts#L129-L141\n *\n * @param databaseNamespace A namespace for the database.\n * @returns A table schema for _ponder_meta table.\n * */\nconst getPonderMetaTableSchema = (databaseNamespace: string) => {\n  if (databaseNamespace === \"public\") {\n    return pgTable(\"_ponder_meta\", (t) => ({\n      key: t.text().primaryKey().$type<\"app\">(),\n      value: t.jsonb().$type<PonderAppMeta>().notNull(),\n    }));\n  }\n\n  return pgSchema(databaseNamespace).table(\"_ponder_meta\", (t) => ({\n    key: t.text().primaryKey().$type<\"app\">(),\n    value: t.jsonb().$type<PonderAppMeta>().notNull(),\n  }));\n};\n\ntype PonderMetaTableSchema = ReturnType<typeof getPonderMetaTableSchema>;\n\n/**\n * Get ponder metadata for the app.\n *\n * @param namespace A namespace for the database (e.g. \"public\").\n * @param db Drizzle DB Client instance.\n * @returns ponder metadata for the app.\n * @throws Error if ponder metadata not found.\n */\nexport async function queryPonderMeta(\n  namespace: string,\n  db: ReadonlyDrizzle<Record<string, unknown>>,\n): Promise<PonderMetaTableSchema[\"$inferSelect\"][\"value\"]> {\n  const PONDER_META = getPonderMetaTableSchema(namespace);\n\n  const [ponderAppMeta] = await db\n    .select({ value: PONDER_META.value })\n    .from(PONDER_META)\n    .where(eq(PONDER_META.key, \"app\"))\n    .limit(1);\n\n  if (!ponderAppMeta) {\n    throw new Error(\"Ponder metadata not found\");\n  }\n\n  return ponderAppMeta.value;\n}\n","import type { MiddlewareHandler } from \"hono\";\nimport { HTTPException } from \"hono/http-exception\";\n\nimport type { EnsRainbow } from \"@ensnode/ensrainbow-sdk\";\n\nimport { queryPonderMeta } from \"./db-helpers\";\nimport { PrometheusMetrics } from \"./prometheus-metrics\";\nimport type {\n  PonderEnvVarsInfo,\n  PonderMetadataMiddlewareOptions,\n  PonderMetadataMiddlewareResponse,\n} from \"./types/api\";\nimport type { BlockInfo, ChainIndexingStatus } from \"./types/common\";\n\n/**\n * Ponder Metadata types definition.\n */\ninterface PonderMetadataModule {\n  /** Application info */\n  AppInfo: {\n    /** Application name */\n    name: string;\n    /** Application version */\n    version: string;\n  };\n\n  /** Environment Variables info */\n  EnvVars: {\n    /** Database schema */\n    DATABASE_SCHEMA: string;\n  } & PonderEnvVarsInfo;\n\n  /** Runtime info */\n  RuntimeInfo: {\n    /**\n     * Application build id\n     * https://github.com/ponder-sh/ponder/blob/626e524/packages/core/src/build/index.ts#L425-L431\n     **/\n    codebaseBuildId: string;\n\n    /** Chain indexing statuses by chain ID */\n    chainIndexingStatuses: { [chainId: number]: ChainIndexingStatus };\n\n    /** ENSRainbow version info */\n    ensRainbow?: EnsRainbow.VersionInfo;\n  };\n}\n\nexport type MetadataMiddlewareResponse = PonderMetadataMiddlewareResponse<\n  PonderMetadataModule[\"AppInfo\"],\n  PonderMetadataModule[\"EnvVars\"],\n  PonderMetadataModule[\"RuntimeInfo\"]\n>;\n\nexport function ponderMetadata<\n  AppInfo extends PonderMetadataModule[\"AppInfo\"],\n  EnvVars extends PonderMetadataModule[\"EnvVars\"],\n>({\n  app,\n  db,\n  env,\n  query,\n  publicClients,\n}: PonderMetadataMiddlewareOptions<AppInfo, EnvVars>): MiddlewareHandler {\n  return async function ponderMetadataMiddleware(ctx) {\n    const indexedChainNames = Object.keys(publicClients);\n\n    const ponderStatus = await query.ponderStatus();\n\n    const metrics = PrometheusMetrics.parse(await query.prometheusMetrics());\n\n    const chainIndexingStatuses: Record<number, ChainIndexingStatus> = {};\n\n    for (const indexedChainName of indexedChainNames) {\n      const publicClient = publicClients[indexedChainName];\n\n      if (!publicClient || typeof publicClient.chain === \"undefined\") {\n        throw new HTTPException(500, {\n          message: `No public client found for \"${indexedChainName}\" chain name`,\n        });\n      }\n\n      const publicClientChainId = publicClient.chain.id;\n\n      /**\n       * Fetches block metadata from blockchain network for a given block number.\n       * @param blockNumber\n       * @returns block metadata\n       * @throws {Error} if failed to fetch block metadata from blockchain network\n       */\n      const fetchBlockMetadata = async (blockNumber: number): Promise<BlockInfo> => {\n        const block = await publicClient.getBlock({\n          blockNumber: BigInt(blockNumber),\n        });\n\n        if (!block) {\n          throw new Error(\n            `Failed to fetch block metadata for block number ${blockNumber} on chain ID \"${publicClientChainId}\"`,\n          );\n        }\n\n        return {\n          number: Number(block.number),\n          timestamp: Number(block.timestamp),\n        } satisfies BlockInfo;\n      };\n\n      const latestSafeBlockData = await publicClient.getBlock();\n\n      if (!latestSafeBlockData) {\n        throw new HTTPException(500, {\n          message: `Failed to fetch latest safe block for chain ID \"${publicClientChainId}\"`,\n        });\n      }\n\n      // mapping latest safe block\n      const latestSafeBlock = {\n        number: Number(latestSafeBlockData.number),\n        timestamp: Number(latestSafeBlockData.timestamp),\n      } satisfies BlockInfo;\n\n      // mapping indexed chain name to its metric representation for metric queries\n      const chain = indexedChainName;\n\n      // mapping last synced block if available\n      const lastSyncedBlockHeight = metrics.getValue(\"ponder_sync_block\", {\n        chain,\n      });\n      let lastSyncedBlock: BlockInfo | null = null;\n      if (lastSyncedBlockHeight) {\n        try {\n          lastSyncedBlock = await fetchBlockMetadata(lastSyncedBlockHeight);\n        } catch (error) {\n          console.error(\"Failed to fetch block metadata for last synced block\", error);\n        }\n      }\n\n      const firstBlockToIndex = await query.firstBlockToIndexByChainId(\n        publicClientChainId,\n        publicClient,\n      );\n\n      // mapping ponder status for current chain\n      const ponderStatusForChain = Object.values(ponderStatus).find(\n        (ponderStatusEntry) => ponderStatusEntry.id === publicClientChainId,\n      );\n\n      // mapping last indexed block if available\n      let lastIndexedBlock: BlockInfo | null = null;\n      if (ponderStatusForChain) {\n        // Since Ponder 0.11, the `block` value in the PonderStatus object\n        // is always provided. It represents either the very first block to be indexed\n        // or the last block that has been indexed.\n        //\n        // We compare the first block to be indexed (from ponder.config.ts)\n        // with the block value from the PonderStatus object (from `GET /status` response).\n        // We only set the `lastIndexedBlock` value if the `block` from the PonderStatus object\n        // is not the same as the `firstBlockToIndex`.\n        if (firstBlockToIndex.number < ponderStatusForChain.block.number) {\n          lastIndexedBlock = ponderStatusForChain.block;\n        }\n      }\n\n      chainIndexingStatuses[publicClientChainId] = {\n        chainId: publicClientChainId,\n        lastSyncedBlock,\n        lastIndexedBlock,\n        latestSafeBlock,\n        firstBlockToIndex,\n      } satisfies ChainIndexingStatus;\n    }\n\n    // mapping ponder app build id if available\n    let ponderAppBuildId: string | undefined;\n    try {\n      ponderAppBuildId = (await queryPonderMeta(env.DATABASE_SCHEMA, db)).build_id;\n    } catch (error) {\n      console.error(\"Failed to fetch ponder metadata\", error);\n    }\n\n    // fetch ENSRainbow version if available\n    let ensRainbowVersionInfo: EnsRainbow.VersionInfo | undefined;\n    if (query.ensRainbowVersion) {\n      try {\n        ensRainbowVersionInfo = await query.ensRainbowVersion();\n      } catch (error) {\n        console.error(\"Failed to fetch ENSRainbow version\", error);\n      }\n    }\n\n    const response = {\n      app,\n      deps: {\n        ponder: formatTextMetricValue(metrics.getLabel(\"ponder_version_info\", \"version\")),\n        nodejs: formatTextMetricValue(metrics.getLabel(\"nodejs_version_info\", \"version\")),\n      },\n      env,\n      runtime: {\n        codebaseBuildId: formatTextMetricValue(ponderAppBuildId),\n        chainIndexingStatuses,\n        ensRainbow: ensRainbowVersionInfo,\n      },\n    } satisfies MetadataMiddlewareResponse;\n\n    // validate if response is in correct state\n    validateResponse(response);\n\n    return ctx.json(response);\n  };\n}\n\n/**\n * Validates the metadata middleware response to ensure correct state.\n *\n * @param response The response to validate\n * @throws {HTTPException} if the response is in an invalid state\n */\nfunction validateResponse(response: MetadataMiddlewareResponse): void {\n  const { chainIndexingStatuses } = response.runtime;\n\n  if (Object.keys(chainIndexingStatuses).length === 0) {\n    throw new HTTPException(500, {\n      message: \"No chain indexing status found\",\n    });\n  }\n\n  if (Object.values(chainIndexingStatuses).some((n) => n.firstBlockToIndex === null)) {\n    throw new HTTPException(500, {\n      message: \"Failed to fetch first block to index for some chains\",\n    });\n  }\n}\n\n/**\n * Formats a text metric value.\n * @param value\n * @returns\n */\nfunction formatTextMetricValue(value?: string): string {\n  return value ?? \"unknown\";\n}\n","import parsePrometheusTextFormat, { type PrometheusMetric } from \"parse-prometheus-text-format\";\n// Ensures local declaration file is available to downstream consumers\nimport \"./types/parse-prometheus-text-format\";\n\ninterface ParsedPrometheusMetric extends Omit<PrometheusMetric, \"metrics\"> {\n  metrics: Array<{\n    value: number;\n    labels?: Record<string, string>;\n  }>;\n}\n\n/**\n * Converts Prometheus text format to JSON format compatible with prom2json\n * @param text Raw Prometheus metric text\n * @returns Array of metrics in prom2json compatible format\n * @example\n * ```ts\n * const metrics = parsePrometheusText(`\n * # HELP ponder_version_info Ponder version information\n * # TYPE ponder_version_info gauge\n * ponder_version_info{version=\"0.9.18\",major=\"0\",minor=\"9\",patch=\"18\"} 1\n * `);\n * // Returns:\n * // [{\n * //   name: \"ponder_version_info\",\n * //   help: \"Ponder version information\",\n * //   type: \"gauge\",\n * //   metrics: [{\n * //     value: 1,\n * //     labels: { version: \"0.9.18\", major: \"0\", minor: \"9\", patch: \"18\" }\n * //   }]\n * // }]\n * ```\n */\nexport function parsePrometheusText(text: string): Array<ParsedPrometheusMetric> {\n  return parsePrometheusTextFormat(text).map((metric) => ({\n    name: metric.name,\n    help: metric.help || \"\",\n    type: metric.type.toLowerCase(),\n    metrics: metric.metrics.map((m) => ({\n      value: Number(m.value),\n      ...(m.labels && Object.keys(m.labels).length > 0 ? { labels: m.labels } : {}),\n    })),\n  }));\n}\n\nexport class PrometheusMetrics {\n  private constructor(private readonly metrics: Array<ParsedPrometheusMetric>) {}\n\n  static parse(maybePrometheusMetricsText: string): PrometheusMetrics {\n    return new PrometheusMetrics(parsePrometheusText(maybePrometheusMetricsText));\n  }\n\n  /**\n   * Gets all metrics of a specific name\n   * @param name Metric name\n   * @returns Array of metrics or undefined if not found\n   * @example\n   * ```ts\n   * const metrics = parser.get('ponder_historical_total_indexing_seconds');\n   * // Returns: [\n   * //   { value: 251224935, labels: { network: \"1\" } },\n   * //   { value: 251224935, labels: { network: \"8453\" } }\n   * // ]\n   * ```\n   */\n  get(name: string): Array<{ value: number; labels?: Record<string, string> }> | undefined {\n    const metric = this.metrics.find((m) => m.name === name);\n    return metric?.metrics;\n  }\n\n  /**\n   * Gets a single metric value, optionally filtered by labels\n   * @param name Metric name\n   * @param labelFilter Optional label key-value pairs to match\n   * @returns Metric value or undefined if not found\n   * @example\n   * ```ts\n   * // Get simple value\n   * parser.getValue('ponder_historical_start_timestamp_seconds') // Returns: 1740391265\n   *\n   * // Get value with label filter\n   * parser.getValue('ponder_historical_total_indexing_seconds', { network: '1' }) // Returns: 251224935\n   * ```\n   */\n  getValue(name: string, labelFilter?: Record<string, string>): number | undefined {\n    const metrics = this.get(name);\n\n    if (!metrics || metrics.length === 0) {\n      return undefined;\n    }\n\n    if (!labelFilter) {\n      return metrics[0]?.value;\n    }\n\n    const metric = metrics.find(\n      (m) => m.labels && Object.entries(labelFilter).every(([k, v]) => m.labels?.[k] === v),\n    );\n\n    return metric?.value;\n  }\n\n  /**\n   * Gets a label value from a metric\n   * @param name Metric name\n   * @param label Label name to retrieve\n   * @returns Label value or undefined if not found\n   * @example\n   * ```ts\n   * parser.getLabel('ponder_version_info', 'version') // Returns: \"0.9.18\"\n   * parser.getLabel('ponder_settings_info', 'ordering') // Returns: \"omnichain\"\n   * ```\n   */\n  getLabel(name: string, label: string): string | undefined {\n    return this.getLabels(name, label)[0];\n  }\n\n  /**\n   * Gets all unique label values for a metric\n   * @param name Metric name\n   * @param label Label name to retrieve\n   * @returns Array of unique label values\n   * @example\n   * ```ts\n   * // Get all network IDs\n   * parser.getLabels('ponder_historical_total_indexing_seconds', 'network')\n   * // Returns: ['1', '8453']\n   * ```\n   */\n  getLabels(name: string, label: string): string[] {\n    const metrics = this.get(name);\n\n    if (!metrics) return [];\n\n    return [\n      ...new Set(metrics.map((m) => m.labels?.[label]).filter((v): v is string => v !== undefined)),\n    ];\n  }\n\n  /**\n   * Gets help text for a metric\n   * @param name Metric name\n   * @returns Help text or undefined if not found\n   * @example\n   * ```ts\n   * parser.getHelp('ponder_historical_start_timestamp_seconds')\n   * // Returns: \"Timestamp at which historical indexing started\"\n   * ```\n   */\n  getHelp(name: string): string | undefined {\n    return this.metrics.find((m) => m.name === name)?.help;\n  }\n\n  /**\n   * Gets metric type\n   * @param name Metric name\n   * @returns Metric type or undefined if not found\n   * @example\n   * ```ts\n   * parser.getType('ponder_version_info') // Returns: \"gauge\"\n   * parser.getType('ponder_postgres_query_total') // Returns: \"counter\"\n   * ```\n   */\n  getType(name: string): string | undefined {\n    return this.metrics.find((m) => m.name === name)?.type;\n  }\n\n  /**\n   * Gets all metric names\n   * @returns Array of metric names\n   * @example\n   * ```ts\n   * parser.getMetricNames()\n   * // Returns: [\n   * //   'ponder_version_info',\n   * //   'ponder_settings_info',\n   * //   'ponder_historical_start_timestamp_seconds',\n   * //   'ponder_historical_total_indexing_seconds'\n   * // ]\n   * ```\n   */\n  getMetricNames(): string[] {\n    return this.metrics.map((m) => m.name);\n  }\n}\n"],"mappings":"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","names":["_a"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ensnode/ponder-metadata",
+  "version": "0.0.0-next-20260102143513",
+  "type": "module",
+  "description": "A Hono middleware for making Ponder app metadata available to clients.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/namehash/ensnode.git",
+    "directory": "packages/ponder-metadata-api"
+  },
+  "homepage": "https://github.com/namehash/ensnode/tree/main/packages/ponder-metadata-api",
+  "keywords": [
+    "Ponder"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "drizzle-orm": "=0.41.0",
+    "parse-prometheus-text-format": "^1.1.1",
+    "viem": "^2.22.13",
+    "@ensnode/ensrainbow-sdk": "0.0.0-next-20260102143513"
+  },
+  "devDependencies": {
+    "@types/node": "22.18.13",
+    "hono": "^4.10.2",
+    "ponder": "0.13.16",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.2",
+    "@ensnode/shared-configs": "0.0.0-next-20260102143513"
+  },
+  "peerDependencies": {
+    "hono": "^4.10.2",
+    "ponder": "0.13.16"
+  },
+  "scripts": {
+    "prepublish": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "lint": "biome check --write .",
+    "lint:ci": "biome ci"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts"
+}