@opendatalabs/vana-sdk 2.2.1 → 2.2.2

package/dist/config/features.cjs

@@ -21,30 +21,7 @@ __export(features_exports, {
   features: () => features
 });
 module.exports = __toCommonJS(features_exports);
-const features = {
-  /**
-   * Use custom ECIES implementation instead of eccrypto
-   *
-   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
-   * When true: Uses the custom platform-specific ECIES implementation
-   *
-   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
-   *
-   * @example
-   * ```bash
-   * # Use eccrypto-js (default)
-   * VANA_USE_CUSTOM_ECIES=false npm run your-app
-   *
-   * # Use custom ECIES implementation
-   * VANA_USE_CUSTOM_ECIES=true npm run your-app
-   * ```
-   *
-   * @returns Whether to use custom ECIES implementation
-   */
-  get useCustomECIES() {
-    return process.env.VANA_USE_CUSTOM_ECIES === "true";
-  }
-};
+const features = {};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   features

package/dist/config/features.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## Dual-Mode ECIES Support\n *\n * The SDK supports two encryption implementations:\n *\n * 1. **eccrypto-js** (Default)\n *    - Pure JavaScript implementation\n *    - Works everywhere (Node.js and browsers)\n *    - No native dependencies\n *    - Good performance for most use cases\n *\n * 2. **Custom ECIES** (Opt-in)\n *    - Uses native `secp256k1` module in Node.js for optimal performance\n *    - Uses `@noble/secp256k1` in browsers (pure JS)\n *    - Slightly faster in Node.js environments\n *    - Currently used by tests to ensure compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead\n * - Node builds: Include both implementations, feature flag chooses at runtime\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n *\n * ### Future Plans\n * Once the custom ECIES implementation is battle-tested:\n * 1. Make custom ECIES the default\n * 2. Eventually remove eccrypto-js dependency\n * 3. Keep the same architecture (native for Node, @noble for browser)\n */\n\n/**\n * Feature flag configuration\n */\nexport const features = {\n  /**\n   * Use custom ECIES implementation instead of eccrypto\n   *\n   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability\n   * When true: Uses the custom platform-specific ECIES implementation\n   *\n   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true\n   *\n   * @example\n   * ```bash\n   * # Use eccrypto-js (default)\n   * VANA_USE_CUSTOM_ECIES=false npm run your-app\n   *\n   * # Use custom ECIES implementation\n   * VANA_USE_CUSTOM_ECIES=true npm run your-app\n   * ```\n   *\n   * @returns Whether to use custom ECIES implementation\n   */\n  get useCustomECIES(): boolean {\n    // Default to false (use eccrypto for stability)\n    // Tests will override this to true since they test the custom implementation\n    return process.env.VANA_USE_CUSTOM_ECIES === \"true\";\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCO,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBtB,IAAI,iBAA0B;AAG5B,WAAO,QAAQ,IAAI,0BAA0B;AAAA,EAC/C;AACF;","names":[]}
+{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## ECIES Encryption\n *\n * The SDK uses a custom ECIES implementation:\n * - **Node.js**: Uses native `secp256k1` module for optimal performance\n * - **Browser**: Uses `@noble/secp256k1` (pure JavaScript)\n * - Fully compatible with eccrypto format for backward compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Use `@noble/secp256k1` (no native dependencies)\n * - Node builds: Use native `secp256k1` when available for better performance\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n * - All encrypted data is compatible with the eccrypto format specification\n */\n\n/**\n * Feature flag configuration\n *\n * @remarks\n * Currently empty as all feature flags have been graduated to default behavior.\n * This module is kept for future feature flag additions.\n */\nexport const features = {};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+BO,MAAM,WAAW,CAAC;","names":[]}

package/dist/config/features.d.ts

@@ -8,55 +8,24 @@
  * The getter pattern is used to allow dynamic evaluation of environment variables,
  * which is necessary for tests to override the default before modules are loaded.
  *
- * ## Dual-Mode ECIES Support
+ * ## ECIES Encryption
  *
- * The SDK supports two encryption implementations:
- *
- * 1. **eccrypto-js** (Default)
- *    - Pure JavaScript implementation
- *    - Works everywhere (Node.js and browsers)
- *    - No native dependencies
- *    - Good performance for most use cases
- *
- * 2. **Custom ECIES** (Opt-in)
- *    - Uses native `secp256k1` module in Node.js for optimal performance
- *    - Uses `@noble/secp256k1` in browsers (pure JS)
- *    - Slightly faster in Node.js environments
- *    - Currently used by tests to ensure compatibility
+ * The SDK uses a custom ECIES implementation:
+ * - **Node.js**: Uses native `secp256k1` module for optimal performance
+ * - **Browser**: Uses `@noble/secp256k1` (pure JavaScript)
+ * - Fully compatible with eccrypto format for backward compatibility
  *
  * ### Architecture Notes
- * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead
- * - Node builds: Include both implementations, feature flag chooses at runtime
+ * - Browser builds: Use `@noble/secp256k1` (no native dependencies)
+ * - Node builds: Use native `secp256k1` when available for better performance
  * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues
- *
- * ### Future Plans
- * Once the custom ECIES implementation is battle-tested:
- * 1. Make custom ECIES the default
- * 2. Eventually remove eccrypto-js dependency
- * 3. Keep the same architecture (native for Node, @noble for browser)
+ * - All encrypted data is compatible with the eccrypto format specification
  */
 /**
  * Feature flag configuration
+ *
+ * @remarks
+ * Currently empty as all feature flags have been graduated to default behavior.
+ * This module is kept for future feature flag additions.
  */
-export declare const features: {
-    /**
-     * Use custom ECIES implementation instead of eccrypto
-     *
-     * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
-     * When true: Uses the custom platform-specific ECIES implementation
-     *
-     * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
-     *
-     * @example
-     * ```bash
-     * # Use eccrypto-js (default)
-     * VANA_USE_CUSTOM_ECIES=false npm run your-app
-     *
-     * # Use custom ECIES implementation
-     * VANA_USE_CUSTOM_ECIES=true npm run your-app
-     * ```
-     *
-     * @returns Whether to use custom ECIES implementation
-     */
-    readonly useCustomECIES: boolean;
-};
+export declare const features: {};

package/dist/config/features.js

@@ -1,27 +1,4 @@
-const features = {
-  /**
-   * Use custom ECIES implementation instead of eccrypto
-   *
-   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
-   * When true: Uses the custom platform-specific ECIES implementation
-   *
-   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
-   *
-   * @example
-   * ```bash
-   * # Use eccrypto-js (default)
-   * VANA_USE_CUSTOM_ECIES=false npm run your-app
-   *
-   * # Use custom ECIES implementation
-   * VANA_USE_CUSTOM_ECIES=true npm run your-app
-   * ```
-   *
-   * @returns Whether to use custom ECIES implementation
-   */
-  get useCustomECIES() {
-    return process.env.VANA_USE_CUSTOM_ECIES === "true";
-  }
-};
+const features = {};
 export {
   features
 };

package/dist/config/features.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## Dual-Mode ECIES Support\n *\n * The SDK supports two encryption implementations:\n *\n * 1. **eccrypto-js** (Default)\n *    - Pure JavaScript implementation\n *    - Works everywhere (Node.js and browsers)\n *    - No native dependencies\n *    - Good performance for most use cases\n *\n * 2. **Custom ECIES** (Opt-in)\n *    - Uses native `secp256k1` module in Node.js for optimal performance\n *    - Uses `@noble/secp256k1` in browsers (pure JS)\n *    - Slightly faster in Node.js environments\n *    - Currently used by tests to ensure compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead\n * - Node builds: Include both implementations, feature flag chooses at runtime\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n *\n * ### Future Plans\n * Once the custom ECIES implementation is battle-tested:\n * 1. Make custom ECIES the default\n * 2. Eventually remove eccrypto-js dependency\n * 3. Keep the same architecture (native for Node, @noble for browser)\n */\n\n/**\n * Feature flag configuration\n */\nexport const features = {\n  /**\n   * Use custom ECIES implementation instead of eccrypto\n   *\n   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability\n   * When true: Uses the custom platform-specific ECIES implementation\n   *\n   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true\n   *\n   * @example\n   * ```bash\n   * # Use eccrypto-js (default)\n   * VANA_USE_CUSTOM_ECIES=false npm run your-app\n   *\n   * # Use custom ECIES implementation\n   * VANA_USE_CUSTOM_ECIES=true npm run your-app\n   * ```\n   *\n   * @returns Whether to use custom ECIES implementation\n   */\n  get useCustomECIES(): boolean {\n    // Default to false (use eccrypto for stability)\n    // Tests will override this to true since they test the custom implementation\n    return process.env.VANA_USE_CUSTOM_ECIES === \"true\";\n  },\n};\n"],"mappings":"AAyCO,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBtB,IAAI,iBAA0B;AAG5B,WAAO,QAAQ,IAAI,0BAA0B;AAAA,EAC/C;AACF;","names":[]}
+{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## ECIES Encryption\n *\n * The SDK uses a custom ECIES implementation:\n * - **Node.js**: Uses native `secp256k1` module for optimal performance\n * - **Browser**: Uses `@noble/secp256k1` (pure JavaScript)\n * - Fully compatible with eccrypto format for backward compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Use `@noble/secp256k1` (no native dependencies)\n * - Node builds: Use native `secp256k1` when available for better performance\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n * - All encrypted data is compatible with the eccrypto format specification\n */\n\n/**\n * Feature flag configuration\n *\n * @remarks\n * Currently empty as all feature flags have been graduated to default behavior.\n * This module is kept for future feature flag additions.\n */\nexport const features = {};\n"],"mappings":"AA+BO,MAAM,WAAW,CAAC;","names":[]}

package/dist/crypto/ecies/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/crypto/ecies/index.ts"],"sourcesContent":["/**\n * ECIES Module Entry Point\n *\n * Exports interface and utilities for ECIES encryption/decryption\n * Platform-specific implementations are imported separately\n */\n\nexport type { ECIESProvider, ECIESEncrypted, ECIESOptions } from \"./interface\";\n\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./interface\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAKO;","names":[]}
+{"version":3,"sources":["../../../src/crypto/ecies/index.ts"],"sourcesContent":["/**\n * ECIES Module Entry Point\n *\n * Exports interface and utilities for ECIES encryption/decryption.\n * Platform-specific implementations (BrowserECIESProvider, NodeECIESProvider)\n * are exported from the platform entry points.\n *\n * @remarks\n * Import from platform-specific entry points:\n * - Browser: `import { BrowserECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/browser'`\n * - Node: `import { NodeECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/node'`\n *\n * @category Cryptography\n */\n\nexport type { ECIESProvider, ECIESEncrypted, ECIESOptions } from \"./interface\";\n\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./interface\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,uBAKO;","names":[]}

package/dist/crypto/ecies/index.d.ts

@@ -1,8 +1,16 @@
 /**
  * ECIES Module Entry Point
  *
- * Exports interface and utilities for ECIES encryption/decryption
- * Platform-specific implementations are imported separately
+ * Exports interface and utilities for ECIES encryption/decryption.
+ * Platform-specific implementations (BrowserECIESProvider, NodeECIESProvider)
+ * are exported from the platform entry points.
+ *
+ * @remarks
+ * Import from platform-specific entry points:
+ * - Browser: `import { BrowserECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/browser'`
+ * - Node: `import { NodeECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/node'`
+ *
+ * @category Cryptography
  */
 export type { ECIESProvider, ECIESEncrypted, ECIESOptions } from "./interface";
 export { ECIESError, isECIESEncrypted, serializeECIES, deserializeECIES, } from "./interface";

package/dist/crypto/ecies/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/crypto/ecies/index.ts"],"sourcesContent":["/**\n * ECIES Module Entry Point\n *\n * Exports interface and utilities for ECIES encryption/decryption\n * Platform-specific implementations are imported separately\n */\n\nexport type { ECIESProvider, ECIESEncrypted, ECIESOptions } from \"./interface\";\n\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./interface\";\n"],"mappings":"AASA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../../src/crypto/ecies/index.ts"],"sourcesContent":["/**\n * ECIES Module Entry Point\n *\n * Exports interface and utilities for ECIES encryption/decryption.\n * Platform-specific implementations (BrowserECIESProvider, NodeECIESProvider)\n * are exported from the platform entry points.\n *\n * @remarks\n * Import from platform-specific entry points:\n * - Browser: `import { BrowserECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/browser'`\n * - Node: `import { NodeECIESProvider, serializeECIES } from '@opendatalabs/vana-sdk/node'`\n *\n * @category Cryptography\n */\n\nexport type { ECIESProvider, ECIESEncrypted, ECIESOptions } from \"./interface\";\n\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./interface\";\n"],"mappings":"AAiBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/index.browser.d.ts

@@ -147,6 +147,8 @@ export { BaseController, RetryUtility, RateLimiter, MemoryCache, EventEmitter, M
 export { BrowserPlatformAdapter } from "./platform/browser";
 export { BrowserECIESUint8Provider as BrowserECIESProvider } from "./crypto/ecies/browser";
 export type { VanaPlatformAdapter } from "./platform/interface";
+export { ECIESError, isECIESEncrypted, serializeECIES, deserializeECIES, } from "./crypto/ecies";
+export type { ECIESProvider, ECIESEncrypted, ECIESOptions, } from "./crypto/ecies";
 export { createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-only";
 export { detectPlatform, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
 export { ApiClient } from "./core/apiClient";

package/dist/index.browser.js

@@ -67,6 +67,12 @@ import {
 } from "./core/generics";
 import { BrowserPlatformAdapter as BrowserPlatformAdapter2 } from "./platform/browser";
 import { BrowserECIESUint8Provider } from "./crypto/ecies/browser";
+import {
+  ECIESError,
+  isECIESEncrypted,
+  serializeECIES,
+  deserializeECIES
+} from "./crypto/ecies";
 import {
   createBrowserPlatformAdapter,
   createPlatformAdapterSafe
@@ -86,6 +92,7 @@ export {
   CONTRACTS,
   CircuitBreaker,
   DataController,
+  ECIESError,
   EnhancedTransactionResponse,
   EventEmitter,
   MemoryCache,
@@ -106,6 +113,7 @@ export {
   createBrowserPlatformAdapter,
   createPlatformAdapterSafe,
   index_browser_default as default,
+  deserializeECIES,
   detectPlatform,
   enhanceResponse,
   getAbi,
@@ -116,6 +124,7 @@ export {
   getPlatformCapabilities,
   getServiceEndpoints,
   isAPIResponse,
+  isECIESEncrypted,
   isPlatformSupported,
   isReplicateAPIResponse,
   mainnetServices,
@@ -124,6 +133,7 @@ export {
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,
+  serializeECIES,
   vanaMainnet
 };
 //# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.browser.ts"],"sourcesContent":["/**\n * @module Browser\n * Browser-specific implementation of the Vana SDK\n */\n\nimport { BrowserPlatformAdapter } from \"./platform/browser\";\nimport { VanaCore } from \"./core\";\nimport type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  StorageRequiredMarker,\n} from \"./types\";\n\n/**\n * Internal implementation class for browser environments.\n * This class is not exported directly - use the Vana factory function instead.\n */\nclass VanaBrowserImpl extends VanaCore {\n  constructor(config: VanaConfig) {\n    super(new BrowserPlatformAdapter(), config);\n  }\n}\n\n/**\n * Creates a new Vana SDK instance configured for browser environments.\n *\n * @remarks\n * This is the primary entry point for browser 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 SDK supports multiple wallet configurations (direct WalletClient or chain config),\n * various storage providers (IPFS, Pinata, Google Drive), and gasless transactions via relayers.\n * All operations are optimized for browser environments with proper bundle size optimization.\n *\n * @param config - Configuration object containing wallet, storage, and relayer settings\n * @returns A fully configured Vana SDK instance for browser use\n * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing\n * @example\n * ```typescript\n * import { Vana } from '@opendatalabs/vana-sdk/browser';\n * import { createWalletClient, custom } from 'viem';\n * import { IPFSStorage } from '@opendatalabs/vana-sdk/browser';\n *\n * // Complete setup with storage and wallet\n * const walletClient = createWalletClient({\n *   chain: mokshaTestnet,\n *   transport: custom(window.ethereum)\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({ gateway: 'https://gateway.pinata.cloud' }),\n *       pinata: new PinataStorage({ apiKey: process.env.PINATA_KEY })\n *     },\n *     defaultProvider: 'ipfs'\n *   },\n *   relayerCallbacks: {\n *     async submitPermissionGrant(typedData, signature) {\n *       const response = await fetch('/api/relay/grant', {\n *         method: 'POST',\n *         body: JSON.stringify({ typedData, signature })\n *       });\n *       return (await response.json()).transactionHash;\n *     }\n *   }\n * });\n *\n * // All operations now available\n * const files = await vana.data.getUserFiles();\n * const permissions = await vana.permissions.getUserPermissions();\n * await vana.data.upload({ content: 'My data', filename: 'data.txt' });\n * ```\n *\n * @example\n * ```typescript\n * // Minimal setup without storage (read-only operations)\n * const vanaReadOnly = Vana({ walletClient });\n *\n * // These work without storage\n * const files = await vanaReadOnly.data.getUserFiles();\n * const permissions = await vanaReadOnly.permissions.getUserPermissions();\n *\n * // This would throw a runtime error\n * // await vanaReadOnly.data.upload(params); // ❌ InvalidConfigurationError\n *\n * // Safe runtime check\n * if (vanaReadOnly.isStorageEnabled()) {\n *   await vanaReadOnly.data.upload(params); // ✅ TypeScript allows this\n * } else {\n *   console.log('Storage not configured - upload unavailable');\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Using chain configuration instead of wallet client\n * const vana = Vana({\n *   chainId: 14800, // Moksha testnet\n *   account: '0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36',\n *   rpcUrl: 'https://rpc.moksha.vana.org',\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n * ```\n *\n * @see {@link https://docs.vana.org/docs/sdk/getting-started | Getting Started Guide} for setup tutorials\n * @see {@link VanaCore} for the underlying implementation details\n * @category Core SDK\n */\nexport function Vana(\n  config: VanaConfigWithStorage,\n): VanaBrowserImpl & StorageRequiredMarker;\nexport function Vana(config: VanaConfig): VanaBrowserImpl;\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 VanaBrowserImpl(config);\n}\n\n/**\n * The type of a Vana SDK instance in browser 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 VanaBrowserImpl>;\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// 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 { 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// TransactionHandle removed - using POJOs instead\nexport type {\n  Operation,\n  TransactionResult,\n  TransactionReceipt,\n  PollingOptions,\n  TransactionWaitOptions,\n} from \"./types/operations\";\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// Platform adapters - browser-safe exports\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { BrowserECIESUint8Provider as BrowserECIESProvider } from \"./crypto/ecies/browser\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Browser-only platform adapter utilities\nexport {\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-only\";\n\n// Note: createNodePlatformAdapter is not exported in browser bundle to avoid Node.js dependencies\n\n// NodePlatformAdapter is available through dynamic import to avoid bundling Node.js dependencies\n// Use createNodePlatformAdapter() for dynamic import\n\n// Platform utilities - browser-safe only\nexport {\n  detectPlatform,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\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\n// For testing purposes, we also export the implementation class\nexport { VanaBrowserImpl };\n"],"mappings":"AAKA,SAAS,8BAA8B;AACvC,SAAS,gBAAgB;AAWzB,MAAM,wBAAwB,SAAS;AAAA,EACrC,YAAY,QAAoB;AAC9B,UAAM,IAAI,uBAAuB,GAAG,MAAM;AAAA,EAC5C;AACF;AAwGO,SAAS,KAAK,QAAoB;AACvC,SAAO,IAAI,gBAAgB,MAAM;AACnC;AAWA,IAAO,wBAAQ;AAIf,SAAS,YAAAA,WAAU,uBAAuB;AAM1C;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,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;AAWd,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,SAAS,0BAAAC,+BAA8B;AACvC,SAAsC,iCAA4B;AAIlE;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,iBAAiB;","names":["VanaCore","BrowserPlatformAdapter"]}
+{"version":3,"sources":["../src/index.browser.ts"],"sourcesContent":["/**\n * @module Browser\n * Browser-specific implementation of the Vana SDK\n */\n\nimport { BrowserPlatformAdapter } from \"./platform/browser\";\nimport { VanaCore } from \"./core\";\nimport type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  StorageRequiredMarker,\n} from \"./types\";\n\n/**\n * Internal implementation class for browser environments.\n * This class is not exported directly - use the Vana factory function instead.\n */\nclass VanaBrowserImpl extends VanaCore {\n  constructor(config: VanaConfig) {\n    super(new BrowserPlatformAdapter(), config);\n  }\n}\n\n/**\n * Creates a new Vana SDK instance configured for browser environments.\n *\n * @remarks\n * This is the primary entry point for browser 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 SDK supports multiple wallet configurations (direct WalletClient or chain config),\n * various storage providers (IPFS, Pinata, Google Drive), and gasless transactions via relayers.\n * All operations are optimized for browser environments with proper bundle size optimization.\n *\n * @param config - Configuration object containing wallet, storage, and relayer settings\n * @returns A fully configured Vana SDK instance for browser use\n * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing\n * @example\n * ```typescript\n * import { Vana } from '@opendatalabs/vana-sdk/browser';\n * import { createWalletClient, custom } from 'viem';\n * import { IPFSStorage } from '@opendatalabs/vana-sdk/browser';\n *\n * // Complete setup with storage and wallet\n * const walletClient = createWalletClient({\n *   chain: mokshaTestnet,\n *   transport: custom(window.ethereum)\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({ gateway: 'https://gateway.pinata.cloud' }),\n *       pinata: new PinataStorage({ apiKey: process.env.PINATA_KEY })\n *     },\n *     defaultProvider: 'ipfs'\n *   },\n *   relayerCallbacks: {\n *     async submitPermissionGrant(typedData, signature) {\n *       const response = await fetch('/api/relay/grant', {\n *         method: 'POST',\n *         body: JSON.stringify({ typedData, signature })\n *       });\n *       return (await response.json()).transactionHash;\n *     }\n *   }\n * });\n *\n * // All operations now available\n * const files = await vana.data.getUserFiles();\n * const permissions = await vana.permissions.getUserPermissions();\n * await vana.data.upload({ content: 'My data', filename: 'data.txt' });\n * ```\n *\n * @example\n * ```typescript\n * // Minimal setup without storage (read-only operations)\n * const vanaReadOnly = Vana({ walletClient });\n *\n * // These work without storage\n * const files = await vanaReadOnly.data.getUserFiles();\n * const permissions = await vanaReadOnly.permissions.getUserPermissions();\n *\n * // This would throw a runtime error\n * // await vanaReadOnly.data.upload(params); // ❌ InvalidConfigurationError\n *\n * // Safe runtime check\n * if (vanaReadOnly.isStorageEnabled()) {\n *   await vanaReadOnly.data.upload(params); // ✅ TypeScript allows this\n * } else {\n *   console.log('Storage not configured - upload unavailable');\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Using chain configuration instead of wallet client\n * const vana = Vana({\n *   chainId: 14800, // Moksha testnet\n *   account: '0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36',\n *   rpcUrl: 'https://rpc.moksha.vana.org',\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n * ```\n *\n * @see {@link https://docs.vana.org/docs/sdk/getting-started | Getting Started Guide} for setup tutorials\n * @see {@link VanaCore} for the underlying implementation details\n * @category Core SDK\n */\nexport function Vana(\n  config: VanaConfigWithStorage,\n): VanaBrowserImpl & StorageRequiredMarker;\nexport function Vana(config: VanaConfig): VanaBrowserImpl;\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 VanaBrowserImpl(config);\n}\n\n/**\n * The type of a Vana SDK instance in browser 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 VanaBrowserImpl>;\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// 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 { 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// TransactionHandle removed - using POJOs instead\nexport type {\n  Operation,\n  TransactionResult,\n  TransactionReceipt,\n  PollingOptions,\n  TransactionWaitOptions,\n} from \"./types/operations\";\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// Platform adapters - browser-safe exports\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport { BrowserECIESUint8Provider as BrowserECIESProvider } from \"./crypto/ecies/browser\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// ECIES utilities and types (exported via module index for consistency)\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./crypto/ecies\";\nexport type {\n  ECIESProvider,\n  ECIESEncrypted,\n  ECIESOptions,\n} from \"./crypto/ecies\";\n\n// Browser-only platform adapter utilities\nexport {\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-only\";\n\n// Note: createNodePlatformAdapter is not exported in browser bundle to avoid Node.js dependencies\n\n// NodePlatformAdapter is available through dynamic import to avoid bundling Node.js dependencies\n// Use createNodePlatformAdapter() for dynamic import\n\n// Platform utilities - browser-safe only\nexport {\n  detectPlatform,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\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\n// For testing purposes, we also export the implementation class\nexport { VanaBrowserImpl };\n"],"mappings":"AAKA,SAAS,8BAA8B;AACvC,SAAS,gBAAgB;AAWzB,MAAM,wBAAwB,SAAS;AAAA,EACrC,YAAY,QAAoB;AAC9B,UAAM,IAAI,uBAAuB,GAAG,MAAM;AAAA,EAC5C;AACF;AAwGO,SAAS,KAAK,QAAoB;AACvC,SAAO,IAAI,gBAAgB,MAAM;AACnC;AAWA,IAAO,wBAAQ;AAIf,SAAS,YAAAA,WAAU,uBAAuB;AAM1C;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,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;AAWd,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,SAAS,0BAAAC,+BAA8B;AACvC,SAAsC,iCAA4B;AAIlE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,iBAAiB;","names":["VanaCore","BrowserPlatformAdapter"]}

package/dist/index.node.cjs

@@ -27,11 +27,13 @@ __export(index_node_exports, {
   CircuitBreaker: () => import_generics.CircuitBreaker,
   DataController: () => import_data.DataController,
   DistributedNonceManager: () => import_nonceManager.DistributedNonceManager,
+  ECIESError: () => import_ecies.ECIESError,
   EnhancedTransactionResponse: () => import_enhancedResponse.EnhancedTransactionResponse,
   EventEmitter: () => import_generics.EventEmitter,
   InMemoryNonceManager: () => import_inMemoryNonceManager.InMemoryNonceManager,
   MemoryCache: () => import_generics.MemoryCache,
   MiddlewarePipeline: () => import_generics.MiddlewarePipeline,
+  NodeECIESProvider: () => import_node3.NodeECIESUint8Provider,
   NodePlatformAdapter: () => import_node2.NodePlatformAdapter,
   OperationsController: () => import_operations.OperationsController,
   PermissionsController: () => import_permissions.PermissionsController,
@@ -54,6 +56,7 @@ __export(index_node_exports, {
   createPlatformAdapterFor: () => import_utils.createPlatformAdapterFor,
   createPlatformAdapterSafe: () => import_browser_safe.createPlatformAdapterSafe,
   default: () => index_node_default,
+  deserializeECIES: () => import_ecies.deserializeECIES,
   detectPlatform: () => import_utils.detectPlatform,
   enhanceResponse: () => import_enhancedResponse.enhanceResponse,
   getAbi: () => import_abi.getAbi,
@@ -65,6 +68,7 @@ __export(index_node_exports, {
   getServiceEndpoints: () => import_default_services.getServiceEndpoints,
   handleRelayerOperation: () => import_relayerHandler.handleRelayerOperation,
   isAPIResponse: () => import_external_apis.isAPIResponse,
+  isECIESEncrypted: () => import_ecies.isECIESEncrypted,
   isPlatformSupported: () => import_utils.isPlatformSupported,
   isReplicateAPIResponse: () => import_external_apis.isReplicateAPIResponse,
   mainnetServices: () => import_default_services.mainnetServices,
@@ -73,6 +77,7 @@ __export(index_node_exports, {
   mokshaTestnet: () => import_chains2.mokshaTestnet,
   parseReplicateOutput: () => import_external_apis.parseReplicateOutput,
   safeParseJSON: () => import_external_apis.safeParseJSON,
+  serializeECIES: () => import_ecies.serializeECIES,
   vanaMainnet: () => import_chains2.vanaMainnet
 });
 module.exports = __toCommonJS(index_node_exports);
@@ -112,6 +117,8 @@ var import_generics = require("./core/generics");
 var import_relayerHandler = require("./server/relayerHandler");
 var import_node2 = require("./platform/node");
 var import_browser = require("./platform/browser");
+var import_node3 = require("./crypto/ecies/node");
+var import_ecies = require("./crypto/ecies");
 var import_utils = require("./platform/utils");
 var import_browser_safe = require("./platform/browser-safe");
 var import_apiClient = require("./core/apiClient");
@@ -138,11 +145,13 @@ var index_node_default = Vana;
   CircuitBreaker,
   DataController,
   DistributedNonceManager,
+  ECIESError,
   EnhancedTransactionResponse,
   EventEmitter,
   InMemoryNonceManager,
   MemoryCache,
   MiddlewarePipeline,
+  NodeECIESProvider,
   NodePlatformAdapter,
   OperationsController,
   PermissionsController,
@@ -164,6 +173,7 @@ var index_node_default = Vana;
   createPlatformAdapter,
   createPlatformAdapterFor,
   createPlatformAdapterSafe,
+  deserializeECIES,
   detectPlatform,
   enhanceResponse,
   getAbi,
@@ -175,6 +185,7 @@ var index_node_default = Vana;
   getServiceEndpoints,
   handleRelayerOperation,
   isAPIResponse,
+  isECIESEncrypted,
   isPlatformSupported,
   isReplicateAPIResponse,
   mainnetServices,
@@ -183,6 +194,7 @@ var index_node_default = Vana;
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,
+  serializeECIES,
   vanaMainnet,
   ...require("./errors"),
   ...require("./contracts/contractController"),

package/dist/index.node.cjs.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  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 { 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":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,kBAAoC;AACpC,kBAAyB;AA2MzB,IAAAA,eAA0C;AAC1C,0BAAwC;AACxC,kCAAqC;AACrC,oBAAoC;AAUpC,8BAAiC;AAcjC,2BAKO;AAMP,8BAIO;AAGP,+BAAc,qBA9Pd;AAiQA,yBAAsC;AACtC,kBAA+B;AAC/B,oBAAiC;AACjC,sBAAmC;AACnC,qBAAiC;AACjC,wBAAqC;AAGrC,+BAAc,2CAzQd;AA4QA,+BAAc,+BA5Qd;AA6QA,+BAAc,+BA7Qd;AA8QA,+BAAc,+BA9Qd;AA+QA,+BAAc,oCA/Qd;AAgRA,+BAAc,2BAhRd;AAiRA,+BAAc,yBAjRd;AAkRA,+BAAc,qCAlRd;AAmRA,+BAAc,mCAnRd;AAsRA,+BAAc,sBAtRd;AAyRA,uBAA8C;AAC9C,oBAAuB;AACvB,8BAMO;AAGP,IAAAC,iBAOO;AACP,+BAAc,qBA5Sd;AA+SA,iBAAuB;AAIvB,sBASO;AAGP,4BAGO;AAeP,IAAAC,eAAoC;AACpC,qBAAuC;AAIvC,mBAMO;AAGP,0BAIO;AAEP,uBAA0B;AAzT1B,MAAM,qBAAqB,qBAAS;AAAA,EAChB;AAAA,EACA;AAAA,EAElB,YAAY,QAAwB;AAClC,UAAM,IAAI,gCAAoB,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;","names":["import_core","import_chains","import_node"]}
+{"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 { 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 { NodeECIESUint8Provider as NodeECIESProvider } from \"./crypto/ecies/node\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// ECIES utilities and types (platform-agnostic, exported via module index)\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./crypto/ecies\";\nexport type {\n  ECIESProvider,\n  ECIESEncrypted,\n  ECIESOptions,\n} from \"./crypto/ecies\";\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":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,kBAAoC;AACpC,kBAAyB;AA2MzB,IAAAA,eAA0C;AAC1C,0BAAwC;AACxC,kCAAqC;AACrC,oBAAoC;AAUpC,8BAAiC;AAcjC,2BAKO;AAMP,8BAIO;AAGP,+BAAc,qBA9Pd;AAiQA,yBAAsC;AACtC,kBAA+B;AAC/B,oBAAiC;AACjC,sBAAmC;AACnC,qBAAiC;AACjC,wBAAqC;AAGrC,+BAAc,2CAzQd;AA4QA,+BAAc,+BA5Qd;AA6QA,+BAAc,+BA7Qd;AA8QA,+BAAc,+BA9Qd;AA+QA,+BAAc,oCA/Qd;AAgRA,+BAAc,2BAhRd;AAiRA,+BAAc,yBAjRd;AAkRA,+BAAc,qCAlRd;AAmRA,+BAAc,mCAnRd;AAsRA,+BAAc,sBAtRd;AAyRA,uBAA8C;AAC9C,oBAAuB;AACvB,8BAMO;AAGP,IAAAC,iBAOO;AACP,+BAAc,qBA5Sd;AA+SA,iBAAuB;AAIvB,sBASO;AAGP,4BAGO;AAeP,IAAAC,eAAoC;AACpC,qBAAuC;AACvC,IAAAA,eAA4D;AAI5D,mBAKO;AAQP,mBAMO;AAGP,0BAIO;AAEP,uBAA0B;AAvU1B,MAAM,qBAAqB,qBAAS;AAAA,EAChB;AAAA,EACA;AAAA,EAElB,YAAY,QAAwB;AAClC,UAAM,IAAI,gCAAoB,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;","names":["import_core","import_chains","import_node"]}

package/dist/index.node.d.ts

@@ -211,7 +211,10 @@ export type { UnifiedRelayerRequest, UnifiedRelayerResponse, } from "./types/rel
 export type { Operation, TransactionResult, TransactionReceipt, PollingOptions, TransactionWaitOptions, } from "./types/operations";
 export { NodePlatformAdapter } from "./platform/node";
 export { BrowserPlatformAdapter } from "./platform/browser";
+export { NodeECIESUint8Provider as NodeECIESProvider } from "./crypto/ecies/node";
 export type { VanaPlatformAdapter } from "./platform/interface";
+export { ECIESError, isECIESEncrypted, serializeECIES, deserializeECIES, } from "./crypto/ecies";
+export type { ECIESProvider, ECIESEncrypted, ECIESOptions, } from "./crypto/ecies";
 export { detectPlatform, createPlatformAdapter, createPlatformAdapterFor, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
 export { createNodePlatformAdapter, createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-safe";
 export { ApiClient } from "./core/apiClient";

package/dist/index.node.js

@@ -78,6 +78,13 @@ import {
 } from "./server/relayerHandler";
 import { NodePlatformAdapter as NodePlatformAdapter2 } from "./platform/node";
 import { BrowserPlatformAdapter } from "./platform/browser";
+import { NodeECIESUint8Provider } from "./crypto/ecies/node";
+import {
+  ECIESError,
+  isECIESEncrypted,
+  serializeECIES,
+  deserializeECIES
+} from "./crypto/ecies";
 import {
   detectPlatform,
   createPlatformAdapter,
@@ -100,11 +107,13 @@ export {
   CircuitBreaker,
   DataController,
   DistributedNonceManager,
+  ECIESError,
   EnhancedTransactionResponse,
   EventEmitter,
   InMemoryNonceManager,
   MemoryCache,
   MiddlewarePipeline,
+  NodeECIESUint8Provider as NodeECIESProvider,
   NodePlatformAdapter2 as NodePlatformAdapter,
   OperationsController,
   PermissionsController,
@@ -127,6 +136,7 @@ export {
   createPlatformAdapterFor,
   createPlatformAdapterSafe,
   index_node_default as default,
+  deserializeECIES,
   detectPlatform,
   enhanceResponse,
   getAbi,
@@ -138,6 +148,7 @@ export {
   getServiceEndpoints,
   handleRelayerOperation,
   isAPIResponse,
+  isECIESEncrypted,
   isPlatformSupported,
   isReplicateAPIResponse,
   mainnetServices,
@@ -146,6 +157,7 @@ export {
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,
+  serializeECIES,
   vanaMainnet
 };
 //# sourceMappingURL=index.node.js.map

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  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 { 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,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"]}
+{"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 { 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 { NodeECIESUint8Provider as NodeECIESProvider } from \"./crypto/ecies/node\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// ECIES utilities and types (platform-agnostic, exported via module index)\nexport {\n  ECIESError,\n  isECIESEncrypted,\n  serializeECIES,\n  deserializeECIES,\n} from \"./crypto/ecies\";\nexport type {\n  ECIESProvider,\n  ECIESEncrypted,\n  ECIESOptions,\n} from \"./crypto/ecies\";\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,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;AACvC,SAAmC,8BAAyB;AAI5D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP;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"]}