@opendatalabs/vana-sdk 0.1.0-alpha.7ee7635 → 0.1.0-alpha.8117ac2

package/dist/index.browser.d.ts

@@ -1,94 +1,9 @@
-import { VanaCore } from './core.js';
-export { VanaCoreFactory } from './core.js';
-export { GrantPermissionParams, UserFile } from './types.js';
-export { APIResponse, PinataListResponse, PinataPin, PinataUploadResponse, ReplicateAPIResponse, ReplicateStatus, isAPIResponse, isReplicateAPIResponse, parseReplicateOutput, safeParseJSON } from './types/external-apis.js';
-export { VanaContract, VanaContract as VanaContractAbi, getAbi } from './generated/abi/index.js';
-export { BlockchainError, ContractNotFoundError, InvalidConfigurationError, NetworkError, NonceError, PermissionError, PersonalServerError, RelayerError, SerializationError, ServerUrlMismatchError, SignatureError, UserRejectedRequestError, VanaError } from './errors.js';
-export { PermissionsController } from './controllers/permissions.js';
-export { DataController } from './controllers/data.js';
-export { ServerController } from './controllers/server.js';
-export { ProtocolController } from './controllers/protocol.js';
-export { ContractFactory, __contractCache, clearContractCache, getContractController, getContractInfo } from './contracts/contractController.js';
-export { DEFAULT_ENCRYPTION_SEED, decryptBlobWithSignedKey, decryptWithPrivateKey, decryptWithWalletPrivateKey, encryptBlobWithSignedKey, encryptFileKey, encryptWithWalletPublicKey, generateEncryptionKey, generateEncryptionKeyPair, generatePGPKeyPair, getEncryptionParameters } from './utils/encryption.js';
-export { formatEth, formatNumber, formatToken, shortenAddress } from './utils/formatters.js';
-export { createGrantFile, getGrantFileHash, retrieveGrantFile, storeGrantFile, validateGrantFile } from './utils/grantFiles.js';
-export { GrantExpiredError, GrantSchemaError, GrantValidationError, GrantValidationOptions, GrantValidationResult, GranteeMismatchError, OperationNotAllowedError, validateGrant, validateGrantExpiry, validateGranteeAccess, validateOperationAccess } from './utils/grantValidation.js';
-export { checkGrantAccess, createAndStoreGrant, createValidatedGrant, getGrantTimeRemaining, isGrantExpired, retrieveAndValidateGrant, summarizeGrant } from './utils/grants.js';
-export { DEFAULT_IPFS_GATEWAY, IPFS_GATEWAYS, convertIpfsUrl, convertIpfsUrlWithFallbacks, extractIpfsHash, fetchWithFallbacks, getGatewayUrls, isIpfsUrl } from './utils/ipfs.js';
-export { DataSchema, SchemaValidationError, SchemaValidator, fetchAndValidateSchema, schemaValidator, validateDataAgainstSchema, validateDataSchemaAgainstMetaSchema } from './utils/schemaValidation.js';
-export { SignatureCache, withSignatureCache } from './utils/signatureCache.js';
-export { Operation, PollingOptions, TransactionReceipt, TransactionResult, TransactionWaitOptions } from './types/operations.js';
-export { StorageError, StorageFile, StorageListOptions, StorageProvider, StorageProviderConfig, StorageUploadResult } from './types/storage.js';
-export { GoogleDriveStorage } from './storage/providers/google-drive.js';
-export { IpfsStorage } from './storage/providers/ipfs.js';
-export { PinataStorage } from './storage/providers/pinata.js';
-export { CallbackStorage } from './storage/providers/callback-storage.js';
-export { StorageManager } from './storage/manager.js';
-import { VanaConfigWithStorage, VanaConfig, StorageRequiredMarker } from './types/config.js';
-export { BaseConfig, BaseConfigWithStorage, ChainConfig, ChainConfigWithStorage, ConfigValidationOptions, ConfigValidationResult, DownloadRelayerCallbacks, RelayerCallbacks, RuntimeConfig, StorageCallbacks, StorageConfig, StorageDownloadOptions, StorageListResult, WalletConfig, WalletConfigWithStorage, hasStorageConfig, isChainConfig, isWalletConfig } from './types/config.js';
-export { getContractAddress } from './config/addresses.js';
-export { chains } from './config/chains.js';
-export { VanaChainConfig, getAllChains, getChainConfig, moksha, mokshaTestnet, vanaMainnet } from './chains/definitions.js';
-export { AsyncQueue, BaseController, CircuitBreaker, EventEmitter, MemoryCache, MiddlewarePipeline, RateLimiter, RetryUtility } from './core/generics.js';
-export { BrowserPlatformAdapter } from './platform/browser.js';
-export { BrowserECIESUint8Provider as BrowserECIESProvider } from './crypto/ecies/browser.js';
-export { VanaPlatformAdapter } from './platform/interface.js';
-export { createBrowserPlatformAdapter, createPlatformAdapterSafe } from './platform/browser-only.js';
-export { detectPlatform, getPlatformCapabilities, isPlatformSupported } from './platform/utils.js';
-export { ApiClient, ApiClientConfig, HttpMethod, RequestOptions } from './core/apiClient.js';
-export { VanaChain, VanaChainId, isVanaChain, isVanaChainId } from './types/chains.js';
-export { ContractAddresses, ContractDeployment, ContractInfo, ContractMethodParams, ContractMethodReturnType, VanaContractInstance, VanaContractName } from './types/contracts.js';
-export { AddRefinerParams, AddRefinerResult, AddSchemaParams, AddSchemaResult, BatchUploadParams, BatchUploadResult, CompleteSchema, DeleteFileParams, DeleteFileResult, DownloadFileParams, DownloadFileResult, EncryptedUploadParams, EncryptionInfo, FileAccessPermissions, FileMetadata, FilePermissionParams, FileSharingConfig, GetFileParams, GetUserFilesParams, GetUserTrustedServersParams, LegacyPermissionParams, Refiner, Schema, SchemaMetadata, TrustedServer, UnencryptedUploadParams, UpdateSchemaIdParams, UpdateSchemaIdResult, UploadEncryptedFileResult, UploadFileParams, UploadFileResult, UploadParams, UploadResult } from './types/data.js';
-export { CreateSchemaParams, CreateSchemaResult } from './controllers/schemas.js';
-export { AddAndTrustServerInput, AddAndTrustServerParams, AddAndTrustServerTypedData, BatchServerInfoResult, CheckPermissionParams, GenericTypedData, GetUserPermissionsOptions, GrantFile, GrantedPermission, Grantee, GranteeInfo, GranteeQueryOptions, OnChainPermissionGrant, PaginatedGrantees, PaginatedTrustedServers, Permission, PermissionAnalytics, PermissionCheckResult, PermissionEvent, PermissionGrantDomain, PermissionGrantMessage, PermissionGrantTypedData, PermissionInfo, PermissionInputMessage, PermissionOperation, PermissionQueryResult, PermissionStatus, QueryPermissionsParams, RegisterGranteeInput, RegisterGranteeParams, RegisterGranteeTypedData, RevokePermissionInput, RevokePermissionParams, RevokePermissionTypedData, Server, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, ServerInfo, ServerTrustStatus, SimplifiedPermissionMessage, SpecificTypedData, TrustServerInput, TrustServerParams, TrustServerTypedData, TrustedServerInfo, TrustedServerQueryOptions, TypedDataPrimaryType, UntrustServerInput, UntrustServerParams, UntrustServerTypedData } from './types/permissions.js';
-export { CreateOperationParams, InitPersonalServerParams, PersonalServerIdentity, PostRequestParams } from './types/personal.js';
-export { RelayerConfig, RelayerErrorResponse, RelayerMetrics, RelayerQueueInfo, RelayerRequestOptions, RelayerStatus, RelayerStorageResponse, RelayerStoreParams, RelayerSubmitParams, RelayerTransactionResponse, RelayerTransactionStatus, RelayerWebhookConfig, RelayerWebhookPayload } from './types/relayer.js';
-export { ApiResponse, Awaited, BlockRange, CacheConfig, GasEstimate, MaybeArray, MaybePromise, NetworkInfo, PaginationParams, PaginationResult, PartialExcept, RateLimitInfo, RequiredExcept, StatusInfo, TimeRange, TransactionOptions, UploadProgress, ValidationResult } from './types/utils.js';
-export { AllKeys, AsyncResult, Brand, Cache, ConditionalOptional, ContractCall, Controller, ControllerContext, DeepPartial, DeepReadonly, EventFilter, EventLog, Factory, GenericRequest, GenericResponse, Middleware, Nominal, NonNullable, Observable, Observer, OmitByType, OptionalKeys, PickByType, Plugin, PromiseResult, RateLimiterConfig, Repository, RequireKeys, RetryConfig, Service, StateMachine, Transformer, Validator } from './types/generics.js';
-export { Abi, Account, Address, Chain, GetContractReturnType, Hash, PublicClient, WalletClient } from 'viem';
-export { $defs, components as ServerComponents, $defs as ServerDefs, operations as ServerOperations, paths as ServerPaths, webhooks as ServerWebhooks, components, operations, paths, webhooks } from './generated/server/server.js';
-export { AuthenticationErrorResponse, BlockchainErrorResponse, ComputeErrorResponse, CreateOperationRequest, CreateOperationResponse, DecryptionErrorResponse, ErrorResponse, FileAccessErrorResponse, GetOperationResponse, GrantValidationErrorResponse, IdentityResponseModel, InternalServerErrorResponse, NotFoundErrorResponse, OperationErrorResponse, PersonalServerModel, ValidationErrorResponse } from './generated/server/server-exports.js';
-import './generated/event-types.js';
-import './generated/abi/ComputeEngineImplementation.js';
-import './generated/abi/DataRegistryImplementation.js';
-import './generated/abi/TeePoolImplementation.js';
-import './generated/abi/TeePoolPhalaImplementation.js';
-import './generated/abi/DataPortabilityPermissionsImplementation.js';
-import './generated/abi/DataPortabilityServersImplementation.js';
-import './generated/abi/DataPortabilityGranteesImplementation.js';
-import './generated/abi/DataRefinerRegistryImplementation.js';
-import './generated/abi/QueryEngineImplementation.js';
-import './generated/abi/ComputeInstructionRegistryImplementation.js';
-import './generated/abi/TeePoolEphemeralStandardImplementation.js';
-import './generated/abi/TeePoolPersistentStandardImplementation.js';
-import './generated/abi/TeePoolPersistentGpuImplementation.js';
-import './generated/abi/TeePoolDedicatedStandardImplementation.js';
-import './generated/abi/TeePoolDedicatedGpuImplementation.js';
-import './generated/abi/VanaEpochImplementation.js';
-import './generated/abi/DLPRegistryImplementation.js';
-import './generated/abi/DLPTreasuryImplementation.js';
-import './generated/abi/DLPRewardDeployerTreasuryImplementation.js';
-import './generated/abi/DLPPerformanceImplementation.js';
-import './generated/abi/DLPRewardDeployerImplementation.js';
-import './generated/abi/DLPRewardSwapImplementation.js';
-import './generated/abi/SwapHelperImplementation.js';
-import './generated/abi/DLPRootImplementation.js';
-import './generated/abi/DataLiquidityPoolImplementation.js';
-import './generated/abi/DLPRegistryTreasuryImplementation.js';
-import './generated/abi/VanaPoolStakingImplementation.js';
-import './generated/abi/VanaPoolEntityImplementation.js';
-import './generated/abi/VanaPoolTreasuryImplementation.js';
-import './generated/abi/DATImplementation.js';
-import './generated/abi/DATFactoryImplementation.js';
-import './generated/abi/DATPausableImplementation.js';
-import './generated/abi/DATVotesImplementation.js';
-import './types/transactionResults.js';
-import './types/controller-context.js';
-import 'abitype';
-import './core/client.js';
-import './crypto/ecies/base.js';
-import './crypto/ecies/interface.js';
-
+/**
+ * @module Browser
+ * Browser-specific implementation of the Vana SDK
+ */
+import { VanaCore } from "./core";
+import type { VanaConfig, VanaConfigWithStorage, StorageRequiredMarker } from "./types";
 /**
  * Internal implementation class for browser environments.
  * This class is not exported directly - use the Vana factory function instead.
@@ -188,14 +103,50 @@ declare class VanaBrowserImpl extends VanaCore {
  * @see {@link VanaCore} for the underlying implementation details
  * @category Core SDK
  */
-declare function Vana(config: VanaConfigWithStorage): VanaBrowserImpl & StorageRequiredMarker;
-declare function Vana(config: VanaConfig): VanaBrowserImpl;
+export declare function Vana(config: VanaConfigWithStorage): VanaBrowserImpl & StorageRequiredMarker;
+export declare function Vana(config: VanaConfig): VanaBrowserImpl;
 /**
  * The type of a Vana SDK instance in browser environments.
  * Uses InstanceType to properly expose all public methods from the class hierarchy.
  *
  * @see {@link Vana}
  */
-type VanaInstance = InstanceType<typeof VanaBrowserImpl>;
-
-export { StorageRequiredMarker, Vana, VanaBrowserImpl, VanaConfig, VanaConfigWithStorage, VanaCore, type VanaInstance, Vana as default };
+export type VanaInstance = InstanceType<typeof VanaBrowserImpl>;
+export default Vana;
+export { VanaCore, VanaCoreFactory } from "./core";
+export type * from "./types";
+export { isReplicateAPIResponse, isAPIResponse, safeParseJSON, parseReplicateOutput, } from "./types/external-apis";
+export type { VanaContract } from "./generated/abi";
+export * from "./errors";
+export { PermissionsController } from "./controllers/permissions";
+export { DataController } from "./controllers/data";
+export { ServerController } from "./controllers/server";
+export { ProtocolController } from "./controllers/protocol";
+export { SchemaController } from "./controllers/schemas";
+export * from "./contracts/contractController";
+export * from "./utils/encryption";
+export * from "./utils/formatters";
+export * from "./utils/grantFiles";
+export * from "./utils/grantValidation";
+export * from "./utils/grants";
+export * from "./utils/ipfs";
+export * from "./utils/schemaValidation";
+export * from "./utils/signatureCache";
+export type { Operation, TransactionResult, TransactionReceipt, PollingOptions, TransactionWaitOptions, } from "./types/operations";
+export * from "./storage";
+export { getContractAddress } from "./config/addresses";
+export { chains } from "./config/chains";
+export { type ServiceEndpoints, mainnetServices, mokshaServices, getServiceEndpoints, getDefaultPersonalServerUrl, } from "./config/default-services";
+export { vanaMainnet, mokshaTestnet, moksha, type VanaChainConfig, getChainConfig, getAllChains, } from "./chains";
+export * from "./chains";
+export { getAbi } from "./generated/abi";
+export type { VanaContract as VanaContractAbi } from "./generated/abi";
+export { BaseController, RetryUtility, RateLimiter, MemoryCache, EventEmitter, MiddlewarePipeline, AsyncQueue, CircuitBreaker, } from "./core/generics";
+export { BrowserPlatformAdapter } from "./platform/browser";
+export { BrowserECIESUint8Provider as BrowserECIESProvider } from "./crypto/ecies/browser";
+export type { VanaPlatformAdapter } from "./platform/interface";
+export { createBrowserPlatformAdapter, createPlatformAdapterSafe, } from "./platform/browser-only";
+export { detectPlatform, isPlatformSupported, getPlatformCapabilities, } from "./platform/utils";
+export { ApiClient } from "./core/apiClient";
+export type { ApiClientConfig, HttpMethod, RequestOptions, } from "./core/apiClient";
+export { VanaBrowserImpl };

package/dist/index.browser.js

@@ -21,6 +21,7 @@ import { PermissionsController } from "./controllers/permissions";
 import { DataController } from "./controllers/data";
 import { ServerController } from "./controllers/server";
 import { ProtocolController } from "./controllers/protocol";
+import { SchemaController } from "./controllers/schemas";
 export * from "./contracts/contractController";
 export * from "./utils/encryption";
 export * from "./utils/formatters";
@@ -33,6 +34,12 @@ export * from "./utils/signatureCache";
 export * from "./storage";
 import { getContractAddress } from "./config/addresses";
 import { chains } from "./config/chains";
+import {
+  mainnetServices,
+  mokshaServices,
+  getServiceEndpoints,
+  getDefaultPersonalServerUrl
+} from "./config/default-services";
 import {
   vanaMainnet,
   mokshaTestnet,
@@ -79,6 +86,7 @@ export {
   ProtocolController,
   RateLimiter,
   RetryUtility,
+  SchemaController,
   ServerController,
   Vana,
   VanaBrowserImpl,
@@ -93,11 +101,15 @@ export {
   getAllChains,
   getChainConfig,
   getContractAddress,
+  getDefaultPersonalServerUrl,
   getPlatformCapabilities,
+  getServiceEndpoints,
   isAPIResponse,
   isPlatformSupported,
   isReplicateAPIResponse,
+  mainnetServices,
   moksha,
+  mokshaServices,
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.browser.ts"],"sourcesContent":["import { 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// 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\";\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 } from \"./config/addresses\";\nexport { chains } from \"./config/chains\";\n\n// Chain configurations with subgraph URLs - explicit exports for better DX\nexport {\n  vanaMainnet,\n  mokshaTestnet,\n  moksha,\n  type VanaChainConfig,\n  getChainConfig,\n  getAllChains,\n} from \"./chains\";\nexport * from \"./chains\";\n\n// ABIs\nexport { getAbi } from \"./generated/abi\";\nexport type { VanaContract as VanaContractAbi } from \"./generated/abi\";\n\n// Generic utilities for extensibility\nexport {\n  BaseController,\n  RetryUtility,\n  RateLimiter,\n  MemoryCache,\n  EventEmitter,\n  MiddlewarePipeline,\n  AsyncQueue,\n  CircuitBreaker,\n} from \"./core/generics\";\n\n// 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":"AAAA,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,cAAc;AAGd,SAAS,6BAA6B;AACtC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AAGnC,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAWd,cAAc;AAGd,SAAS,0BAA0B;AACnC,SAAS,cAAc;AAGvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAGd,SAAS,cAAc;AAIvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,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// Error classes\nexport * from \"./errors\";\n\n// Controllers\nexport { PermissionsController } from \"./controllers/permissions\";\nexport { DataController } from \"./controllers/data\";\nexport { ServerController } from \"./controllers/server\";\nexport { ProtocolController } from \"./controllers/protocol\";\nexport { SchemaController } from \"./controllers/schemas\";\n\n// Contract controller\nexport * from \"./contracts/contractController\";\n\n// Utilities\nexport * from \"./utils/encryption\";\nexport * from \"./utils/formatters\";\nexport * from \"./utils/grantFiles\";\nexport * from \"./utils/grantValidation\";\nexport * from \"./utils/grants\";\nexport * from \"./utils/ipfs\";\nexport * from \"./utils/schemaValidation\";\nexport * from \"./utils/signatureCache\";\n// 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 } from \"./config/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,cAAc;AAGd,SAAS,6BAA6B;AACtC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AAGjC,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAWd,cAAc;AAGd,SAAS,0BAA0B;AACnC,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"]}

package/dist/index.cjs

@@ -1,3 +1,5 @@
 "use strict";
-throw new Error('Import from "@opendatalabs/vana-sdk/browser" or "@opendatalabs/vana-sdk/node" instead of the root entry point.');
+throw new Error(
+  'Import from "@opendatalabs/vana-sdk/browser" or "@opendatalabs/vana-sdk/node" instead of the root entry point.'
+);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["throw new Error('Import from \"@opendatalabs/vana-sdk/browser\" or \"@opendatalabs/vana-sdk/node\" instead of the root entry point.');\n"],"mappings":";AAAA,MAAM,IAAI,MAAM,gHAAgH;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Main entry point for the Vana SDK.\n *\n * @remarks\n * This module prevents accidental imports from the root package path and\n * ensures developers explicitly choose the correct platform-specific build.\n * The SDK requires platform-specific implementations for cryptography,\n * storage, and networking operations.\n *\n * **DO NOT import from this module directly.**\n *\n * Instead, use one of the platform-specific entry points:\n * - `@opendatalabs/vana-sdk/browser` for web applications\n * - `@opendatalabs/vana-sdk/node` for Node.js applications\n *\n * @example\n * ```typescript\n * // ❌ WRONG - This will throw an error\n * import { something } from '@opendatalabs/vana-sdk';\n *\n * // ✅ CORRECT - For browser/web applications\n * import { BrowserPlatformAdapter } from '@opendatalabs/vana-sdk/browser';\n *\n * // ✅ CORRECT - For Node.js applications\n * import { NodePlatformAdapter } from '@opendatalabs/vana-sdk/node';\n * ```\n *\n * @throws {Error} Always throws an error directing to use platform-specific imports\n *\n * @category Core\n * @module index\n */\nthrow new Error(\n  'Import from \"@opendatalabs/vana-sdk/browser\" or \"@opendatalabs/vana-sdk/node\" instead of the root entry point.',\n);\n"],"mappings":";AAgCA,MAAM,IAAI;AAAA,EACR;AACF;","names":[]}

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,2 +1,4 @@
-throw new Error('Import from "@opendatalabs/vana-sdk/browser" or "@opendatalabs/vana-sdk/node" instead of the root entry point.');
+throw new Error(
+  'Import from "@opendatalabs/vana-sdk/browser" or "@opendatalabs/vana-sdk/node" instead of the root entry point.'
+);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["throw new Error('Import from \"@opendatalabs/vana-sdk/browser\" or \"@opendatalabs/vana-sdk/node\" instead of the root entry point.');\n"],"mappings":"AAAA,MAAM,IAAI,MAAM,gHAAgH;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Main entry point for the Vana SDK.\n *\n * @remarks\n * This module prevents accidental imports from the root package path and\n * ensures developers explicitly choose the correct platform-specific build.\n * The SDK requires platform-specific implementations for cryptography,\n * storage, and networking operations.\n *\n * **DO NOT import from this module directly.**\n *\n * Instead, use one of the platform-specific entry points:\n * - `@opendatalabs/vana-sdk/browser` for web applications\n * - `@opendatalabs/vana-sdk/node` for Node.js applications\n *\n * @example\n * ```typescript\n * // ❌ WRONG - This will throw an error\n * import { something } from '@opendatalabs/vana-sdk';\n *\n * // ✅ CORRECT - For browser/web applications\n * import { BrowserPlatformAdapter } from '@opendatalabs/vana-sdk/browser';\n *\n * // ✅ CORRECT - For Node.js applications\n * import { NodePlatformAdapter } from '@opendatalabs/vana-sdk/node';\n * ```\n *\n * @throws {Error} Always throws an error directing to use platform-specific imports\n *\n * @category Core\n * @module index\n */\nthrow new Error(\n  'Import from \"@opendatalabs/vana-sdk/browser\" or \"@opendatalabs/vana-sdk/node\" instead of the root entry point.',\n);\n"],"mappings":"AAgCA,MAAM,IAAI;AAAA,EACR;AACF;","names":[]}

package/dist/index.node.cjs

@@ -51,12 +51,16 @@ __export(index_node_exports, {
   getAllChains: () => import_chains2.getAllChains,
   getChainConfig: () => import_chains2.getChainConfig,
   getContractAddress: () => import_addresses.getContractAddress,
+  getDefaultPersonalServerUrl: () => import_default_services.getDefaultPersonalServerUrl,
   getPlatformCapabilities: () => import_utils.getPlatformCapabilities,
-  handleRelayerRequest: () => import_handler.handleRelayerRequest,
+  getServiceEndpoints: () => import_default_services.getServiceEndpoints,
+  handleRelayerOperation: () => import_relayerHandler.handleRelayerOperation,
   isAPIResponse: () => import_external_apis.isAPIResponse,
   isPlatformSupported: () => import_utils.isPlatformSupported,
   isReplicateAPIResponse: () => import_external_apis.isReplicateAPIResponse,
+  mainnetServices: () => import_default_services.mainnetServices,
   moksha: () => import_chains2.moksha,
+  mokshaServices: () => import_default_services.mokshaServices,
   mokshaTestnet: () => import_chains2.mokshaTestnet,
   parseReplicateOutput: () => import_external_apis.parseReplicateOutput,
   safeParseJSON: () => import_external_apis.safeParseJSON,
@@ -85,19 +89,22 @@ __reExport(index_node_exports, require("./utils/signatureCache"), module.exports
 __reExport(index_node_exports, require("./storage"), module.exports);
 var import_addresses = require("./config/addresses");
 var import_chains = require("./config/chains");
+var import_default_services = require("./config/default-services");
 var import_chains2 = require("./chains");
 __reExport(index_node_exports, require("./chains"), module.exports);
 var import_abi = require("./generated/abi");
 var import_generics = require("./core/generics");
-var import_handler = require("./server/handler");
+var import_relayerHandler = require("./server/relayerHandler");
 var import_node2 = require("./platform/node");
 var import_browser = require("./platform/browser");
 var import_utils = require("./platform/utils");
 var import_browser_safe = require("./platform/browser-safe");
 var import_apiClient = require("./core/apiClient");
 class VanaNodeImpl extends import_core.VanaCore {
+  operationStore;
   constructor(config) {
     super(new import_node.NodePlatformAdapter(), config);
+    this.operationStore = config.operationStore;
   }
 }
 function Vana(config) {
@@ -137,12 +144,16 @@ var index_node_default = Vana;
   getAllChains,
   getChainConfig,
   getContractAddress,
+  getDefaultPersonalServerUrl,
   getPlatformCapabilities,
-  handleRelayerRequest,
+  getServiceEndpoints,
+  handleRelayerOperation,
   isAPIResponse,
   isPlatformSupported,
   isReplicateAPIResponse,
+  mainnetServices,
   moksha,
+  mokshaServices,
   mokshaTestnet,
   parseReplicateOutput,
   safeParseJSON,

package/dist/index.node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.node.ts"],"sourcesContent":["import { NodePlatformAdapter } from \"./platform/node\";\nimport { VanaCore } from \"./core\";\nimport type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  StorageRequiredMarker,\n} from \"./types\";\n\n/**\n * Internal implementation class for Node.js environments.\n * This class is not exported directly - use the Vana factory function instead.\n */\nclass VanaNodeImpl extends VanaCore {\n  constructor(config: VanaConfig) {\n    super(new NodePlatformAdapter(), config);\n  }\n}\n\n/**\n * Creates a new Vana SDK instance configured for Node.js environments.\n *\n * @remarks\n * This is the primary entry point for Node.js applications using the Vana SDK. The function\n * automatically detects your configuration type and provides compile-time type safety:\n * - **With storage configured**: All methods including file upload/download are available\n * - **Without storage**: Storage-dependent methods throw runtime errors and are excluded from TypeScript\n *\n * The Node.js version provides enhanced capabilities including native file system access,\n * server-side cryptographic operations, and support for personal server deployment.\n * It includes all browser capabilities plus Node.js-specific optimizations and utilities.\n *\n * @param config - Configuration object containing wallet, storage, and relayer settings\n * @returns A fully configured Vana SDK instance for Node.js use\n * @throws {InvalidConfigurationError} When configuration parameters are invalid or missing\n * @example\n * ```typescript\n * import { Vana } from '@opendatalabs/vana-sdk/node';\n * import { createWalletClient, http } from 'viem';\n * import { privateKeyToAccount } from 'viem/accounts';\n * import { IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk/node';\n * import { mokshaTestnet } from '@opendatalabs/vana-sdk/node';\n *\n * // Server setup with private key\n * const account = privateKeyToAccount('0x...');\n * const walletClient = createWalletClient({\n *   account,\n *   chain: mokshaTestnet,\n *   transport: http('https://rpc.moksha.vana.org')\n * });\n *\n * const vana = Vana({\n *   walletClient,\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({\n *         gateway: 'https://gateway.pinata.cloud',\n *         timeout: 30000\n *       }),\n *       pinata: new PinataStorage({\n *         apiKey: process.env.PINATA_KEY,\n *         secretKey: process.env.PINATA_SECRET\n *       })\n *     },\n *     defaultProvider: 'pinata'\n *   },\n *   relayerCallbacks: {\n *     async submitPermissionGrant(typedData, signature) {\n *       // Server-side relayer implementation\n *       return await submitToCustomRelayer(typedData, signature);\n *     }\n *   }\n * });\n *\n * // Server operations\n * const uploadResult = await vana.data.upload({\n *   content: await fs.readFile('./user-data.json'),\n *   filename: 'user-data.json',\n *   schemaId: 1\n * });\n *\n * // Personal server setup\n * await vana.server.setupPersonalServer({\n *   serverUrl: 'https://my-server.example.com',\n *   capabilities: ['data_processing', 'ml_inference']\n * });\n * ```\n *\n * @example\n * ```typescript\n * // CLI tool or script usage\n * const vana = Vana({\n *   chainId: 14800, // Moksha testnet\n *   account: privateKeyToAccount(process.env.PRIVATE_KEY),\n *   rpcUrl: process.env.RPC_URL,\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n *\n * // Batch operations for data processing\n * const userFiles = await vana.data.getUserFiles({\n *   owner: process.env.USER_ADDRESS\n * });\n *\n * for (const file of userFiles) {\n *   const decrypted = await vana.data.decryptFile(file);\n *   // Process file data...\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Express.js server integration\n * import express from 'express';\n * import { handleRelayerRequest } from '@opendatalabs/vana-sdk/node';\n *\n * const app = express();\n *\n * app.post('/api/relay/:operation', async (req, res) => {\n *   try {\n *     const result = await handleRelayerRequest(\n *       req.params.operation,\n *       req.body,\n *       vana\n *     );\n *     res.json({ success: true, result });\n *   } catch (error) {\n *     res.status(500).json({ error: error.message });\n *   }\n * });\n * ```\n *\n * @see {@link https://docs.vana.org/docs/sdk/server-setup | Server Setup Guide} for Node.js-specific features\n * @see {@link VanaCore} for the underlying implementation details\n * @category Core SDK\n */\nexport function Vana(\n  config: VanaConfigWithStorage,\n): VanaNodeImpl & StorageRequiredMarker;\nexport function Vana(config: VanaConfig): VanaNodeImpl;\n/**\n * Creates a new Vana SDK instance.\n *\n * @param config - The configuration for the Vana SDK\n * @returns A new Vana SDK instance\n */\nexport function Vana(config: VanaConfig) {\n  return new VanaNodeImpl(config);\n}\n\n/**\n * The type of a Vana SDK instance in Node.js environments.\n * Uses InstanceType to properly expose all public methods from the class hierarchy.\n *\n * @see {@link Vana}\n */\nexport type VanaInstance = InstanceType<typeof VanaNodeImpl>;\n\n// Export as default export\nexport default Vana;\n\n// Re-export everything that was in index.ts (avoiding circular dependency)\n// Core class and factory\nexport { VanaCore, VanaCoreFactory } from \"./core\";\n\n// Types - modular exports\nexport type * from \"./types\";\n\n// Type guards and utilities\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./types/external-apis\";\n\n// VanaContract is exported from abi to avoid circular dependencies\nexport type { VanaContract } from \"./generated/abi\";\n\n// Error classes\nexport * from \"./errors\";\n\n// Controllers\nexport { PermissionsController } from \"./controllers/permissions\";\nexport { DataController } from \"./controllers/data\";\nexport { ServerController } from \"./controllers/server\";\nexport { ProtocolController } from \"./controllers/protocol\";\nexport { SchemaController } from \"./controllers/schemas\";\n\n// Contract controller\nexport * from \"./contracts/contractController\";\n\n// Utilities\nexport * from \"./utils/encryption\";\nexport * from \"./utils/formatters\";\nexport * from \"./utils/grantFiles\";\nexport * from \"./utils/grantValidation\";\nexport * from \"./utils/grants\";\nexport * from \"./utils/ipfs\";\nexport * from \"./utils/schemaValidation\";\nexport * from \"./utils/signatureCache\";\n\n// Storage API\nexport * from \"./storage\";\n\n// Configuration\nexport { getContractAddress } from \"./config/addresses\";\nexport { chains } from \"./config/chains\";\n\n// Chain configurations with subgraph URLs - explicit exports for better DX\nexport {\n  vanaMainnet,\n  mokshaTestnet,\n  moksha,\n  type VanaChainConfig,\n  getChainConfig,\n  getAllChains,\n} from \"./chains\";\nexport * from \"./chains\";\n\n// ABIs\nexport { getAbi } from \"./generated/abi\";\nexport type { VanaContract as VanaContractAbi } from \"./generated/abi\";\n\n// Generic utilities for extensibility\nexport {\n  BaseController,\n  RetryUtility,\n  RateLimiter,\n  MemoryCache,\n  EventEmitter,\n  MiddlewarePipeline,\n  AsyncQueue,\n  CircuitBreaker,\n} from \"./core/generics\";\n\n// Server-side utilities\nexport { handleRelayerRequest } from \"./server/handler\";\nexport type { RelayerRequestPayload } from \"./server/handler\";\n// TransactionHandle removed - using POJOs instead\nexport type {\n  Operation,\n  TransactionResult,\n  TransactionReceipt,\n  PollingOptions,\n  TransactionWaitOptions,\n} from \"./types/operations\";\n\n// Platform adapters\nexport { NodePlatformAdapter } from \"./platform/node\";\nexport { BrowserPlatformAdapter } from \"./platform/browser\";\nexport type { VanaPlatformAdapter } from \"./platform/interface\";\n\n// Platform utilities\nexport {\n  detectPlatform,\n  createPlatformAdapter,\n  createPlatformAdapterFor,\n  isPlatformSupported,\n  getPlatformCapabilities,\n} from \"./platform/utils\";\n\n// Browser-safe platform utilities\nexport {\n  createNodePlatformAdapter,\n  createBrowserPlatformAdapter,\n  createPlatformAdapterSafe,\n} from \"./platform/browser-safe\";\n\nexport { ApiClient } from \"./core/apiClient\";\n\nexport type {\n  ApiClientConfig,\n  HttpMethod,\n  RequestOptions,\n} from \"./core/apiClient\";\n\n// Note: Default export is already handled above with the Vana factory function\n// For testing purposes, we also export the implementation class\nexport { VanaNodeImpl };\n"],"mappings":";;;;;;;;;;;;;;;;;;;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,kBAAoC;AACpC,kBAAyB;AAmKzB,IAAAA,eAA0C;AAM1C,2BAKO;AAMP,+BAAc,qBArLd;AAwLA,yBAAsC;AACtC,kBAA+B;AAC/B,oBAAiC;AACjC,sBAAmC;AACnC,qBAAiC;AAGjC,+BAAc,2CA/Ld;AAkMA,+BAAc,+BAlMd;AAmMA,+BAAc,+BAnMd;AAoMA,+BAAc,+BApMd;AAqMA,+BAAc,oCArMd;AAsMA,+BAAc,2BAtMd;AAuMA,+BAAc,yBAvMd;AAwMA,+BAAc,qCAxMd;AAyMA,+BAAc,mCAzMd;AA4MA,+BAAc,sBA5Md;AA+MA,uBAAmC;AACnC,oBAAuB;AAGvB,IAAAC,iBAOO;AACP,+BAAc,qBA3Nd;AA8NA,iBAAuB;AAIvB,sBASO;AAGP,qBAAqC;AAYrC,IAAAC,eAAoC;AACpC,qBAAuC;AAIvC,mBAMO;AAGP,0BAIO;AAEP,uBAA0B;AAlQ1B,MAAM,qBAAqB,qBAAS;AAAA,EAClC,YAAY,QAAoB;AAC9B,UAAM,IAAI,gCAAoB,GAAG,MAAM;AAAA,EACzC;AACF;AAmIO,SAAS,KAAK,QAAoB;AACvC,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  IOperationStore,\n} from \"./types\";\n\n/**\n * Node.js-specific configuration interface with operation store support\n *\n * @category Configuration\n */\nexport type VanaNodeConfig = VanaConfig & {\n  operationStore?: IOperationStore;\n};\n\n/**\n * Node.js configuration with storage requirements\n *\n * @category Configuration\n */\nexport type VanaNodeConfigWithStorage = VanaConfigWithStorage & {\n  operationStore?: IOperationStore;\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;\n\n  constructor(config: VanaNodeConfig) {\n    super(new NodePlatformAdapter(), config);\n    this.operationStore = config.operationStore;\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\";\n\n// Types - modular exports\nexport type * from \"./types\";\n\n// Type guards and utilities\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./types/external-apis\";\n\n// VanaContract is exported from abi to avoid circular dependencies\nexport type { VanaContract } from \"./generated/abi\";\n\n// Error classes\nexport * from \"./errors\";\n\n// Controllers\nexport { PermissionsController } from \"./controllers/permissions\";\nexport { DataController } from \"./controllers/data\";\nexport { ServerController } from \"./controllers/server\";\nexport { ProtocolController } from \"./controllers/protocol\";\nexport { SchemaController } from \"./controllers/schemas\";\n\n// Contract controller\nexport * from \"./contracts/contractController\";\n\n// Utilities\nexport * from \"./utils/encryption\";\nexport * from \"./utils/formatters\";\nexport * from \"./utils/grantFiles\";\nexport * from \"./utils/grantValidation\";\nexport * from \"./utils/grants\";\nexport * from \"./utils/ipfs\";\nexport * from \"./utils/schemaValidation\";\nexport * from \"./utils/signatureCache\";\n\n// Storage API\nexport * from \"./storage\";\n\n// Configuration\nexport { getContractAddress } from \"./config/addresses\";\nexport { chains } from \"./config/chains\";\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 { handleRelayerOperation } 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"],"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;AAKA,kBAAoC;AACpC,kBAAyB;AAkMzB,IAAAA,eAA0C;AAM1C,2BAKO;AAMP,+BAAc,qBAzNd;AA4NA,yBAAsC;AACtC,kBAA+B;AAC/B,oBAAiC;AACjC,sBAAmC;AACnC,qBAAiC;AAGjC,+BAAc,2CAnOd;AAsOA,+BAAc,+BAtOd;AAuOA,+BAAc,+BAvOd;AAwOA,+BAAc,+BAxOd;AAyOA,+BAAc,oCAzOd;AA0OA,+BAAc,2BA1Od;AA2OA,+BAAc,yBA3Od;AA4OA,+BAAc,qCA5Od;AA6OA,+BAAc,mCA7Od;AAgPA,+BAAc,sBAhPd;AAmPA,uBAAmC;AACnC,oBAAuB;AACvB,8BAMO;AAGP,IAAAC,iBAOO;AACP,+BAAc,qBAtQd;AAyQA,iBAAuB;AAIvB,sBASO;AAGP,4BAAuC;AAevC,IAAAC,eAAoC;AACpC,qBAAuC;AAIvC,mBAMO;AAGP,0BAIO;AAEP,uBAA0B;AAvR1B,MAAM,qBAAqB,qBAAS;AAAA,EAChB;AAAA,EAElB,YAAY,QAAwB;AAClC,UAAM,IAAI,gCAAoB,GAAG,MAAM;AACvC,SAAK,iBAAiB,OAAO;AAAA,EAC/B;AACF;AA2IO,SAAS,KAAK,QAAwB;AAC3C,SAAO,IAAI,aAAa,MAAM;AAChC;AAWA,IAAO,qBAAQ;","names":["import_core","import_chains","import_node"]}