@umbra-privacy/indexer-read-service-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Umbra Privacy
+
+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,108 @@
+# @umbra-privacy/indexer-read-service-client
+
+TypeScript HTTP client for the Umbra Indexer Read Service. Provides typed methods for querying UTXO data, Merkle proofs, tree metadata, and health status from the Umbra indexer.
+
+## Installation
+
+```bash
+pnpm add @umbra-privacy/indexer-read-service-client
+```
+
+## Usage
+
+```typescript
+import { ReadServiceClient } from "@umbra-privacy/indexer-read-service-client";
+
+const client = new ReadServiceClient({
+  endpoint: "https://acqzie0a1h.execute-api.eu-central-1.amazonaws.com",
+});
+
+// Health checks
+const health = await client.health();
+const detailed = await client.healthDetailed();
+const liveness = await client.liveness();
+const readiness = await client.readiness();
+
+// Global stats
+const stats = await client.getStats();
+
+// Tree metadata
+const treeInfo = await client.getTreeInfo(0);
+
+// Merkle proofs
+const proof = await client.getProof(0, 42);
+
+// UTXO queries
+const utxos = await client.getUtxoData({ start: 0, limit: 100 });
+const single = await client.getUtxo(42);
+const treeUtxos = await client.getTreeUtxos(0, { cursor: 0, limit: 50 });
+
+// Columnar format (better compression for large datasets)
+const columnar = await client.getUtxoDataColumnar({ start: 0, limit: 1000 });
+
+// Auto-paginated fetch
+const allUtxos = await client.getAllUtxoData(0);
+```
+
+## API
+
+### `ReadServiceClient`
+
+**Constructor**
+
+- `new ReadServiceClient({ endpoint, fetch? })` — Create a client. Optionally provide a custom `fetch` implementation.
+
+**Health**
+
+- `health()` — Basic health check
+- `healthDetailed()` — Detailed health with version, uptime, and storage status
+- `liveness()` — Kubernetes-style liveness probe
+- `readiness()` — Kubernetes-style readiness probe
+
+**Stats & Trees**
+
+- `getStats()` — Global UTXO count and latest index
+- `getTreeInfo(treeIndex)` — Merkle tree metadata (root, leaf count)
+
+**Proofs**
+
+- `getProof(treeIndex, insertionIndex)` — Merkle inclusion proof for a specific leaf
+
+**UTXOs**
+
+- `getUtxoData(params?)` — Paginated UTXO query by absolute index range
+- `getUtxoDataColumnar(params?)` — Same query in columnar layout for better compression
+- `getUtxo(absoluteIndex)` — Single UTXO by absolute index (returns `null` on 404)
+- `getTreeUtxos(treeIndex, params?)` — UTXOs scoped to a specific tree
+- `getAllUtxoData(start?, end?, pageSize?)` — Auto-paginated fetch of all UTXOs
+
+### Error Handling
+
+All methods throw `IndexerReadError` on failure:
+
+```typescript
+import { IndexerReadError } from "@umbra-privacy/indexer-read-service-client";
+
+try {
+  await client.getUtxo(999999);
+} catch (err) {
+  if (err instanceof IndexerReadError) {
+    console.log(err.operation);  // "getUtxo"
+    console.log(err.statusCode); // 404, 500, etc.
+    console.log(err.message);
+  }
+}
+```
+
+## Transport
+
+All responses are protobuf-encoded (`application/protobuf`). The client handles deserialization automatically using `@umbra-privacy/indexer-proto-gen` schemas.
+
+## Dependencies
+
+- `@bufbuild/protobuf` ^2.0.0
+- `@umbra-privacy/indexer-proto-gen`
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,428 @@
+'use strict';
+
+var indexerProtoGen = require('@umbra-privacy/indexer-proto-gen');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/errors.ts
+var IndexerReadError = class extends Error {
+  static {
+    __name(this, "IndexerReadError");
+  }
+  operation;
+  statusCode;
+  constructor(operation, message, statusCode, cause) {
+    super(`Read service '${operation}' failed: ${message}`);
+    this.name = "IndexerReadError";
+    this.operation = operation;
+    this.statusCode = statusCode;
+    this.cause = cause;
+  }
+};
+
+// src/client.ts
+var ACCEPT_PROTOBUF = "application/protobuf";
+var ReadServiceClient = class {
+  static {
+    __name(this, "ReadServiceClient");
+  }
+  endpoint;
+  fetchFn;
+  constructor(config) {
+    this.endpoint = config.endpoint.replace(/\/+$/, "");
+    this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  // ===========================================================================
+  // Health
+  // ===========================================================================
+  async health() {
+    return this.get(
+      "/health",
+      "health",
+      indexerProtoGen.BasicHealthResponseSchema,
+      protoToBasicHealth
+    );
+  }
+  async healthDetailed() {
+    return this.get(
+      "/health/detailed",
+      "healthDetailed",
+      indexerProtoGen.DetailedHealthResponseSchema,
+      protoToDetailedHealth
+    );
+  }
+  async liveness() {
+    return this.get(
+      "/health/liveness",
+      "liveness",
+      indexerProtoGen.LivenessResponseSchema,
+      protoToLiveness
+    );
+  }
+  async readiness() {
+    return this.get(
+      "/health/readiness",
+      "readiness",
+      indexerProtoGen.ReadinessResponseSchema,
+      protoToReadiness
+    );
+  }
+  // ===========================================================================
+  // Stats
+  // ===========================================================================
+  /** Get global UTXO statistics. */
+  async getStats() {
+    return this.get(
+      "/v1/stats",
+      "getStats",
+      indexerProtoGen.StatsResponseSchema,
+      protoToStatsResponse
+    );
+  }
+  // ===========================================================================
+  // Tree Info
+  // ===========================================================================
+  /**
+   * Get metadata for a specific Merkle tree.
+   *
+   * @param treeIndex - The Merkle tree index.
+   */
+  async getTreeInfo(treeIndex) {
+    return this.get(
+      `/v1/trees/${treeIndex}`,
+      "getTreeInfo",
+      indexerProtoGen.TreeInfoResponseSchema,
+      protoToTreeInfoResponse
+    );
+  }
+  // ===========================================================================
+  // Merkle Proof
+  // ===========================================================================
+  /**
+   * Get a Merkle proof for a specific leaf in a tree.
+   *
+   * @param treeIndex - The Merkle tree index.
+   * @param insertionIndex - The leaf index within the tree.
+   */
+  async getProof(treeIndex, insertionIndex) {
+    return this.get(
+      `/v1/trees/${treeIndex}/proof/${insertionIndex}`,
+      "getProof",
+      indexerProtoGen.ProofResponseSchema,
+      protoToProofResponse
+    );
+  }
+  // ===========================================================================
+  // UTXO Data
+  // ===========================================================================
+  /**
+   * Fetch UTXO data by absolute index range with pagination.
+   *
+   * @param params - Query parameters (start, end, limit — all optional).
+   */
+  async getUtxoData(params = {}) {
+    const query = buildQuery(params);
+    return this.get(
+      `/v1/utxos${query}`,
+      "getUtxoData",
+      indexerProtoGen.UtxoResponseSchema,
+      protoToUtxoResponse
+    );
+  }
+  /**
+   * Fetch UTXO data in columnar layout for maximum compression.
+   *
+   * Sends `X-Response-Layout: columnar` header. Data is transposed into
+   * column arrays instead of row arrays for better compression ratios.
+   *
+   * @param params - Query parameters (start, end, limit — all optional).
+   */
+  async getUtxoDataColumnar(params = {}) {
+    const query = buildQuery(params);
+    return this.get(
+      `/v1/utxos${query}`,
+      "getUtxoDataColumnar",
+      indexerProtoGen.UtxoColumnarResponseSchema,
+      protoToUtxoColumnarResponse,
+      { "X-Response-Layout": "columnar" }
+    );
+  }
+  /**
+   * Fetch a single UTXO by its absolute index.
+   *
+   * Returns `null` if the UTXO does not exist (404).
+   *
+   * @param absoluteIndex - The global absolute index across all trees.
+   */
+  async getUtxo(absoluteIndex) {
+    try {
+      const proto = await this.get(
+        `/v1/utxos/${absoluteIndex}`,
+        "getUtxo",
+        indexerProtoGen.SingleUtxoResponseSchema,
+        (p) => p
+      );
+      return proto.utxo ? protoUtxoItemToJson(proto.utxo) : null;
+    } catch (err) {
+      if (err instanceof IndexerReadError && err.statusCode === 404) {
+        return null;
+      }
+      throw err;
+    }
+  }
+  /**
+   * Fetch UTXOs scoped to a specific Merkle tree with pagination.
+   *
+   * @param treeIndex - The Merkle tree index.
+   * @param params - Pagination params (cursor = absolute_index, limit optional).
+   */
+  async getTreeUtxos(treeIndex, params = {}) {
+    const parts = [];
+    if (params.cursor !== void 0) parts.push(`cursor=${params.cursor}`);
+    if (params.limit !== void 0) parts.push(`limit=${params.limit}`);
+    const query = parts.length > 0 ? `?${parts.join("&")}` : "";
+    return this.get(
+      `/v1/trees/${treeIndex}/utxos${query}`,
+      "getTreeUtxos",
+      indexerProtoGen.UtxoResponseSchema,
+      protoToUtxoResponse
+    );
+  }
+  /**
+   * Fetch all UTXO data with automatic pagination.
+   *
+   * Iterates through all pages starting from `start` up to an optional `end`.
+   *
+   * @param start - Starting absolute index (default: 0).
+   * @param end - Optional ending absolute index (inclusive). Omit to fetch everything.
+   * @param pageSize - Records per page (default: 1000, max: 5000).
+   */
+  async getAllUtxoData(start = 0, end, pageSize = 1e3) {
+    const allItems = [];
+    let cursor = start;
+    while (true) {
+      const response = await this.getUtxoData({ start: cursor, end, limit: pageSize });
+      allItems.push(...response.items);
+      if (!response.has_more || response.next_cursor === null) {
+        break;
+      }
+      cursor = response.next_cursor;
+    }
+    return allItems;
+  }
+  // ===========================================================================
+  // Internal helpers
+  // ===========================================================================
+  async get(path, operation, protoSchema, protoToJson, extraHeaders) {
+    const url = `${this.endpoint}${path}`;
+    let response;
+    try {
+      response = await this.fetchFn(url, {
+        method: "GET",
+        headers: { Accept: ACCEPT_PROTOBUF, ...extraHeaders }
+      });
+    } catch (err) {
+      throw new IndexerReadError(operation, `Network error: ${err}`, void 0, err);
+    }
+    return this.handleResponse(response, operation, protoSchema, protoToJson);
+  }
+  async handleResponse(response, operation, protoSchema, protoToJson) {
+    if (!response.ok) {
+      let errorMessage;
+      try {
+        const errorBody = await response.text();
+        errorMessage = errorBody || response.statusText;
+      } catch {
+        errorMessage = response.statusText;
+      }
+      throw new IndexerReadError(operation, errorMessage, response.status);
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("protobuf")) {
+      try {
+        const buffer = await response.arrayBuffer();
+        const proto = indexerProtoGen.fromBinary(protoSchema, new Uint8Array(buffer));
+        return protoToJson(proto);
+      } catch (err) {
+        throw new IndexerReadError(
+          operation,
+          `Failed to decode protobuf response: ${err}`,
+          response.status,
+          err
+        );
+      }
+    }
+    try {
+      return await response.json();
+    } catch (err) {
+      throw new IndexerReadError(
+        operation,
+        `Failed to parse response: ${err}`,
+        response.status,
+        err
+      );
+    }
+  }
+};
+function buildQuery(params) {
+  const parts = [];
+  if (params.start !== void 0) parts.push(`start=${params.start}`);
+  if (params.end !== void 0) parts.push(`end=${params.end}`);
+  if (params.limit !== void 0) parts.push(`limit=${params.limit}`);
+  return parts.length > 0 ? `?${parts.join("&")}` : "";
+}
+__name(buildQuery, "buildQuery");
+function bytesToBase64(bytes) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+__name(bytesToBase64, "bytesToBase64");
+function protoToBasicHealth(p) {
+  return { status: p.status };
+}
+__name(protoToBasicHealth, "protoToBasicHealth");
+function protoToDetailedHealth(p) {
+  return {
+    status: p.status,
+    version: p.version,
+    timestamp: p.timestamp,
+    uptime_seconds: Number(p.uptimeSeconds),
+    storage: p.storage ? { status: p.storage.status, connected: p.storage.connected } : { status: "unknown", connected: false }
+  };
+}
+__name(protoToDetailedHealth, "protoToDetailedHealth");
+function protoToLiveness(p) {
+  return { alive: p.alive };
+}
+__name(protoToLiveness, "protoToLiveness");
+function protoToReadiness(p) {
+  return { ready: p.ready, storage: p.storage };
+}
+__name(protoToReadiness, "protoToReadiness");
+function protoToStatsResponse(p) {
+  return {
+    total_utxos: Number(p.totalUtxos),
+    latest_absolute_index: p.latestAbsoluteIndex !== void 0 ? Number(p.latestAbsoluteIndex) : null
+  };
+}
+__name(protoToStatsResponse, "protoToStatsResponse");
+function protoToTreeInfoResponse(p) {
+  return {
+    tree_index: Number(p.treeIndex),
+    num_leaves: Number(p.numLeaves),
+    root: bytesToBase64(p.root),
+    utxo_count: Number(p.utxoCount)
+  };
+}
+__name(protoToTreeInfoResponse, "protoToTreeInfoResponse");
+function protoToProofResponse(p) {
+  return {
+    root: bytesToBase64(p.root),
+    tree_index: Number(p.treeIndex),
+    insertion_index: Number(p.insertionIndex),
+    proof: p.proof.map(bytesToBase64),
+    leaf: bytesToBase64(p.leaf)
+  };
+}
+__name(protoToProofResponse, "protoToProofResponse");
+function protoUtxoItemToJson(item) {
+  return {
+    absolute_index: Number(item.absoluteIndex),
+    tree_index: Number(item.treeIndex),
+    insertion_index: Number(item.insertionIndex),
+    final_commitment: bytesToBase64(item.finalCommitment),
+    h1_version: readU128LE(item.h1Version),
+    h1_commitment_index: readU128LE(item.h1CommitmentIndex),
+    h1_sender_address: bytesToBase64(item.h1SenderAddress),
+    h1_mint_address: bytesToBase64(item.h1MintAddress),
+    h1_relayer_fixed_sol_fees: Number(item.h1RelayerFixedSolFees),
+    h1_year: item.h1Year,
+    h1_month: item.h1Month,
+    h1_day: item.h1Day,
+    h1_hour: item.h1Hour,
+    h1_minute: item.h1Minute,
+    h1_second: item.h1Second,
+    h1_purpose: item.h1Purpose,
+    h1_circuit_provable_hash: bytesToBase64(item.h1CircuitProvableHash),
+    h1_smart_program_provable_hash: bytesToBase64(item.h1SmartProgramProvableHash),
+    h1_hash: bytesToBase64(item.h1Hash),
+    h2_hash: bytesToBase64(item.h2Hash),
+    aes_encrypted_data: bytesToBase64(item.aesEncryptedData),
+    depositor_x25519_public_key: bytesToBase64(item.depositorX25519PublicKey),
+    timestamp: Number(item.timestamp),
+    slot: Number(item.slot),
+    event_type: item.eventType
+  };
+}
+__name(protoUtxoItemToJson, "protoUtxoItemToJson");
+function readU128LE(bytes) {
+  if (bytes.length < 16) return "0";
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const lo = view.getBigUint64(0, true);
+  const hi = view.getBigUint64(8, true);
+  const value = hi << 64n | lo;
+  return value.toString();
+}
+__name(readU128LE, "readU128LE");
+function protoToUtxoResponse(p) {
+  return {
+    items: p.items.map(protoUtxoItemToJson),
+    has_more: p.hasMore,
+    next_cursor: p.nextCursor !== void 0 ? Number(p.nextCursor) : null,
+    total_count: Number(p.totalCount),
+    start_index: Number(p.startIndex),
+    end_index: p.endIndex !== void 0 ? Number(p.endIndex) : null
+  };
+}
+__name(protoToUtxoResponse, "protoToUtxoResponse");
+function protoToUtxoColumnarResponse(p) {
+  const cols = p.columns;
+  return {
+    columns: cols ? {
+      absolute_index: cols.absoluteIndex.map(Number),
+      tree_index: cols.treeIndex.map(Number),
+      insertion_index: cols.insertionIndex.map(Number),
+      final_commitment: cols.finalCommitment.map(bytesToBase64),
+      h1_version: cols.h1Version.map(bytesToBase64),
+      h1_commitment_index: cols.h1CommitmentIndex.map(bytesToBase64),
+      h1_sender_address: cols.h1SenderAddress.map(bytesToBase64),
+      h1_mint_address: cols.h1MintAddress.map(bytesToBase64),
+      h1_relayer_fixed_sol_fees: cols.h1RelayerFixedSolFees.map(Number),
+      h1_year: cols.h1Year.slice(),
+      h1_month: cols.h1Month.slice(),
+      h1_day: cols.h1Day.slice(),
+      h1_hour: cols.h1Hour.slice(),
+      h1_minute: cols.h1Minute.slice(),
+      h1_second: cols.h1Second.slice(),
+      h1_purpose: cols.h1Purpose.slice(),
+      h1_circuit_provable_hash: cols.h1CircuitProvableHash.map(bytesToBase64),
+      h1_smart_program_provable_hash: cols.h1SmartProgramProvableHash.map(bytesToBase64),
+      h1_hash: cols.h1Hash.map(bytesToBase64),
+      h2_hash: cols.h2Hash.map(bytesToBase64),
+      aes_encrypted_data: cols.aesEncryptedData.map(bytesToBase64),
+      depositor_x25519_public_key: cols.depositorX25519PublicKey.map(bytesToBase64),
+      timestamp: cols.timestamp.map(Number),
+      slot: cols.slot.map(Number),
+      event_type: cols.eventType.slice()
+    } : null,
+    count: p.count,
+    has_more: p.hasMore,
+    next_cursor: p.nextCursor !== void 0 ? Number(p.nextCursor) : null,
+    total_count: Number(p.totalCount),
+    start_index: Number(p.startIndex),
+    end_index: p.endIndex !== void 0 ? Number(p.endIndex) : null
+  };
+}
+__name(protoToUtxoColumnarResponse, "protoToUtxoColumnarResponse");
+
+exports.IndexerReadError = IndexerReadError;
+exports.ReadServiceClient = ReadServiceClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":["BasicHealthResponseSchema","DetailedHealthResponseSchema","LivenessResponseSchema","ReadinessResponseSchema","StatsResponseSchema","TreeInfoResponseSchema","ProofResponseSchema","UtxoResponseSchema","UtxoColumnarResponseSchema","SingleUtxoResponseSchema","fromBinary"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error class for Indexer Read Service client operations.\n */\nexport class IndexerReadError extends Error {\n  public readonly operation: string;\n  public readonly statusCode: number | undefined;\n\n  constructor(operation: string, message: string, statusCode?: number, cause?: Error) {\n    super(`Read service '${operation}' failed: ${message}`);\n    this.name = \"IndexerReadError\";\n    this.operation = operation;\n    this.statusCode = statusCode;\n    this.cause = cause;\n  }\n}\n","/**\n * ReadServiceClient — typed HTTP client for the Umbra Indexer Read Service.\n *\n * All responses are protobuf-encoded binary.\n *\n * @example\n * ```typescript\n * const client = new ReadServiceClient({ endpoint: \"http://localhost:8082\" });\n * const stats = await client.getStats();\n * const proof = await client.getProof(0, 42);\n * const utxos = await client.getUtxoData({ start: 0, limit: 100 });\n * ```\n */\n\nimport {\n  fromBinary,\n  type BasicHealthResponse as ProtoBasicHealth,\n  BasicHealthResponseSchema,\n  type DetailedHealthResponse as ProtoDetailedHealth,\n  DetailedHealthResponseSchema,\n  type LivenessResponse as ProtoLiveness,\n  LivenessResponseSchema,\n  type ReadinessResponse as ProtoReadiness,\n  ReadinessResponseSchema,\n  type ProofResponse as ProtoProof,\n  ProofResponseSchema,\n  type UtxoResponse as ProtoUtxo,\n  UtxoResponseSchema,\n  type UtxoColumnarResponse as ProtoUtxoColumnar,\n  UtxoColumnarResponseSchema,\n  type StatsResponse as ProtoStats,\n  StatsResponseSchema,\n  type TreeInfoResponse as ProtoTreeInfo,\n  TreeInfoResponseSchema,\n  type SingleUtxoResponse as ProtoSingleUtxo,\n  SingleUtxoResponseSchema,\n} from \"@umbra-privacy/indexer-proto-gen\";\nimport type { GenMessage } from \"@bufbuild/protobuf/codegenv2\";\nimport type { Message } from \"@bufbuild/protobuf\";\n\nimport { IndexerReadError } from \"./errors.js\";\nimport type {\n  BasicHealthResponse,\n  DetailedHealthResponse,\n  LivenessResponse,\n  ProofResponse,\n  ReadServiceClientConfig,\n  ReadinessResponse,\n  StatsResponse,\n  TreeInfoResponse,\n  UtxoColumnarResponse,\n  UtxoDataResponse,\n  UtxoRequest,\n  UtxoResponse,\n} from \"./types.js\";\n\nconst ACCEPT_PROTOBUF = \"application/protobuf\";\n\nexport class ReadServiceClient {\n  private readonly endpoint: string;\n  private readonly fetchFn: typeof globalThis.fetch;\n\n  constructor(config: ReadServiceClientConfig) {\n    this.endpoint = config.endpoint.replace(/\\/+$/, \"\");\n    this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  // ===========================================================================\n  // Health\n  // ===========================================================================\n\n  async health(): Promise<BasicHealthResponse> {\n    return this.get<BasicHealthResponse, ProtoBasicHealth>(\n      \"/health\",\n      \"health\",\n      BasicHealthResponseSchema,\n      protoToBasicHealth,\n    );\n  }\n\n  async healthDetailed(): Promise<DetailedHealthResponse> {\n    return this.get<DetailedHealthResponse, ProtoDetailedHealth>(\n      \"/health/detailed\",\n      \"healthDetailed\",\n      DetailedHealthResponseSchema,\n      protoToDetailedHealth,\n    );\n  }\n\n  async liveness(): Promise<LivenessResponse> {\n    return this.get<LivenessResponse, ProtoLiveness>(\n      \"/health/liveness\",\n      \"liveness\",\n      LivenessResponseSchema,\n      protoToLiveness,\n    );\n  }\n\n  async readiness(): Promise<ReadinessResponse> {\n    return this.get<ReadinessResponse, ProtoReadiness>(\n      \"/health/readiness\",\n      \"readiness\",\n      ReadinessResponseSchema,\n      protoToReadiness,\n    );\n  }\n\n  // ===========================================================================\n  // Stats\n  // ===========================================================================\n\n  /** Get global UTXO statistics. */\n  async getStats(): Promise<StatsResponse> {\n    return this.get<StatsResponse, ProtoStats>(\n      \"/v1/stats\",\n      \"getStats\",\n      StatsResponseSchema,\n      protoToStatsResponse,\n    );\n  }\n\n  // ===========================================================================\n  // Tree Info\n  // ===========================================================================\n\n  /**\n   * Get metadata for a specific Merkle tree.\n   *\n   * @param treeIndex - The Merkle tree index.\n   */\n  async getTreeInfo(treeIndex: number): Promise<TreeInfoResponse> {\n    return this.get<TreeInfoResponse, ProtoTreeInfo>(\n      `/v1/trees/${treeIndex}`,\n      \"getTreeInfo\",\n      TreeInfoResponseSchema,\n      protoToTreeInfoResponse,\n    );\n  }\n\n  // ===========================================================================\n  // Merkle Proof\n  // ===========================================================================\n\n  /**\n   * Get a Merkle proof for a specific leaf in a tree.\n   *\n   * @param treeIndex - The Merkle tree index.\n   * @param insertionIndex - The leaf index within the tree.\n   */\n  async getProof(treeIndex: number, insertionIndex: number): Promise<ProofResponse> {\n    return this.get<ProofResponse, ProtoProof>(\n      `/v1/trees/${treeIndex}/proof/${insertionIndex}`,\n      \"getProof\",\n      ProofResponseSchema,\n      protoToProofResponse,\n    );\n  }\n\n  // ===========================================================================\n  // UTXO Data\n  // ===========================================================================\n\n  /**\n   * Fetch UTXO data by absolute index range with pagination.\n   *\n   * @param params - Query parameters (start, end, limit — all optional).\n   */\n  async getUtxoData(params: UtxoRequest = {}): Promise<UtxoResponse> {\n    const query = buildQuery(params);\n    return this.get<UtxoResponse, ProtoUtxo>(\n      `/v1/utxos${query}`,\n      \"getUtxoData\",\n      UtxoResponseSchema,\n      protoToUtxoResponse,\n    );\n  }\n\n  /**\n   * Fetch UTXO data in columnar layout for maximum compression.\n   *\n   * Sends `X-Response-Layout: columnar` header. Data is transposed into\n   * column arrays instead of row arrays for better compression ratios.\n   *\n   * @param params - Query parameters (start, end, limit — all optional).\n   */\n  async getUtxoDataColumnar(params: UtxoRequest = {}): Promise<UtxoColumnarResponse> {\n    const query = buildQuery(params);\n    return this.get<UtxoColumnarResponse, ProtoUtxoColumnar>(\n      `/v1/utxos${query}`,\n      \"getUtxoDataColumnar\",\n      UtxoColumnarResponseSchema,\n      protoToUtxoColumnarResponse,\n      { \"X-Response-Layout\": \"columnar\" },\n    );\n  }\n\n  /**\n   * Fetch a single UTXO by its absolute index.\n   *\n   * Returns `null` if the UTXO does not exist (404).\n   *\n   * @param absoluteIndex - The global absolute index across all trees.\n   */\n  async getUtxo(absoluteIndex: number): Promise<UtxoDataResponse | null> {\n    try {\n      const proto = await this.get<ProtoSingleUtxo, ProtoSingleUtxo>(\n        `/v1/utxos/${absoluteIndex}`,\n        \"getUtxo\",\n        SingleUtxoResponseSchema,\n        (p) => p,\n      );\n      return proto.utxo ? protoUtxoItemToJson(proto.utxo) : null;\n    } catch (err) {\n      if (err instanceof IndexerReadError && err.statusCode === 404) {\n        return null;\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Fetch UTXOs scoped to a specific Merkle tree with pagination.\n   *\n   * @param treeIndex - The Merkle tree index.\n   * @param params - Pagination params (cursor = absolute_index, limit optional).\n   */\n  async getTreeUtxos(\n    treeIndex: number,\n    params: { cursor?: number; limit?: number } = {},\n  ): Promise<UtxoResponse> {\n    const parts: string[] = [];\n    if (params.cursor !== undefined) parts.push(`cursor=${params.cursor}`);\n    if (params.limit !== undefined) parts.push(`limit=${params.limit}`);\n    const query = parts.length > 0 ? `?${parts.join(\"&\")}` : \"\";\n    return this.get<UtxoResponse, ProtoUtxo>(\n      `/v1/trees/${treeIndex}/utxos${query}`,\n      \"getTreeUtxos\",\n      UtxoResponseSchema,\n      protoToUtxoResponse,\n    );\n  }\n\n  /**\n   * Fetch all UTXO data with automatic pagination.\n   *\n   * Iterates through all pages starting from `start` up to an optional `end`.\n   *\n   * @param start - Starting absolute index (default: 0).\n   * @param end - Optional ending absolute index (inclusive). Omit to fetch everything.\n   * @param pageSize - Records per page (default: 1000, max: 5000).\n   */\n  async getAllUtxoData(\n    start: number = 0,\n    end?: number,\n    pageSize: number = 1000,\n  ): Promise<UtxoDataResponse[]> {\n    const allItems: UtxoDataResponse[] = [];\n    let cursor = start;\n\n    while (true) {\n      const response = await this.getUtxoData({ start: cursor, end, limit: pageSize });\n\n      allItems.push(...response.items);\n\n      if (!response.has_more || response.next_cursor === null) {\n        break;\n      }\n\n      cursor = response.next_cursor;\n    }\n\n    return allItems;\n  }\n\n  // ===========================================================================\n  // Internal helpers\n  // ===========================================================================\n\n  protected async get<T, P extends Message>(\n    path: string,\n    operation: string,\n    protoSchema: GenMessage<P>,\n    protoToJson: (proto: P) => T,\n    extraHeaders?: Record<string, string>,\n  ): Promise<T> {\n    const url = `${this.endpoint}${path}`;\n\n    let response: Response;\n    try {\n      response = await this.fetchFn(url, {\n        method: \"GET\",\n        headers: { Accept: ACCEPT_PROTOBUF, ...extraHeaders },\n      });\n    } catch (err) {\n      throw new IndexerReadError(operation, `Network error: ${err}`, undefined, err as Error);\n    }\n\n    return this.handleResponse<T, P>(response, operation, protoSchema, protoToJson);\n  }\n\n  protected async handleResponse<T, P extends Message>(\n    response: Response,\n    operation: string,\n    protoSchema: GenMessage<P>,\n    protoToJson: (proto: P) => T,\n  ): Promise<T> {\n    if (!response.ok) {\n      let errorMessage: string;\n      try {\n        const errorBody = await response.text();\n        errorMessage = errorBody || response.statusText;\n      } catch {\n        errorMessage = response.statusText;\n      }\n      throw new IndexerReadError(operation, errorMessage, response.status);\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n    if (contentType.includes(\"protobuf\")) {\n      try {\n        const buffer = await response.arrayBuffer();\n        const proto = fromBinary(protoSchema, new Uint8Array(buffer));\n        return protoToJson(proto);\n      } catch (err) {\n        throw new IndexerReadError(\n          operation,\n          `Failed to decode protobuf response: ${err}`,\n          response.status,\n          err as Error,\n        );\n      }\n    }\n\n    // Fallback to JSON (e.g. error responses)\n    try {\n      return (await response.json()) as T;\n    } catch (err) {\n      throw new IndexerReadError(\n        operation,\n        `Failed to parse response: ${err}`,\n        response.status,\n        err as Error,\n      );\n    }\n  }\n}\n\n// =============================================================================\n// Query string builder\n// =============================================================================\n\nfunction buildQuery(params: UtxoRequest): string {\n  const parts: string[] = [];\n  if (params.start !== undefined) parts.push(`start=${params.start}`);\n  if (params.end !== undefined) parts.push(`end=${params.end}`);\n  if (params.limit !== undefined) parts.push(`limit=${params.limit}`);\n  return parts.length > 0 ? `?${parts.join(\"&\")}` : \"\";\n}\n\n// =============================================================================\n// Proto-to-JSON conversion helpers\n// =============================================================================\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(bytes).toString(\"base64\");\n  }\n  let binary = \"\";\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n\nfunction protoToBasicHealth(p: ProtoBasicHealth): BasicHealthResponse {\n  return { status: p.status };\n}\n\nfunction protoToDetailedHealth(p: ProtoDetailedHealth): DetailedHealthResponse {\n  return {\n    status: p.status,\n    version: p.version,\n    timestamp: p.timestamp,\n    uptime_seconds: Number(p.uptimeSeconds),\n    storage: p.storage\n      ? { status: p.storage.status, connected: p.storage.connected }\n      : { status: \"unknown\", connected: false },\n  };\n}\n\nfunction protoToLiveness(p: ProtoLiveness): LivenessResponse {\n  return { alive: p.alive };\n}\n\nfunction protoToReadiness(p: ProtoReadiness): ReadinessResponse {\n  return { ready: p.ready, storage: p.storage };\n}\n\nfunction protoToStatsResponse(p: ProtoStats): StatsResponse {\n  return {\n    total_utxos: Number(p.totalUtxos),\n    latest_absolute_index:\n      p.latestAbsoluteIndex !== undefined ? Number(p.latestAbsoluteIndex) : null,\n  };\n}\n\nfunction protoToTreeInfoResponse(p: ProtoTreeInfo): TreeInfoResponse {\n  return {\n    tree_index: Number(p.treeIndex),\n    num_leaves: Number(p.numLeaves),\n    root: bytesToBase64(p.root),\n    utxo_count: Number(p.utxoCount),\n  };\n}\n\nfunction protoToProofResponse(p: ProtoProof): ProofResponse {\n  return {\n    root: bytesToBase64(p.root),\n    tree_index: Number(p.treeIndex),\n    insertion_index: Number(p.insertionIndex),\n    proof: p.proof.map(bytesToBase64),\n    leaf: bytesToBase64(p.leaf),\n  };\n}\n\nfunction protoUtxoItemToJson(item: ProtoUtxo[\"items\"][number]): UtxoDataResponse {\n  return {\n    absolute_index: Number(item.absoluteIndex),\n    tree_index: Number(item.treeIndex),\n    insertion_index: Number(item.insertionIndex),\n    final_commitment: bytesToBase64(item.finalCommitment),\n    h1_version: readU128LE(item.h1Version),\n    h1_commitment_index: readU128LE(item.h1CommitmentIndex),\n    h1_sender_address: bytesToBase64(item.h1SenderAddress),\n    h1_mint_address: bytesToBase64(item.h1MintAddress),\n    h1_relayer_fixed_sol_fees: Number(item.h1RelayerFixedSolFees),\n    h1_year: item.h1Year,\n    h1_month: item.h1Month,\n    h1_day: item.h1Day,\n    h1_hour: item.h1Hour,\n    h1_minute: item.h1Minute,\n    h1_second: item.h1Second,\n    h1_purpose: item.h1Purpose,\n    h1_circuit_provable_hash: bytesToBase64(item.h1CircuitProvableHash),\n    h1_smart_program_provable_hash: bytesToBase64(item.h1SmartProgramProvableHash),\n    h1_hash: bytesToBase64(item.h1Hash),\n    h2_hash: bytesToBase64(item.h2Hash),\n    aes_encrypted_data: bytesToBase64(item.aesEncryptedData),\n    depositor_x25519_public_key: bytesToBase64(item.depositorX25519PublicKey),\n    timestamp: Number(item.timestamp),\n    slot: Number(item.slot),\n    event_type: item.eventType,\n  };\n}\n\n/** Read a u128 from 16 little-endian bytes and return as decimal string. */\nfunction readU128LE(bytes: Uint8Array): string {\n  if (bytes.length < 16) return \"0\";\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  const lo = view.getBigUint64(0, true);\n  const hi = view.getBigUint64(8, true);\n  const value = (hi << 64n) | lo;\n  return value.toString();\n}\n\nfunction protoToUtxoResponse(p: ProtoUtxo): UtxoResponse {\n  return {\n    items: p.items.map(protoUtxoItemToJson),\n    has_more: p.hasMore,\n    next_cursor: p.nextCursor !== undefined ? Number(p.nextCursor) : null,\n    total_count: Number(p.totalCount),\n    start_index: Number(p.startIndex),\n    end_index: p.endIndex !== undefined ? Number(p.endIndex) : null,\n  };\n}\n\nfunction protoToUtxoColumnarResponse(p: ProtoUtxoColumnar): UtxoColumnarResponse {\n  const cols = p.columns;\n  return {\n    columns: cols\n      ? {\n          absolute_index: cols.absoluteIndex.map(Number),\n          tree_index: cols.treeIndex.map(Number),\n          insertion_index: cols.insertionIndex.map(Number),\n          final_commitment: cols.finalCommitment.map(bytesToBase64),\n          h1_version: cols.h1Version.map(bytesToBase64),\n          h1_commitment_index: cols.h1CommitmentIndex.map(bytesToBase64),\n          h1_sender_address: cols.h1SenderAddress.map(bytesToBase64),\n          h1_mint_address: cols.h1MintAddress.map(bytesToBase64),\n          h1_relayer_fixed_sol_fees: cols.h1RelayerFixedSolFees.map(Number),\n          h1_year: cols.h1Year.slice(),\n          h1_month: cols.h1Month.slice(),\n          h1_day: cols.h1Day.slice(),\n          h1_hour: cols.h1Hour.slice(),\n          h1_minute: cols.h1Minute.slice(),\n          h1_second: cols.h1Second.slice(),\n          h1_purpose: cols.h1Purpose.slice(),\n          h1_circuit_provable_hash: cols.h1CircuitProvableHash.map(bytesToBase64),\n          h1_smart_program_provable_hash: cols.h1SmartProgramProvableHash.map(bytesToBase64),\n          h1_hash: cols.h1Hash.map(bytesToBase64),\n          h2_hash: cols.h2Hash.map(bytesToBase64),\n          aes_encrypted_data: cols.aesEncryptedData.map(bytesToBase64),\n          depositor_x25519_public_key: cols.depositorX25519PublicKey.map(bytesToBase64),\n          timestamp: cols.timestamp.map(Number),\n          slot: cols.slot.map(Number),\n          event_type: cols.eventType.slice(),\n        }\n      : null,\n    count: p.count,\n    has_more: p.hasMore,\n    next_cursor: p.nextCursor !== undefined ? Number(p.nextCursor) : null,\n    total_count: Number(p.totalCount),\n    start_index: Number(p.startIndex),\n    end_index: p.endIndex !== undefined ? Number(p.endIndex) : null,\n  };\n}\n"]}