@opendatalabs/vana-sdk 2.3.0 → 3.0.1

package/dist/core/health.cjs

@@ -1,289 +0,0 @@
-"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);
-var health_exports = {};
-__export(health_exports, {
-  SystemHealthChecker: () => SystemHealthChecker
-});
-module.exports = __toCommonJS(health_exports);
-class SystemHealthChecker {
-  config;
-  constructor(config) {
-    this.config = {
-      ...config,
-      addresses: config.addresses ?? [],
-      staleThresholdSeconds: config.staleThresholdSeconds ?? 300
-    };
-  }
-  /**
-   * Performs a comprehensive health check of the system.
-   *
-   * @returns The health status of the system
-   */
-  async check() {
-    const timestamp = Date.now();
-    const errors = [];
-    const atomicStore = await this.checkAtomicStore();
-    if (atomicStore.status !== "healthy") {
-      errors.push(`Atomic store ${atomicStore.status}: ${atomicStore.message}`);
-    }
-    const operationStore = await this.checkOperationStore();
-    if (operationStore.status !== "healthy") {
-      errors.push(
-        `Operation store ${operationStore.status}: ${operationStore.message}`
-      );
-    }
-    const blockchain = await this.checkBlockchain();
-    if (blockchain.status !== "healthy") {
-      errors.push(`Blockchain ${blockchain.status}: ${blockchain.message}`);
-    }
-    let nonces;
-    if (this.config.addresses.length > 0) {
-      nonces = await this.checkNonces();
-      for (const nonce of nonces) {
-        if (nonce.status !== "healthy") {
-          errors.push(`Nonce ${nonce.status} for ${nonce.address}`);
-        }
-      }
-    }
-    const queue = await this.checkQueue();
-    if (queue && queue.isStale) {
-      errors.push(
-        `Queue is stale (oldest pending: ${queue.oldestPending}s ago)`
-      );
-    }
-    let status;
-    if (errors.length === 0) {
-      status = "healthy";
-    } else if (atomicStore.status === "unhealthy" || operationStore.status === "unhealthy" || blockchain.status === "unhealthy") {
-      status = "unhealthy";
-    } else {
-      status = "degraded";
-    }
-    return {
-      status,
-      timestamp,
-      checks: {
-        atomicStore,
-        operationStore,
-        blockchain,
-        nonces,
-        queue
-      },
-      errors: errors.length > 0 ? errors : void 0
-    };
-  }
-  /**
-   * Checks the health of the atomic store.
-   */
-  async checkAtomicStore() {
-    try {
-      const start = Date.now();
-      const testKey = `health:check:${Date.now()}`;
-      await this.config.atomicStore.set(testKey, "test");
-      const value = await this.config.atomicStore.get(testKey);
-      if (value !== "test") {
-        return {
-          status: "unhealthy",
-          message: "Atomic store read/write test failed"
-        };
-      }
-      if (this.config.atomicStore.delete) {
-        await this.config.atomicStore.delete(testKey);
-      }
-      const latency = Date.now() - start;
-      if (latency > 1e3) {
-        return {
-          status: "degraded",
-          message: `High latency: ${latency}ms`,
-          latency
-        };
-      }
-      return {
-        status: "healthy",
-        latency
-      };
-    } catch (error) {
-      return {
-        status: "unhealthy",
-        message: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
-  }
-  /**
-   * Checks the health of the operation store.
-   */
-  async checkOperationStore() {
-    try {
-      const start = Date.now();
-      await this.config.operationStore.getQueuedOperations({ limit: 1 });
-      const latency = Date.now() - start;
-      if (latency > 2e3) {
-        return {
-          status: "degraded",
-          message: `High latency: ${latency}ms`,
-          latency
-        };
-      }
-      return {
-        status: "healthy",
-        latency
-      };
-    } catch (error) {
-      return {
-        status: "unhealthy",
-        message: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
-  }
-  /**
-   * Checks blockchain connectivity.
-   */
-  async checkBlockchain() {
-    try {
-      const start = Date.now();
-      const blockNumber = await this.config.publicClient.getBlockNumber();
-      if (blockNumber === 0n) {
-        return {
-          status: "unhealthy",
-          message: "Invalid block number"
-        };
-      }
-      const latency = Date.now() - start;
-      if (latency > 5e3) {
-        return {
-          status: "degraded",
-          message: `High latency: ${latency}ms`,
-          latency
-        };
-      }
-      return {
-        status: "healthy",
-        latency
-      };
-    } catch (error) {
-      return {
-        status: "unhealthy",
-        message: error instanceof Error ? error.message : "Unknown error"
-      };
-    }
-  }
-  /**
-   * Checks nonce synchronization for configured addresses.
-   */
-  async checkNonces() {
-    const results = [];
-    for (const address of this.config.addresses) {
-      try {
-        const lastUsedKey = `nonce:${this.config.chainId}:${address}:lastUsed`;
-        const lastUsedStr = await this.config.atomicStore.get(lastUsedKey);
-        const lastUsed = lastUsedStr ? parseInt(lastUsedStr) : -1;
-        const [pendingCount, confirmedCount] = await Promise.all([
-          this.config.publicClient.getTransactionCount({
-            address,
-            blockTag: "pending"
-          }),
-          this.config.publicClient.getTransactionCount({
-            address,
-            blockTag: "latest"
-          })
-        ]);
-        const blockchainPending = pendingCount === 0 ? -1 : Number(pendingCount) - 1;
-        const blockchainConfirmed = confirmedCount === 0 ? -1 : Number(confirmedCount) - 1;
-        let status;
-        const gap = blockchainPending - blockchainConfirmed;
-        if (lastUsed < blockchainConfirmed) {
-          status = "desynced";
-        } else if (gap > 5) {
-          status = "stuck";
-        } else {
-          status = "healthy";
-        }
-        results.push({
-          address,
-          status,
-          lastUsed,
-          blockchainPending,
-          blockchainConfirmed,
-          gap: gap > 0 ? gap : void 0
-        });
-      } catch {
-        results.push({
-          address,
-          status: "desynced",
-          lastUsed: -1,
-          blockchainPending: -1,
-          blockchainConfirmed: -1
-        });
-      }
-    }
-    return results;
-  }
-  /**
-   * Checks operation queue health.
-   */
-  async checkQueue() {
-    try {
-      const [pending, processing, failed] = await Promise.all([
-        this.config.operationStore.getQueuedOperations({ limit: 100 }),
-        this.config.operationStore.getProcessingOperations?.({ limit: 100 }),
-        this.config.operationStore.getFailedOperations?.({ limit: 100 })
-      ]);
-      const pendingCount = pending.length;
-      const processingCount = processing?.length ?? 0;
-      const failedCount = failed?.length ?? 0;
-      let oldestPending;
-      let isStale = false;
-      if (pendingCount > 0 && pending[0].createdAt) {
-        const ageSeconds = Math.floor(
-          (Date.now() - pending[0].createdAt) / 1e3
-        );
-        oldestPending = ageSeconds;
-        isStale = ageSeconds > this.config.staleThresholdSeconds;
-      }
-      return {
-        pendingCount,
-        processingCount,
-        failedCount,
-        oldestPending,
-        isStale
-      };
-    } catch {
-      return void 0;
-    }
-  }
-  /**
-   * Gets a simple health check response for HTTP endpoints.
-   *
-   * @returns A simple health object suitable for JSON response
-   */
-  async getSimpleHealth() {
-    const health = await this.check();
-    return {
-      healthy: health.status === "healthy",
-      status: health.status,
-      timestamp: health.timestamp,
-      errors: health.errors
-    };
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SystemHealthChecker
-});
-//# sourceMappingURL=health.cjs.map

package/dist/core/health.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/health.ts"],"sourcesContent":["/**\n * System health monitoring for distributed relayer deployments.\n *\n * @module\n */\n\nimport type { IAtomicStore } from \"../types/atomicStore\";\nimport type { IOperationStore } from \"../types/operationStore\";\nimport type { PublicClient } from \"viem\";\n\n/**\n * Configuration for SystemHealthChecker.\n */\nexport interface SystemHealthCheckerConfig {\n  /** Atomic store for distributed state */\n  atomicStore: IAtomicStore;\n  /** Operation store for queue state */\n  operationStore: IOperationStore;\n  /** Public client for blockchain queries */\n  publicClient: PublicClient;\n  /** Chain ID to monitor */\n  chainId: number;\n  /** Addresses to monitor (optional) */\n  addresses?: string[];\n  /** Stale threshold in seconds (default: 300) */\n  staleThresholdSeconds?: number;\n}\n\n/**\n * Health status for the system.\n */\nexport interface HealthStatus {\n  /** Overall health status */\n  status: \"healthy\" | \"degraded\" | \"unhealthy\";\n  /** Timestamp of the check */\n  timestamp: number;\n  /** Individual component checks */\n  checks: {\n    atomicStore: ComponentHealth;\n    operationStore: ComponentHealth;\n    blockchain: ComponentHealth;\n    nonces?: NonceHealth[];\n    queue?: QueueHealth;\n  };\n  /** Any error messages */\n  errors?: string[];\n}\n\n/**\n * Health status for a component.\n */\nexport interface ComponentHealth {\n  status: \"healthy\" | \"degraded\" | \"unhealthy\";\n  message?: string;\n  latency?: number;\n}\n\n/**\n * Nonce health for an address.\n */\nexport interface NonceHealth {\n  address: string;\n  status: \"healthy\" | \"stuck\" | \"desynced\";\n  lastUsed: number;\n  blockchainPending: number;\n  blockchainConfirmed: number;\n  gap?: number;\n}\n\n/**\n * Queue health information.\n */\nexport interface QueueHealth {\n  pendingCount: number;\n  processingCount: number;\n  failedCount: number;\n  oldestPending?: number;\n  isStale: boolean;\n}\n\n/**\n * System health checker for monitoring distributed relayer deployments.\n *\n * @remarks\n * This class provides comprehensive health monitoring for relayer systems:\n * - Storage backend connectivity and performance\n * - Blockchain RPC availability\n * - Nonce synchronization status\n * - Operation queue health\n * - Stuck transaction detection\n *\n * @example\n * ```typescript\n * const healthChecker = new SystemHealthChecker({\n *   atomicStore,\n *   operationStore,\n *   publicClient,\n *   chainId: 14800,\n *   addresses: [relayerAddress]\n * });\n *\n * const health = await healthChecker.check();\n * if (health.status === 'unhealthy') {\n *   console.error('System unhealthy:', health.errors);\n * }\n * ```\n *\n * @category Health\n */\nexport class SystemHealthChecker {\n  private readonly config: Required<SystemHealthCheckerConfig>;\n\n  constructor(config: SystemHealthCheckerConfig) {\n    this.config = {\n      ...config,\n      addresses: config.addresses ?? [],\n      staleThresholdSeconds: config.staleThresholdSeconds ?? 300,\n    };\n  }\n\n  /**\n   * Performs a comprehensive health check of the system.\n   *\n   * @returns The health status of the system\n   */\n  async check(): Promise<HealthStatus> {\n    const timestamp = Date.now();\n    const errors: string[] = [];\n\n    // Check atomic store\n    const atomicStore = await this.checkAtomicStore();\n    if (atomicStore.status !== \"healthy\") {\n      errors.push(`Atomic store ${atomicStore.status}: ${atomicStore.message}`);\n    }\n\n    // Check operation store\n    const operationStore = await this.checkOperationStore();\n    if (operationStore.status !== \"healthy\") {\n      errors.push(\n        `Operation store ${operationStore.status}: ${operationStore.message}`,\n      );\n    }\n\n    // Check blockchain connectivity\n    const blockchain = await this.checkBlockchain();\n    if (blockchain.status !== \"healthy\") {\n      errors.push(`Blockchain ${blockchain.status}: ${blockchain.message}`);\n    }\n\n    // Check nonces if addresses provided\n    let nonces: NonceHealth[] | undefined;\n    if (this.config.addresses.length > 0) {\n      nonces = await this.checkNonces();\n      for (const nonce of nonces) {\n        if (nonce.status !== \"healthy\") {\n          errors.push(`Nonce ${nonce.status} for ${nonce.address}`);\n        }\n      }\n    }\n\n    // Check queue health\n    const queue = await this.checkQueue();\n    if (queue && queue.isStale) {\n      errors.push(\n        `Queue is stale (oldest pending: ${queue.oldestPending}s ago)`,\n      );\n    }\n\n    // Determine overall status\n    let status: \"healthy\" | \"degraded\" | \"unhealthy\";\n    if (errors.length === 0) {\n      status = \"healthy\";\n    } else if (\n      atomicStore.status === \"unhealthy\" ||\n      operationStore.status === \"unhealthy\" ||\n      blockchain.status === \"unhealthy\"\n    ) {\n      status = \"unhealthy\";\n    } else {\n      status = \"degraded\";\n    }\n\n    return {\n      status,\n      timestamp,\n      checks: {\n        atomicStore,\n        operationStore,\n        blockchain,\n        nonces,\n        queue,\n      },\n      errors: errors.length > 0 ? errors : undefined,\n    };\n  }\n\n  /**\n   * Checks the health of the atomic store.\n   */\n  private async checkAtomicStore(): Promise<ComponentHealth> {\n    try {\n      const start = Date.now();\n      const testKey = `health:check:${Date.now()}`;\n\n      // Test basic operations\n      await this.config.atomicStore.set(testKey, \"test\");\n      const value = await this.config.atomicStore.get(testKey);\n\n      if (value !== \"test\") {\n        return {\n          status: \"unhealthy\",\n          message: \"Atomic store read/write test failed\",\n        };\n      }\n\n      // Clean up\n      if (this.config.atomicStore.delete) {\n        await this.config.atomicStore.delete(testKey);\n      }\n\n      const latency = Date.now() - start;\n\n      if (latency > 1000) {\n        return {\n          status: \"degraded\",\n          message: `High latency: ${latency}ms`,\n          latency,\n        };\n      }\n\n      return {\n        status: \"healthy\",\n        latency,\n      };\n    } catch (error) {\n      return {\n        status: \"unhealthy\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      };\n    }\n  }\n\n  /**\n   * Checks the health of the operation store.\n   */\n  private async checkOperationStore(): Promise<ComponentHealth> {\n    try {\n      const start = Date.now();\n\n      // Test basic query\n      await this.config.operationStore.getQueuedOperations({ limit: 1 });\n\n      const latency = Date.now() - start;\n\n      if (latency > 2000) {\n        return {\n          status: \"degraded\",\n          message: `High latency: ${latency}ms`,\n          latency,\n        };\n      }\n\n      return {\n        status: \"healthy\",\n        latency,\n      };\n    } catch (error) {\n      return {\n        status: \"unhealthy\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      };\n    }\n  }\n\n  /**\n   * Checks blockchain connectivity.\n   */\n  private async checkBlockchain(): Promise<ComponentHealth> {\n    try {\n      const start = Date.now();\n\n      // Test RPC connectivity\n      const blockNumber = await this.config.publicClient.getBlockNumber();\n\n      if (blockNumber === 0n) {\n        return {\n          status: \"unhealthy\",\n          message: \"Invalid block number\",\n        };\n      }\n\n      const latency = Date.now() - start;\n\n      if (latency > 5000) {\n        return {\n          status: \"degraded\",\n          message: `High latency: ${latency}ms`,\n          latency,\n        };\n      }\n\n      return {\n        status: \"healthy\",\n        latency,\n      };\n    } catch (error) {\n      return {\n        status: \"unhealthy\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      };\n    }\n  }\n\n  /**\n   * Checks nonce synchronization for configured addresses.\n   */\n  private async checkNonces(): Promise<NonceHealth[]> {\n    const results: NonceHealth[] = [];\n\n    for (const address of this.config.addresses) {\n      try {\n        const lastUsedKey = `nonce:${this.config.chainId}:${address}:lastUsed`;\n\n        // Get stored nonce\n        const lastUsedStr = await this.config.atomicStore.get(lastUsedKey);\n        const lastUsed = lastUsedStr ? parseInt(lastUsedStr) : -1;\n\n        // Get blockchain nonces\n        const [pendingCount, confirmedCount] = await Promise.all([\n          this.config.publicClient.getTransactionCount({\n            address: address as `0x${string}`,\n            blockTag: \"pending\",\n          }),\n          this.config.publicClient.getTransactionCount({\n            address: address as `0x${string}`,\n            blockTag: \"latest\",\n          }),\n        ]);\n\n        const blockchainPending =\n          pendingCount === 0 ? -1 : Number(pendingCount) - 1;\n        const blockchainConfirmed =\n          confirmedCount === 0 ? -1 : Number(confirmedCount) - 1;\n\n        // Determine status\n        let status: \"healthy\" | \"stuck\" | \"desynced\";\n        const gap = blockchainPending - blockchainConfirmed;\n\n        if (lastUsed < blockchainConfirmed) {\n          status = \"desynced\";\n        } else if (gap > 5) {\n          status = \"stuck\";\n        } else {\n          status = \"healthy\";\n        }\n\n        results.push({\n          address,\n          status,\n          lastUsed,\n          blockchainPending,\n          blockchainConfirmed,\n          gap: gap > 0 ? gap : undefined,\n        });\n      } catch {\n        results.push({\n          address,\n          status: \"desynced\",\n          lastUsed: -1,\n          blockchainPending: -1,\n          blockchainConfirmed: -1,\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Checks operation queue health.\n   */\n  private async checkQueue(): Promise<QueueHealth | undefined> {\n    try {\n      const [pending, processing, failed] = await Promise.all([\n        this.config.operationStore.getQueuedOperations({ limit: 100 }),\n        this.config.operationStore.getProcessingOperations?.({ limit: 100 }),\n        this.config.operationStore.getFailedOperations?.({ limit: 100 }),\n      ]);\n\n      const pendingCount = pending.length;\n      const processingCount = processing?.length ?? 0;\n      const failedCount = failed?.length ?? 0;\n\n      // Check for stale operations\n      let oldestPending: number | undefined;\n      let isStale = false;\n\n      if (pendingCount > 0 && pending[0].createdAt) {\n        const ageSeconds = Math.floor(\n          (Date.now() - pending[0].createdAt) / 1000,\n        );\n        oldestPending = ageSeconds;\n        isStale = ageSeconds > this.config.staleThresholdSeconds;\n      }\n\n      return {\n        pendingCount,\n        processingCount,\n        failedCount,\n        oldestPending,\n        isStale,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Gets a simple health check response for HTTP endpoints.\n   *\n   * @returns A simple health object suitable for JSON response\n   */\n  async getSimpleHealth(): Promise<{\n    healthy: boolean;\n    status: string;\n    timestamp: number;\n    errors?: string[];\n  }> {\n    const health = await this.check();\n\n    return {\n      healthy: health.status === \"healthy\",\n      status: health.status,\n      timestamp: health.timestamp,\n      errors: health.errors,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA6GO,MAAM,oBAAoB;AAAA,EACd;AAAA,EAEjB,YAAY,QAAmC;AAC7C,SAAK,SAAS;AAAA,MACZ,GAAG;AAAA,MACH,WAAW,OAAO,aAAa,CAAC;AAAA,MAChC,uBAAuB,OAAO,yBAAyB;AAAA,IACzD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAA+B;AACnC,UAAM,YAAY,KAAK,IAAI;AAC3B,UAAM,SAAmB,CAAC;AAG1B,UAAM,cAAc,MAAM,KAAK,iBAAiB;AAChD,QAAI,YAAY,WAAW,WAAW;AACpC,aAAO,KAAK,gBAAgB,YAAY,MAAM,KAAK,YAAY,OAAO,EAAE;AAAA,IAC1E;AAGA,UAAM,iBAAiB,MAAM,KAAK,oBAAoB;AACtD,QAAI,eAAe,WAAW,WAAW;AACvC,aAAO;AAAA,QACL,mBAAmB,eAAe,MAAM,KAAK,eAAe,OAAO;AAAA,MACrE;AAAA,IACF;AAGA,UAAM,aAAa,MAAM,KAAK,gBAAgB;AAC9C,QAAI,WAAW,WAAW,WAAW;AACnC,aAAO,KAAK,cAAc,WAAW,MAAM,KAAK,WAAW,OAAO,EAAE;AAAA,IACtE;AAGA,QAAI;AACJ,QAAI,KAAK,OAAO,UAAU,SAAS,GAAG;AACpC,eAAS,MAAM,KAAK,YAAY;AAChC,iBAAW,SAAS,QAAQ;AAC1B,YAAI,MAAM,WAAW,WAAW;AAC9B,iBAAO,KAAK,SAAS,MAAM,MAAM,QAAQ,MAAM,OAAO,EAAE;AAAA,QAC1D;AAAA,MACF;AAAA,IACF;AAGA,UAAM,QAAQ,MAAM,KAAK,WAAW;AACpC,QAAI,SAAS,MAAM,SAAS;AAC1B,aAAO;AAAA,QACL,mCAAmC,MAAM,aAAa;AAAA,MACxD;AAAA,IACF;AAGA,QAAI;AACJ,QAAI,OAAO,WAAW,GAAG;AACvB,eAAS;AAAA,IACX,WACE,YAAY,WAAW,eACvB,eAAe,WAAW,eAC1B,WAAW,WAAW,aACtB;AACA,eAAS;AAAA,IACX,OAAO;AACL,eAAS;AAAA,IACX;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,QAAQ,OAAO,SAAS,IAAI,SAAS;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,mBAA6C;AACzD,QAAI;AACF,YAAM,QAAQ,KAAK,IAAI;AACvB,YAAM,UAAU,gBAAgB,KAAK,IAAI,CAAC;AAG1C,YAAM,KAAK,OAAO,YAAY,IAAI,SAAS,MAAM;AACjD,YAAM,QAAQ,MAAM,KAAK,OAAO,YAAY,IAAI,OAAO;AAEvD,UAAI,UAAU,QAAQ;AACpB,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,SAAS;AAAA,QACX;AAAA,MACF;AAGA,UAAI,KAAK,OAAO,YAAY,QAAQ;AAClC,cAAM,KAAK,OAAO,YAAY,OAAO,OAAO;AAAA,MAC9C;AAEA,YAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,UAAI,UAAU,KAAM;AAClB,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,SAAS,iBAAiB,OAAO;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,sBAAgD;AAC5D,QAAI;AACF,YAAM,QAAQ,KAAK,IAAI;AAGvB,YAAM,KAAK,OAAO,eAAe,oBAAoB,EAAE,OAAO,EAAE,CAAC;AAEjE,YAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,UAAI,UAAU,KAAM;AAClB,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,SAAS,iBAAiB,OAAO;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,kBAA4C;AACxD,QAAI;AACF,YAAM,QAAQ,KAAK,IAAI;AAGvB,YAAM,cAAc,MAAM,KAAK,OAAO,aAAa,eAAe;AAElE,UAAI,gBAAgB,IAAI;AACtB,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,SAAS;AAAA,QACX;AAAA,MACF;AAEA,YAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,UAAI,UAAU,KAAM;AAClB,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,SAAS,iBAAiB,OAAO;AAAA,UACjC;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,cAAsC;AAClD,UAAM,UAAyB,CAAC;AAEhC,eAAW,WAAW,KAAK,OAAO,WAAW;AAC3C,UAAI;AACF,cAAM,cAAc,SAAS,KAAK,OAAO,OAAO,IAAI,OAAO;AAG3D,cAAM,cAAc,MAAM,KAAK,OAAO,YAAY,IAAI,WAAW;AACjE,cAAM,WAAW,cAAc,SAAS,WAAW,IAAI;AAGvD,cAAM,CAAC,cAAc,cAAc,IAAI,MAAM,QAAQ,IAAI;AAAA,UACvD,KAAK,OAAO,aAAa,oBAAoB;AAAA,YAC3C;AAAA,YACA,UAAU;AAAA,UACZ,CAAC;AAAA,UACD,KAAK,OAAO,aAAa,oBAAoB;AAAA,YAC3C;AAAA,YACA,UAAU;AAAA,UACZ,CAAC;AAAA,QACH,CAAC;AAED,cAAM,oBACJ,iBAAiB,IAAI,KAAK,OAAO,YAAY,IAAI;AACnD,cAAM,sBACJ,mBAAmB,IAAI,KAAK,OAAO,cAAc,IAAI;AAGvD,YAAI;AACJ,cAAM,MAAM,oBAAoB;AAEhC,YAAI,WAAW,qBAAqB;AAClC,mBAAS;AAAA,QACX,WAAW,MAAM,GAAG;AAClB,mBAAS;AAAA,QACX,OAAO;AACL,mBAAS;AAAA,QACX;AAEA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK,MAAM,IAAI,MAAM;AAAA,QACvB,CAAC;AAAA,MACH,QAAQ;AACN,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,UAAU;AAAA,UACV,mBAAmB;AAAA,UACnB,qBAAqB;AAAA,QACvB,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,aAA+C;AAC3D,QAAI;AACF,YAAM,CAAC,SAAS,YAAY,MAAM,IAAI,MAAM,QAAQ,IAAI;AAAA,QACtD,KAAK,OAAO,eAAe,oBAAoB,EAAE,OAAO,IAAI,CAAC;AAAA,QAC7D,KAAK,OAAO,eAAe,0BAA0B,EAAE,OAAO,IAAI,CAAC;AAAA,QACnE,KAAK,OAAO,eAAe,sBAAsB,EAAE,OAAO,IAAI,CAAC;AAAA,MACjE,CAAC;AAED,YAAM,eAAe,QAAQ;AAC7B,YAAM,kBAAkB,YAAY,UAAU;AAC9C,YAAM,cAAc,QAAQ,UAAU;AAGtC,UAAI;AACJ,UAAI,UAAU;AAEd,UAAI,eAAe,KAAK,QAAQ,CAAC,EAAE,WAAW;AAC5C,cAAM,aAAa,KAAK;AAAA,WACrB,KAAK,IAAI,IAAI,QAAQ,CAAC,EAAE,aAAa;AAAA,QACxC;AACA,wBAAgB;AAChB,kBAAU,aAAa,KAAK,OAAO;AAAA,MACrC;AAEA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,kBAKH;AACD,UAAM,SAAS,MAAM,KAAK,MAAM;AAEhC,WAAO;AAAA,MACL,SAAS,OAAO,WAAW;AAAA,MAC3B,QAAQ,OAAO;AAAA,MACf,WAAW,OAAO;AAAA,MAClB,QAAQ,OAAO;AAAA,IACjB;AAAA,EACF;AACF;","names":[]}

package/dist/core/health.d.ts

@@ -1,143 +0,0 @@
-/**
- * System health monitoring for distributed relayer deployments.
- *
- * @module
- */
-import type { IAtomicStore } from "../types/atomicStore";
-import type { IOperationStore } from "../types/operationStore";
-import type { PublicClient } from "viem";
-/**
- * Configuration for SystemHealthChecker.
- */
-export interface SystemHealthCheckerConfig {
-    /** Atomic store for distributed state */
-    atomicStore: IAtomicStore;
-    /** Operation store for queue state */
-    operationStore: IOperationStore;
-    /** Public client for blockchain queries */
-    publicClient: PublicClient;
-    /** Chain ID to monitor */
-    chainId: number;
-    /** Addresses to monitor (optional) */
-    addresses?: string[];
-    /** Stale threshold in seconds (default: 300) */
-    staleThresholdSeconds?: number;
-}
-/**
- * Health status for the system.
- */
-export interface HealthStatus {
-    /** Overall health status */
-    status: "healthy" | "degraded" | "unhealthy";
-    /** Timestamp of the check */
-    timestamp: number;
-    /** Individual component checks */
-    checks: {
-        atomicStore: ComponentHealth;
-        operationStore: ComponentHealth;
-        blockchain: ComponentHealth;
-        nonces?: NonceHealth[];
-        queue?: QueueHealth;
-    };
-    /** Any error messages */
-    errors?: string[];
-}
-/**
- * Health status for a component.
- */
-export interface ComponentHealth {
-    status: "healthy" | "degraded" | "unhealthy";
-    message?: string;
-    latency?: number;
-}
-/**
- * Nonce health for an address.
- */
-export interface NonceHealth {
-    address: string;
-    status: "healthy" | "stuck" | "desynced";
-    lastUsed: number;
-    blockchainPending: number;
-    blockchainConfirmed: number;
-    gap?: number;
-}
-/**
- * Queue health information.
- */
-export interface QueueHealth {
-    pendingCount: number;
-    processingCount: number;
-    failedCount: number;
-    oldestPending?: number;
-    isStale: boolean;
-}
-/**
- * System health checker for monitoring distributed relayer deployments.
- *
- * @remarks
- * This class provides comprehensive health monitoring for relayer systems:
- * - Storage backend connectivity and performance
- * - Blockchain RPC availability
- * - Nonce synchronization status
- * - Operation queue health
- * - Stuck transaction detection
- *
- * @example
- * ```typescript
- * const healthChecker = new SystemHealthChecker({
- *   atomicStore,
- *   operationStore,
- *   publicClient,
- *   chainId: 14800,
- *   addresses: [relayerAddress]
- * });
- *
- * const health = await healthChecker.check();
- * if (health.status === 'unhealthy') {
- *   console.error('System unhealthy:', health.errors);
- * }
- * ```
- *
- * @category Health
- */
-export declare class SystemHealthChecker {
-    private readonly config;
-    constructor(config: SystemHealthCheckerConfig);
-    /**
-     * Performs a comprehensive health check of the system.
-     *
-     * @returns The health status of the system
-     */
-    check(): Promise<HealthStatus>;
-    /**
-     * Checks the health of the atomic store.
-     */
-    private checkAtomicStore;
-    /**
-     * Checks the health of the operation store.
-     */
-    private checkOperationStore;
-    /**
-     * Checks blockchain connectivity.
-     */
-    private checkBlockchain;
-    /**
-     * Checks nonce synchronization for configured addresses.
-     */
-    private checkNonces;
-    /**
-     * Checks operation queue health.
-     */
-    private checkQueue;
-    /**
-     * Gets a simple health check response for HTTP endpoints.
-     *
-     * @returns A simple health object suitable for JSON response
-     */
-    getSimpleHealth(): Promise<{
-        healthy: boolean;
-        status: string;
-        timestamp: number;
-        errors?: string[];
-    }>;
-}