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

package/dist/core/health.js

@@ -0,0 +1,265 @@
+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
+    };
+  }
+}
+export {
+  SystemHealthChecker
+};
+//# sourceMappingURL=health.js.map

package/dist/core/health.js.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/inMemoryNonceManager.cjs

@@ -0,0 +1,138 @@
+"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 inMemoryNonceManager_exports = {};
+__export(inMemoryNonceManager_exports, {
+  InMemoryNonceManager: () => InMemoryNonceManager
+});
+module.exports = __toCommonJS(inMemoryNonceManager_exports);
+class InMemoryNonceManager {
+  publicClient;
+  lastUsedNonces = /* @__PURE__ */ new Map();
+  constructor(publicClient) {
+    this.publicClient = publicClient;
+  }
+  /**
+   * Assigns the next available nonce for an address.
+   *
+   * @remarks
+   * This method:
+   * 1. Gets the pending count from the blockchain
+   * 2. Compares with the last used nonce in memory
+   * 3. Returns the higher of (pending count, last used + 1)
+   *
+   * @param address - The address to assign a nonce for
+   * @param chainId - The chain ID for the network
+   * @returns The assigned nonce (never returns null in single-instance mode)
+   */
+  async assignNonce(address, chainId) {
+    const key = `${chainId}:${address}`;
+    const pendingCount = await this.publicClient.getTransactionCount({
+      address,
+      blockTag: "pending"
+    });
+    const lastUsed = this.lastUsedNonces.get(key) ?? -1;
+    const nextNonce = Math.max(pendingCount, lastUsed + 1);
+    this.lastUsedNonces.set(key, nextNonce);
+    console.log(
+      `[InMemoryNonceManager] Assigned nonce ${nextNonce} for ${address} on chain ${chainId} (pending: ${pendingCount}, lastUsed: ${lastUsed})`
+    );
+    return nextNonce;
+  }
+  /**
+   * Resets the nonce counter for an address.
+   *
+   * @remarks
+   * Clears the in-memory tracking for an address, causing the next
+   * assignment to use the blockchain's pending count.
+   *
+   * @param address - The address to reset
+   * @param chainId - The chain ID for the network
+   */
+  async resetNonce(address, chainId) {
+    const key = `${chainId}:${address}`;
+    this.lastUsedNonces.delete(key);
+    console.log(
+      `[InMemoryNonceManager] Reset nonce for ${address} on chain ${chainId}`
+    );
+  }
+  /**
+   * Burns a stuck nonce by sending a minimal self-transfer with higher gas.
+   *
+   * @remarks
+   * This is the same implementation as DistributedNonceManager for consistency.
+   *
+   * @param walletClient - The wallet client to send the burn transaction
+   * @param nonceToBurn - The nonce to burn
+   * @param address - The address whose nonce to burn
+   * @param chainId - The chain ID for the network
+   * @param gasMultiplier - Multiplier for gas prices (default: 1.5)
+   * @returns The transaction hash of the burn transaction
+   */
+  async burnNonce(walletClient, nonceToBurn, address, chainId, gasMultiplier = 1.5) {
+    try {
+      const fees = await this.publicClient.estimateFeesPerGas();
+      const bump = (x) => x * BigInt(Math.floor(gasMultiplier * 100)) / 100n;
+      const newMaxFee = bump(fees.maxFeePerGas);
+      const newMaxPriorityFee = bump(fees.maxPriorityFeePerGas);
+      console.log(
+        `[InMemoryNonceManager] Burning stuck nonce ${nonceToBurn} with high gas`
+      );
+      const burnTx = await walletClient.sendTransaction({
+        account: walletClient.account,
+        to: address,
+        value: 0n,
+        nonce: nonceToBurn,
+        gas: 21000n,
+        maxFeePerGas: newMaxFee,
+        maxPriorityFeePerGas: newMaxPriorityFee,
+        chain: {
+          id: chainId,
+          name: chainId === 14800 ? "Vana Moksha" : "Vana Mainnet",
+          network: chainId === 14800 ? "moksha" : "mainnet",
+          nativeCurrency: { name: "VANA", symbol: "VANA", decimals: 18 },
+          rpcUrls: {
+            default: {
+              http: [
+                chainId === 14800 ? "https://rpc.moksha.vana.org" : "https://rpc.vana.org"
+              ]
+            },
+            public: {
+              http: [
+                chainId === 14800 ? "https://rpc.moksha.vana.org" : "https://rpc.vana.org"
+              ]
+            }
+          }
+        }
+      });
+      console.log(`[InMemoryNonceManager] Burn transaction sent: ${burnTx}`);
+      return burnTx;
+    } catch (error) {
+      console.error(
+        `[InMemoryNonceManager] Error burning nonce ${nonceToBurn}:`,
+        error
+      );
+      throw error;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InMemoryNonceManager
+});
+//# sourceMappingURL=inMemoryNonceManager.cjs.map

package/dist/core/inMemoryNonceManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/inMemoryNonceManager.ts"],"sourcesContent":["/**\n * Simple in-memory nonce manager for single-instance deployments.\n *\n * @internal\n * @module\n */\n\nimport type { PublicClient, WalletClient, Address, Hash } from \"viem\";\n\n/**\n * Simple nonce manager for single-instance deployments.\n *\n * @internal\n * @remarks\n * This class provides nonce management for single-instance deployments\n * where distributed coordination is not needed. It keeps track of nonces\n * in memory and syncs with the blockchain's pending count.\n *\n * ⚠️ WARNING: This should ONLY be used for single-instance deployments.\n * Using this with multiple instances will cause nonce conflicts!\n *\n * Key features:\n * - Simple in-memory tracking\n * - Syncs with blockchain pending count\n * - No external dependencies (no Redis needed)\n * - Suitable for hobby projects and development\n */\nexport class InMemoryNonceManager {\n  private readonly publicClient: PublicClient;\n  private readonly lastUsedNonces = new Map<string, number>();\n\n  constructor(publicClient: PublicClient) {\n    this.publicClient = publicClient;\n  }\n\n  /**\n   * Assigns the next available nonce for an address.\n   *\n   * @remarks\n   * This method:\n   * 1. Gets the pending count from the blockchain\n   * 2. Compares with the last used nonce in memory\n   * 3. Returns the higher of (pending count, last used + 1)\n   *\n   * @param address - The address to assign a nonce for\n   * @param chainId - The chain ID for the network\n   * @returns The assigned nonce (never returns null in single-instance mode)\n   */\n  async assignNonce(address: Address, chainId: number): Promise<number | null> {\n    const key = `${chainId}:${address}`;\n\n    // Get pending transaction count from blockchain\n    const pendingCount = await this.publicClient.getTransactionCount({\n      address,\n      blockTag: \"pending\",\n    });\n\n    // Get last used nonce from memory\n    const lastUsed = this.lastUsedNonces.get(key) ?? -1;\n\n    // Calculate next nonce (max of pending count or last used + 1)\n    const nextNonce = Math.max(pendingCount, lastUsed + 1);\n\n    // Update memory\n    this.lastUsedNonces.set(key, nextNonce);\n\n    console.log(\n      `[InMemoryNonceManager] Assigned nonce ${nextNonce} for ${address} on chain ${chainId} (pending: ${pendingCount}, lastUsed: ${lastUsed})`,\n    );\n\n    return nextNonce;\n  }\n\n  /**\n   * Resets the nonce counter for an address.\n   *\n   * @remarks\n   * Clears the in-memory tracking for an address, causing the next\n   * assignment to use the blockchain's pending count.\n   *\n   * @param address - The address to reset\n   * @param chainId - The chain ID for the network\n   */\n  async resetNonce(address: Address, chainId: number): Promise<void> {\n    const key = `${chainId}:${address}`;\n    this.lastUsedNonces.delete(key);\n\n    console.log(\n      `[InMemoryNonceManager] Reset nonce for ${address} on chain ${chainId}`,\n    );\n  }\n\n  /**\n   * Burns a stuck nonce by sending a minimal self-transfer with higher gas.\n   *\n   * @remarks\n   * This is the same implementation as DistributedNonceManager for consistency.\n   *\n   * @param walletClient - The wallet client to send the burn transaction\n   * @param nonceToBurn - The nonce to burn\n   * @param address - The address whose nonce to burn\n   * @param chainId - The chain ID for the network\n   * @param gasMultiplier - Multiplier for gas prices (default: 1.5)\n   * @returns The transaction hash of the burn transaction\n   */\n  async burnNonce(\n    walletClient: WalletClient,\n    nonceToBurn: number,\n    address: Address,\n    chainId: number,\n    gasMultiplier: number = 1.5,\n  ): Promise<Hash> {\n    try {\n      // Get current gas prices\n      const fees = await this.publicClient.estimateFeesPerGas();\n\n      // Bump gas prices by multiplier\n      const bump = (x: bigint) =>\n        (x * BigInt(Math.floor(gasMultiplier * 100))) / 100n;\n\n      const newMaxFee = bump(fees.maxFeePerGas);\n      const newMaxPriorityFee = bump(fees.maxPriorityFeePerGas);\n\n      console.log(\n        `[InMemoryNonceManager] Burning stuck nonce ${nonceToBurn} with high gas`,\n      );\n\n      // Send minimal self-transfer to burn the nonce\n      const burnTx = await walletClient.sendTransaction({\n        account: walletClient.account!,\n        to: address,\n        value: 0n,\n        nonce: nonceToBurn,\n        gas: 21000n,\n        maxFeePerGas: newMaxFee,\n        maxPriorityFeePerGas: newMaxPriorityFee,\n        chain: {\n          id: chainId,\n          name: chainId === 14800 ? \"Vana Moksha\" : \"Vana Mainnet\",\n          network: chainId === 14800 ? \"moksha\" : \"mainnet\",\n          nativeCurrency: { name: \"VANA\", symbol: \"VANA\", decimals: 18 },\n          rpcUrls: {\n            default: {\n              http: [\n                chainId === 14800\n                  ? \"https://rpc.moksha.vana.org\"\n                  : \"https://rpc.vana.org\",\n              ],\n            },\n            public: {\n              http: [\n                chainId === 14800\n                  ? \"https://rpc.moksha.vana.org\"\n                  : \"https://rpc.vana.org\",\n              ],\n            },\n          },\n        },\n      });\n\n      console.log(`[InMemoryNonceManager] Burn transaction sent: ${burnTx}`);\n      return burnTx;\n    } catch (error) {\n      console.error(\n        `[InMemoryNonceManager] Error burning nonce ${nonceToBurn}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BO,MAAM,qBAAqB;AAAA,EACf;AAAA,EACA,iBAAiB,oBAAI,IAAoB;AAAA,EAE1D,YAAY,cAA4B;AACtC,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,YAAY,SAAkB,SAAyC;AAC3E,UAAM,MAAM,GAAG,OAAO,IAAI,OAAO;AAGjC,UAAM,eAAe,MAAM,KAAK,aAAa,oBAAoB;AAAA,MAC/D;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAGD,UAAM,WAAW,KAAK,eAAe,IAAI,GAAG,KAAK;AAGjD,UAAM,YAAY,KAAK,IAAI,cAAc,WAAW,CAAC;AAGrD,SAAK,eAAe,IAAI,KAAK,SAAS;AAEtC,YAAQ;AAAA,MACN,yCAAyC,SAAS,QAAQ,OAAO,aAAa,OAAO,cAAc,YAAY,eAAe,QAAQ;AAAA,IACxI;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,SAAkB,SAAgC;AACjE,UAAM,MAAM,GAAG,OAAO,IAAI,OAAO;AACjC,SAAK,eAAe,OAAO,GAAG;AAE9B,YAAQ;AAAA,MACN,0CAA0C,OAAO,aAAa,OAAO;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,UACJ,cACA,aACA,SACA,SACA,gBAAwB,KACT;AACf,QAAI;AAEF,YAAM,OAAO,MAAM,KAAK,aAAa,mBAAmB;AAGxD,YAAM,OAAO,CAAC,MACX,IAAI,OAAO,KAAK,MAAM,gBAAgB,GAAG,CAAC,IAAK;AAElD,YAAM,YAAY,KAAK,KAAK,YAAY;AACxC,YAAM,oBAAoB,KAAK,KAAK,oBAAoB;AAExD,cAAQ;AAAA,QACN,8CAA8C,WAAW;AAAA,MAC3D;AAGA,YAAM,SAAS,MAAM,aAAa,gBAAgB;AAAA,QAChD,SAAS,aAAa;AAAA,QACtB,IAAI;AAAA,QACJ,OAAO;AAAA,QACP,OAAO;AAAA,QACP,KAAK;AAAA,QACL,cAAc;AAAA,QACd,sBAAsB;AAAA,QACtB,OAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,YAAY,QAAQ,gBAAgB;AAAA,UAC1C,SAAS,YAAY,QAAQ,WAAW;AAAA,UACxC,gBAAgB,EAAE,MAAM,QAAQ,QAAQ,QAAQ,UAAU,GAAG;AAAA,UAC7D,SAAS;AAAA,YACP,SAAS;AAAA,cACP,MAAM;AAAA,gBACJ,YAAY,QACR,gCACA;AAAA,cACN;AAAA,YACF;AAAA,YACA,QAAQ;AAAA,cACN,MAAM;AAAA,gBACJ,YAAY,QACR,gCACA;AAAA,cACN;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAED,cAAQ,IAAI,iDAAiD,MAAM,EAAE;AACrE,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,8CAA8C,WAAW;AAAA,QACzD;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/core/inMemoryNonceManager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Simple in-memory nonce manager for single-instance deployments.
+ *
+ * @internal
+ * @module
+ */
+import type { PublicClient, WalletClient, Address, Hash } from "viem";
+/**
+ * Simple nonce manager for single-instance deployments.
+ *
+ * @internal
+ * @remarks
+ * This class provides nonce management for single-instance deployments
+ * where distributed coordination is not needed. It keeps track of nonces
+ * in memory and syncs with the blockchain's pending count.
+ *
+ * ⚠️ WARNING: This should ONLY be used for single-instance deployments.
+ * Using this with multiple instances will cause nonce conflicts!
+ *
+ * Key features:
+ * - Simple in-memory tracking
+ * - Syncs with blockchain pending count
+ * - No external dependencies (no Redis needed)
+ * - Suitable for hobby projects and development
+ */
+export declare class InMemoryNonceManager {
+    private readonly publicClient;
+    private readonly lastUsedNonces;
+    constructor(publicClient: PublicClient);
+    /**
+     * Assigns the next available nonce for an address.
+     *
+     * @remarks
+     * This method:
+     * 1. Gets the pending count from the blockchain
+     * 2. Compares with the last used nonce in memory
+     * 3. Returns the higher of (pending count, last used + 1)
+     *
+     * @param address - The address to assign a nonce for
+     * @param chainId - The chain ID for the network
+     * @returns The assigned nonce (never returns null in single-instance mode)
+     */
+    assignNonce(address: Address, chainId: number): Promise<number | null>;
+    /**
+     * Resets the nonce counter for an address.
+     *
+     * @remarks
+     * Clears the in-memory tracking for an address, causing the next
+     * assignment to use the blockchain's pending count.
+     *
+     * @param address - The address to reset
+     * @param chainId - The chain ID for the network
+     */
+    resetNonce(address: Address, chainId: number): Promise<void>;
+    /**
+     * Burns a stuck nonce by sending a minimal self-transfer with higher gas.
+     *
+     * @remarks
+     * This is the same implementation as DistributedNonceManager for consistency.
+     *
+     * @param walletClient - The wallet client to send the burn transaction
+     * @param nonceToBurn - The nonce to burn
+     * @param address - The address whose nonce to burn
+     * @param chainId - The chain ID for the network
+     * @param gasMultiplier - Multiplier for gas prices (default: 1.5)
+     * @returns The transaction hash of the burn transaction
+     */
+    burnNonce(walletClient: WalletClient, nonceToBurn: number, address: Address, chainId: number, gasMultiplier?: number): Promise<Hash>;
+}

package/dist/core/inMemoryNonceManager.js

@@ -0,0 +1,114 @@
+class InMemoryNonceManager {
+  publicClient;
+  lastUsedNonces = /* @__PURE__ */ new Map();
+  constructor(publicClient) {
+    this.publicClient = publicClient;
+  }
+  /**
+   * Assigns the next available nonce for an address.
+   *
+   * @remarks
+   * This method:
+   * 1. Gets the pending count from the blockchain
+   * 2. Compares with the last used nonce in memory
+   * 3. Returns the higher of (pending count, last used + 1)
+   *
+   * @param address - The address to assign a nonce for
+   * @param chainId - The chain ID for the network
+   * @returns The assigned nonce (never returns null in single-instance mode)
+   */
+  async assignNonce(address, chainId) {
+    const key = `${chainId}:${address}`;
+    const pendingCount = await this.publicClient.getTransactionCount({
+      address,
+      blockTag: "pending"
+    });
+    const lastUsed = this.lastUsedNonces.get(key) ?? -1;
+    const nextNonce = Math.max(pendingCount, lastUsed + 1);
+    this.lastUsedNonces.set(key, nextNonce);
+    console.log(
+      `[InMemoryNonceManager] Assigned nonce ${nextNonce} for ${address} on chain ${chainId} (pending: ${pendingCount}, lastUsed: ${lastUsed})`
+    );
+    return nextNonce;
+  }
+  /**
+   * Resets the nonce counter for an address.
+   *
+   * @remarks
+   * Clears the in-memory tracking for an address, causing the next
+   * assignment to use the blockchain's pending count.
+   *
+   * @param address - The address to reset
+   * @param chainId - The chain ID for the network
+   */
+  async resetNonce(address, chainId) {
+    const key = `${chainId}:${address}`;
+    this.lastUsedNonces.delete(key);
+    console.log(
+      `[InMemoryNonceManager] Reset nonce for ${address} on chain ${chainId}`
+    );
+  }
+  /**
+   * Burns a stuck nonce by sending a minimal self-transfer with higher gas.
+   *
+   * @remarks
+   * This is the same implementation as DistributedNonceManager for consistency.
+   *
+   * @param walletClient - The wallet client to send the burn transaction
+   * @param nonceToBurn - The nonce to burn
+   * @param address - The address whose nonce to burn
+   * @param chainId - The chain ID for the network
+   * @param gasMultiplier - Multiplier for gas prices (default: 1.5)
+   * @returns The transaction hash of the burn transaction
+   */
+  async burnNonce(walletClient, nonceToBurn, address, chainId, gasMultiplier = 1.5) {
+    try {
+      const fees = await this.publicClient.estimateFeesPerGas();
+      const bump = (x) => x * BigInt(Math.floor(gasMultiplier * 100)) / 100n;
+      const newMaxFee = bump(fees.maxFeePerGas);
+      const newMaxPriorityFee = bump(fees.maxPriorityFeePerGas);
+      console.log(
+        `[InMemoryNonceManager] Burning stuck nonce ${nonceToBurn} with high gas`
+      );
+      const burnTx = await walletClient.sendTransaction({
+        account: walletClient.account,
+        to: address,
+        value: 0n,
+        nonce: nonceToBurn,
+        gas: 21000n,
+        maxFeePerGas: newMaxFee,
+        maxPriorityFeePerGas: newMaxPriorityFee,
+        chain: {
+          id: chainId,
+          name: chainId === 14800 ? "Vana Moksha" : "Vana Mainnet",
+          network: chainId === 14800 ? "moksha" : "mainnet",
+          nativeCurrency: { name: "VANA", symbol: "VANA", decimals: 18 },
+          rpcUrls: {
+            default: {
+              http: [
+                chainId === 14800 ? "https://rpc.moksha.vana.org" : "https://rpc.vana.org"
+              ]
+            },
+            public: {
+              http: [
+                chainId === 14800 ? "https://rpc.moksha.vana.org" : "https://rpc.vana.org"
+              ]
+            }
+          }
+        }
+      });
+      console.log(`[InMemoryNonceManager] Burn transaction sent: ${burnTx}`);
+      return burnTx;
+    } catch (error) {
+      console.error(
+        `[InMemoryNonceManager] Error burning nonce ${nonceToBurn}:`,
+        error
+      );
+      throw error;
+    }
+  }
+}
+export {
+  InMemoryNonceManager
+};
+//# sourceMappingURL=inMemoryNonceManager.js.map

package/dist/core/inMemoryNonceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/inMemoryNonceManager.ts"],"sourcesContent":["/**\n * Simple in-memory nonce manager for single-instance deployments.\n *\n * @internal\n * @module\n */\n\nimport type { PublicClient, WalletClient, Address, Hash } from \"viem\";\n\n/**\n * Simple nonce manager for single-instance deployments.\n *\n * @internal\n * @remarks\n * This class provides nonce management for single-instance deployments\n * where distributed coordination is not needed. It keeps track of nonces\n * in memory and syncs with the blockchain's pending count.\n *\n * ⚠️ WARNING: This should ONLY be used for single-instance deployments.\n * Using this with multiple instances will cause nonce conflicts!\n *\n * Key features:\n * - Simple in-memory tracking\n * - Syncs with blockchain pending count\n * - No external dependencies (no Redis needed)\n * - Suitable for hobby projects and development\n */\nexport class InMemoryNonceManager {\n  private readonly publicClient: PublicClient;\n  private readonly lastUsedNonces = new Map<string, number>();\n\n  constructor(publicClient: PublicClient) {\n    this.publicClient = publicClient;\n  }\n\n  /**\n   * Assigns the next available nonce for an address.\n   *\n   * @remarks\n   * This method:\n   * 1. Gets the pending count from the blockchain\n   * 2. Compares with the last used nonce in memory\n   * 3. Returns the higher of (pending count, last used + 1)\n   *\n   * @param address - The address to assign a nonce for\n   * @param chainId - The chain ID for the network\n   * @returns The assigned nonce (never returns null in single-instance mode)\n   */\n  async assignNonce(address: Address, chainId: number): Promise<number | null> {\n    const key = `${chainId}:${address}`;\n\n    // Get pending transaction count from blockchain\n    const pendingCount = await this.publicClient.getTransactionCount({\n      address,\n      blockTag: \"pending\",\n    });\n\n    // Get last used nonce from memory\n    const lastUsed = this.lastUsedNonces.get(key) ?? -1;\n\n    // Calculate next nonce (max of pending count or last used + 1)\n    const nextNonce = Math.max(pendingCount, lastUsed + 1);\n\n    // Update memory\n    this.lastUsedNonces.set(key, nextNonce);\n\n    console.log(\n      `[InMemoryNonceManager] Assigned nonce ${nextNonce} for ${address} on chain ${chainId} (pending: ${pendingCount}, lastUsed: ${lastUsed})`,\n    );\n\n    return nextNonce;\n  }\n\n  /**\n   * Resets the nonce counter for an address.\n   *\n   * @remarks\n   * Clears the in-memory tracking for an address, causing the next\n   * assignment to use the blockchain's pending count.\n   *\n   * @param address - The address to reset\n   * @param chainId - The chain ID for the network\n   */\n  async resetNonce(address: Address, chainId: number): Promise<void> {\n    const key = `${chainId}:${address}`;\n    this.lastUsedNonces.delete(key);\n\n    console.log(\n      `[InMemoryNonceManager] Reset nonce for ${address} on chain ${chainId}`,\n    );\n  }\n\n  /**\n   * Burns a stuck nonce by sending a minimal self-transfer with higher gas.\n   *\n   * @remarks\n   * This is the same implementation as DistributedNonceManager for consistency.\n   *\n   * @param walletClient - The wallet client to send the burn transaction\n   * @param nonceToBurn - The nonce to burn\n   * @param address - The address whose nonce to burn\n   * @param chainId - The chain ID for the network\n   * @param gasMultiplier - Multiplier for gas prices (default: 1.5)\n   * @returns The transaction hash of the burn transaction\n   */\n  async burnNonce(\n    walletClient: WalletClient,\n    nonceToBurn: number,\n    address: Address,\n    chainId: number,\n    gasMultiplier: number = 1.5,\n  ): Promise<Hash> {\n    try {\n      // Get current gas prices\n      const fees = await this.publicClient.estimateFeesPerGas();\n\n      // Bump gas prices by multiplier\n      const bump = (x: bigint) =>\n        (x * BigInt(Math.floor(gasMultiplier * 100))) / 100n;\n\n      const newMaxFee = bump(fees.maxFeePerGas);\n      const newMaxPriorityFee = bump(fees.maxPriorityFeePerGas);\n\n      console.log(\n        `[InMemoryNonceManager] Burning stuck nonce ${nonceToBurn} with high gas`,\n      );\n\n      // Send minimal self-transfer to burn the nonce\n      const burnTx = await walletClient.sendTransaction({\n        account: walletClient.account!,\n        to: address,\n        value: 0n,\n        nonce: nonceToBurn,\n        gas: 21000n,\n        maxFeePerGas: newMaxFee,\n        maxPriorityFeePerGas: newMaxPriorityFee,\n        chain: {\n          id: chainId,\n          name: chainId === 14800 ? \"Vana Moksha\" : \"Vana Mainnet\",\n          network: chainId === 14800 ? \"moksha\" : \"mainnet\",\n          nativeCurrency: { name: \"VANA\", symbol: \"VANA\", decimals: 18 },\n          rpcUrls: {\n            default: {\n              http: [\n                chainId === 14800\n                  ? \"https://rpc.moksha.vana.org\"\n                  : \"https://rpc.vana.org\",\n              ],\n            },\n            public: {\n              http: [\n                chainId === 14800\n                  ? \"https://rpc.moksha.vana.org\"\n                  : \"https://rpc.vana.org\",\n              ],\n            },\n          },\n        },\n      });\n\n      console.log(`[InMemoryNonceManager] Burn transaction sent: ${burnTx}`);\n      return burnTx;\n    } catch (error) {\n      console.error(\n        `[InMemoryNonceManager] Error burning nonce ${nonceToBurn}:`,\n        error,\n      );\n      throw error;\n    }\n  }\n}\n"],"mappings":"AA2BO,MAAM,qBAAqB;AAAA,EACf;AAAA,EACA,iBAAiB,oBAAI,IAAoB;AAAA,EAE1D,YAAY,cAA4B;AACtC,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,YAAY,SAAkB,SAAyC;AAC3E,UAAM,MAAM,GAAG,OAAO,IAAI,OAAO;AAGjC,UAAM,eAAe,MAAM,KAAK,aAAa,oBAAoB;AAAA,MAC/D;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAGD,UAAM,WAAW,KAAK,eAAe,IAAI,GAAG,KAAK;AAGjD,UAAM,YAAY,KAAK,IAAI,cAAc,WAAW,CAAC;AAGrD,SAAK,eAAe,IAAI,KAAK,SAAS;AAEtC,YAAQ;AAAA,MACN,yCAAyC,SAAS,QAAQ,OAAO,aAAa,OAAO,cAAc,YAAY,eAAe,QAAQ;AAAA,IACxI;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,SAAkB,SAAgC;AACjE,UAAM,MAAM,GAAG,OAAO,IAAI,OAAO;AACjC,SAAK,eAAe,OAAO,GAAG;AAE9B,YAAQ;AAAA,MACN,0CAA0C,OAAO,aAAa,OAAO;AAAA,IACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,UACJ,cACA,aACA,SACA,SACA,gBAAwB,KACT;AACf,QAAI;AAEF,YAAM,OAAO,MAAM,KAAK,aAAa,mBAAmB;AAGxD,YAAM,OAAO,CAAC,MACX,IAAI,OAAO,KAAK,MAAM,gBAAgB,GAAG,CAAC,IAAK;AAElD,YAAM,YAAY,KAAK,KAAK,YAAY;AACxC,YAAM,oBAAoB,KAAK,KAAK,oBAAoB;AAExD,cAAQ;AAAA,QACN,8CAA8C,WAAW;AAAA,MAC3D;AAGA,YAAM,SAAS,MAAM,aAAa,gBAAgB;AAAA,QAChD,SAAS,aAAa;AAAA,QACtB,IAAI;AAAA,QACJ,OAAO;AAAA,QACP,OAAO;AAAA,QACP,KAAK;AAAA,QACL,cAAc;AAAA,QACd,sBAAsB;AAAA,QACtB,OAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,YAAY,QAAQ,gBAAgB;AAAA,UAC1C,SAAS,YAAY,QAAQ,WAAW;AAAA,UACxC,gBAAgB,EAAE,MAAM,QAAQ,QAAQ,QAAQ,UAAU,GAAG;AAAA,UAC7D,SAAS;AAAA,YACP,SAAS;AAAA,cACP,MAAM;AAAA,gBACJ,YAAY,QACR,gCACA;AAAA,cACN;AAAA,YACF;AAAA,YACA,QAAQ;AAAA,cACN,MAAM;AAAA,gBACJ,YAAY,QACR,gCACA;AAAA,cACN;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAED,cAAQ,IAAI,iDAAiD,MAAM,EAAE;AACrE,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,8CAA8C,WAAW;AAAA,QACzD;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}