@opendatalabs/vana-sdk 0.1.0-alpha.7ee7635 → 0.1.0-alpha.80df35f

package/dist/core/generics.d.ts

@@ -1,10 +1,8 @@
-import { ControllerContext, Controller, GenericRequest, Middleware, GenericResponse, RetryConfig, RateLimiterConfig, Cache, Observable, Observer } from '../types/generics.js';
-import 'viem';
-
+import type { Controller, ControllerContext, GenericRequest, GenericResponse, RetryConfig, RateLimiterConfig, Middleware, Cache, Observer, Observable } from "../types/generics";
 /**
  * Base controller class with common functionality
  */
-declare abstract class BaseController<TContext extends ControllerContext = ControllerContext> implements Controller<TContext> {
+export declare abstract class BaseController<TContext extends ControllerContext = ControllerContext> implements Controller<TContext> {
     readonly context: TContext;
     constructor(context: TContext);
     /**
@@ -28,14 +26,14 @@ declare abstract class BaseController<TContext extends ControllerContext = Contr
 /**
  * Generic retry utility with exponential backoff
  */
-declare class RetryUtility {
+export declare class RetryUtility {
     private static delay;
     static withRetry<T>(operation: () => Promise<T>, config: RetryConfig): Promise<T>;
 }
 /**
  * Generic rate limiter
  */
-declare class RateLimiter {
+export declare class RateLimiter {
     private config;
     private requests;
     constructor(config: RateLimiterConfig);
@@ -47,7 +45,7 @@ declare class RateLimiter {
 /**
  * Generic in-memory cache implementation
  */
-declare class MemoryCache<TKey = string, TValue = unknown> implements Cache<TKey, TValue> {
+export declare class MemoryCache<TKey = string, TValue = unknown> implements Cache<TKey, TValue> {
     private cache;
     get(key: TKey): Promise<TValue | undefined>;
     set(key: TKey, value: TValue, ttl?: number): Promise<void>;
@@ -60,7 +58,7 @@ declare class MemoryCache<TKey = string, TValue = unknown> implements Cache<TKey
 /**
  * Generic event emitter implementation
  */
-declare class EventEmitter<TEvent = unknown> implements Observable<TEvent> {
+export declare class EventEmitter<TEvent = unknown> implements Observable<TEvent> {
     private observers;
     subscribe(observer: Observer<TEvent>): () => void;
     unsubscribe(observer: Observer<TEvent>): void;
@@ -71,7 +69,7 @@ declare class EventEmitter<TEvent = unknown> implements Observable<TEvent> {
 /**
  * Generic middleware pipeline
  */
-declare class MiddlewarePipeline {
+export declare class MiddlewarePipeline {
     private middleware;
     use(middleware: Middleware<any, any>): void;
     processRequest<TRequest>(request: TRequest): Promise<TRequest>;
@@ -83,7 +81,7 @@ declare class MiddlewarePipeline {
 /**
  * Generic async queue for managing concurrent operations
  */
-declare class AsyncQueue<T = unknown> {
+export declare class AsyncQueue<T = unknown> {
     private concurrency;
     private queue;
     private running;
@@ -98,7 +96,7 @@ declare class AsyncQueue<T = unknown> {
 /**
  * Generic circuit breaker pattern
  */
-declare class CircuitBreaker {
+export declare class CircuitBreaker {
     private config;
     private state;
     private failures;
@@ -116,5 +114,3 @@ declare class CircuitBreaker {
     getFailures(): number;
     reset(): void;
 }
-
-export { AsyncQueue, BaseController, CircuitBreaker, EventEmitter, MemoryCache, MiddlewarePipeline, RateLimiter, RetryUtility };

package/dist/core/generics.js

@@ -1,9 +1,6 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 class BaseController {
+  context;
   constructor(context) {
-    __publicField(this, "context");
     this.context = context;
   }
   /**
@@ -47,6 +44,9 @@ class BaseController {
         }
       }
       return {
+        // TODO(TYPES): undefined coerced to TResponse for error case.
+        // Future improvement: Use discriminated union with success: false
+        // to properly type data as undefined when error occurs.
         data: void 0,
         success: false,
         error: {
@@ -87,9 +87,9 @@ class RetryUtility {
         if (attempt === config.maxAttempts) {
           break;
         }
-        const baseDelay = config.baseDelay * Math.pow(config.backoffMultiplier || 2, attempt - 1);
-        const maxDelay = config.maxDelay || 3e4;
-        const jitter = config.jitter || 0;
+        const baseDelay = config.baseDelay * Math.pow(config.backoffMultiplier ?? 2, attempt - 1);
+        const maxDelay = config.maxDelay ?? 3e4;
+        const jitter = config.jitter ?? 0;
         let delay = Math.min(baseDelay, maxDelay);
         if (jitter > 0) {
           delay += Math.random() * jitter * delay;
@@ -97,14 +97,14 @@ class RetryUtility {
         await this.delay(delay);
       }
     }
-    throw lastError || new Error("Operation failed after retries");
+    throw lastError ?? new Error("Operation failed after retries");
   }
 }
 class RateLimiter {
   constructor(config) {
     this.config = config;
-    __publicField(this, "requests", []);
   }
+  requests = [];
   async checkLimit() {
     const now = Date.now();
     const windowStart = now - this.config.windowMs;
@@ -132,9 +132,7 @@ class RateLimiter {
   }
 }
 class MemoryCache {
-  constructor() {
-    __publicField(this, "cache", /* @__PURE__ */ new Map());
-  }
+  cache = /* @__PURE__ */ new Map();
   async get(key) {
     const item = this.cache.get(key);
     if (!item) return void 0;
@@ -172,12 +170,12 @@ class MemoryCache {
   }
 }
 class EventEmitter {
-  constructor() {
-    __publicField(this, "observers", []);
-  }
+  observers = [];
   subscribe(observer) {
     this.observers.push(observer);
-    return () => this.unsubscribe(observer);
+    return () => {
+      this.unsubscribe(observer);
+    };
   }
   unsubscribe(observer) {
     const index = this.observers.indexOf(observer);
@@ -207,11 +205,7 @@ class EventEmitter {
   }
 }
 class MiddlewarePipeline {
-  constructor() {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    __publicField(this, "middleware", []);
-  }
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  middleware = [];
   use(middleware) {
     this.middleware.push(middleware);
   }
@@ -243,7 +237,6 @@ class MiddlewarePipeline {
       }
     }
   }
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   getMiddleware() {
     return [...this.middleware];
   }
@@ -254,9 +247,9 @@ class MiddlewarePipeline {
 class AsyncQueue {
   constructor(concurrency = 1) {
     this.concurrency = concurrency;
-    __publicField(this, "queue", []);
-    __publicField(this, "running", 0);
   }
+  queue = [];
+  running = 0;
   async add(operation) {
     return new Promise((resolve, reject) => {
       this.queue.push(async () => {
@@ -301,11 +294,11 @@ class AsyncQueue {
 class CircuitBreaker {
   constructor(config) {
     this.config = config;
-    __publicField(this, "state", "closed");
-    __publicField(this, "failures", 0);
-    __publicField(this, "lastFailureTime", 0);
-    __publicField(this, "successes", 0);
   }
+  state = "closed";
+  failures = 0;
+  lastFailureTime = 0;
+  successes = 0;
   async execute(operation) {
     if (this.state === "open") {
       if (Date.now() - this.lastFailureTime > this.config.recoveryTimeout) {
@@ -328,7 +321,7 @@ class CircuitBreaker {
     this.failures = 0;
     if (this.state === "half-open") {
       this.successes++;
-      if (this.successes >= (this.config.halfOpenMaxAttempts || 1)) {
+      if (this.successes >= (this.config.halfOpenMaxAttempts ?? 1)) {
         this.state = "closed";
       }
     }

package/dist/core/generics.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/generics.ts"],"sourcesContent":["import type {\n  Controller,\n  ControllerContext,\n  GenericRequest,\n  GenericResponse,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n  Cache,\n  Observer,\n  Observable,\n} from \"../types/generics\";\n\n/**\n * Base controller class with common functionality\n */\nexport abstract class BaseController<\n  TContext extends ControllerContext = ControllerContext,\n> implements Controller<TContext>\n{\n  public readonly context: TContext;\n\n  constructor(context: TContext) {\n    this.context = context;\n  }\n\n  /**\n   * Execute a request with optional middleware pipeline\n   *\n   * @param request - The generic request object containing parameters and metadata\n   * @param handler - The function that processes the request parameters\n   * @param middleware - Optional array of middleware functions to apply\n   * @returns Promise resolving to a generic response object\n   */\n  protected async executeRequest<TParams, TResponse>(\n    request: GenericRequest<TParams>,\n    handler: (params: TParams) => Promise<TResponse>,\n    middleware: Middleware[] = [],\n  ): Promise<GenericResponse<TResponse>> {\n    try {\n      // Apply request middleware\n      let processedRequest = request;\n      for (const mw of middleware) {\n        if (mw.request) {\n          processedRequest = (await mw.request(\n            processedRequest,\n          )) as GenericRequest<TParams>;\n        }\n      }\n\n      // Execute handler\n      let response = await handler(processedRequest.params);\n\n      // Apply response middleware\n      for (const mw of middleware.reverse()) {\n        if (mw.response) {\n          response = (await mw.response(response)) as Awaited<TResponse>;\n        }\n      }\n\n      return {\n        data: response,\n        success: true,\n      };\n    } catch (error) {\n      // Handle errors with middleware\n      for (const mw of middleware) {\n        if (mw.error) {\n          const handled = await mw.error(error as Error, request);\n          if (handled) {\n            return {\n              data: handled as TResponse,\n              success: true,\n            };\n          }\n        }\n      }\n\n      return {\n        data: undefined as unknown as TResponse,\n        success: false,\n        error: {\n          code: \"EXECUTION_ERROR\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n          details: error,\n        },\n      };\n    }\n  }\n\n  /**\n   * Validate parameters with optional custom validator\n   *\n   * @param params - The parameters to validate\n   * @param validator - Optional function to validate parameter types\n   * @throws Error if validation fails, asserts type if successful\n   */\n  protected validateParams<T>(\n    params: unknown,\n    validator?: (params: unknown) => params is T,\n  ): asserts params is T {\n    if (validator && !validator(params)) {\n      throw new Error(\"Invalid parameters\");\n    }\n  }\n}\n\n/**\n * Generic retry utility with exponential backoff\n */\nexport class RetryUtility {\n  private static async delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  static async withRetry<T>(\n    operation: () => Promise<T>,\n    config: RetryConfig,\n  ): Promise<T> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Check if we should retry\n        if (config.shouldRetry && !config.shouldRetry(lastError, attempt)) {\n          throw lastError;\n        }\n\n        // Don't delay on the last attempt\n        if (attempt === config.maxAttempts) {\n          break;\n        }\n\n        // Calculate delay with exponential backoff and jitter\n        const baseDelay =\n          config.baseDelay *\n          Math.pow(config.backoffMultiplier || 2, attempt - 1);\n        const maxDelay = config.maxDelay || 30000;\n        const jitter = config.jitter || 0;\n\n        let delay = Math.min(baseDelay, maxDelay);\n\n        if (jitter > 0) {\n          delay += Math.random() * jitter * delay;\n        }\n\n        await this.delay(delay);\n      }\n    }\n\n    throw lastError || new Error(\"Operation failed after retries\");\n  }\n}\n\n/**\n * Generic rate limiter\n */\nexport class RateLimiter {\n  private requests: number[] = [];\n\n  constructor(private config: RateLimiterConfig) {}\n\n  async checkLimit(): Promise<boolean> {\n    const now = Date.now();\n    const windowStart = now - this.config.windowMs;\n\n    // Remove requests outside the window\n    this.requests = this.requests.filter((time) => time > windowStart);\n\n    // Check if we can make a request\n    if (this.requests.length < this.config.requestsPerWindow) {\n      this.requests.push(now);\n      return true;\n    }\n\n    return false;\n  }\n\n  async waitForSlot(): Promise<void> {\n    while (!(await this.checkLimit())) {\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n  }\n\n  getRemainingRequests(): number {\n    const now = Date.now();\n    const windowStart = now - this.config.windowMs;\n    const activeRequests = this.requests.filter((time) => time > windowStart);\n    return Math.max(0, this.config.requestsPerWindow - activeRequests.length);\n  }\n\n  getResetTime(): number {\n    if (this.requests.length === 0) return 0;\n    return Math.max(0, this.requests[0] + this.config.windowMs - Date.now());\n  }\n}\n\n/**\n * Generic in-memory cache implementation\n */\nexport class MemoryCache<TKey = string, TValue = unknown>\n  implements Cache<TKey, TValue>\n{\n  private cache = new Map<TKey, { value: TValue; expiry?: number }>();\n\n  async get(key: TKey): Promise<TValue | undefined> {\n    const item = this.cache.get(key);\n\n    if (!item) return undefined;\n\n    // Check if expired\n    if (item.expiry && Date.now() > item.expiry) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    return item.value;\n  }\n\n  async set(key: TKey, value: TValue, ttl?: number): Promise<void> {\n    const expiry = ttl ? Date.now() + ttl : undefined;\n    this.cache.set(key, { value, expiry });\n  }\n\n  async delete(key: TKey): Promise<boolean> {\n    return this.cache.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n  }\n\n  async has(key: TKey): Promise<boolean> {\n    const exists = this.cache.has(key);\n    if (!exists) return false;\n\n    // Check expiry\n    const item = this.cache.get(key);\n    if (item?.expiry && Date.now() > item.expiry) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  size(): number {\n    return this.cache.size;\n  }\n\n  keys(): TKey[] {\n    return Array.from(this.cache.keys());\n  }\n}\n\n/**\n * Generic event emitter implementation\n */\nexport class EventEmitter<TEvent = unknown> implements Observable<TEvent> {\n  private observers: Observer<TEvent>[] = [];\n\n  subscribe(observer: Observer<TEvent>): () => void {\n    this.observers.push(observer);\n\n    return () => this.unsubscribe(observer);\n  }\n\n  unsubscribe(observer: Observer<TEvent>): void {\n    const index = this.observers.indexOf(observer);\n    if (index > -1) {\n      this.observers.splice(index, 1);\n    }\n  }\n\n  emit(event: TEvent): void {\n    for (const observer of this.observers) {\n      try {\n        const result = observer.notify(event);\n        if (result instanceof Promise) {\n          result.catch((error) => {\n            console.error(\"Observer error:\", error);\n          });\n        }\n      } catch (error) {\n        console.error(\"Observer error:\", error);\n      }\n    }\n  }\n\n  getObserverCount(): number {\n    return this.observers.length;\n  }\n\n  removeAllObservers(): void {\n    this.observers = [];\n  }\n}\n\n/**\n * Generic middleware pipeline\n */\nexport class MiddlewarePipeline {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private middleware: Middleware<any, any>[] = [];\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  use(middleware: Middleware<any, any>): void {\n    this.middleware.push(middleware);\n  }\n\n  async processRequest<TRequest>(request: TRequest): Promise<TRequest> {\n    let processed = request;\n\n    for (const mw of this.middleware) {\n      if (mw.request) {\n        processed = await mw.request(processed);\n      }\n    }\n\n    return processed;\n  }\n\n  async processResponse<TResponse>(response: TResponse): Promise<TResponse> {\n    let processed = response;\n\n    // Process in reverse order\n    for (const mw of this.middleware.slice().reverse()) {\n      if (mw.response) {\n        processed = await mw.response(processed);\n      }\n    }\n\n    return processed;\n  }\n\n  async handleError<TRequest, TResponse>(\n    error: Error,\n    request: TRequest,\n  ): Promise<TResponse | void> {\n    for (const mw of this.middleware) {\n      if (mw.error) {\n        const result = await mw.error(error, request);\n        if (result) {\n          return result;\n        }\n      }\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  getMiddleware(): Middleware<any, any>[] {\n    return [...this.middleware];\n  }\n\n  clear(): void {\n    this.middleware = [];\n  }\n}\n\n/**\n * Generic async queue for managing concurrent operations\n */\nexport class AsyncQueue<T = unknown> {\n  private queue: Array<() => Promise<T>> = [];\n  private running = 0;\n\n  constructor(private concurrency = 1) {}\n\n  async add<R>(operation: () => Promise<R>): Promise<R> {\n    return new Promise((resolve, reject) => {\n      this.queue.push(async () => {\n        try {\n          const result = await operation();\n          resolve(result as unknown as R);\n          return result as unknown as T;\n        } catch (error) {\n          reject(error);\n          throw error;\n        } finally {\n          this.running--;\n          this.processQueue();\n        }\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private processQueue(): void {\n    while (this.running < this.concurrency && this.queue.length > 0) {\n      const operation = this.queue.shift();\n      if (operation) {\n        this.running++;\n        operation().catch(() => {\n          // Error already handled in add method\n        });\n      }\n    }\n  }\n\n  get pending(): number {\n    return this.queue.length;\n  }\n\n  get active(): number {\n    return this.running;\n  }\n\n  get size(): number {\n    return this.queue.length + this.running;\n  }\n\n  clear(): void {\n    this.queue = [];\n  }\n}\n\n/**\n * Generic circuit breaker pattern\n */\nexport class CircuitBreaker {\n  private state: \"closed\" | \"open\" | \"half-open\" = \"closed\";\n  private failures = 0;\n  private lastFailureTime = 0;\n  private successes = 0;\n\n  constructor(\n    private config: {\n      failureThreshold: number;\n      recoveryTimeout: number;\n      halfOpenMaxAttempts?: number;\n    },\n  ) {}\n\n  async execute<TResult>(operation: () => Promise<TResult>): Promise<TResult> {\n    if (this.state === \"open\") {\n      if (Date.now() - this.lastFailureTime > this.config.recoveryTimeout) {\n        this.state = \"half-open\";\n        this.successes = 0;\n      } else {\n        throw new Error(\"Circuit breaker is open\");\n      }\n    }\n\n    try {\n      const result = await operation();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n\n    if (this.state === \"half-open\") {\n      this.successes++;\n      if (this.successes >= (this.config.halfOpenMaxAttempts || 1)) {\n        this.state = \"closed\";\n      }\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailureTime = Date.now();\n\n    if (this.failures >= this.config.failureThreshold) {\n      this.state = \"open\";\n    }\n  }\n\n  getState(): string {\n    return this.state;\n  }\n\n  getFailures(): number {\n    return this.failures;\n  }\n\n  reset(): void {\n    this.state = \"closed\";\n    this.failures = 0;\n    this.successes = 0;\n    this.lastFailureTime = 0;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/core/generics.ts"],"sourcesContent":["import type {\n  Controller,\n  ControllerContext,\n  GenericRequest,\n  GenericResponse,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n  Cache,\n  Observer,\n  Observable,\n} from \"../types/generics\";\n\n/**\n * Base controller class with common functionality\n */\nexport abstract class BaseController<\n  TContext extends ControllerContext = ControllerContext,\n> implements Controller<TContext>\n{\n  public readonly context: TContext;\n\n  constructor(context: TContext) {\n    this.context = context;\n  }\n\n  /**\n   * Execute a request with optional middleware pipeline\n   *\n   * @param request - The generic request object containing parameters and metadata\n   * @param handler - The function that processes the request parameters\n   * @param middleware - Optional array of middleware functions to apply\n   * @returns Promise resolving to a generic response object\n   */\n  protected async executeRequest<TParams, TResponse>(\n    request: GenericRequest<TParams>,\n    handler: (params: TParams) => Promise<TResponse>,\n    middleware: Middleware[] = [],\n  ): Promise<GenericResponse<TResponse>> {\n    try {\n      // Apply request middleware\n      let processedRequest = request;\n      for (const mw of middleware) {\n        if (mw.request) {\n          processedRequest = (await mw.request(\n            processedRequest,\n          )) as GenericRequest<TParams>;\n        }\n      }\n\n      // Execute handler\n      let response = await handler(processedRequest.params);\n\n      // Apply response middleware\n      for (const mw of middleware.reverse()) {\n        if (mw.response) {\n          response = (await mw.response(response)) as Awaited<TResponse>;\n        }\n      }\n\n      return {\n        data: response,\n        success: true,\n      };\n    } catch (error) {\n      // Handle errors with middleware\n      for (const mw of middleware) {\n        if (mw.error) {\n          const handled = await mw.error(error as Error, request);\n          if (handled) {\n            return {\n              data: handled as TResponse,\n              success: true,\n            };\n          }\n        }\n      }\n\n      return {\n        // TODO(TYPES): undefined coerced to TResponse for error case.\n        // Future improvement: Use discriminated union with success: false\n        // to properly type data as undefined when error occurs.\n        data: undefined as unknown as TResponse,\n        success: false,\n        error: {\n          code: \"EXECUTION_ERROR\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n          details: error,\n        },\n      };\n    }\n  }\n\n  /**\n   * Validate parameters with optional custom validator\n   *\n   * @param params - The parameters to validate\n   * @param validator - Optional function to validate parameter types\n   * @throws Error if validation fails, asserts type if successful\n   */\n  protected validateParams<T>(\n    params: unknown,\n    validator?: (params: unknown) => params is T,\n  ): asserts params is T {\n    if (validator && !validator(params)) {\n      throw new Error(\"Invalid parameters\");\n    }\n  }\n}\n\n/**\n * Generic retry utility with exponential backoff\n */\nexport class RetryUtility {\n  private static async delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  static async withRetry<T>(\n    operation: () => Promise<T>,\n    config: RetryConfig,\n  ): Promise<T> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Check if we should retry\n        if (config.shouldRetry && !config.shouldRetry(lastError, attempt)) {\n          throw lastError;\n        }\n\n        // Don't delay on the last attempt\n        if (attempt === config.maxAttempts) {\n          break;\n        }\n\n        // Calculate delay with exponential backoff and jitter\n        const baseDelay =\n          config.baseDelay *\n          Math.pow(config.backoffMultiplier ?? 2, attempt - 1);\n        const maxDelay = config.maxDelay ?? 30000;\n        const jitter = config.jitter ?? 0;\n\n        let delay = Math.min(baseDelay, maxDelay);\n\n        if (jitter > 0) {\n          delay += Math.random() * jitter * delay;\n        }\n\n        await this.delay(delay);\n      }\n    }\n\n    throw lastError ?? new Error(\"Operation failed after retries\");\n  }\n}\n\n/**\n * Generic rate limiter\n */\nexport class RateLimiter {\n  private requests: number[] = [];\n\n  constructor(private config: RateLimiterConfig) {}\n\n  async checkLimit(): Promise<boolean> {\n    const now = Date.now();\n    const windowStart = now - this.config.windowMs;\n\n    // Remove requests outside the window\n    this.requests = this.requests.filter((time) => time > windowStart);\n\n    // Check if we can make a request\n    if (this.requests.length < this.config.requestsPerWindow) {\n      this.requests.push(now);\n      return true;\n    }\n\n    return false;\n  }\n\n  async waitForSlot(): Promise<void> {\n    while (!(await this.checkLimit())) {\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n  }\n\n  getRemainingRequests(): number {\n    const now = Date.now();\n    const windowStart = now - this.config.windowMs;\n    const activeRequests = this.requests.filter((time) => time > windowStart);\n    return Math.max(0, this.config.requestsPerWindow - activeRequests.length);\n  }\n\n  getResetTime(): number {\n    if (this.requests.length === 0) return 0;\n    return Math.max(0, this.requests[0] + this.config.windowMs - Date.now());\n  }\n}\n\n/**\n * Generic in-memory cache implementation\n */\nexport class MemoryCache<TKey = string, TValue = unknown>\n  implements Cache<TKey, TValue>\n{\n  private cache = new Map<TKey, { value: TValue; expiry?: number }>();\n\n  async get(key: TKey): Promise<TValue | undefined> {\n    const item = this.cache.get(key);\n\n    if (!item) return undefined;\n\n    // Check if expired\n    if (item.expiry && Date.now() > item.expiry) {\n      this.cache.delete(key);\n      return undefined;\n    }\n\n    return item.value;\n  }\n\n  async set(key: TKey, value: TValue, ttl?: number): Promise<void> {\n    const expiry = ttl ? Date.now() + ttl : undefined;\n    this.cache.set(key, { value, expiry });\n  }\n\n  async delete(key: TKey): Promise<boolean> {\n    return this.cache.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n  }\n\n  async has(key: TKey): Promise<boolean> {\n    const exists = this.cache.has(key);\n    if (!exists) return false;\n\n    // Check expiry\n    const item = this.cache.get(key);\n    if (item?.expiry && Date.now() > item.expiry) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  size(): number {\n    return this.cache.size;\n  }\n\n  keys(): TKey[] {\n    return Array.from(this.cache.keys());\n  }\n}\n\n/**\n * Generic event emitter implementation\n */\nexport class EventEmitter<TEvent = unknown> implements Observable<TEvent> {\n  private observers: Observer<TEvent>[] = [];\n\n  subscribe(observer: Observer<TEvent>): () => void {\n    this.observers.push(observer);\n\n    return () => {\n      this.unsubscribe(observer);\n    };\n  }\n\n  unsubscribe(observer: Observer<TEvent>): void {\n    const index = this.observers.indexOf(observer);\n    if (index > -1) {\n      this.observers.splice(index, 1);\n    }\n  }\n\n  emit(event: TEvent): void {\n    for (const observer of this.observers) {\n      try {\n        const result = observer.notify(event);\n        if (result instanceof Promise) {\n          result.catch((error) => {\n            console.error(\"Observer error:\", error);\n          });\n        }\n      } catch (error) {\n        console.error(\"Observer error:\", error);\n      }\n    }\n  }\n\n  getObserverCount(): number {\n    return this.observers.length;\n  }\n\n  removeAllObservers(): void {\n    this.observers = [];\n  }\n}\n\n/**\n * Generic middleware pipeline\n */\nexport class MiddlewarePipeline {\n  private middleware: Middleware<any, any>[] = [];\n\n  use(middleware: Middleware<any, any>): void {\n    this.middleware.push(middleware);\n  }\n\n  async processRequest<TRequest>(request: TRequest): Promise<TRequest> {\n    let processed = request;\n\n    for (const mw of this.middleware) {\n      if (mw.request) {\n        processed = await mw.request(processed);\n      }\n    }\n\n    return processed;\n  }\n\n  async processResponse<TResponse>(response: TResponse): Promise<TResponse> {\n    let processed = response;\n\n    // Process in reverse order\n    for (const mw of this.middleware.slice().reverse()) {\n      if (mw.response) {\n        processed = await mw.response(processed);\n      }\n    }\n\n    return processed;\n  }\n\n  async handleError<TRequest, TResponse>(\n    error: Error,\n    request: TRequest,\n  ): Promise<TResponse | void> {\n    for (const mw of this.middleware) {\n      if (mw.error) {\n        const result = await mw.error(error, request);\n        if (result) {\n          return result;\n        }\n      }\n    }\n  }\n\n  getMiddleware(): Middleware<any, any>[] {\n    return [...this.middleware];\n  }\n\n  clear(): void {\n    this.middleware = [];\n  }\n}\n\n/**\n * Generic async queue for managing concurrent operations\n */\nexport class AsyncQueue<T = unknown> {\n  private queue: Array<() => Promise<T>> = [];\n  private running = 0;\n\n  constructor(private concurrency = 1) {}\n\n  async add<R>(operation: () => Promise<R>): Promise<R> {\n    return new Promise((resolve, reject) => {\n      this.queue.push(async () => {\n        try {\n          const result = await operation();\n          resolve(result as unknown as R);\n          return result as unknown as T;\n        } catch (error) {\n          reject(error);\n          throw error;\n        } finally {\n          this.running--;\n          this.processQueue();\n        }\n      });\n\n      this.processQueue();\n    });\n  }\n\n  private processQueue(): void {\n    while (this.running < this.concurrency && this.queue.length > 0) {\n      const operation = this.queue.shift();\n      if (operation) {\n        this.running++;\n        operation().catch(() => {\n          // Error already handled in add method\n        });\n      }\n    }\n  }\n\n  get pending(): number {\n    return this.queue.length;\n  }\n\n  get active(): number {\n    return this.running;\n  }\n\n  get size(): number {\n    return this.queue.length + this.running;\n  }\n\n  clear(): void {\n    this.queue = [];\n  }\n}\n\n/**\n * Generic circuit breaker pattern\n */\nexport class CircuitBreaker {\n  private state: \"closed\" | \"open\" | \"half-open\" = \"closed\";\n  private failures = 0;\n  private lastFailureTime = 0;\n  private successes = 0;\n\n  constructor(\n    private config: {\n      failureThreshold: number;\n      recoveryTimeout: number;\n      halfOpenMaxAttempts?: number;\n    },\n  ) {}\n\n  async execute<TResult>(operation: () => Promise<TResult>): Promise<TResult> {\n    if (this.state === \"open\") {\n      if (Date.now() - this.lastFailureTime > this.config.recoveryTimeout) {\n        this.state = \"half-open\";\n        this.successes = 0;\n      } else {\n        throw new Error(\"Circuit breaker is open\");\n      }\n    }\n\n    try {\n      const result = await operation();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n\n    if (this.state === \"half-open\") {\n      this.successes++;\n      if (this.successes >= (this.config.halfOpenMaxAttempts ?? 1)) {\n        this.state = \"closed\";\n      }\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailureTime = Date.now();\n\n    if (this.failures >= this.config.failureThreshold) {\n      this.state = \"open\";\n    }\n  }\n\n  getState(): string {\n    return this.state;\n  }\n\n  getFailures(): number {\n    return this.failures;\n  }\n\n  reset(): void {\n    this.state = \"closed\";\n    this.failures = 0;\n    this.successes = 0;\n    this.lastFailureTime = 0;\n  }\n}\n"],"mappings":"AAgBO,MAAe,eAGtB;AAAA,EACkB;AAAA,EAEhB,YAAY,SAAmB;AAC7B,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAgB,eACd,SACA,SACA,aAA2B,CAAC,GACS;AACrC,QAAI;AAEF,UAAI,mBAAmB;AACvB,iBAAW,MAAM,YAAY;AAC3B,YAAI,GAAG,SAAS;AACd,6BAAoB,MAAM,GAAG;AAAA,YAC3B;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAGA,UAAI,WAAW,MAAM,QAAQ,iBAAiB,MAAM;AAGpD,iBAAW,MAAM,WAAW,QAAQ,GAAG;AACrC,YAAI,GAAG,UAAU;AACf,qBAAY,MAAM,GAAG,SAAS,QAAQ;AAAA,QACxC;AAAA,MACF;AAEA,aAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,IACF,SAAS,OAAO;AAEd,iBAAW,MAAM,YAAY;AAC3B,YAAI,GAAG,OAAO;AACZ,gBAAM,UAAU,MAAM,GAAG,MAAM,OAAgB,OAAO;AACtD,cAAI,SAAS;AACX,mBAAO;AAAA,cACL,MAAM;AAAA,cACN,SAAS;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA;AAAA;AAAA;AAAA,QAIL,MAAM;AAAA,QACN,SAAS;AAAA,QACT,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,UAClD,SAAS;AAAA,QACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,eACR,QACA,WACqB;AACrB,QAAI,aAAa,CAAC,UAAU,MAAM,GAAG;AACnC,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAAA,EACF;AACF;AAKO,MAAM,aAAa;AAAA,EACxB,aAAqB,MAAM,IAA2B;AACpD,WAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EACzD;AAAA,EAEA,aAAa,UACX,WACA,QACY;AACZ,QAAI;AAEJ,aAAS,UAAU,GAAG,WAAW,OAAO,aAAa,WAAW;AAC9D,UAAI;AACF,eAAO,MAAM,UAAU;AAAA,MACzB,SAAS,OAAO;AACd,oBAAY;AAGZ,YAAI,OAAO,eAAe,CAAC,OAAO,YAAY,WAAW,OAAO,GAAG;AACjE,gBAAM;AAAA,QACR;AAGA,YAAI,YAAY,OAAO,aAAa;AAClC;AAAA,QACF;AAGA,cAAM,YACJ,OAAO,YACP,KAAK,IAAI,OAAO,qBAAqB,GAAG,UAAU,CAAC;AACrD,cAAM,WAAW,OAAO,YAAY;AACpC,cAAM,SAAS,OAAO,UAAU;AAEhC,YAAI,QAAQ,KAAK,IAAI,WAAW,QAAQ;AAExC,YAAI,SAAS,GAAG;AACd,mBAAS,KAAK,OAAO,IAAI,SAAS;AAAA,QACpC;AAEA,cAAM,KAAK,MAAM,KAAK;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,aAAa,IAAI,MAAM,gCAAgC;AAAA,EAC/D;AACF;AAKO,MAAM,YAAY;AAAA,EAGvB,YAAoB,QAA2B;AAA3B;AAAA,EAA4B;AAAA,EAFxC,WAAqB,CAAC;AAAA,EAI9B,MAAM,aAA+B;AACnC,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,cAAc,MAAM,KAAK,OAAO;AAGtC,SAAK,WAAW,KAAK,SAAS,OAAO,CAAC,SAAS,OAAO,WAAW;AAGjE,QAAI,KAAK,SAAS,SAAS,KAAK,OAAO,mBAAmB;AACxD,WAAK,SAAS,KAAK,GAAG;AACtB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,cAA6B;AACjC,WAAO,CAAE,MAAM,KAAK,WAAW,GAAI;AACjC,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAG,CAAC;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,uBAA+B;AAC7B,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,cAAc,MAAM,KAAK,OAAO;AACtC,UAAM,iBAAiB,KAAK,SAAS,OAAO,CAAC,SAAS,OAAO,WAAW;AACxE,WAAO,KAAK,IAAI,GAAG,KAAK,OAAO,oBAAoB,eAAe,MAAM;AAAA,EAC1E;AAAA,EAEA,eAAuB;AACrB,QAAI,KAAK,SAAS,WAAW,EAAG,QAAO;AACvC,WAAO,KAAK,IAAI,GAAG,KAAK,SAAS,CAAC,IAAI,KAAK,OAAO,WAAW,KAAK,IAAI,CAAC;AAAA,EACzE;AACF;AAKO,MAAM,YAEb;AAAA,EACU,QAAQ,oBAAI,IAA8C;AAAA,EAElE,MAAM,IAAI,KAAwC;AAChD,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAE/B,QAAI,CAAC,KAAM,QAAO;AAGlB,QAAI,KAAK,UAAU,KAAK,IAAI,IAAI,KAAK,QAAQ;AAC3C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAEA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,IAAI,KAAW,OAAe,KAA6B;AAC/D,UAAM,SAAS,MAAM,KAAK,IAAI,IAAI,MAAM;AACxC,SAAK,MAAM,IAAI,KAAK,EAAE,OAAO,OAAO,CAAC;AAAA,EACvC;AAAA,EAEA,MAAM,OAAO,KAA6B;AACxC,WAAO,KAAK,MAAM,OAAO,GAAG;AAAA,EAC9B;AAAA,EAEA,MAAM,QAAuB;AAC3B,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA,EAEA,MAAM,IAAI,KAA6B;AACrC,UAAM,SAAS,KAAK,MAAM,IAAI,GAAG;AACjC,QAAI,CAAC,OAAQ,QAAO;AAGpB,UAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAC/B,QAAI,MAAM,UAAU,KAAK,IAAI,IAAI,KAAK,QAAQ;AAC5C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,OAAe;AACb,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA,EAEA,OAAe;AACb,WAAO,MAAM,KAAK,KAAK,MAAM,KAAK,CAAC;AAAA,EACrC;AACF;AAKO,MAAM,aAA6D;AAAA,EAChE,YAAgC,CAAC;AAAA,EAEzC,UAAU,UAAwC;AAChD,SAAK,UAAU,KAAK,QAAQ;AAE5B,WAAO,MAAM;AACX,WAAK,YAAY,QAAQ;AAAA,IAC3B;AAAA,EACF;AAAA,EAEA,YAAY,UAAkC;AAC5C,UAAM,QAAQ,KAAK,UAAU,QAAQ,QAAQ;AAC7C,QAAI,QAAQ,IAAI;AACd,WAAK,UAAU,OAAO,OAAO,CAAC;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,KAAK,OAAqB;AACxB,eAAW,YAAY,KAAK,WAAW;AACrC,UAAI;AACF,cAAM,SAAS,SAAS,OAAO,KAAK;AACpC,YAAI,kBAAkB,SAAS;AAC7B,iBAAO,MAAM,CAAC,UAAU;AACtB,oBAAQ,MAAM,mBAAmB,KAAK;AAAA,UACxC,CAAC;AAAA,QACH;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,MAAM,mBAAmB,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,mBAA2B;AACzB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,qBAA2B;AACzB,SAAK,YAAY,CAAC;AAAA,EACpB;AACF;AAKO,MAAM,mBAAmB;AAAA,EACtB,aAAqC,CAAC;AAAA,EAE9C,IAAI,YAAwC;AAC1C,SAAK,WAAW,KAAK,UAAU;AAAA,EACjC;AAAA,EAEA,MAAM,eAAyB,SAAsC;AACnE,QAAI,YAAY;AAEhB,eAAW,MAAM,KAAK,YAAY;AAChC,UAAI,GAAG,SAAS;AACd,oBAAY,MAAM,GAAG,QAAQ,SAAS;AAAA,MACxC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,gBAA2B,UAAyC;AACxE,QAAI,YAAY;AAGhB,eAAW,MAAM,KAAK,WAAW,MAAM,EAAE,QAAQ,GAAG;AAClD,UAAI,GAAG,UAAU;AACf,oBAAY,MAAM,GAAG,SAAS,SAAS;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,YACJ,OACA,SAC2B;AAC3B,eAAW,MAAM,KAAK,YAAY;AAChC,UAAI,GAAG,OAAO;AACZ,cAAM,SAAS,MAAM,GAAG,MAAM,OAAO,OAAO;AAC5C,YAAI,QAAQ;AACV,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,gBAAwC;AACtC,WAAO,CAAC,GAAG,KAAK,UAAU;AAAA,EAC5B;AAAA,EAEA,QAAc;AACZ,SAAK,aAAa,CAAC;AAAA,EACrB;AACF;AAKO,MAAM,WAAwB;AAAA,EAInC,YAAoB,cAAc,GAAG;AAAjB;AAAA,EAAkB;AAAA,EAH9B,QAAiC,CAAC;AAAA,EAClC,UAAU;AAAA,EAIlB,MAAM,IAAO,WAAyC;AACpD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,MAAM,KAAK,YAAY;AAC1B,YAAI;AACF,gBAAM,SAAS,MAAM,UAAU;AAC/B,kBAAQ,MAAsB;AAC9B,iBAAO;AAAA,QACT,SAAS,OAAO;AACd,iBAAO,KAAK;AACZ,gBAAM;AAAA,QACR,UAAE;AACA,eAAK;AACL,eAAK,aAAa;AAAA,QACpB;AAAA,MACF,CAAC;AAED,WAAK,aAAa;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EAEQ,eAAqB;AAC3B,WAAO,KAAK,UAAU,KAAK,eAAe,KAAK,MAAM,SAAS,GAAG;AAC/D,YAAM,YAAY,KAAK,MAAM,MAAM;AACnC,UAAI,WAAW;AACb,aAAK;AACL,kBAAU,EAAE,MAAM,MAAM;AAAA,QAExB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA,EAEA,IAAI,SAAiB;AACnB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,KAAK,MAAM,SAAS,KAAK;AAAA,EAClC;AAAA,EAEA,QAAc;AACZ,SAAK,QAAQ,CAAC;AAAA,EAChB;AACF;AAKO,MAAM,eAAe;AAAA,EAM1B,YACU,QAKR;AALQ;AAAA,EAKP;AAAA,EAXK,QAAyC;AAAA,EACzC,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,YAAY;AAAA,EAUpB,MAAM,QAAiB,WAAqD;AAC1E,QAAI,KAAK,UAAU,QAAQ;AACzB,UAAI,KAAK,IAAI,IAAI,KAAK,kBAAkB,KAAK,OAAO,iBAAiB;AACnE,aAAK,QAAQ;AACb,aAAK,YAAY;AAAA,MACnB,OAAO;AACL,cAAM,IAAI,MAAM,yBAAyB;AAAA,MAC3C;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,UAAU;AAC/B,WAAK,UAAU;AACf,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,UAAU;AACf,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,YAAkB;AACxB,SAAK,WAAW;AAEhB,QAAI,KAAK,UAAU,aAAa;AAC9B,WAAK;AACL,UAAI,KAAK,cAAc,KAAK,OAAO,uBAAuB,IAAI;AAC5D,aAAK,QAAQ;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,YAAkB;AACxB,SAAK;AACL,SAAK,kBAAkB,KAAK,IAAI;AAEhC,QAAI,KAAK,YAAY,KAAK,OAAO,kBAAkB;AACjD,WAAK,QAAQ;AAAA,IACf;AAAA,EACF;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,cAAsB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAc;AACZ,SAAK,QAAQ;AACb,SAAK,WAAW;AAChB,SAAK,YAAY;AACjB,SAAK,kBAAkB;AAAA,EACzB;AACF;","names":[]}

package/dist/core/tests/apiClient.test.d.ts

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

package/dist/core/tests/client.test.d.ts

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

package/dist/core/tests/generics.test.d.ts

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

package/dist/core.cjs

@@ -41,6 +41,7 @@ var import_server = require("./controllers/server");
 var import_protocol = require("./controllers/protocol");
 var import_storage = require("./storage");
 var import_viem = require("viem");
+var import_wallet = require("./utils/wallet");
 var import_chains = require("./config/chains");
 var import_chains2 = require("./chains");
 var import_encryption = require("./utils/encryption");
@@ -103,9 +104,10 @@ class VanaCore {
   storageManager;
   hasRequiredStorage;
   ipfsGateways;
-  defaultPersonalServerUrl;
   publicClient;
   walletClient;
+  _staticUserAddress;
+  // For read-only mode
   /**
    * Initializes a new VanaCore client instance with the provided configuration.
    *
@@ -133,17 +135,12 @@ class VanaCore {
     this.relayerCallbacks = config.relayerCallbacks;
     this.downloadRelayer = config.downloadRelayer;
     this.ipfsGateways = config.ipfsGateways;
-    this.defaultPersonalServerUrl = config.defaultPersonalServerUrl;
     this.hasRequiredStorage = (0, import_types.hasStorageConfig)(config);
     if (config.storage?.providers) {
       this.storageManager = new import_storage.StorageManager();
       for (const [name, provider] of Object.entries(config.storage.providers)) {
         const isDefault = name === config.storage.defaultProvider;
-        this.storageManager.register(
-          name,
-          provider,
-          isDefault
-        );
+        this.storageManager.register(name, provider, isDefault);
       }
       if (!config.storage.defaultProvider && Object.keys(config.storage.providers).length > 0) {
         const firstProviderName = Object.keys(config.storage.providers)[0];
@@ -151,8 +148,34 @@ class VanaCore {
       }
     }
     let walletClient;
+    let publicClient;
+    let staticUserAddress;
+    let chainToUse;
     if ((0, import_types.isWalletConfig)(config)) {
       walletClient = config.walletClient;
+      chainToUse = walletClient.chain ?? import_chains2.vanaMainnet;
+      staticUserAddress = void 0;
+      if ("publicClient" in config && config.publicClient) {
+        publicClient = config.publicClient;
+      } else {
+        publicClient = (0, import_viem.createPublicClient)({
+          chain: chainToUse,
+          transport: (0, import_viem.http)()
+        });
+      }
+    } else if ((0, import_types.isReadOnlyConfig)(config)) {
+      walletClient = void 0;
+      publicClient = config.publicClient;
+      staticUserAddress = config.address;
+      chainToUse = config.publicClient.chain ?? import_chains2.vanaMainnet;
+    } else if ((0, import_types.isAddressOnlyConfig)(config)) {
+      walletClient = void 0;
+      staticUserAddress = config.address;
+      chainToUse = config.chain ?? import_chains2.vanaMainnet;
+      publicClient = (0, import_viem.createPublicClient)({
+        chain: chainToUse,
+        transport: (0, import_viem.http)()
+      });
     } else if ((0, import_types.isChainConfig)(config)) {
       if (!config.account) {
         throw new import_errors.InvalidConfigurationError(
@@ -165,27 +188,35 @@ class VanaCore {
           `Unsupported chain ID: ${config.chainId}`
         );
       }
+      chainToUse = chain;
       walletClient = (0, import_viem.createWalletClient)({
         chain,
-        transport: (0, import_viem.http)(config.rpcUrl || chain.rpcUrls.default.http[0]),
+        transport: (0, import_viem.http)(config.rpcUrl ?? chain.rpcUrls.default.http[0]),
         account: config.account
       });
+      staticUserAddress = void 0;
+      publicClient = (0, import_viem.createPublicClient)({
+        chain,
+        transport: (0, import_viem.http)()
+      });
     } else {
       throw new import_errors.InvalidConfigurationError(
-        "Invalid configuration: must be either WalletConfig or ChainConfig"
+        "Invalid configuration: must provide either walletClient, publicClient + address, or address alone"
       );
     }
-    const publicClient = (0, import_viem.createPublicClient)({
-      chain: walletClient.chain,
-      transport: (0, import_viem.http)()
-    });
     this.publicClient = publicClient;
     this.walletClient = walletClient;
-    const chainConfig = (0, import_chains2.getChainConfig)(walletClient.chain.id);
-    const subgraphUrl = config.subgraphUrl || chainConfig?.subgraphUrl;
+    this._staticUserAddress = staticUserAddress;
+    const chainConfig = (0, import_chains2.getChainConfig)(chainToUse.id);
+    const subgraphUrl = config.subgraphUrl ?? chainConfig?.subgraphUrl;
+    const personalServerUrl = config.defaultPersonalServerUrl ?? chainConfig?.personalServerUrl;
+    const self = this;
     const sharedContext = {
       walletClient,
       publicClient,
+      get userAddress() {
+        return self.userAddress;
+      },
       applicationClient: walletClient,
       // Using same wallet for now
       relayerCallbacks: this.relayerCallbacks,
@@ -197,7 +228,7 @@ class VanaCore {
       validateStorageRequired: this.validateStorageRequired.bind(this),
       hasStorage: this.hasStorage.bind(this),
       ipfsGateways: this.ipfsGateways,
-      defaultPersonalServerUrl: this.defaultPersonalServerUrl,
+      defaultPersonalServerUrl: personalServerUrl,
       waitForTransactionEvents: this.waitForTransactionEvents.bind(this),
       waitForOperation: this.waitForOperation.bind(this)
     };
@@ -316,13 +347,13 @@ class VanaCore {
       }
       if (!(0, import_types.isVanaChainId)(config.walletClient.chain.id)) {
         throw new import_errors.InvalidConfigurationError(
-          `Unsupported chain ID: ${config.walletClient.chain.id}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`
+          `Unsupported chain ID: ${String(config.walletClient.chain.id)}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`
         );
       }
     } else if ((0, import_types.isChainConfig)(config)) {
       if (!(0, import_types.isVanaChainId)(config.chainId)) {
         throw new import_errors.InvalidConfigurationError(
-          `Unsupported chain ID: ${config.chainId}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`
+          `Unsupported chain ID: ${String(config.chainId)}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`
         );
       }
       if (config.rpcUrl) {
@@ -345,9 +376,26 @@ class VanaCore {
           );
         }
       }
+    } else if ((0, import_types.isReadOnlyConfig)(config)) {
+      if (!config.publicClient) {
+        throw new import_errors.InvalidConfigurationError(
+          "publicClient is required for read-only configuration"
+        );
+      }
+      if (!config.address) {
+        throw new import_errors.InvalidConfigurationError(
+          "address is required for read-only configuration"
+        );
+      }
+    } else if ((0, import_types.isAddressOnlyConfig)(config)) {
+      if (!config.address) {
+        throw new import_errors.InvalidConfigurationError(
+          "address is required for address-only configuration"
+        );
+      }
     } else {
       throw new import_errors.InvalidConfigurationError(
-        "Configuration must be either WalletConfig or ChainConfig"
+        "Invalid configuration: must provide either walletClient, publicClient + address, or address alone"
       );
     }
   }
@@ -378,27 +426,24 @@ class VanaCore {
     return this.protocol.getChainName();
   }
   /**
-   * Retrieves the user's wallet address from the connected client.
+   * The user's wallet address.
+   * In wallet mode, this always returns the current wallet account address.
+   * In read-only mode, this returns the static address provided during initialization.
    *
-   * @returns A Promise that resolves to the user's Ethereum address
    * @example
    * ```typescript
-   * const address = await vana.getUserAddress();
+   * const address = vana.userAddress;
    * console.log(`User address: ${address}`); // e.g., "User address: 0x742d35..."
    * ```
    */
-  async getUserAddress() {
-    if (!this.walletClient.account) {
-      throw new Error("No wallet account connected");
+  get userAddress() {
+    if (this.walletClient?.account) {
+      return (0, import_wallet.extractAddress)(this.walletClient.account);
     }
-    const account = this.walletClient.account;
-    if (typeof account === "string") {
-      return account;
+    if (this._staticUserAddress) {
+      return this._staticUserAddress;
     }
-    if (typeof account === "object" && account.address) {
-      return account.address;
-    }
-    throw new Error("Unable to determine wallet address");
+    throw new Error("No user address available");
   }
   /**
    * Retrieves comprehensive runtime configuration information.
@@ -416,7 +461,7 @@ class VanaCore {
       chainId: this.chainId,
       chainName: this.chainName,
       relayerCallbacks: this.relayerCallbacks,
-      storageProviders: this.storageManager?.getStorageProviders() || [],
+      storageProviders: this.storageManager?.getStorageProviders() ?? [],
       defaultStorageProvider: this.storageManager?.getDefaultStorageProvider()
     };
   }
@@ -645,7 +690,10 @@ class VanaCore {
    */
   async waitForTransactionEvents(transaction, options) {
     const { parseTransaction } = await import("./utils/parseTransactionPojo");
-    const receipt = await this.waitForTransactionReceipt(transaction.hash, options);
+    const receipt = await this.waitForTransactionReceipt(
+      transaction.hash,
+      options
+    );
     const result = parseTransaction(transaction, receipt);
     return result;
   }