@opendatalabs/vana-sdk 0.1.0-alpha.eebb656 → 0.1.0-alpha.ef15099

package/dist/index.node.js

@@ -1,8 +1,12 @@
 import { NodePlatformAdapter } from "./platform/node";
 import { VanaCore } from "./core";
 class VanaNodeImpl extends VanaCore {
+  operationStore;
+  atomicStore;
   constructor(config) {
     super(new NodePlatformAdapter(), config);
+    this.operationStore = config.operationStore;
+    this.atomicStore = config.atomicStore;
   }
 }
 function Vana(config) {
@@ -10,18 +14,30 @@ function Vana(config) {
 }
 var index_node_default = Vana;
 import { VanaCore as VanaCore2, VanaCoreFactory } from "./core";
+import { DistributedNonceManager } from "./core/nonceManager";
+import { InMemoryNonceManager } from "./core/inMemoryNonceManager";
+import { SystemHealthChecker } from "./core/health";
+import { RedisAtomicStore } from "./lib/redisAtomicStore";
 import {
   isReplicateAPIResponse,
   isAPIResponse,
   safeParseJSON,
   parseReplicateOutput
 } from "./types/external-apis";
+import {
+  EnhancedTransactionResponse,
+  canEnhanceResponse,
+  enhanceResponse
+} from "./client/enhancedResponse";
 export * from "./errors";
 import { PermissionsController } from "./controllers/permissions";
+import { RuntimePermissionsController } from "./controllers/runtimePermissions";
+import { AccessSettlementController } from "./controllers/accessSettlement";
 import { DataController } from "./controllers/data";
 import { ServerController } from "./controllers/server";
 import { ProtocolController } from "./controllers/protocol";
 import { SchemaController } from "./controllers/schemas";
+import { OperationsController } from "./controllers/operations";
 export * from "./contracts/contractController";
 export * from "./utils/encryption";
 export * from "./utils/formatters";
@@ -32,8 +48,14 @@ export * from "./utils/ipfs";
 export * from "./utils/schemaValidation";
 export * from "./utils/signatureCache";
 export * from "./storage";
-import { getContractAddress } from "./config/addresses";
+import { getContractAddress, CONTRACTS } from "./generated/addresses";
 import { chains } from "./config/chains";
+import {
+  mainnetServices,
+  mokshaServices,
+  getServiceEndpoints,
+  getDefaultPersonalServerUrl
+} from "./config/default-services";
 import {
   vanaMainnet,
   mokshaTestnet,
@@ -53,7 +75,9 @@ import {
   AsyncQueue,
   CircuitBreaker
 } from "./core/generics";
-import { handleRelayerRequest } from "./server/handler";
+import {
+  handleRelayerOperation
+} from "./server/relayerHandler";
 import { NodePlatformAdapter as NodePlatformAdapter2 } from "./platform/node";
 import { BrowserPlatformAdapter } from "./platform/browser";
 import {
@@ -70,26 +94,36 @@ import {
 } from "./platform/browser-safe";
 import { ApiClient } from "./core/apiClient";
 export {
+  AccessSettlementController,
   ApiClient,
   AsyncQueue,
   BaseController,
   BrowserPlatformAdapter,
+  CONTRACTS,
   CircuitBreaker,
   DataController,
+  DistributedNonceManager,
+  EnhancedTransactionResponse,
   EventEmitter,
+  InMemoryNonceManager,
   MemoryCache,
   MiddlewarePipeline,
   NodePlatformAdapter2 as NodePlatformAdapter,
+  OperationsController,
   PermissionsController,
   ProtocolController,
   RateLimiter,
+  RedisAtomicStore,
   RetryUtility,
+  RuntimePermissionsController,
   SchemaController,
   ServerController,
+  SystemHealthChecker,
   Vana,
   VanaCore2 as VanaCore,
   VanaCoreFactory,
   VanaNodeImpl,
+  canEnhanceResponse,
   chains,
   createBrowserPlatformAdapter,
   createNodePlatformAdapter,
@@ -98,16 +132,21 @@ export {
   createPlatformAdapterSafe,
   index_node_default as default,
   detectPlatform,
+  enhanceResponse,
   getAbi,
   getAllChains,
   getChainConfig,
   getContractAddress,
+  getDefaultPersonalServerUrl,
   getPlatformCapabilities,
-  handleRelayerRequest,
+  getServiceEndpoints,
+  handleRelayerOperation,
   isAPIResponse,
   isPlatformSupported,
   isReplicateAPIResponse,
+  mainnetServices,
   moksha,
+  mokshaServices,
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,

package/dist/index.node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.node.ts"],"sourcesContent":["/**\n * @module Node\n * Node.js-specific implementation of the Vana SDK\n */\n\nimport { NodePlatformAdapter } from \"./platform/node\";\nimport { VanaCore } from \"./core\";\nimport type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  StorageRequiredMarker,\n} from \"./types\";\n\n/**\n * Internal implementation class for Node.js environments.\n * This class is not exported directly - use the Vana factory function instead.\n */\nclass VanaNodeImpl extends VanaCore {\n  constructor(config: VanaConfig) {\n    super(new NodePlatformAdapter(), config);\n  }\n}\n\n/**\n * Creates a new Vana SDK instance configured for Node.js environments.\n *\n * @remarks\n * This is the primary entry point for Node.js applications using the Vana SDK. The function\n * automatically detects your configuration type and provides compile-time type safety:\n * - **With storage configured**: All methods including file upload/download are available\n * - **Without storage**: Storage-dependent methods throw runtime errors and are excluded from TypeScript\n *\n * The Node.js version provides enhanced capabilities including native file system access,\n * server-side cryptographic operations, and support for personal server deployment.\n * It includes all browser capabilities plus Node.js-specific optimizations and utilities.\n *\n * @param config - Configuration object containing wallet, storage, and relayer settings\n * @returns A fully configured Vana SDK instance for Node.js use\n * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing\n * @example\n * ```typescript\n * import { Vana } from '@opendatalabs/vana-sdk/node';\n * import { createWalletClient, http } from 'viem';\n * import { privateKeyToAccount } from 'viem/accounts';\n * import { IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk/node';\n * import { mokshaTestnet } from '@opendatalabs/vana-sdk/node';\n *\n * // Server setup with private key\n * const account = privateKeyToAccount('0x...');\n * const walletClient = createWalletClient({\n *   account,\n *   chain: mokshaTestnet,\n *   transport: http('https://rpc.moksha.vana.org')\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({\n *         gateway: 'https://gateway.pinata.cloud',\n *         timeout: 30000\n *       }),\n *       pinata: new PinataStorage({\n *         apiKey: process.env.PINATA_KEY,\n *         secretKey: process.env.PINATA_SECRET\n *       })\n *     },\n *     defaultProvider: 'pinata'\n *   },\n *   relayerCallbacks: {\n *     async submitPermissionGrant(typedData, signature) {\n *       // Server-side relayer implementation\n *       return await submitToCustomRelayer(typedData, signature);\n *     }\n *   }\n * });\n *\n * // Server operations\n * const uploadResult = await vana.data.upload({\n *   content: await fs.readFile('./user-data.json'),\n *   filename: 'user-data.json',\n *   schemaId: 1\n * });\n *\n * // Personal server setup\n * await vana.server.setupPersonalServer({\n *   serverUrl: 'https://my-server.example.com',\n *   capabilities: ['data_processing', 'ml_inference']\n * });\n * ```\n *\n * @example\n * ```typescript\n * // CLI tool or script usage\n * const vana = Vana({\n *   chainId: 14800, // Moksha testnet\n *   account: privateKeyToAccount(process.env.PRIVATE_KEY),\n *   rpcUrl: process.env.RPC_URL,\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n *\n * // Batch operations for data processing\n * const userFiles = await vana.data.getUserFiles({\n *   owner: process.env.USER_ADDRESS\n * });\n *\n * for (const file of userFiles) {\n *   const decrypted = await vana.data.decryptFile(file);\n *   // Process file data...\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Express.js server integration\n * import express from 'express';\n * import { handleRelayerRequest } from '@opendatalabs/vana-sdk/node';\n *\n * const app = express();\n *\n * app.post('/api/relay/:operation', async (req, res) => {\n *   try {\n *     const result = await handleRelayerRequest(\n *       req.params.operation,\n *       req.body,\n *       vana\n *     );\n *     res.json({ success: true, result });\n *   } catch (error) {\n *     res.status(500).json({ error: error.message });\n *   }\n * });\n * ```\n *\n * @see {@link https://docs.vana.org/docs/sdk/server-setup | Server Setup Guide} for Node.js-specific features\n * @see {@link VanaCore} for the underlying implementation details\n * @category Core SDK\n */\nexport function Vana(\n  config: VanaConfigWithStorage,\n): VanaNodeImpl & StorageRequiredMarker;\nexport function Vana(config: VanaConfig): VanaNodeImpl;\n/**\n * Creates a new Vana SDK instance.\n *\n * @param config - The configuration for the Vana SDK\n * @returns A new Vana SDK instance\n */\nexport function Vana(config: VanaConfig) {\n  return new VanaNodeImpl(config);\n}\n\n/**\n * The type of a Vana SDK instance in Node.js environments.\n * Uses InstanceType to properly expose all public methods from the class hierarchy.\n *\n * @see {@link Vana}\n */\nexport type VanaInstance = InstanceType<typeof VanaNodeImpl>;\n\n// Export as default export\nexport default Vana;\n\n// Re-export everything that was in index.ts (avoiding circular dependency)\n// Core class and factory\nexport { VanaCore, VanaCoreFactory } from \"./core\";\n\n// Types - modular exports\nexport type * from \"./types\";\n\n// Type guards and utilities\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./types/external-apis\";\n\n// VanaContract is exported from abi to avoid circular dependencies\nexport type { VanaContract } from \"./generated/abi\";\n\n// Error classes\nexport * from \"./errors\";\n\n// Controllers\nexport { PermissionsController } from \"./controllers/permissions\";\nexport { DataController } from \"./controllers/data\";\nexport { ServerController } from \"./controllers/server\";\nexport { ProtocolController } from \"./controllers/protocol\";\nexport { SchemaController } from \"./controllers/schemas\";\n\n// Contract controller\nexport * from \"./contracts/contractController\";\n\n// Utilities\nexport * from \"./utils/encryption\";\nexport * from \"./utils/formatters\";\nexport * from \"./utils/grantFiles\";\nexport * from \"./utils/grantValidation\";\nexport * from \"./utils/grants\";\nexport * from \"./utils/ipfs\";\nexport * from \"./utils/schemaValidation\";\nexport * from \"./utils/signatureCache\";\n\n// Storage API\nexport * from \"./storage\";\n\n// Configuration\nexport { getContractAddress } from \"./config/addresses\";\nexport { chains } from \"./config/chains\";\n\n// Chain configurations with subgraph URLs - explicit exports for better DX\nexport {\n  vanaMainnet,\n  mokshaTestnet,\n  moksha,\n  type VanaChainConfig,\n  getChainConfig,\n  getAllChains,\n} from \"./chains\";\nexport * from \"./chains\";\n\n// ABIs\nexport { getAbi } from \"./generated/abi\";\nexport type { VanaContract as VanaContractAbi } from \"./generated/abi\";\n\n// Generic utilities for extensibility\nexport {\n  BaseController,\n  RetryUtility,\n  RateLimiter,\n  MemoryCache,\n  EventEmitter,\n  MiddlewarePipeline,\n  AsyncQueue,\n  CircuitBreaker,\n} from \"./core/generics\";\n\n// Server-side utilities\nexport { handleRelayerRequest } from \"./server/handler\";\nexport type { RelayerRequestPayload } from \"./server/handler\";\n// TransactionHandle removed - using POJOs instead\nexport type {\n  Operation,\n  TransactionResult,\n  TransactionReceipt,\n  PollingOptions,\n  TransactionWaitOptions,\n} from \"./types/operations\";\n\n// Platform adapters\nexport { NodePlatformAdapter } from \"./platform/node\";\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Browser-safe platform utilities\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n\nexport { ApiClient } from \"./core/apiClient\";\n\nexport type {\n  ApiClientConfig,\n  HttpMethod,\n  RequestOptions,\n} from \"./core/apiClient\";\n\n// Note: Default export is already handled above with the Vana factory function\n// For testing purposes, we also export the implementation class\nexport { VanaNodeImpl };\n"],"mappings":"AAKA,SAAS,2BAA2B;AACpC,SAAS,gBAAgB;AAWzB,MAAM,qBAAqB,SAAS;AAAA,EAClC,YAAY,QAAoB;AAC9B,UAAM,IAAI,oBAAoB,GAAG,MAAM;AAAA,EACzC;AACF;AAmIO,SAAS,KAAK,QAAoB;AACvC,SAAO,IAAI,aAAa,MAAM;AAChC;AAWA,IAAO,qBAAQ;AAIf,SAAS,YAAAA,WAAU,uBAAuB;AAM1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,cAAc;AAGd,SAAS,6BAA6B;AACtC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AAGjC,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,SAAS,0BAA0B;AACnC,SAAS,cAAc;AAGvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAGd,SAAS,cAAc;AAIvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,4BAA4B;AAYrC,SAAS,uBAAAC,4BAA2B;AACpC,SAAS,8BAA8B;AAIvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,iBAAiB;","names":["VanaCore","NodePlatformAdapter"]}
+{"version":3,"sources":["../src/index.node.ts"],"sourcesContent":["/**\n * @module Node\n * Node.js-specific implementation of the Vana SDK\n */\n\nimport { NodePlatformAdapter } from \"./platform/node\";\nimport { VanaCore } from \"./core\";\nimport type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  StorageRequiredMarker,\n  RelayerRequiredMarker,\n} from \"./types\";\nimport type {\n  IOperationStore,\n  IRelayerStateStore,\n} from \"./types/operationStore\";\nimport type { IAtomicStore } from \"./types/atomicStore\";\nimport type { PublicClient } from \"viem\";\n\n/**\n * Node.js-specific configuration interface with operation store support\n *\n * @category Configuration\n */\nexport type VanaNodeConfig = VanaConfig & {\n  operationStore?: IOperationStore | IRelayerStateStore; // Can be either type\n  atomicStore?: IAtomicStore;\n};\n\n/**\n * Node.js configuration with storage requirements\n *\n * @category Configuration\n */\nexport type VanaNodeConfigWithStorage = VanaConfigWithStorage & {\n  operationStore?: IOperationStore | IRelayerStateStore; // Can be either type\n  atomicStore?: IAtomicStore;\n};\n\n/**\n * Internal implementation class for Node.js environments.\n * This class is not exported directly - use the Vana factory function instead.\n */\nclass VanaNodeImpl extends VanaCore {\n  override readonly operationStore?: IOperationStore | IRelayerStateStore;\n  override readonly atomicStore?: IAtomicStore;\n\n  constructor(config: VanaNodeConfig) {\n    super(new NodePlatformAdapter(), config);\n    this.operationStore = config.operationStore;\n    this.atomicStore = config.atomicStore;\n  }\n}\n\n/**\n * Creates a new Vana SDK instance configured for Node.js environments.\n *\n * @remarks\n * This is the primary entry point for Node.js applications using the Vana SDK. The function\n * automatically detects your configuration type and provides compile-time type safety:\n * - **With storage configured**: All methods including file upload/download are available\n * - **Without storage**: Storage-dependent methods throw runtime errors and are excluded from TypeScript\n *\n * The Node.js version provides enhanced capabilities including native file system access,\n * server-side cryptographic operations, and support for personal server deployment.\n * It includes all browser capabilities plus Node.js-specific optimizations and utilities.\n *\n * @param config - Configuration object containing wallet, storage, and relayer settings\n * @returns A fully configured Vana SDK instance for Node.js use\n * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing\n * @example\n * ```typescript\n * import { Vana } from '@opendatalabs/vana-sdk/node';\n * import { createWalletClient, http } from 'viem';\n * import { privateKeyToAccount } from 'viem/accounts';\n * import { IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk/node';\n * import { mokshaTestnet } from '@opendatalabs/vana-sdk/node';\n *\n * // Server setup with private key\n * const account = privateKeyToAccount('0x...');\n * const walletClient = createWalletClient({\n *   account,\n *   chain: mokshaTestnet,\n *   transport: http('https://rpc.moksha.vana.org')\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({\n *         gateway: 'https://gateway.pinata.cloud',\n *         timeout: 30000\n *       }),\n *       pinata: new PinataStorage({\n *         apiKey: process.env.PINATA_KEY,\n *         secretKey: process.env.PINATA_SECRET\n *       })\n *     },\n *     defaultProvider: 'pinata'\n *   },\n *   relayerCallbacks: {\n *     async submitPermissionGrant(typedData, signature) {\n *       // Server-side relayer implementation\n *       return await submitToCustomRelayer(typedData, signature);\n *     }\n *   }\n * });\n *\n * // Server operations\n * const uploadResult = await vana.data.upload({\n *   content: await fs.readFile('./user-data.json'),\n *   filename: 'user-data.json',\n *   schemaId: 1\n * });\n *\n * // Personal server setup\n * await vana.server.setupPersonalServer({\n *   serverUrl: 'https://my-server.example.com',\n *   capabilities: ['data_processing', 'ml_inference']\n * });\n * ```\n *\n * @example\n * ```typescript\n * // CLI tool or script usage\n * const vana = Vana({\n *   chainId: 14800, // Moksha testnet\n *   account: privateKeyToAccount(process.env.PRIVATE_KEY),\n *   rpcUrl: process.env.RPC_URL,\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n *\n * // Batch operations for data processing\n * const userFiles = await vana.data.getUserFiles({\n *   owner: process.env.USER_ADDRESS\n * });\n *\n * for (const file of userFiles) {\n *   const decrypted = await vana.data.decryptFile(file);\n *   // Process file data...\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Express.js server integration\n * import express from 'express';\n * import { handleRelayerOperation } from '@opendatalabs/vana-sdk/node';\n *\n * const app = express();\n *\n * app.post('/api/relay', async (req, res) => {\n *   try {\n *     const result = await handleRelayerOperation(\n *       vana,\n *       req.body\n *     );\n *     res.json(result);\n *   } catch (error) {\n *     res.status(500).json({ error: error.message });\n *   }\n * });\n * ```\n *\n * @see {@link https://docs.vana.org/docs/sdk/server-setup | Server Setup Guide} for Node.js-specific features\n * @see {@link VanaCore} for the underlying implementation details\n * @category Core SDK\n */\n// Overload 1: For configurations that include both storage and operation store\nexport function Vana(\n  config: VanaNodeConfigWithStorage & { operationStore: IOperationStore },\n): VanaNodeImpl & StorageRequiredMarker & RelayerRequiredMarker;\n\n// Overload 2: For configurations that include only the operation store\nexport function Vana(\n  config: VanaNodeConfig & { operationStore: IOperationStore },\n): VanaNodeImpl & RelayerRequiredMarker;\n\n// Overload 3: For configurations with storage but no operation store\nexport function Vana(\n  config: VanaNodeConfigWithStorage,\n): VanaNodeImpl & StorageRequiredMarker;\n\n// Overload 4: Base configuration without special requirements\nexport function Vana(config: VanaNodeConfig): VanaNodeImpl;\n\n// Implementation\nexport function Vana(config: VanaNodeConfig) {\n  return new VanaNodeImpl(config);\n}\n\n/**\n * The type of a Vana SDK instance in Node.js environments.\n * Uses InstanceType to properly expose all public methods from the class hierarchy.\n *\n * @see {@link Vana}\n */\nexport type VanaInstance = InstanceType<typeof VanaNodeImpl>;\n\n// Export as default export\nexport default Vana;\n\n// Re-export everything that was in index.ts (avoiding circular dependency)\n// Core class and factory\nexport { VanaCore, VanaCoreFactory } from \"./core\";\nexport { DistributedNonceManager } from \"./core/nonceManager\";\nexport { InMemoryNonceManager } from \"./core/inMemoryNonceManager\";\nexport { SystemHealthChecker } from \"./core/health\";\nexport type {\n  SystemHealthCheckerConfig,\n  HealthStatus,\n  ComponentHealth,\n  NonceHealth,\n  QueueHealth,\n} from \"./core/health\";\n\n// Storage implementations\nexport { RedisAtomicStore } from \"./lib/redisAtomicStore\";\nexport type { RedisAtomicStoreConfig } from \"./lib/redisAtomicStore\";\n\n// Types - modular exports\nexport type * from \"./types\";\nexport type { IAtomicStore } from \"./types/atomicStore\";\nexport type {\n  IOperationStore,\n  StoredOperation,\n  IRelayerStateStore,\n  OperationState,\n} from \"./types/operationStore\";\n\n// Type guards and utilities\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./types/external-apis\";\n\n// VanaContract is exported from abi to avoid circular dependencies\nexport type { VanaContract } from \"./generated/abi\";\n\n// Enhanced response pattern for improved developer experience\nexport {\n  EnhancedTransactionResponse,\n  canEnhanceResponse,\n  enhanceResponse,\n} from \"./client/enhancedResponse\";\n\n// Error classes\nexport * from \"./errors\";\n\n// Controllers\nexport { PermissionsController } from \"./controllers/permissions\";\nexport { RuntimePermissionsController } from \"./controllers/runtimePermissions\";\nexport { AccessSettlementController } from \"./controllers/accessSettlement\";\nexport { DataController } from \"./controllers/data\";\nexport { ServerController } from \"./controllers/server\";\nexport { ProtocolController } from \"./controllers/protocol\";\nexport { SchemaController } from \"./controllers/schemas\";\nexport { OperationsController } from \"./controllers/operations\";\n\n// Contract controller\nexport * from \"./contracts/contractController\";\n\n// Utilities\nexport * from \"./utils/encryption\";\nexport * from \"./utils/formatters\";\nexport * from \"./utils/grantFiles\";\nexport * from \"./utils/grantValidation\";\nexport * from \"./utils/grants\";\nexport * from \"./utils/ipfs\";\nexport * from \"./utils/schemaValidation\";\nexport * from \"./utils/signatureCache\";\n\n// Storage API\nexport * from \"./storage\";\n\n// Configuration\nexport { getContractAddress, CONTRACTS } from \"./generated/addresses\";\nexport { chains } from \"./config/chains\";\nexport {\n  type ServiceEndpoints,\n  mainnetServices,\n  mokshaServices,\n  getServiceEndpoints,\n  getDefaultPersonalServerUrl,\n} from \"./config/default-services\";\n\n// Chain configurations with subgraph URLs - explicit exports for better DX\nexport {\n  vanaMainnet,\n  mokshaTestnet,\n  moksha,\n  type VanaChainConfig,\n  getChainConfig,\n  getAllChains,\n} from \"./chains\";\nexport * from \"./chains\";\n\n// ABIs\nexport { getAbi } from \"./generated/abi\";\nexport type { VanaContract as VanaContractAbi } from \"./generated/abi\";\n\n// Generic utilities for extensibility\nexport {\n  BaseController,\n  RetryUtility,\n  RateLimiter,\n  MemoryCache,\n  EventEmitter,\n  MiddlewarePipeline,\n  AsyncQueue,\n  CircuitBreaker,\n} from \"./core/generics\";\n\n// Server-side utilities\nexport {\n  handleRelayerOperation,\n  type RelayerOperationOptions,\n} from \"./server/relayerHandler\";\nexport type {\n  UnifiedRelayerRequest,\n  UnifiedRelayerResponse,\n} from \"./types/relayer\";\n// TransactionHandle removed - using POJOs instead\nexport type {\n  Operation,\n  TransactionResult,\n  TransactionReceipt,\n  PollingOptions,\n  TransactionWaitOptions,\n} from \"./types/operations\";\n\n// Platform adapters\nexport { NodePlatformAdapter } from \"./platform/node\";\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Browser-safe platform utilities\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n\nexport { ApiClient } from \"./core/apiClient\";\n\nexport type {\n  ApiClientConfig,\n  HttpMethod,\n  RequestOptions,\n} from \"./core/apiClient\";\n\n// Note: Default export is already handled above with the Vana factory function\n// For testing purposes, we also export the implementation class\nexport { VanaNodeImpl };\n\n// Server-specific interface for accessing stores\nexport interface VanaWithStores {\n  readonly operationStore?: IOperationStore | IRelayerStateStore;\n  readonly atomicStore?: IAtomicStore;\n  readonly publicClient: PublicClient;\n}\n"],"mappings":"AAKA,SAAS,2BAA2B;AACpC,SAAS,gBAAgB;AAsCzB,MAAM,qBAAqB,SAAS;AAAA,EAChB;AAAA,EACA;AAAA,EAElB,YAAY,QAAwB;AAClC,UAAM,IAAI,oBAAoB,GAAG,MAAM;AACvC,SAAK,iBAAiB,OAAO;AAC7B,SAAK,cAAc,OAAO;AAAA,EAC5B;AACF;AA2IO,SAAS,KAAK,QAAwB;AAC3C,SAAO,IAAI,aAAa,MAAM;AAChC;AAWA,IAAO,qBAAQ;AAIf,SAAS,YAAAA,WAAU,uBAAuB;AAC1C,SAAS,+BAA+B;AACxC,SAAS,4BAA4B;AACrC,SAAS,2BAA2B;AAUpC,SAAS,wBAAwB;AAcjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,cAAc;AAGd,SAAS,6BAA6B;AACtC,SAAS,oCAAoC;AAC7C,SAAS,kCAAkC;AAC3C,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,4BAA4B;AAGrC,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,SAAS,oBAAoB,iBAAiB;AAC9C,SAAS,cAAc;AACvB;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAGd,SAAS,cAAc;AAIvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,OAEK;AAeP,SAAS,uBAAAC,4BAA2B;AACpC,SAAS,8BAA8B;AAIvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,iBAAiB;","names":["VanaCore","NodePlatformAdapter"]}

package/dist/lib/__tests__/redisAtomicStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/redisAtomicStore.cjs

@@ -0,0 +1,201 @@
+"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 redisAtomicStore_exports = {};
+__export(redisAtomicStore_exports, {
+  RedisAtomicStore: () => RedisAtomicStore
+});
+module.exports = __toCommonJS(redisAtomicStore_exports);
+class RedisAtomicStore {
+  redis;
+  // ioredis instance
+  keyPrefix;
+  /**
+   * Lua script for safe lock release.
+   * This ensures we only delete a lock if the value matches our lock ID.
+   */
+  UNLOCK_SCRIPT = `
+    if redis.call("GET", KEYS[1]) == ARGV[1] then
+      return redis.call("DEL", KEYS[1])
+    else
+      return 0
+    end
+  `;
+  constructor(config) {
+    if (typeof config.redis === "string") {
+      throw new Error(
+        "RedisAtomicStore requires an initialized Redis client instance. Please create the Redis client in your application and pass it to the constructor."
+      );
+    }
+    this.redis = config.redis;
+    this.keyPrefix = config.keyPrefix ?? "vana-sdk:atomic";
+    if (!this.redis || typeof this.redis.incr !== "function" || typeof this.redis.set !== "function" || typeof this.redis.get !== "function" || typeof this.redis.eval !== "function") {
+      throw new Error(
+        "Invalid Redis client instance provided to RedisAtomicStore"
+      );
+    }
+  }
+  /**
+   * Atomically increments a counter.
+   */
+  async incr(key) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    return await this.redis.incr(fullKey);
+  }
+  /**
+   * Acquires a distributed lock using SET NX EX.
+   */
+  async acquireLock(key, ttlSeconds) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    const lockId = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+    const result = await this.redis.set(
+      fullKey,
+      lockId,
+      "EX",
+      ttlSeconds,
+      "NX"
+    );
+    if (result === "OK") {
+      console.log(`[RedisAtomicStore] Lock acquired: ${key} with ID ${lockId}`);
+      return lockId;
+    }
+    return null;
+  }
+  /**
+   * Releases a lock using a Lua script for atomicity.
+   */
+  async releaseLock(key, lockId) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    const result = await this.redis.eval(
+      this.UNLOCK_SCRIPT,
+      1,
+      // Number of keys
+      fullKey,
+      // KEYS[1]
+      lockId
+      // ARGV[1]
+    );
+    if (result === 1) {
+      console.log(`[RedisAtomicStore] Lock released: ${key}`);
+    } else {
+      console.warn(
+        `[RedisAtomicStore] Lock release failed: ${key} (lock not held or expired)`
+      );
+    }
+  }
+  /**
+   * Gets a value from Redis.
+   */
+  async get(key) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    return await this.redis.get(fullKey);
+  }
+  /**
+   * Sets a value in Redis.
+   */
+  async set(key, value) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    await this.redis.set(fullKey, value);
+  }
+  /**
+   * Sets a value with TTL for automatic expiration.
+   */
+  async setWithTTL(key, value, ttlSeconds) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    await this.redis.setex(fullKey, ttlSeconds, value);
+  }
+  /**
+   * Deletes a key from Redis.
+   */
+  async delete(key) {
+    const fullKey = `${this.keyPrefix}:${key}`;
+    await this.redis.del(fullKey);
+  }
+  /**
+   * Executes a Lua script atomically.
+   *
+   * @remarks
+   * This provides generic script execution for complex atomic operations.
+   * Keys passed to the script will be automatically prefixed.
+   *
+   * @param script - The Lua script to execute
+   * @param keys - Array of keys (will be prefixed)
+   * @param args - Array of arguments
+   * @returns The script's return value
+   */
+  async eval(script, keys, args) {
+    const prefixedKeys = keys.map((key) => `${this.keyPrefix}:${key}`);
+    const result = await this.redis.eval(
+      script,
+      keys.length,
+      ...prefixedKeys,
+      ...args
+    );
+    return result;
+  }
+  /**
+   * Atomically assigns a nonce using Vana App's battle-tested logic.
+   *
+   * @remarks
+   * This is a Redis-specific optimization that uses a Lua script for
+   * atomic nonce assignment with gap prevention. This method is called
+   * by DistributedNonceManager when it detects a Redis store.
+   *
+   * Ported from apps/web/app/api/relay/route.ts (Vana App production code)
+   * DO NOT MODIFY without thorough testing in production environment.
+   *
+   * @param key - The key for storing the last used nonce
+   * @param pendingCount - The current pending transaction count from blockchain
+   * @returns The assigned nonce
+   */
+  async atomicAssignNonce(key, pendingCount) {
+    const LUA_ASSIGN_NONCE = `
+      -- KEYS[1] = lastUsedKey
+      -- ARGV[1] = pendingCount (integer)
+
+      local last = tonumber(redis.call("GET", KEYS[1]) or "-1")
+      local pending = tonumber(ARGV[1])
+      local candidate = last + 1
+      if pending > candidate or (candidate - pending > 500) then
+        -- If pending is ahead OR if candidate is too far ahead (>500 nonces), reset to pending
+        candidate = pending
+      end
+
+      -- IMPORTANT: Atomically update the last used nonce
+      redis.call("SET", KEYS[1], candidate)
+
+      return candidate
+    `;
+    const fullKey = `${this.keyPrefix}:${key}`;
+    const nonce = await this.redis.eval(
+      LUA_ASSIGN_NONCE,
+      1,
+      // Number of keys
+      fullKey,
+      // KEYS[1]
+      pendingCount.toString()
+      // ARGV[1]
+    );
+    return nonce;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RedisAtomicStore
+});
+//# sourceMappingURL=redisAtomicStore.cjs.map

package/dist/lib/redisAtomicStore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/redisAtomicStore.ts"],"sourcesContent":["/**\n * Redis implementation of IAtomicStore for production use.\n *\n * @remarks\n * This is a Node.js-only implementation that requires the ioredis package.\n * It will not be included in browser bundles.\n *\n * @module\n */\n\nimport type { IAtomicStoreWithNonceSupport } from \"../types/atomicStore\";\n\n/**\n * Configuration for RedisAtomicStore\n */\nexport interface RedisAtomicStoreConfig {\n  /** Redis connection URL or ioredis options */\n  redis: string | any;\n  /** Key prefix for all operations (default: 'vana-sdk:atomic') */\n  keyPrefix?: string;\n}\n\n/**\n * Redis-backed implementation of IAtomicStore.\n *\n * @remarks\n * This implementation uses Redis's native atomic operations:\n * - INCR for atomic counter increments\n * - SET NX EX for distributed locking\n * - Lua script for safe lock release\n *\n * Redis is ideal for this use case because:\n * - All operations are atomic by design\n * - Built-in TTL support for automatic cleanup\n * - High performance (sub-millisecond operations)\n * - Battle-tested in production environments\n *\n * @example\n * ```typescript\n * import Redis from 'ioredis';\n * import { RedisAtomicStore } from '@opendatalabs/vana-sdk/node';\n *\n * const redis = new Redis(process.env.REDIS_URL);\n * const atomicStore = new RedisAtomicStore({\n *   redis: redis\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   atomicStore,\n *   operationStore\n * });\n * ```\n *\n * @category Storage\n */\nexport class RedisAtomicStore implements IAtomicStoreWithNonceSupport {\n  private redis: any; // ioredis instance\n  private keyPrefix: string;\n\n  /**\n   * Lua script for safe lock release.\n   * This ensures we only delete a lock if the value matches our lock ID.\n   */\n  private readonly UNLOCK_SCRIPT = `\n    if redis.call(\"GET\", KEYS[1]) == ARGV[1] then\n      return redis.call(\"DEL\", KEYS[1])\n    else\n      return 0\n    end\n  `;\n\n  constructor(config: RedisAtomicStoreConfig) {\n    // Dynamic import to avoid bundling ioredis in browser builds\n    // The actual Redis instance should be passed in already created\n    if (typeof config.redis === \"string\") {\n      throw new Error(\n        \"RedisAtomicStore requires an initialized Redis client instance. \" +\n          \"Please create the Redis client in your application and pass it to the constructor.\",\n      );\n    }\n\n    this.redis = config.redis;\n    this.keyPrefix = config.keyPrefix ?? \"vana-sdk:atomic\";\n\n    // Validate that the redis instance has the methods we need\n    if (\n      !this.redis ||\n      typeof this.redis.incr !== \"function\" ||\n      typeof this.redis.set !== \"function\" ||\n      typeof this.redis.get !== \"function\" ||\n      typeof this.redis.eval !== \"function\"\n    ) {\n      throw new Error(\n        \"Invalid Redis client instance provided to RedisAtomicStore\",\n      );\n    }\n  }\n\n  /**\n   * Atomically increments a counter.\n   */\n  async incr(key: string): Promise<number> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    return await this.redis.incr(fullKey);\n  }\n\n  /**\n   * Acquires a distributed lock using SET NX EX.\n   */\n  async acquireLock(key: string, ttlSeconds: number): Promise<string | null> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    const lockId = `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;\n\n    // SET key value NX EX ttl\n    const result = await this.redis.set(\n      fullKey,\n      lockId,\n      \"EX\",\n      ttlSeconds,\n      \"NX\",\n    );\n\n    if (result === \"OK\") {\n      console.log(`[RedisAtomicStore] Lock acquired: ${key} with ID ${lockId}`);\n      return lockId;\n    }\n\n    return null;\n  }\n\n  /**\n   * Releases a lock using a Lua script for atomicity.\n   */\n  async releaseLock(key: string, lockId: string): Promise<void> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n\n    // Use Lua script for atomic compare-and-delete\n    const result = (await this.redis.eval(\n      this.UNLOCK_SCRIPT,\n      1, // Number of keys\n      fullKey, // KEYS[1]\n      lockId, // ARGV[1]\n    )) as number;\n\n    if (result === 1) {\n      console.log(`[RedisAtomicStore] Lock released: ${key}`);\n    } else {\n      console.warn(\n        `[RedisAtomicStore] Lock release failed: ${key} (lock not held or expired)`,\n      );\n    }\n  }\n\n  /**\n   * Gets a value from Redis.\n   */\n  async get(key: string): Promise<string | null> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    return await this.redis.get(fullKey);\n  }\n\n  /**\n   * Sets a value in Redis.\n   */\n  async set(key: string, value: string): Promise<void> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    await this.redis.set(fullKey, value);\n  }\n\n  /**\n   * Sets a value with TTL for automatic expiration.\n   */\n  async setWithTTL?(\n    key: string,\n    value: string,\n    ttlSeconds: number,\n  ): Promise<void> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    await this.redis.setex(fullKey, ttlSeconds, value);\n  }\n\n  /**\n   * Deletes a key from Redis.\n   */\n  async delete?(key: string): Promise<void> {\n    const fullKey = `${this.keyPrefix}:${key}`;\n    await this.redis.del(fullKey);\n  }\n\n  /**\n   * Executes a Lua script atomically.\n   *\n   * @remarks\n   * This provides generic script execution for complex atomic operations.\n   * Keys passed to the script will be automatically prefixed.\n   *\n   * @param script - The Lua script to execute\n   * @param keys - Array of keys (will be prefixed)\n   * @param args - Array of arguments\n   * @returns The script's return value\n   */\n  async eval(script: string, keys: string[], args: string[]): Promise<any> {\n    // Apply key prefix to all keys\n    const prefixedKeys = keys.map((key) => `${this.keyPrefix}:${key}`);\n\n    // Execute the Lua script\n    const result = await this.redis.eval(\n      script,\n      keys.length,\n      ...prefixedKeys,\n      ...args,\n    );\n\n    return result;\n  }\n\n  /**\n   * Atomically assigns a nonce using Vana App's battle-tested logic.\n   *\n   * @remarks\n   * This is a Redis-specific optimization that uses a Lua script for\n   * atomic nonce assignment with gap prevention. This method is called\n   * by DistributedNonceManager when it detects a Redis store.\n   *\n   * Ported from apps/web/app/api/relay/route.ts (Vana App production code)\n   * DO NOT MODIFY without thorough testing in production environment.\n   *\n   * @param key - The key for storing the last used nonce\n   * @param pendingCount - The current pending transaction count from blockchain\n   * @returns The assigned nonce\n   */\n  async atomicAssignNonce(key: string, pendingCount: number): Promise<number> {\n    const LUA_ASSIGN_NONCE = `\n      -- KEYS[1] = lastUsedKey\n      -- ARGV[1] = pendingCount (integer)\n\n      local last = tonumber(redis.call(\"GET\", KEYS[1]) or \"-1\")\n      local pending = tonumber(ARGV[1])\n      local candidate = last + 1\n      if pending > candidate or (candidate - pending > 500) then\n        -- If pending is ahead OR if candidate is too far ahead (>500 nonces), reset to pending\n        candidate = pending\n      end\n\n      -- IMPORTANT: Atomically update the last used nonce\n      redis.call(\"SET\", KEYS[1], candidate)\n\n      return candidate\n    `;\n\n    const fullKey = `${this.keyPrefix}:${key}`;\n    const nonce = (await this.redis.eval(\n      LUA_ASSIGN_NONCE,\n      1, // Number of keys\n      fullKey, // KEYS[1]\n      pendingCount.toString(), // ARGV[1]\n    )) as number;\n\n    return nonce;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/lib/redisAtomicStore.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Redis implementation of IAtomicStore for production use.
+ *
+ * @remarks
+ * This is a Node.js-only implementation that requires the ioredis package.
+ * It will not be included in browser bundles.
+ *
+ * @module
+ */
+import type { IAtomicStoreWithNonceSupport } from "../types/atomicStore";
+/**
+ * Configuration for RedisAtomicStore
+ */
+export interface RedisAtomicStoreConfig {
+    /** Redis connection URL or ioredis options */
+    redis: string | any;
+    /** Key prefix for all operations (default: 'vana-sdk:atomic') */
+    keyPrefix?: string;
+}
+/**
+ * Redis-backed implementation of IAtomicStore.
+ *
+ * @remarks
+ * This implementation uses Redis's native atomic operations:
+ * - INCR for atomic counter increments
+ * - SET NX EX for distributed locking
+ * - Lua script for safe lock release
+ *
+ * Redis is ideal for this use case because:
+ * - All operations are atomic by design
+ * - Built-in TTL support for automatic cleanup
+ * - High performance (sub-millisecond operations)
+ * - Battle-tested in production environments
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis';
+ * import { RedisAtomicStore } from '@opendatalabs/vana-sdk/node';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const atomicStore = new RedisAtomicStore({
+ *   redis: redis
+ * });
+ *
+ * const vana = Vana({
+ *   walletClient,
+ *   atomicStore,
+ *   operationStore
+ * });
+ * ```
+ *
+ * @category Storage
+ */
+export declare class RedisAtomicStore implements IAtomicStoreWithNonceSupport {
+    private redis;
+    private keyPrefix;
+    /**
+     * Lua script for safe lock release.
+     * This ensures we only delete a lock if the value matches our lock ID.
+     */
+    private readonly UNLOCK_SCRIPT;
+    constructor(config: RedisAtomicStoreConfig);
+    /**
+     * Atomically increments a counter.
+     */
+    incr(key: string): Promise<number>;
+    /**
+     * Acquires a distributed lock using SET NX EX.
+     */
+    acquireLock(key: string, ttlSeconds: number): Promise<string | null>;
+    /**
+     * Releases a lock using a Lua script for atomicity.
+     */
+    releaseLock(key: string, lockId: string): Promise<void>;
+    /**
+     * Gets a value from Redis.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Sets a value in Redis.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Sets a value with TTL for automatic expiration.
+     */
+    setWithTTL?(key: string, value: string, ttlSeconds: number): Promise<void>;
+    /**
+     * Deletes a key from Redis.
+     */
+    delete?(key: string): Promise<void>;
+    /**
+     * Executes a Lua script atomically.
+     *
+     * @remarks
+     * This provides generic script execution for complex atomic operations.
+     * Keys passed to the script will be automatically prefixed.
+     *
+     * @param script - The Lua script to execute
+     * @param keys - Array of keys (will be prefixed)
+     * @param args - Array of arguments
+     * @returns The script's return value
+     */
+    eval(script: string, keys: string[], args: string[]): Promise<any>;
+    /**
+     * Atomically assigns a nonce using Vana App's battle-tested logic.
+     *
+     * @remarks
+     * This is a Redis-specific optimization that uses a Lua script for
+     * atomic nonce assignment with gap prevention. This method is called
+     * by DistributedNonceManager when it detects a Redis store.
+     *
+     * Ported from apps/web/app/api/relay/route.ts (Vana App production code)
+     * DO NOT MODIFY without thorough testing in production environment.
+     *
+     * @param key - The key for storing the last used nonce
+     * @param pendingCount - The current pending transaction count from blockchain
+     * @returns The assigned nonce
+     */
+    atomicAssignNonce(key: string, pendingCount: number): Promise<number>;
+}