@ensnode/ponder-metadata 0.1.0

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/middleware.d.ts

@@ -0,0 +1,18 @@
+import { MiddlewareHandler } from 'hono';
+import { ReadonlyDrizzle } from 'ponder';
+import { PublicClient } from 'viem';
+
+declare function ponderMetadata({ app, db, env, fetchPrometheusMetrics, publicClients, }: {
+    db: ReadonlyDrizzle<Record<string, unknown>>;
+    app: {
+        name: string;
+        version: string;
+    };
+    env: {
+        DATABASE_SCHEMA: string;
+    } & Record<string, unknown>;
+    fetchPrometheusMetrics: () => Promise<string>;
+    publicClients: Record<number, PublicClient>;
+}): MiddlewareHandler;
+
+export { ponderMetadata };

package/dist/middleware.js

@@ -0,0 +1,283 @@
+// src/db-helpers.ts
+import { pgSchema, pgTable } from "drizzle-orm/pg-core";
+import { eq } from "ponder";
+var getPonderMeta = (namespace) => {
+  if (namespace === "public") {
+    return pgTable("_ponder_meta", (t) => ({
+      key: t.text().primaryKey().$type(),
+      value: t.jsonb().$type().notNull()
+    }));
+  }
+  return pgSchema(namespace).table("_ponder_meta", (t) => ({
+    key: t.text().primaryKey().$type(),
+    value: t.jsonb().$type().notNull()
+  }));
+};
+var getPonderStatus = (namespace) => {
+  if (namespace === "public") {
+    return pgTable("_ponder_status", (t) => ({
+      network_name: t.text().primaryKey(),
+      block_number: t.bigint({ mode: "number" }),
+      block_timestamp: t.bigint({ mode: "number" }),
+      ready: t.boolean().notNull()
+    }));
+  }
+  return pgSchema(namespace).table("_ponder_status", (t) => ({
+    network_name: t.text().primaryKey(),
+    block_number: t.bigint({ mode: "number" }),
+    block_timestamp: t.bigint({ mode: "number" }),
+    ready: t.boolean().notNull()
+  }));
+};
+async function queryPonderStatus(namespace, db) {
+  const PONDER_STATUS = getPonderStatus(namespace);
+  return db.select().from(PONDER_STATUS);
+}
+async function queryPonderMeta(namespace, db) {
+  const PONDER_META = getPonderMeta(namespace);
+  return db.select({ value: PONDER_META.value }).from(PONDER_META).where(eq(PONDER_META.key, "app")).limit(1).then((result) => {
+    var _a;
+    return (_a = result[0]) == null ? void 0 : _a.value;
+  });
+}
+
+// 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,
+  fetchPrometheusMetrics,
+  publicClients
+}) {
+  return async function ponderMetadataMiddleware(ctx) {
+    const indexedChainIds = Object.keys(publicClients).map(Number);
+    const ponderStatus = await queryPonderStatus(env.DATABASE_SCHEMA, db);
+    const ponderMeta = await queryPonderMeta(env.DATABASE_SCHEMA, db);
+    const metrics = PrometheusMetrics.parse(await fetchPrometheusMetrics());
+    const networkIndexingStatus = {};
+    for (const indexedChainId of indexedChainIds) {
+      const publicClient = publicClients[indexedChainId];
+      if (!publicClient) {
+        throw new Error(`No public client found for chainId ${indexedChainId}`);
+      }
+      const latestSafeBlock = await publicClient.getBlock();
+      const network = indexedChainId.toString();
+      const ponderStatusForNetwork = ponderStatus.find((s) => s.network_name === network);
+      const lastIndexedBlock = mapPonderStatusBlockToBlockMetadata(ponderStatusForNetwork);
+      networkIndexingStatus[network] = {
+        totalBlocksCount: metrics.getValue("ponder_historical_total_blocks", {
+          network
+        }) ?? null,
+        cachedBlocksCount: metrics.getValue("ponder_historical_cached_blocks", {
+          network
+        }) ?? null,
+        lastSyncedBlock: blockInfo({
+          number: metrics.getValue("ponder_sync_block", {
+            network
+          }) ?? 0,
+          timestamp: 0
+        }),
+        latestSafeBlock: blockInfo({
+          number: Number(latestSafeBlock.number),
+          timestamp: Number(latestSafeBlock.timestamp)
+        }),
+        lastIndexedBlock,
+        isRealtime: Boolean(metrics.getValue("ponder_sync_is_realtime", { network })),
+        isComplete: Boolean(metrics.getValue("ponder_sync_is_complete", { network })),
+        isQueued: lastIndexedBlock === null
+      };
+    }
+    return ctx.json({
+      app,
+      // application dependencies version
+      deps: {
+        ponder: metrics.getLabel("ponder_version_info", "version"),
+        nodejs: metrics.getLabel("nodejs_version_info", "version")
+      },
+      // application environment variables
+      env,
+      // application runtime information
+      runtime: {
+        // application build id
+        // https://github.com/ponder-sh/ponder/blob/626e524/packages/core/src/build/index.ts#L425-L431
+        codebaseBuildId: ponderMeta == null ? void 0 : ponderMeta.build_id,
+        // tableNames: meta?.table_names,
+        networkIndexingStatus
+      }
+    });
+  };
+}
+function blockInfo(block) {
+  if (!block.number) {
+    return null;
+  }
+  return {
+    height: block.number,
+    timestamp: block.timestamp ?? 0,
+    utc: block.timestamp ? new Date(block.timestamp * 1e3).toISOString() : ""
+  };
+}
+function mapPonderStatusBlockToBlockMetadata(block) {
+  if (!(block == null ? void 0 : block.block_number)) {
+    return null;
+  }
+  return blockInfo({
+    number: block.block_number,
+    timestamp: block.block_timestamp
+  });
+}
+export {
+  ponderMetadata
+};
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/db-helpers.ts","../src/prometheus-metrics.ts","../src/middleware.ts"],"sourcesContent":["import { pgSchema, pgTable } from \"drizzle-orm/pg-core\";\nimport { type ReadonlyDrizzle, eq } from \"ponder\";\n\ntype NamespaceBuild = string;\n\ntype PonderApp = {\n  is_locked: 0 | 1;\n  is_dev: 0 | 1;\n  heartbeat_at: number;\n  build_id: string;\n  checkpoint: string;\n  table_names: string[];\n  version: string;\n};\n\nconst getPonderMeta = (namespace: NamespaceBuild) => {\n  if (namespace === \"public\") {\n    return pgTable(\"_ponder_meta\", (t) => ({\n      key: t.text().primaryKey().$type<\"app\">(),\n      value: t.jsonb().$type<PonderApp>().notNull(),\n    }));\n  }\n\n  return pgSchema(namespace).table(\"_ponder_meta\", (t) => ({\n    key: t.text().primaryKey().$type<\"app\">(),\n    value: t.jsonb().$type<PonderApp>().notNull(),\n  }));\n};\n\nconst getPonderStatus = (namespace: NamespaceBuild) => {\n  if (namespace === \"public\") {\n    return pgTable(\"_ponder_status\", (t) => ({\n      network_name: t.text().primaryKey(),\n      block_number: t.bigint({ mode: \"number\" }),\n      block_timestamp: t.bigint({ mode: \"number\" }),\n      ready: t.boolean().notNull(),\n    }));\n  }\n\n  return pgSchema(namespace).table(\"_ponder_status\", (t) => ({\n    network_name: t.text().primaryKey(),\n    block_number: t.bigint({ mode: \"number\" }),\n    block_timestamp: t.bigint({ mode: \"number\" }),\n    ready: t.boolean().notNull(),\n  }));\n};\n\nexport async function queryPonderStatus(\n  namespace: string,\n  db: ReadonlyDrizzle<Record<string, unknown>>,\n) {\n  const PONDER_STATUS = getPonderStatus(namespace);\n\n  return db.select().from(PONDER_STATUS);\n}\n\nexport async function queryPonderMeta(\n  namespace: string,\n  db: ReadonlyDrizzle<Record<string, unknown>>,\n) {\n  const PONDER_META = getPonderMeta(namespace);\n\n  return db\n    .select({ value: PONDER_META.value })\n    .from(PONDER_META)\n    .where(eq(PONDER_META.key, \"app\"))\n    .limit(1)\n    .then((result: any) => result[0]?.value);\n}\n","import parsePrometheusTextFormat from \"parse-prometheus-text-format\";\nimport 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","import { MiddlewareHandler } from \"hono\";\nimport { ReadonlyDrizzle } from \"ponder\";\nimport { PublicClient } from \"viem\";\nimport { queryPonderMeta, queryPonderStatus } from \"./db-helpers\";\nimport { PrometheusMetrics } from \"./prometheus-metrics\";\nimport type { BlockMetadata, NetworkIndexingStatus } from \"./types/common\";\n\nexport function ponderMetadata({\n  app,\n  db,\n  env,\n  fetchPrometheusMetrics,\n  publicClients,\n}: {\n  db: ReadonlyDrizzle<Record<string, unknown>>;\n  app: {\n    name: string;\n    version: string;\n  };\n  env: {\n    DATABASE_SCHEMA: string;\n  } & Record<string, unknown>;\n  fetchPrometheusMetrics: () => Promise<string>;\n  publicClients: Record<number, PublicClient>;\n}): MiddlewareHandler {\n  return async function ponderMetadataMiddleware(ctx) {\n    const indexedChainIds = Object.keys(publicClients).map(Number);\n\n    const ponderStatus = await queryPonderStatus(env.DATABASE_SCHEMA, db);\n    const ponderMeta = await queryPonderMeta(env.DATABASE_SCHEMA, db);\n    const metrics = PrometheusMetrics.parse(await fetchPrometheusMetrics());\n\n    const networkIndexingStatus: Record<string, NetworkIndexingStatus> = {};\n\n    for (const indexedChainId of indexedChainIds) {\n      const publicClient = publicClients[indexedChainId];\n\n      if (!publicClient) {\n        throw new Error(`No public client found for chainId ${indexedChainId}`);\n      }\n\n      const latestSafeBlock = await publicClient.getBlock();\n\n      const network = indexedChainId.toString();\n      const ponderStatusForNetwork = ponderStatus.find((s) => s.network_name === network);\n      const lastIndexedBlock = mapPonderStatusBlockToBlockMetadata(ponderStatusForNetwork);\n\n      networkIndexingStatus[network] = {\n        totalBlocksCount:\n          metrics.getValue(\"ponder_historical_total_blocks\", {\n            network,\n          }) ?? null,\n        cachedBlocksCount:\n          metrics.getValue(\"ponder_historical_cached_blocks\", {\n            network,\n          }) ?? null,\n        lastSyncedBlock: blockInfo({\n          number:\n            metrics.getValue(\"ponder_sync_block\", {\n              network,\n            }) ?? 0,\n          timestamp: 0,\n        }),\n        latestSafeBlock: blockInfo({\n          number: Number(latestSafeBlock.number),\n          timestamp: Number(latestSafeBlock.timestamp),\n        }),\n        lastIndexedBlock,\n        isRealtime: Boolean(metrics.getValue(\"ponder_sync_is_realtime\", { network })),\n        isComplete: Boolean(metrics.getValue(\"ponder_sync_is_complete\", { network })),\n        isQueued: lastIndexedBlock === null,\n      } satisfies NetworkIndexingStatus;\n    }\n\n    return ctx.json({\n      app,\n      // application dependencies version\n      deps: {\n        ponder: metrics.getLabel(\"ponder_version_info\", \"version\"),\n        nodejs: metrics.getLabel(\"nodejs_version_info\", \"version\"),\n      },\n      // application environment variables\n      env,\n      // application runtime information\n      runtime: {\n        // application build id\n        // https://github.com/ponder-sh/ponder/blob/626e524/packages/core/src/build/index.ts#L425-L431\n        codebaseBuildId: ponderMeta?.build_id,\n        // tableNames: meta?.table_names,\n        networkIndexingStatus,\n      },\n    });\n  };\n}\n\nfunction blockInfo(block: {\n  number: number | null;\n  timestamp: number | null;\n}): BlockMetadata | null {\n  if (!block.number) {\n    return null;\n  }\n\n  return {\n    height: block.number,\n    timestamp: block.timestamp ?? 0,\n    utc: block.timestamp ? new Date(block.timestamp * 1000).toISOString() : \"\",\n  };\n}\n\nfunction mapPonderStatusBlockToBlockMetadata(\n  block:\n    | {\n        block_number: number | null;\n        block_timestamp: number | null;\n      }\n    | undefined,\n): BlockMetadata | null {\n  if (!block?.block_number) {\n    return null;\n  }\n\n  return blockInfo({\n    number: block.block_number,\n    timestamp: block.block_timestamp,\n  });\n}\n"],"mappings":";AAAA,SAAS,UAAU,eAAe;AAClC,SAA+B,UAAU;AAczC,IAAM,gBAAgB,CAAC,cAA8B;AACnD,MAAI,cAAc,UAAU;AAC1B,WAAO,QAAQ,gBAAgB,CAAC,OAAO;AAAA,MACrC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAa;AAAA,MACxC,OAAO,EAAE,MAAM,EAAE,MAAiB,EAAE,QAAQ;AAAA,IAC9C,EAAE;AAAA,EACJ;AAEA,SAAO,SAAS,SAAS,EAAE,MAAM,gBAAgB,CAAC,OAAO;AAAA,IACvD,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAa;AAAA,IACxC,OAAO,EAAE,MAAM,EAAE,MAAiB,EAAE,QAAQ;AAAA,EAC9C,EAAE;AACJ;AAEA,IAAM,kBAAkB,CAAC,cAA8B;AACrD,MAAI,cAAc,UAAU;AAC1B,WAAO,QAAQ,kBAAkB,CAAC,OAAO;AAAA,MACvC,cAAc,EAAE,KAAK,EAAE,WAAW;AAAA,MAClC,cAAc,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAAA,MACzC,iBAAiB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAAA,MAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ;AAAA,IAC7B,EAAE;AAAA,EACJ;AAEA,SAAO,SAAS,SAAS,EAAE,MAAM,kBAAkB,CAAC,OAAO;AAAA,IACzD,cAAc,EAAE,KAAK,EAAE,WAAW;AAAA,IAClC,cAAc,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAAA,IACzC,iBAAiB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAAA,IAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ;AAAA,EAC7B,EAAE;AACJ;AAEA,eAAsB,kBACpB,WACA,IACA;AACA,QAAM,gBAAgB,gBAAgB,SAAS;AAE/C,SAAO,GAAG,OAAO,EAAE,KAAK,aAAa;AACvC;AAEA,eAAsB,gBACpB,WACA,IACA;AACA,QAAM,cAAc,cAAc,SAAS;AAE3C,SAAO,GACJ,OAAO,EAAE,OAAO,YAAY,MAAM,CAAC,EACnC,KAAK,WAAW,EAChB,MAAM,GAAG,YAAY,KAAK,KAAK,CAAC,EAChC,MAAM,CAAC,EACP,KAAK,CAAC,WAAa;AAnExB;AAmE2B,wBAAO,CAAC,MAAR,mBAAW;AAAA,GAAK;AAC3C;;;ACpEA,OAAO,+BAA+B;AAmC/B,SAAS,oBAAoB,MAA6C;AAC/E,SAAO,0BAA0B,IAAI,EAAE,IAAI,CAAC,YAAY;AAAA,IACtD,MAAM,OAAO;AAAA,IACb,MAAM,OAAO,QAAQ;AAAA,IACrB,MAAM,OAAO,KAAK,YAAY;AAAA,IAC9B,SAAS,OAAO,QAAQ,IAAI,CAAC,OAAO;AAAA,MAClC,OAAO,OAAO,EAAE,KAAK;AAAA,MACrB,GAAI,EAAE,UAAU,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,QAAQ,EAAE,OAAO,IAAI,CAAC;AAAA,IAC7E,EAAE;AAAA,EACJ,EAAE;AACJ;AAEO,IAAM,oBAAN,MAAM,mBAAkB;AAAA,EACrB,YAA6B,SAAwC;AAAxC;AAAA,EAAyC;AAAA,EAE9E,OAAO,MAAM,4BAAuD;AAClE,WAAO,IAAI,mBAAkB,oBAAoB,0BAA0B,CAAC;AAAA,EAC9E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,IAAI,MAAqF;AACvF,UAAM,SAAS,KAAK,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AACvD,WAAO,iCAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,SAAS,MAAc,aAA0D;AAtFnF;AAuFI,UAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,QAAI,CAAC,WAAW,QAAQ,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,aAAa;AAChB,cAAO,aAAQ,CAAC,MAAT,mBAAY;AAAA,IACrB;AAEA,UAAM,SAAS,QAAQ;AAAA,MACrB,CAAC,MAAM,EAAE,UAAU,OAAO,QAAQ,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAG;AAlGpE,YAAAA;AAkGuE,iBAAAA,MAAA,EAAE,WAAF,gBAAAA,IAAW,QAAO;AAAA,OAAC;AAAA,IACtF;AAEA,WAAO,iCAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,SAAS,MAAc,OAAmC;AACxD,WAAO,KAAK,UAAU,MAAM,KAAK,EAAE,CAAC;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,UAAU,MAAc,OAAyB;AAC/C,UAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,WAAO;AAAA,MACL,GAAG,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAG;AAzIjC;AAyIoC,uBAAE,WAAF,mBAAW;AAAA,OAAM,EAAE,OAAO,CAAC,MAAmB,MAAM,MAAS,CAAC;AAAA,IAC9F;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,QAAQ,MAAkC;AAvJ5C;AAwJI,YAAO,UAAK,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,MAAxC,mBAA2C;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,QAAQ,MAAkC;AArK5C;AAsKI,YAAO,UAAK,QAAQ,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,MAAxC,mBAA2C;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,iBAA2B;AACzB,WAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EACvC;AACF;;;ACnLO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAWsB;AACpB,SAAO,eAAe,yBAAyB,KAAK;AAClD,UAAM,kBAAkB,OAAO,KAAK,aAAa,EAAE,IAAI,MAAM;AAE7D,UAAM,eAAe,MAAM,kBAAkB,IAAI,iBAAiB,EAAE;AACpE,UAAM,aAAa,MAAM,gBAAgB,IAAI,iBAAiB,EAAE;AAChE,UAAM,UAAU,kBAAkB,MAAM,MAAM,uBAAuB,CAAC;AAEtE,UAAM,wBAA+D,CAAC;AAEtE,eAAW,kBAAkB,iBAAiB;AAC5C,YAAM,eAAe,cAAc,cAAc;AAEjD,UAAI,CAAC,cAAc;AACjB,cAAM,IAAI,MAAM,sCAAsC,cAAc,EAAE;AAAA,MACxE;AAEA,YAAM,kBAAkB,MAAM,aAAa,SAAS;AAEpD,YAAM,UAAU,eAAe,SAAS;AACxC,YAAM,yBAAyB,aAAa,KAAK,CAAC,MAAM,EAAE,iBAAiB,OAAO;AAClF,YAAM,mBAAmB,oCAAoC,sBAAsB;AAEnF,4BAAsB,OAAO,IAAI;AAAA,QAC/B,kBACE,QAAQ,SAAS,kCAAkC;AAAA,UACjD;AAAA,QACF,CAAC,KAAK;AAAA,QACR,mBACE,QAAQ,SAAS,mCAAmC;AAAA,UAClD;AAAA,QACF,CAAC,KAAK;AAAA,QACR,iBAAiB,UAAU;AAAA,UACzB,QACE,QAAQ,SAAS,qBAAqB;AAAA,YACpC;AAAA,UACF,CAAC,KAAK;AAAA,UACR,WAAW;AAAA,QACb,CAAC;AAAA,QACD,iBAAiB,UAAU;AAAA,UACzB,QAAQ,OAAO,gBAAgB,MAAM;AAAA,UACrC,WAAW,OAAO,gBAAgB,SAAS;AAAA,QAC7C,CAAC;AAAA,QACD;AAAA,QACA,YAAY,QAAQ,QAAQ,SAAS,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AAAA,QAC5E,YAAY,QAAQ,QAAQ,SAAS,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AAAA,QAC5E,UAAU,qBAAqB;AAAA,MACjC;AAAA,IACF;AAEA,WAAO,IAAI,KAAK;AAAA,MACd;AAAA;AAAA,MAEA,MAAM;AAAA,QACJ,QAAQ,QAAQ,SAAS,uBAAuB,SAAS;AAAA,QACzD,QAAQ,QAAQ,SAAS,uBAAuB,SAAS;AAAA,MAC3D;AAAA;AAAA,MAEA;AAAA;AAAA,MAEA,SAAS;AAAA;AAAA;AAAA,QAGP,iBAAiB,yCAAY;AAAA;AAAA,QAE7B;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,SAAS,UAAU,OAGM;AACvB,MAAI,CAAC,MAAM,QAAQ;AACjB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,WAAW,MAAM,aAAa;AAAA,IAC9B,KAAK,MAAM,YAAY,IAAI,KAAK,MAAM,YAAY,GAAI,EAAE,YAAY,IAAI;AAAA,EAC1E;AACF;AAEA,SAAS,oCACP,OAMsB;AACtB,MAAI,EAAC,+BAAO,eAAc;AACxB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,WAAW,MAAM;AAAA,EACnB,CAAC;AACH;","names":["_a"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ensnode/ponder-metadata",
+  "version": "0.1.0",
+  "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"
+  ],
+  "exports": {
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "default": "./dist/middleware.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.39.3",
+    "parse-prometheus-text-format": "^1.1.1",
+    "viem": "^2.22.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@ensnode/shared-configs": "",
+    "@types/node": "^20.10.0",
+    "hono": "^4.6.14",
+    "ponder": "^0.9.18",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "peerDependencies": {
+    "hono": "^4.6.14",
+    "ponder": "^0.9.18"
+  },
+  "scripts": {
+    "prepublish": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "lint": "biome check --write",
+    "lint:ci": "biome ci"
+  },
+  "main": "./dist/middleware.js",
+  "module": "./dist/middleware.mjs",
+  "types": "./dist/middleware.d.ts"
+}