@ensnode/ponder-sdk 0.0.0-next-20260204111615

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 SDK
+
+This package is a utility library for interacting with Ponder apps and data.

package/dist/index.cjs

@@ -0,0 +1,125 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PonderClient: () => PonderClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/deserialize/indexing-status.ts
+var import_v43 = require("zod/v4");
+
+// src/blocks.ts
+var import_v42 = require("zod/v4");
+
+// src/numbers.ts
+var import_v4 = require("zod/v4");
+var numberSchema = import_v4.z.number({ error: `Value must be a number` });
+var integerSchema = numberSchema.int({ error: `Value must be an integer` });
+var nonnegativeNumberSchema = numberSchema.nonnegative({
+  error: `Value must be non-negative`
+});
+var positiveNumberSchema = numberSchema.positive({ error: `Value must be positive` });
+var nonnegativeIntegerSchema = integerSchema.nonnegative({
+  error: `Value must be a non-negative integer`
+});
+var positiveIntegerSchema = integerSchema.positive({
+  error: `Value must be a positive integer`
+});
+
+// src/time.ts
+var unixTimestampSchema = integerSchema;
+
+// src/blocks.ts
+var blockNumberSchema = nonnegativeIntegerSchema;
+var blockRefSchema = import_v42.z.object({
+  number: blockNumberSchema,
+  timestamp: unixTimestampSchema
+});
+
+// src/chains.ts
+var chainIdSchema = positiveIntegerSchema;
+
+// src/deserialize/indexing-status.ts
+var schemaSerializedChainName = import_v43.z.string();
+var schemaSerializedChainBlockRef = import_v43.z.object({
+  id: chainIdSchema,
+  block: blockRefSchema
+});
+function invariant_includesAtLeastOneIndexedChain(ctx) {
+  const records = ctx.value;
+  if (Object.keys(records).length === 0) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: "Ponder Indexing Status must include at least one indexed chain."
+    });
+  }
+}
+var schemaSerializedPonderIndexingStatus = import_v43.z.record(schemaSerializedChainName, schemaSerializedChainBlockRef).check(invariant_includesAtLeastOneIndexedChain);
+function buildPonderIndexingStatus(data) {
+  const chains = /* @__PURE__ */ new Map();
+  for (const [, chainData] of Object.entries(data)) {
+    chains.set(chainData.id, chainData.block);
+  }
+  return {
+    chains
+  };
+}
+function deserializePonderIndexingStatus(data) {
+  const validation = schemaSerializedPonderIndexingStatus.safeParse(data);
+  if (!validation.success) {
+    throw new Error(
+      `Invalid serialized Ponder Indexing Status: ${(0, import_v43.prettifyError)(validation.error)}`
+    );
+  }
+  return buildPonderIndexingStatus(validation.data);
+}
+
+// src/client.ts
+var PonderClient = class {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  /**
+   * Get Ponder Indexing Status
+   *
+   * @returns Ponder Indexing Status.
+   * @throws Error if the response could not be fetched or was invalid.
+   */
+  async status() {
+    const requestUrl = new URL("/status", this.baseUrl);
+    const response = await fetch(requestUrl);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch Ponder Indexing Status response: ${response.status} ${response.statusText}`
+      );
+    }
+    let responseData;
+    try {
+      responseData = await response.json();
+    } catch {
+      throw new Error("Failed to parse Ponder Indexing Status response as JSON");
+    }
+    return deserializePonderIndexingStatus(responseData);
+  }
+};
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/deserialize/indexing-status.ts","../src/blocks.ts","../src/numbers.ts","../src/time.ts","../src/chains.ts","../src/client.ts"],"sourcesContent":["export * from \"./client\";\n","/**\n * Ponder Indexing Status\n *\n * Defines the structure and validation for the Ponder Indexing Status response\n * from `GET /status` endpoint.\n * @see https://ponder.sh/docs/advanced/observability#indexing-status\n */\n\nimport { prettifyError, z } from \"zod/v4\";\nimport type { ParsePayload } from \"zod/v4/core\";\n\nimport type { BlockRef } from \"../blocks\";\nimport { blockRefSchema } from \"../blocks\";\nimport type { ChainId } from \"../chains\";\nimport { chainIdSchema } from \"../chains\";\nimport type { PonderIndexingStatus } from \"../indexing-status\";\n\nconst schemaSerializedChainName = z.string();\n\nconst schemaSerializedChainBlockRef = z.object({\n  id: chainIdSchema,\n  block: blockRefSchema,\n});\n\nfunction invariant_includesAtLeastOneIndexedChain(\n  ctx: ParsePayload<SerializedPonderIndexingStatus>,\n) {\n  const records = ctx.value;\n  if (Object.keys(records).length === 0) {\n    ctx.issues.push({\n      code: \"custom\",\n      input: ctx.value,\n      message: \"Ponder Indexing Status must include at least one indexed chain.\",\n    });\n  }\n}\n\n/**\n * Schema describing the response of fetching `GET /status` from a Ponder app.\n */\nconst schemaSerializedPonderIndexingStatus = z\n  .record(schemaSerializedChainName, schemaSerializedChainBlockRef)\n  .check(invariant_includesAtLeastOneIndexedChain);\n\n/**\n * Serialized Ponder Indexing Status.\n */\nexport type SerializedPonderIndexingStatus = z.infer<typeof schemaSerializedPonderIndexingStatus>;\n\n/**\n * Build Ponder Indexing Status\n *\n * @param data Validated serialized Ponder Indexing Status.\n * @returns Ponder Indexing Status.\n */\nfunction buildPonderIndexingStatus(data: SerializedPonderIndexingStatus): PonderIndexingStatus {\n  const chains = new Map<ChainId, BlockRef>();\n\n  for (const [, chainData] of Object.entries(data)) {\n    chains.set(chainData.id, chainData.block);\n  }\n\n  return {\n    chains,\n  };\n}\n\n/**\n * Deserialize and validate a Serialized Ponder Indexing Status.\n *\n * @param data Maybe a Serialized Ponder Indexing Status.\n * @returns Deserialized and validated Ponder Indexing Status.\n * @throws Error if data cannot be deserialized into a valid Ponder Indexing Status.\n */\nexport function deserializePonderIndexingStatus(\n  data: SerializedPonderIndexingStatus | unknown,\n): PonderIndexingStatus {\n  const validation = schemaSerializedPonderIndexingStatus.safeParse(data);\n\n  if (!validation.success) {\n    throw new Error(\n      `Invalid serialized Ponder Indexing Status: ${prettifyError(validation.error)}`,\n    );\n  }\n\n  return buildPonderIndexingStatus(validation.data);\n}\n","import { z } from \"zod/v4\";\n\nimport { nonnegativeIntegerSchema } from \"./numbers\";\nimport { unixTimestampSchema } from \"./time\";\n\n//// Block Number\n\nexport const blockNumberSchema = nonnegativeIntegerSchema;\n\n/**\n * Block Number\n *\n * Guaranteed to be a non-negative integer.\n */\nexport type BlockNumber = z.infer<typeof blockNumberSchema>;\n\nexport const blockRefSchema = z.object({\n  number: blockNumberSchema,\n  timestamp: unixTimestampSchema,\n});\n\n/**\n * BlockRef\n *\n * Reference to a block.\n */\nexport type BlockRef = z.infer<typeof blockRefSchema>;\n","import { z } from \"zod/v4\";\n\n// Numbers\n\n/**\n * Any finite number. Rejects non-finite numbers such as `NaN` and `Infinity`.\n */\nexport const numberSchema = z.number({ error: `Value must be a number` });\n\nexport const integerSchema = numberSchema.int({ error: `Value must be an integer` });\n\nexport const nonnegativeNumberSchema = numberSchema.nonnegative({\n  error: `Value must be non-negative`,\n});\n\nexport const positiveNumberSchema = numberSchema.positive({ error: `Value must be positive` });\n\nexport const nonnegativeIntegerSchema = integerSchema.nonnegative({\n  error: `Value must be a non-negative integer`,\n});\n\nexport const positiveIntegerSchema = integerSchema.positive({\n  error: `Value must be a positive integer`,\n});\n","import type { z } from \"zod/v4\";\n\nimport { integerSchema } from \"./numbers\";\n\n//// Unix Timestamp\nexport const unixTimestampSchema = integerSchema;\n\n/**\n * Unix timestamp value\n *\n * Represents the number of seconds that have elapsed\n * since January 1, 1970 (midnight UTC/GMT).\n *\n * Guaranteed to be an integer. May be zero or negative to represent a time at or\n * before Jan 1, 1970.\n */\nexport type UnixTimestamp = z.infer<typeof unixTimestampSchema>;\n","import type { z } from \"zod/v4\";\n\nimport { positiveIntegerSchema } from \"./numbers\";\n\n// Chain ID\n\nexport const chainIdSchema = positiveIntegerSchema;\n\n/**\n * Chain ID\n *\n * Represents a unique identifier for a chain.\n * Guaranteed to be a positive integer.\n *\n * Chain id standards are organized by the Ethereum Community @ https://github.com/ethereum-lists/chains\n **/\nexport type ChainId = z.infer<typeof chainIdSchema>;\n","import { deserializePonderIndexingStatus } from \"./deserialize/indexing-status\";\nimport type { PonderIndexingStatus } from \"./indexing-status\";\n\n/**\n * PonderClient for fetching data from Ponder apps.\n */\nexport class PonderClient {\n  constructor(private baseUrl: URL) {}\n\n  /**\n   * Get Ponder Indexing Status\n   *\n   * @returns Ponder Indexing Status.\n   * @throws Error if the response could not be fetched or was invalid.\n   */\n  async status(): Promise<PonderIndexingStatus> {\n    const requestUrl = new URL(\"/status\", this.baseUrl);\n    const response = await fetch(requestUrl);\n\n    if (!response.ok) {\n      throw new Error(\n        `Failed to fetch Ponder Indexing Status response: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    let responseData: unknown;\n\n    try {\n      responseData = await response.json();\n    } catch {\n      throw new Error(\"Failed to parse Ponder Indexing Status response as JSON\");\n    }\n\n    return deserializePonderIndexingStatus(responseData);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACQA,IAAAA,aAAiC;;;ACRjC,IAAAC,aAAkB;;;ACAlB,gBAAkB;AAOX,IAAM,eAAe,YAAE,OAAO,EAAE,OAAO,yBAAyB,CAAC;AAEjE,IAAM,gBAAgB,aAAa,IAAI,EAAE,OAAO,2BAA2B,CAAC;AAE5E,IAAM,0BAA0B,aAAa,YAAY;AAAA,EAC9D,OAAO;AACT,CAAC;AAEM,IAAM,uBAAuB,aAAa,SAAS,EAAE,OAAO,yBAAyB,CAAC;AAEtF,IAAM,2BAA2B,cAAc,YAAY;AAAA,EAChE,OAAO;AACT,CAAC;AAEM,IAAM,wBAAwB,cAAc,SAAS;AAAA,EAC1D,OAAO;AACT,CAAC;;;AClBM,IAAM,sBAAsB;;;AFE5B,IAAM,oBAAoB;AAS1B,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,QAAQ;AAAA,EACR,WAAW;AACb,CAAC;;;AGbM,IAAM,gBAAgB;;;AJW7B,IAAM,4BAA4B,aAAE,OAAO;AAE3C,IAAM,gCAAgC,aAAE,OAAO;AAAA,EAC7C,IAAI;AAAA,EACJ,OAAO;AACT,CAAC;AAED,SAAS,yCACP,KACA;AACA,QAAM,UAAU,IAAI;AACpB,MAAI,OAAO,KAAK,OAAO,EAAE,WAAW,GAAG;AACrC,QAAI,OAAO,KAAK;AAAA,MACd,MAAM;AAAA,MACN,OAAO,IAAI;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAKA,IAAM,uCAAuC,aAC1C,OAAO,2BAA2B,6BAA6B,EAC/D,MAAM,wCAAwC;AAajD,SAAS,0BAA0B,MAA4D;AAC7F,QAAM,SAAS,oBAAI,IAAuB;AAE1C,aAAW,CAAC,EAAE,SAAS,KAAK,OAAO,QAAQ,IAAI,GAAG;AAChD,WAAO,IAAI,UAAU,IAAI,UAAU,KAAK;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL;AAAA,EACF;AACF;AASO,SAAS,gCACd,MACsB;AACtB,QAAM,aAAa,qCAAqC,UAAU,IAAI;AAEtE,MAAI,CAAC,WAAW,SAAS;AACvB,UAAM,IAAI;AAAA,MACR,kDAA8C,0BAAc,WAAW,KAAK,CAAC;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO,0BAA0B,WAAW,IAAI;AAClD;;;AKhFO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,SAAc;AAAd;AAAA,EAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQnC,MAAM,SAAwC;AAC5C,UAAM,aAAa,IAAI,IAAI,WAAW,KAAK,OAAO;AAClD,UAAM,WAAW,MAAM,MAAM,UAAU;AAEvC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,oDAAoD,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MAC5F;AAAA,IACF;AAEA,QAAI;AAEJ,QAAI;AACF,qBAAe,MAAM,SAAS,KAAK;AAAA,IACrC,QAAQ;AACN,YAAM,IAAI,MAAM,yDAAyD;AAAA,IAC3E;AAEA,WAAO,gCAAgC,YAAY;AAAA,EACrD;AACF;","names":["import_v4","import_v4"]}

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+import { z } from 'zod/v4';
+
+declare const blockRefSchema: z.ZodObject<{
+    number: z.ZodNumber;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * BlockRef
+ *
+ * Reference to a block.
+ */
+type BlockRef = z.infer<typeof blockRefSchema>;
+
+declare const chainIdSchema: z.ZodNumber;
+/**
+ * Chain ID
+ *
+ * Represents a unique identifier for a chain.
+ * Guaranteed to be a positive integer.
+ *
+ * Chain id standards are organized by the Ethereum Community @ https://github.com/ethereum-lists/chains
+ **/
+type ChainId = z.infer<typeof chainIdSchema>;
+
+/**
+ * Ponder Indexing Status
+ *
+ * Represents the chain indexing status in a Ponder application.
+ */
+interface PonderIndexingStatus {
+    /**
+     * Map of indexed chain IDs to their block reference.
+     *
+     * Guarantees:
+     * - Includes entry for at least one indexed chain.
+     * - BlockRef corresponds to either:
+     *   - The first block to be indexed (when chain indexing is currently queued).
+     *   - The last indexed block (when chain indexing is currently in progress).
+     */
+    chains: Map<ChainId, BlockRef>;
+}
+
+/**
+ * PonderClient for fetching data from Ponder apps.
+ */
+declare class PonderClient {
+    private baseUrl;
+    constructor(baseUrl: URL);
+    /**
+     * Get Ponder Indexing Status
+     *
+     * @returns Ponder Indexing Status.
+     * @throws Error if the response could not be fetched or was invalid.
+     */
+    status(): Promise<PonderIndexingStatus>;
+}
+
+export { PonderClient };

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod/v4';
+
+declare const blockRefSchema: z.ZodObject<{
+    number: z.ZodNumber;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * BlockRef
+ *
+ * Reference to a block.
+ */
+type BlockRef = z.infer<typeof blockRefSchema>;
+
+declare const chainIdSchema: z.ZodNumber;
+/**
+ * Chain ID
+ *
+ * Represents a unique identifier for a chain.
+ * Guaranteed to be a positive integer.
+ *
+ * Chain id standards are organized by the Ethereum Community @ https://github.com/ethereum-lists/chains
+ **/
+type ChainId = z.infer<typeof chainIdSchema>;
+
+/**
+ * Ponder Indexing Status
+ *
+ * Represents the chain indexing status in a Ponder application.
+ */
+interface PonderIndexingStatus {
+    /**
+     * Map of indexed chain IDs to their block reference.
+     *
+     * Guarantees:
+     * - Includes entry for at least one indexed chain.
+     * - BlockRef corresponds to either:
+     *   - The first block to be indexed (when chain indexing is currently queued).
+     *   - The last indexed block (when chain indexing is currently in progress).
+     */
+    chains: Map<ChainId, BlockRef>;
+}
+
+/**
+ * PonderClient for fetching data from Ponder apps.
+ */
+declare class PonderClient {
+    private baseUrl;
+    constructor(baseUrl: URL);
+    /**
+     * Get Ponder Indexing Status
+     *
+     * @returns Ponder Indexing Status.
+     * @throws Error if the response could not be fetched or was invalid.
+     */
+    status(): Promise<PonderIndexingStatus>;
+}
+
+export { PonderClient };

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/deserialize/indexing-status.ts
+import { prettifyError, z as z3 } from "zod/v4";
+
+// src/blocks.ts
+import { z as z2 } from "zod/v4";
+
+// src/numbers.ts
+import { z } from "zod/v4";
+var numberSchema = z.number({ error: `Value must be a number` });
+var integerSchema = numberSchema.int({ error: `Value must be an integer` });
+var nonnegativeNumberSchema = numberSchema.nonnegative({
+  error: `Value must be non-negative`
+});
+var positiveNumberSchema = numberSchema.positive({ error: `Value must be positive` });
+var nonnegativeIntegerSchema = integerSchema.nonnegative({
+  error: `Value must be a non-negative integer`
+});
+var positiveIntegerSchema = integerSchema.positive({
+  error: `Value must be a positive integer`
+});
+
+// src/time.ts
+var unixTimestampSchema = integerSchema;
+
+// src/blocks.ts
+var blockNumberSchema = nonnegativeIntegerSchema;
+var blockRefSchema = z2.object({
+  number: blockNumberSchema,
+  timestamp: unixTimestampSchema
+});
+
+// src/chains.ts
+var chainIdSchema = positiveIntegerSchema;
+
+// src/deserialize/indexing-status.ts
+var schemaSerializedChainName = z3.string();
+var schemaSerializedChainBlockRef = z3.object({
+  id: chainIdSchema,
+  block: blockRefSchema
+});
+function invariant_includesAtLeastOneIndexedChain(ctx) {
+  const records = ctx.value;
+  if (Object.keys(records).length === 0) {
+    ctx.issues.push({
+      code: "custom",
+      input: ctx.value,
+      message: "Ponder Indexing Status must include at least one indexed chain."
+    });
+  }
+}
+var schemaSerializedPonderIndexingStatus = z3.record(schemaSerializedChainName, schemaSerializedChainBlockRef).check(invariant_includesAtLeastOneIndexedChain);
+function buildPonderIndexingStatus(data) {
+  const chains = /* @__PURE__ */ new Map();
+  for (const [, chainData] of Object.entries(data)) {
+    chains.set(chainData.id, chainData.block);
+  }
+  return {
+    chains
+  };
+}
+function deserializePonderIndexingStatus(data) {
+  const validation = schemaSerializedPonderIndexingStatus.safeParse(data);
+  if (!validation.success) {
+    throw new Error(
+      `Invalid serialized Ponder Indexing Status: ${prettifyError(validation.error)}`
+    );
+  }
+  return buildPonderIndexingStatus(validation.data);
+}
+
+// src/client.ts
+var PonderClient = class {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  /**
+   * Get Ponder Indexing Status
+   *
+   * @returns Ponder Indexing Status.
+   * @throws Error if the response could not be fetched or was invalid.
+   */
+  async status() {
+    const requestUrl = new URL("/status", this.baseUrl);
+    const response = await fetch(requestUrl);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch Ponder Indexing Status response: ${response.status} ${response.statusText}`
+      );
+    }
+    let responseData;
+    try {
+      responseData = await response.json();
+    } catch {
+      throw new Error("Failed to parse Ponder Indexing Status response as JSON");
+    }
+    return deserializePonderIndexingStatus(responseData);
+  }
+};
+export {
+  PonderClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deserialize/indexing-status.ts","../src/blocks.ts","../src/numbers.ts","../src/time.ts","../src/chains.ts","../src/client.ts"],"sourcesContent":["/**\n * Ponder Indexing Status\n *\n * Defines the structure and validation for the Ponder Indexing Status response\n * from `GET /status` endpoint.\n * @see https://ponder.sh/docs/advanced/observability#indexing-status\n */\n\nimport { prettifyError, z } from \"zod/v4\";\nimport type { ParsePayload } from \"zod/v4/core\";\n\nimport type { BlockRef } from \"../blocks\";\nimport { blockRefSchema } from \"../blocks\";\nimport type { ChainId } from \"../chains\";\nimport { chainIdSchema } from \"../chains\";\nimport type { PonderIndexingStatus } from \"../indexing-status\";\n\nconst schemaSerializedChainName = z.string();\n\nconst schemaSerializedChainBlockRef = z.object({\n  id: chainIdSchema,\n  block: blockRefSchema,\n});\n\nfunction invariant_includesAtLeastOneIndexedChain(\n  ctx: ParsePayload<SerializedPonderIndexingStatus>,\n) {\n  const records = ctx.value;\n  if (Object.keys(records).length === 0) {\n    ctx.issues.push({\n      code: \"custom\",\n      input: ctx.value,\n      message: \"Ponder Indexing Status must include at least one indexed chain.\",\n    });\n  }\n}\n\n/**\n * Schema describing the response of fetching `GET /status` from a Ponder app.\n */\nconst schemaSerializedPonderIndexingStatus = z\n  .record(schemaSerializedChainName, schemaSerializedChainBlockRef)\n  .check(invariant_includesAtLeastOneIndexedChain);\n\n/**\n * Serialized Ponder Indexing Status.\n */\nexport type SerializedPonderIndexingStatus = z.infer<typeof schemaSerializedPonderIndexingStatus>;\n\n/**\n * Build Ponder Indexing Status\n *\n * @param data Validated serialized Ponder Indexing Status.\n * @returns Ponder Indexing Status.\n */\nfunction buildPonderIndexingStatus(data: SerializedPonderIndexingStatus): PonderIndexingStatus {\n  const chains = new Map<ChainId, BlockRef>();\n\n  for (const [, chainData] of Object.entries(data)) {\n    chains.set(chainData.id, chainData.block);\n  }\n\n  return {\n    chains,\n  };\n}\n\n/**\n * Deserialize and validate a Serialized Ponder Indexing Status.\n *\n * @param data Maybe a Serialized Ponder Indexing Status.\n * @returns Deserialized and validated Ponder Indexing Status.\n * @throws Error if data cannot be deserialized into a valid Ponder Indexing Status.\n */\nexport function deserializePonderIndexingStatus(\n  data: SerializedPonderIndexingStatus | unknown,\n): PonderIndexingStatus {\n  const validation = schemaSerializedPonderIndexingStatus.safeParse(data);\n\n  if (!validation.success) {\n    throw new Error(\n      `Invalid serialized Ponder Indexing Status: ${prettifyError(validation.error)}`,\n    );\n  }\n\n  return buildPonderIndexingStatus(validation.data);\n}\n","import { z } from \"zod/v4\";\n\nimport { nonnegativeIntegerSchema } from \"./numbers\";\nimport { unixTimestampSchema } from \"./time\";\n\n//// Block Number\n\nexport const blockNumberSchema = nonnegativeIntegerSchema;\n\n/**\n * Block Number\n *\n * Guaranteed to be a non-negative integer.\n */\nexport type BlockNumber = z.infer<typeof blockNumberSchema>;\n\nexport const blockRefSchema = z.object({\n  number: blockNumberSchema,\n  timestamp: unixTimestampSchema,\n});\n\n/**\n * BlockRef\n *\n * Reference to a block.\n */\nexport type BlockRef = z.infer<typeof blockRefSchema>;\n","import { z } from \"zod/v4\";\n\n// Numbers\n\n/**\n * Any finite number. Rejects non-finite numbers such as `NaN` and `Infinity`.\n */\nexport const numberSchema = z.number({ error: `Value must be a number` });\n\nexport const integerSchema = numberSchema.int({ error: `Value must be an integer` });\n\nexport const nonnegativeNumberSchema = numberSchema.nonnegative({\n  error: `Value must be non-negative`,\n});\n\nexport const positiveNumberSchema = numberSchema.positive({ error: `Value must be positive` });\n\nexport const nonnegativeIntegerSchema = integerSchema.nonnegative({\n  error: `Value must be a non-negative integer`,\n});\n\nexport const positiveIntegerSchema = integerSchema.positive({\n  error: `Value must be a positive integer`,\n});\n","import type { z } from \"zod/v4\";\n\nimport { integerSchema } from \"./numbers\";\n\n//// Unix Timestamp\nexport const unixTimestampSchema = integerSchema;\n\n/**\n * Unix timestamp value\n *\n * Represents the number of seconds that have elapsed\n * since January 1, 1970 (midnight UTC/GMT).\n *\n * Guaranteed to be an integer. May be zero or negative to represent a time at or\n * before Jan 1, 1970.\n */\nexport type UnixTimestamp = z.infer<typeof unixTimestampSchema>;\n","import type { z } from \"zod/v4\";\n\nimport { positiveIntegerSchema } from \"./numbers\";\n\n// Chain ID\n\nexport const chainIdSchema = positiveIntegerSchema;\n\n/**\n * Chain ID\n *\n * Represents a unique identifier for a chain.\n * Guaranteed to be a positive integer.\n *\n * Chain id standards are organized by the Ethereum Community @ https://github.com/ethereum-lists/chains\n **/\nexport type ChainId = z.infer<typeof chainIdSchema>;\n","import { deserializePonderIndexingStatus } from \"./deserialize/indexing-status\";\nimport type { PonderIndexingStatus } from \"./indexing-status\";\n\n/**\n * PonderClient for fetching data from Ponder apps.\n */\nexport class PonderClient {\n  constructor(private baseUrl: URL) {}\n\n  /**\n   * Get Ponder Indexing Status\n   *\n   * @returns Ponder Indexing Status.\n   * @throws Error if the response could not be fetched or was invalid.\n   */\n  async status(): Promise<PonderIndexingStatus> {\n    const requestUrl = new URL(\"/status\", this.baseUrl);\n    const response = await fetch(requestUrl);\n\n    if (!response.ok) {\n      throw new Error(\n        `Failed to fetch Ponder Indexing Status response: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    let responseData: unknown;\n\n    try {\n      responseData = await response.json();\n    } catch {\n      throw new Error(\"Failed to parse Ponder Indexing Status response as JSON\");\n    }\n\n    return deserializePonderIndexingStatus(responseData);\n  }\n}\n"],"mappings":";AAQA,SAAS,eAAe,KAAAA,UAAS;;;ACRjC,SAAS,KAAAC,UAAS;;;ACAlB,SAAS,SAAS;AAOX,IAAM,eAAe,EAAE,OAAO,EAAE,OAAO,yBAAyB,CAAC;AAEjE,IAAM,gBAAgB,aAAa,IAAI,EAAE,OAAO,2BAA2B,CAAC;AAE5E,IAAM,0BAA0B,aAAa,YAAY;AAAA,EAC9D,OAAO;AACT,CAAC;AAEM,IAAM,uBAAuB,aAAa,SAAS,EAAE,OAAO,yBAAyB,CAAC;AAEtF,IAAM,2BAA2B,cAAc,YAAY;AAAA,EAChE,OAAO;AACT,CAAC;AAEM,IAAM,wBAAwB,cAAc,SAAS;AAAA,EAC1D,OAAO;AACT,CAAC;;;AClBM,IAAM,sBAAsB;;;AFE5B,IAAM,oBAAoB;AAS1B,IAAM,iBAAiBC,GAAE,OAAO;AAAA,EACrC,QAAQ;AAAA,EACR,WAAW;AACb,CAAC;;;AGbM,IAAM,gBAAgB;;;AJW7B,IAAM,4BAA4BC,GAAE,OAAO;AAE3C,IAAM,gCAAgCA,GAAE,OAAO;AAAA,EAC7C,IAAI;AAAA,EACJ,OAAO;AACT,CAAC;AAED,SAAS,yCACP,KACA;AACA,QAAM,UAAU,IAAI;AACpB,MAAI,OAAO,KAAK,OAAO,EAAE,WAAW,GAAG;AACrC,QAAI,OAAO,KAAK;AAAA,MACd,MAAM;AAAA,MACN,OAAO,IAAI;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAKA,IAAM,uCAAuCA,GAC1C,OAAO,2BAA2B,6BAA6B,EAC/D,MAAM,wCAAwC;AAajD,SAAS,0BAA0B,MAA4D;AAC7F,QAAM,SAAS,oBAAI,IAAuB;AAE1C,aAAW,CAAC,EAAE,SAAS,KAAK,OAAO,QAAQ,IAAI,GAAG;AAChD,WAAO,IAAI,UAAU,IAAI,UAAU,KAAK;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL;AAAA,EACF;AACF;AASO,SAAS,gCACd,MACsB;AACtB,QAAM,aAAa,qCAAqC,UAAU,IAAI;AAEtE,MAAI,CAAC,WAAW,SAAS;AACvB,UAAM,IAAI;AAAA,MACR,8CAA8C,cAAc,WAAW,KAAK,CAAC;AAAA,IAC/E;AAAA,EACF;AAEA,SAAO,0BAA0B,WAAW,IAAI;AAClD;;;AKhFO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,SAAc;AAAd;AAAA,EAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQnC,MAAM,SAAwC;AAC5C,UAAM,aAAa,IAAI,IAAI,WAAW,KAAK,OAAO;AAClD,UAAM,WAAW,MAAM,MAAM,UAAU;AAEvC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,oDAAoD,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MAC5F;AAAA,IACF;AAEA,QAAI;AAEJ,QAAI;AACF,qBAAe,MAAM,SAAS,KAAK;AAAA,IACrC,QAAQ;AACN,YAAM,IAAI,MAAM,yDAAyD;AAAA,IAC3E;AAEA,WAAO,gCAAgC,YAAY;AAAA,EACrD;AACF;","names":["z","z","z","z"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ensnode/ponder-sdk",
+  "version": "0.0.0-next-20260204111615",
+  "type": "module",
+  "description": "A utility library for interacting with Ponder apps and data.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/namehash/ensnode.git",
+    "directory": "packages/ponder-sdk"
+  },
+  "homepage": "https://github.com/namehash/ensnode/tree/main/packages/ponder-sdk",
+  "keywords": [
+    "ENSNode",
+    "Ponder"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.9",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.2",
+    "zod": "^4.3.6",
+    "@ensnode/shared-configs": "0.0.0-next-20260204111615"
+  },
+  "peerDependencies": {
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "prepublish": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "lint": "biome check --write .",
+    "lint:ci": "biome ci"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}