@opendatalabs/vana-sdk 0.1.0-alpha.ffe4659 → 2.0.0

package/dist/core/health.cjs

@@ -0,0 +1,289 @@
+"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

@@ -0,0 +1 @@
+{"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":"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","names":[]}

package/dist/core/health.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 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[];
+    }>;
+}