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

package/dist/core/apiClient.js

@@ -0,0 +1,309 @@
+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);
+import {
+  RetryUtility,
+  RateLimiter,
+  MiddlewarePipeline,
+  CircuitBreaker
+} from "./generics";
+class ApiClient {
+  constructor(config = {}) {
+    __publicField(this, "config");
+    __publicField(this, "middleware");
+    __publicField(this, "rateLimiter");
+    __publicField(this, "circuitBreaker");
+    this.config = {
+      baseUrl: config.baseUrl || "",
+      headers: config.headers || {},
+      timeout: config.timeout || 3e4,
+      retry: config.retry || {
+        maxAttempts: 3,
+        baseDelay: 1e3,
+        backoffMultiplier: 2,
+        shouldRetry: (error) => error.message.includes("network")
+      },
+      rateLimit: config.rateLimit || {
+        requestsPerWindow: 100,
+        windowMs: 6e4
+      },
+      circuitBreaker: config.circuitBreaker || {
+        failureThreshold: 5,
+        recoveryTimeout: 6e4,
+        halfOpenMaxAttempts: 3
+      }
+    };
+    this.middleware = new MiddlewarePipeline();
+    this.rateLimiter = new RateLimiter(this.config.rateLimit);
+    this.circuitBreaker = new CircuitBreaker(this.config.circuitBreaker);
+  }
+  /**
+   * Add middleware to the request pipeline
+   *
+   * @param middleware - The middleware function to add to the pipeline
+   */
+  use(middleware) {
+    this.middleware.use(middleware);
+  }
+  /**
+   * Make a generic HTTP request
+   *
+   * @param url - The URL to make the request to
+   * @param options - Request options including method, headers, body, etc.
+   * @returns Promise resolving to the response data
+   */
+  async request(url, options = {}) {
+    const fullUrl = this.buildUrl(url);
+    const requestOptions = this.buildRequestOptions(options);
+    const request = {
+      params: {
+        url: fullUrl,
+        options: requestOptions
+      },
+      options: requestOptions
+    };
+    if (!options.skipRateLimit && this.rateLimiter) {
+      await this.rateLimiter.waitForSlot();
+    }
+    if (this.circuitBreaker) {
+      return this.circuitBreaker.execute(
+        () => this.executeRequest(request)
+      );
+    }
+    return this.executeRequest(request);
+  }
+  /**
+   * Make a GET request
+   *
+   * @param url - The URL to make the GET request to
+   * @param options - Request options (excluding method)
+   * @returns Promise resolving to the response data
+   */
+  async get(url, options = {}) {
+    return this.request(url, { ...options, method: "GET" });
+  }
+  /**
+   * Make a POST request
+   *
+   * @param url - The URL to make the POST request to
+   * @param data - The data to send in the request body
+   * @param options - Request options (excluding method)
+   * @returns Promise resolving to the response data
+   */
+  async post(url, data, options = {}) {
+    return this.request(url, {
+      ...options,
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Make a PUT request
+   *
+   * @param url - The URL to make the PUT request to
+   * @param data - The data to send in the request body
+   * @param options - Request options (excluding method)
+   * @returns Promise resolving to the response data
+   */
+  async put(url, data, options = {}) {
+    return this.request(url, {
+      ...options,
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Make a DELETE request
+   *
+   * @param url - The URL to make the DELETE request to
+   * @param options - Request options (excluding method)
+   * @returns Promise resolving to the response data
+   */
+  async delete(url, options = {}) {
+    return this.request(url, { ...options, method: "DELETE" });
+  }
+  /**
+   * Make a PATCH request
+   *
+   * @param url - The URL to make the PATCH request to
+   * @param data - The data to send in the request body
+   * @param options - Request options (excluding method)
+   * @returns Promise resolving to the response data
+   */
+  async patch(url, data, options = {}) {
+    return this.request(url, {
+      ...options,
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Execute the actual HTTP request with middleware and retry
+   *
+   * @param request - The generic request object containing URL and options
+   * @returns Promise resolving to the generic response with data
+   */
+  async executeRequest(request) {
+    const executeWithRetry = async () => {
+      try {
+        const processedRequest = await this.middleware.processRequest(request);
+        const response = await this.makeHttpRequest(
+          processedRequest.params.url,
+          processedRequest.params.options
+        );
+        const processedResponse = await this.middleware.processResponse(response);
+        return processedResponse;
+      } catch (error) {
+        const handledResponse = await this.middleware.handleError(error, request);
+        if (handledResponse) {
+          return handledResponse;
+        }
+        throw error;
+      }
+    };
+    if (!request.params.options.skipRetry) {
+      return RetryUtility.withRetry(executeWithRetry, this.config.retry);
+    }
+    return executeWithRetry();
+  }
+  /**
+   * Make the actual HTTP request using fetch API
+   *
+   * @param url - The URL to make the request to
+   * @param options - The request options including method, headers, body, etc.
+   * @returns Promise resolving to the generic response with data
+   */
+  async makeHttpRequest(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+      controller.abort();
+    }, options.timeout || this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method: options.method || "GET",
+        headers: {
+          ...this.config.headers,
+          ...options.headers
+        },
+        signal: controller.signal,
+        // Add body for POST/PUT/PATCH requests
+        ...options.method && ["POST", "PUT", "PATCH"].includes(options.method) && {
+          body: JSON.stringify(options.params)
+        }
+      });
+      clearTimeout(timeoutId);
+      const responseData = await response.json();
+      const data = responseData;
+      if (!response.ok) {
+        return {
+          data: null,
+          success: false,
+          error: {
+            code: response.status.toString(),
+            message: data.message || response.statusText,
+            details: data
+          }
+        };
+      }
+      return {
+        data: responseData,
+        success: true,
+        meta: {
+          status: response.status,
+          statusText: response.statusText,
+          headers: Object.fromEntries(response.headers.entries())
+        }
+      };
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === "AbortError") {
+        return {
+          data: null,
+          success: false,
+          error: {
+            code: "TIMEOUT",
+            message: "Request timeout",
+            details: error
+          }
+        };
+      }
+      return {
+        data: null,
+        success: false,
+        error: {
+          code: "NETWORK_ERROR",
+          message: error instanceof Error ? error.message : "Unknown error",
+          details: error
+        }
+      };
+    }
+  }
+  /**
+   * Build the full URL
+   *
+   * @param url - The URL or path to build the full URL from
+   * @returns The complete URL string
+   */
+  buildUrl(url) {
+    if (url.startsWith("http")) {
+      return url;
+    }
+    const baseUrl = this.config.baseUrl.endsWith("/") ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl;
+    const path = url.startsWith("/") ? url : `/${url}`;
+    return `${baseUrl}${path}`;
+  }
+  /**
+   * Build request options with defaults
+   *
+   * @param options - The request options to merge with defaults
+   * @returns The merged request options with defaults applied
+   */
+  buildRequestOptions(options) {
+    return {
+      method: "GET",
+      headers: {},
+      timeout: this.config.timeout,
+      ...options
+    };
+  }
+  /**
+   * Get client statistics
+   *
+   * @returns Object containing client statistics and performance metrics
+   */
+  getStats() {
+    return {
+      rateLimiter: this.rateLimiter ? {
+        remaining: this.rateLimiter.getRemainingRequests(),
+        resetTime: this.rateLimiter.getResetTime()
+      } : null,
+      circuitBreaker: this.circuitBreaker ? {
+        state: this.circuitBreaker.getState(),
+        failures: this.circuitBreaker.getFailures()
+      } : null,
+      middleware: {
+        count: this.middleware.getMiddleware().length
+      }
+    };
+  }
+  /**
+   * Reset client state
+   */
+  reset() {
+    this.circuitBreaker?.reset();
+    this.middleware.clear();
+  }
+}
+export {
+  ApiClient
+};
+//# sourceMappingURL=apiClient.js.map

package/dist/core/apiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/apiClient.ts"],"sourcesContent":["import type {\n  GenericRequest,\n  GenericResponse,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n} from \"../types/generics\";\nimport {\n  RetryUtility,\n  RateLimiter,\n  MiddlewarePipeline,\n  CircuitBreaker,\n} from \"./generics\";\n\n/**\n * Configuration for the generic API client\n */\nexport interface ApiClientConfig {\n  /** Base URL for all requests */\n  baseUrl?: string;\n  /** Default headers */\n  headers?: Record<string, string>;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n  /** Retry configuration */\n  retry?: RetryConfig;\n  /** Rate limiting configuration */\n  rateLimit?: RateLimiterConfig;\n  /** Circuit breaker configuration */\n  circuitBreaker?: {\n    failureThreshold: number;\n    recoveryTimeout: number;\n    halfOpenMaxAttempts?: number;\n  };\n}\n\n/**\n * HTTP method types\n */\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Request options for API calls\n */\nexport interface RequestOptions {\n  /** HTTP method */\n  method?: HttpMethod;\n  /** Request headers */\n  headers?: Record<string, string>;\n  /** Query parameters */\n  params?: Record<string, unknown>;\n  /** Request timeout */\n  timeout?: number;\n  /** Skip retry for this request */\n  skipRetry?: boolean;\n  /** Skip rate limiting for this request */\n  skipRateLimit?: boolean;\n}\n\n/**\n * Generic API client with middleware, retry, rate limiting, and circuit breaker support\n */\nexport class ApiClient {\n  private readonly config: Required<ApiClientConfig>;\n  private readonly middleware: MiddlewarePipeline;\n  private readonly rateLimiter?: RateLimiter;\n  private readonly circuitBreaker?: CircuitBreaker;\n\n  constructor(config: ApiClientConfig = {}) {\n    this.config = {\n      baseUrl: config.baseUrl || \"\",\n      headers: config.headers || {},\n      timeout: config.timeout || 30000,\n      retry: config.retry || {\n        maxAttempts: 3,\n        baseDelay: 1000,\n        backoffMultiplier: 2,\n        shouldRetry: (error) => error.message.includes(\"network\"),\n      },\n      rateLimit: config.rateLimit || {\n        requestsPerWindow: 100,\n        windowMs: 60000,\n      },\n      circuitBreaker: config.circuitBreaker || {\n        failureThreshold: 5,\n        recoveryTimeout: 60000,\n        halfOpenMaxAttempts: 3,\n      },\n    };\n\n    this.middleware = new MiddlewarePipeline();\n    this.rateLimiter = new RateLimiter(this.config.rateLimit);\n    this.circuitBreaker = new CircuitBreaker(this.config.circuitBreaker);\n  }\n\n  /**\n   * Add middleware to the request pipeline\n   *\n   * @param middleware - The middleware function to add to the pipeline\n   */\n  use(middleware: Middleware): void {\n    this.middleware.use(middleware);\n  }\n\n  /**\n   * Make a generic HTTP request\n   *\n   * @param url - The URL to make the request to\n   * @param options - Request options including method, headers, body, etc.\n   * @returns Promise resolving to the response data\n   */\n  async request<TData = unknown>(\n    url: string,\n    options: RequestOptions = {},\n  ): Promise<GenericResponse<TData>> {\n    const fullUrl = this.buildUrl(url);\n    const requestOptions = this.buildRequestOptions(options);\n\n    const request: GenericRequest<{\n      url: string;\n      options: RequestOptions;\n    }> = {\n      params: {\n        url: fullUrl,\n        options: requestOptions,\n      },\n      options: requestOptions,\n    };\n\n    // Apply rate limiting\n    if (!options.skipRateLimit && this.rateLimiter) {\n      await this.rateLimiter.waitForSlot();\n    }\n\n    // Execute with circuit breaker\n    if (this.circuitBreaker) {\n      return this.circuitBreaker.execute(() =>\n        this.executeRequest<TData>(request),\n      );\n    }\n\n    return this.executeRequest<TData>(request);\n  }\n\n  /**\n   * Make a GET request\n   *\n   * @param url - The URL to make the GET request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async get<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"GET\" });\n  }\n\n  /**\n   * Make a POST request\n   *\n   * @param url - The URL to make the POST request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async post<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n    });\n  }\n\n  /**\n   * Make a PUT request\n   *\n   * @param url - The URL to make the PUT request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async put<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PUT\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n    });\n  }\n\n  /**\n   * Make a DELETE request\n   *\n   * @param url - The URL to make the DELETE request to\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async delete<TData = unknown>(\n    url: string,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, { ...options, method: \"DELETE\" });\n  }\n\n  /**\n   * Make a PATCH request\n   *\n   * @param url - The URL to make the PATCH request to\n   * @param data - The data to send in the request body\n   * @param options - Request options (excluding method)\n   * @returns Promise resolving to the response data\n   */\n  async patch<TData = unknown>(\n    url: string,\n    data?: unknown,\n    options: Omit<RequestOptions, \"method\"> = {},\n  ): Promise<GenericResponse<TData>> {\n    return this.request<TData>(url, {\n      ...options,\n      method: \"PATCH\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...options.headers,\n      },\n    });\n  }\n\n  /**\n   * Execute the actual HTTP request with middleware and retry\n   *\n   * @param request - The generic request object containing URL and options\n   * @returns Promise resolving to the generic response with data\n   */\n  private async executeRequest<TData>(\n    request: GenericRequest<{ url: string; options: RequestOptions }>,\n  ): Promise<GenericResponse<TData>> {\n    const executeWithRetry = async (): Promise<GenericResponse<TData>> => {\n      try {\n        // Process request through middleware\n        const processedRequest = await this.middleware.processRequest(request);\n\n        // Make the actual HTTP request\n        const response = await this.makeHttpRequest<TData>(\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.url,\n          (\n            processedRequest as GenericRequest<{\n              url: string;\n              options: RequestOptions;\n            }>\n          ).params.options,\n        );\n\n        // Process response through middleware\n        const processedResponse =\n          await this.middleware.processResponse(response);\n\n        return processedResponse;\n      } catch (error) {\n        // Try to handle error with middleware\n        const handledResponse = await this.middleware.handleError<\n          typeof request,\n          GenericResponse<TData>\n        >(error as Error, request);\n\n        if (handledResponse) {\n          return handledResponse;\n        }\n\n        throw error;\n      }\n    };\n\n    // Apply retry logic if not skipped\n    if (!request.params.options.skipRetry) {\n      return RetryUtility.withRetry(executeWithRetry, this.config.retry);\n    }\n\n    return executeWithRetry();\n  }\n\n  /**\n   * Make the actual HTTP request using fetch API\n   *\n   * @param url - The URL to make the request to\n   * @param options - The request options including method, headers, body, etc.\n   * @returns Promise resolving to the generic response with data\n   */\n  private async makeHttpRequest<TData>(\n    url: string,\n    options: RequestOptions,\n  ): Promise<GenericResponse<TData>> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => {\n      controller.abort();\n    }, options.timeout || this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method: options.method || \"GET\",\n        headers: {\n          ...this.config.headers,\n          ...options.headers,\n        },\n        signal: controller.signal,\n        // Add body for POST/PUT/PATCH requests\n        ...(options.method &&\n          [\"POST\", \"PUT\", \"PATCH\"].includes(options.method) && {\n            body: JSON.stringify(options.params),\n          }),\n      });\n\n      clearTimeout(timeoutId);\n\n      const responseData: unknown = await response.json();\n      const data = responseData as { message?: string; [key: string]: unknown };\n\n      if (!response.ok) {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: response.status.toString(),\n            message: data.message || response.statusText,\n            details: data,\n          },\n        };\n      }\n\n      return {\n        data: responseData as TData,\n        success: true,\n        meta: {\n          status: response.status,\n          statusText: response.statusText,\n          headers: Object.fromEntries(response.headers.entries()),\n        },\n      };\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof Error && error.name === \"AbortError\") {\n        return {\n          data: null as unknown as TData,\n          success: false,\n          error: {\n            code: \"TIMEOUT\",\n            message: \"Request timeout\",\n            details: error,\n          },\n        };\n      }\n\n      return {\n        data: null as unknown as TData,\n        success: false,\n        error: {\n          code: \"NETWORK_ERROR\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n          details: error,\n        },\n      };\n    }\n  }\n\n  /**\n   * Build the full URL\n   *\n   * @param url - The URL or path to build the full URL from\n   * @returns The complete URL string\n   */\n  private buildUrl(url: string): string {\n    if (url.startsWith(\"http\")) {\n      return url;\n    }\n\n    const baseUrl = this.config.baseUrl.endsWith(\"/\")\n      ? this.config.baseUrl.slice(0, -1)\n      : this.config.baseUrl;\n    const path = url.startsWith(\"/\") ? url : `/${url}`;\n\n    return `${baseUrl}${path}`;\n  }\n\n  /**\n   * Build request options with defaults\n   *\n   * @param options - The request options to merge with defaults\n   * @returns The merged request options with defaults applied\n   */\n  private buildRequestOptions(options: RequestOptions): RequestOptions {\n    return {\n      method: \"GET\",\n      headers: {},\n      timeout: this.config.timeout,\n      ...options,\n    };\n  }\n\n  /**\n   * Get client statistics\n   *\n   * @returns Object containing client statistics and performance metrics\n   */\n  getStats() {\n    return {\n      rateLimiter: this.rateLimiter\n        ? {\n            remaining: this.rateLimiter.getRemainingRequests(),\n            resetTime: this.rateLimiter.getResetTime(),\n          }\n        : null,\n      circuitBreaker: this.circuitBreaker\n        ? {\n            state: this.circuitBreaker.getState(),\n            failures: this.circuitBreaker.getFailures(),\n          }\n        : null,\n      middleware: {\n        count: this.middleware.getMiddleware().length,\n      },\n    };\n  }\n\n  /**\n   * Reset client state\n   */\n  reset(): void {\n    this.circuitBreaker?.reset();\n    this.middleware.clear();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/client.cjs

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_exports = {};
+__export(client_exports, {
+  createClient: () => createClient,
+  createWalletClient: () => createWalletClient,
+  defaultFromBlocks: () => defaultFromBlocks,
+  getDefaultFromBlock: () => getDefaultFromBlock
+});
+module.exports = __toCommonJS(client_exports);
+var import_viem = require("viem");
+var import_chains = require("../config/chains");
+const defaultFromBlocks = {
+  14800: BigInt(732312),
+  // Moksha Testnet - earliest contract deployment
+  1480: BigInt(758584)
+  // Vana Mainnet - earliest contract deployment
+};
+function getDefaultFromBlock(chainId) {
+  return defaultFromBlocks[chainId] || BigInt(0);
+}
+let _client;
+const createClient = (chainId = import_chains.mokshaTestnet.id) => {
+  if (!_client || _client.chain?.id !== chainId) {
+    const chain = import_chains.chains[chainId];
+    if (!chain) {
+      throw new Error(`Chain ${chainId} not found`);
+    }
+    _client = (0, import_viem.createPublicClient)({
+      chain,
+      transport: (0, import_viem.http)()
+    });
+  }
+  return _client;
+};
+const createWalletClient = (chainId = import_chains.mokshaTestnet.id, account) => {
+  const chain = import_chains.chains[chainId];
+  if (!chain) {
+    throw new Error(`Chain ${chainId} not found`);
+  }
+  return (0, import_viem.createWalletClient)({
+    chain,
+    transport: (0, import_viem.http)(),
+    account
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClient,
+  createWalletClient,
+  defaultFromBlocks,
+  getDefaultFromBlock
+});
+//# sourceMappingURL=client.cjs.map

package/dist/core/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/client.ts"],"sourcesContent":["import {\n  Chain,\n  createPublicClient,\n  http,\n  Account,\n  createWalletClient as viemCreateWalletClient,\n  PublicClient,\n  WalletClient,\n} from \"viem\";\nimport { chains, mokshaTestnet } from \"../config/chains\";\n\n/**\n * Default starting block numbers for querying blockchain events and data per chain.\n *\n * @remarks\n * These block numbers represent the earliest deployment of Vana protocol contracts\n * on each network. Using these as starting points for event queries significantly\n * improves performance by avoiding unnecessary queries of blocks before the\n * protocol existed.\n *\n * - Moksha Testnet (14800): Block 732312 - DataRegistry deployment\n * - Vana Mainnet (1480): Block 758584 - DataRegistry deployment\n *\n * @category Blockchain\n */\nexport const defaultFromBlocks: Record<number, bigint> = {\n  14800: BigInt(732312), // Moksha Testnet - earliest contract deployment\n  1480: BigInt(758584), // Vana Mainnet - earliest contract deployment\n};\n\n/**\n * Gets the default starting block for a specific chain.\n *\n * @param chainId - The chain ID to get the default from block for\n * @returns The default starting block for the chain, or 0n if not configured\n * @category Blockchain\n */\nexport function getDefaultFromBlock(chainId: number): bigint {\n  return defaultFromBlocks[chainId] || BigInt(0);\n}\n\n// Cache for clients\nlet _client: PublicClient & { chain: Chain };\n\n/**\n * Creates or retrieves a cached public client for blockchain read operations.\n *\n * @remarks\n * This function provides an optimized way to access blockchain data by maintaining\n * a cached client instance per chain. The client is used for reading contract state,\n * querying events, and other read-only blockchain operations. It automatically\n * handles HTTP transport configuration and chain switching.\n *\n * @param chainId - The chain ID to connect to (defaults to Moksha testnet)\n * @returns A public client configured for the specified chain with caching optimization\n * @throws {Error} When the specified chain ID is not supported by the SDK\n * @example\n * ```typescript\n * // Get client for default chain (Moksha testnet)\n * const client = createClient();\n *\n * // Get client for specific chain\n * const mainnetClient = createClient(14800);\n *\n * // Use client for blockchain reads\n * const blockNumber = await client.getBlockNumber();\n * ```\n * @category Blockchain\n */\nexport const createClient = (\n  chainId: keyof typeof chains = mokshaTestnet.id,\n): PublicClient & { chain: Chain } => {\n  if (!_client || _client.chain?.id !== chainId) {\n    const chain = chains[chainId];\n    if (!chain) {\n      throw new Error(`Chain ${chainId} not found`);\n    }\n\n    _client = createPublicClient({\n      chain,\n      transport: http(),\n    });\n  }\n\n  return _client;\n};\n\n/**\n * Creates a wallet client for blockchain transaction signing and submission.\n *\n * @remarks\n * This function creates a wallet client configured for transaction signing and\n * submission on the specified chain. Unlike the public client, wallet clients\n * are not cached and require an account for transaction signing. The client\n * handles HTTP transport configuration and provides access to wallet-specific\n * operations like signing transactions and messages.\n *\n * @param chainId - The chain ID to connect to (defaults to Moksha testnet)\n * @param account - Optional account for transaction signing (can be set later)\n * @returns A wallet client configured for the specified chain\n * @throws {Error} When the specified chain ID is not supported by the SDK\n * @example\n * ```typescript\n * import { privateKeyToAccount } from 'viem/accounts';\n *\n * // Create wallet client for default chain\n * const account = privateKeyToAccount('0x...');\n * const walletClient = createWalletClient(mokshaTestnet.id, account);\n *\n * // Use for transaction signing\n * const txHash = await walletClient.writeContract({\n *   address: contractAddress,\n *   abi: contractAbi,\n *   functionName: 'someFunction',\n *   args: []\n * });\n *\n * // Create without account (account can be set later)\n * const client = createWalletClient();\n * ```\n * @category Blockchain\n */\nexport const createWalletClient = (\n  chainId: keyof typeof chains = mokshaTestnet.id,\n  account?: Account,\n): WalletClient => {\n  const chain = chains[chainId];\n  if (!chain) {\n    throw new Error(`Chain ${chainId} not found`);\n  }\n\n  return viemCreateWalletClient({\n    chain,\n    transport: http(),\n    account,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAQO;AACP,oBAAsC;AAgB/B,MAAM,oBAA4C;AAAA,EACvD,OAAO,OAAO,MAAM;AAAA;AAAA,EACpB,MAAM,OAAO,MAAM;AAAA;AACrB;AASO,SAAS,oBAAoB,SAAyB;AAC3D,SAAO,kBAAkB,OAAO,KAAK,OAAO,CAAC;AAC/C;AAGA,IAAI;AA2BG,MAAM,eAAe,CAC1B,UAA+B,4BAAc,OACT;AACpC,MAAI,CAAC,WAAW,QAAQ,OAAO,OAAO,SAAS;AAC7C,UAAM,QAAQ,qBAAO,OAAO;AAC5B,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,SAAS,OAAO,YAAY;AAAA,IAC9C;AAEA,kBAAU,gCAAmB;AAAA,MAC3B;AAAA,MACA,eAAW,kBAAK;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAqCO,MAAM,qBAAqB,CAChC,UAA+B,4BAAc,IAC7C,YACiB;AACjB,QAAM,QAAQ,qBAAO,OAAO;AAC5B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,SAAS,OAAO,YAAY;AAAA,EAC9C;AAEA,aAAO,YAAAA,oBAAuB;AAAA,IAC5B;AAAA,IACA,eAAW,kBAAK;AAAA,IAChB;AAAA,EACF,CAAC;AACH;","names":["viemCreateWalletClient"]}

package/dist/core/client.d.cts

@@ -0,0 +1,92 @@
+import { PublicClient, Chain, Account, WalletClient } from 'viem';
+import { chains } from '../config/chains.cjs';
+
+/**
+ * Default starting block numbers for querying blockchain events and data per chain.
+ *
+ * @remarks
+ * These block numbers represent the earliest deployment of Vana protocol contracts
+ * on each network. Using these as starting points for event queries significantly
+ * improves performance by avoiding unnecessary queries of blocks before the
+ * protocol existed.
+ *
+ * - Moksha Testnet (14800): Block 732312 - DataRegistry deployment
+ * - Vana Mainnet (1480): Block 758584 - DataRegistry deployment
+ *
+ * @category Blockchain
+ */
+declare const defaultFromBlocks: Record<number, bigint>;
+/**
+ * Gets the default starting block for a specific chain.
+ *
+ * @param chainId - The chain ID to get the default from block for
+ * @returns The default starting block for the chain, or 0n if not configured
+ * @category Blockchain
+ */
+declare function getDefaultFromBlock(chainId: number): bigint;
+/**
+ * Creates or retrieves a cached public client for blockchain read operations.
+ *
+ * @remarks
+ * This function provides an optimized way to access blockchain data by maintaining
+ * a cached client instance per chain. The client is used for reading contract state,
+ * querying events, and other read-only blockchain operations. It automatically
+ * handles HTTP transport configuration and chain switching.
+ *
+ * @param chainId - The chain ID to connect to (defaults to Moksha testnet)
+ * @returns A public client configured for the specified chain with caching optimization
+ * @throws {Error} When the specified chain ID is not supported by the SDK
+ * @example
+ * ```typescript
+ * // Get client for default chain (Moksha testnet)
+ * const client = createClient();
+ *
+ * // Get client for specific chain
+ * const mainnetClient = createClient(14800);
+ *
+ * // Use client for blockchain reads
+ * const blockNumber = await client.getBlockNumber();
+ * ```
+ * @category Blockchain
+ */
+declare const createClient: (chainId?: keyof typeof chains) => PublicClient & {
+    chain: Chain;
+};
+/**
+ * Creates a wallet client for blockchain transaction signing and submission.
+ *
+ * @remarks
+ * This function creates a wallet client configured for transaction signing and
+ * submission on the specified chain. Unlike the public client, wallet clients
+ * are not cached and require an account for transaction signing. The client
+ * handles HTTP transport configuration and provides access to wallet-specific
+ * operations like signing transactions and messages.
+ *
+ * @param chainId - The chain ID to connect to (defaults to Moksha testnet)
+ * @param account - Optional account for transaction signing (can be set later)
+ * @returns A wallet client configured for the specified chain
+ * @throws {Error} When the specified chain ID is not supported by the SDK
+ * @example
+ * ```typescript
+ * import { privateKeyToAccount } from 'viem/accounts';
+ *
+ * // Create wallet client for default chain
+ * const account = privateKeyToAccount('0x...');
+ * const walletClient = createWalletClient(mokshaTestnet.id, account);
+ *
+ * // Use for transaction signing
+ * const txHash = await walletClient.writeContract({
+ *   address: contractAddress,
+ *   abi: contractAbi,
+ *   functionName: 'someFunction',
+ *   args: []
+ * });
+ *
+ * // Create without account (account can be set later)
+ * const client = createWalletClient();
+ * ```
+ * @category Blockchain
+ */
+declare const createWalletClient: (chainId?: keyof typeof chains, account?: Account) => WalletClient;
+
+export { createClient, createWalletClient, defaultFromBlocks, getDefaultFromBlock };

package/dist/core/client.d.ts

@@ -0,0 +1,92 @@
+import { PublicClient, Chain, Account, WalletClient } from 'viem';
+import { chains } from '../config/chains.js';
+
+/**
+ * Default starting block numbers for querying blockchain events and data per chain.
+ *
+ * @remarks
+ * These block numbers represent the earliest deployment of Vana protocol contracts
+ * on each network. Using these as starting points for event queries significantly
+ * improves performance by avoiding unnecessary queries of blocks before the
+ * protocol existed.
+ *
+ * - Moksha Testnet (14800): Block 732312 - DataRegistry deployment
+ * - Vana Mainnet (1480): Block 758584 - DataRegistry deployment
+ *
+ * @category Blockchain
+ */
+declare const defaultFromBlocks: Record<number, bigint>;
+/**
+ * Gets the default starting block for a specific chain.
+ *
+ * @param chainId - The chain ID to get the default from block for
+ * @returns The default starting block for the chain, or 0n if not configured
+ * @category Blockchain
+ */
+declare function getDefaultFromBlock(chainId: number): bigint;
+/**
+ * Creates or retrieves a cached public client for blockchain read operations.
+ *
+ * @remarks
+ * This function provides an optimized way to access blockchain data by maintaining
+ * a cached client instance per chain. The client is used for reading contract state,
+ * querying events, and other read-only blockchain operations. It automatically
+ * handles HTTP transport configuration and chain switching.
+ *
+ * @param chainId - The chain ID to connect to (defaults to Moksha testnet)
+ * @returns A public client configured for the specified chain with caching optimization
+ * @throws {Error} When the specified chain ID is not supported by the SDK
+ * @example
+ * ```typescript
+ * // Get client for default chain (Moksha testnet)
+ * const client = createClient();
+ *
+ * // Get client for specific chain
+ * const mainnetClient = createClient(14800);
+ *
+ * // Use client for blockchain reads
+ * const blockNumber = await client.getBlockNumber();
+ * ```
+ * @category Blockchain
+ */
+declare const createClient: (chainId?: keyof typeof chains) => PublicClient & {
+    chain: Chain;
+};
+/**
+ * Creates a wallet client for blockchain transaction signing and submission.
+ *
+ * @remarks
+ * This function creates a wallet client configured for transaction signing and
+ * submission on the specified chain. Unlike the public client, wallet clients
+ * are not cached and require an account for transaction signing. The client
+ * handles HTTP transport configuration and provides access to wallet-specific
+ * operations like signing transactions and messages.
+ *
+ * @param chainId - The chain ID to connect to (defaults to Moksha testnet)
+ * @param account - Optional account for transaction signing (can be set later)
+ * @returns A wallet client configured for the specified chain
+ * @throws {Error} When the specified chain ID is not supported by the SDK
+ * @example
+ * ```typescript
+ * import { privateKeyToAccount } from 'viem/accounts';
+ *
+ * // Create wallet client for default chain
+ * const account = privateKeyToAccount('0x...');
+ * const walletClient = createWalletClient(mokshaTestnet.id, account);
+ *
+ * // Use for transaction signing
+ * const txHash = await walletClient.writeContract({
+ *   address: contractAddress,
+ *   abi: contractAbi,
+ *   functionName: 'someFunction',
+ *   args: []
+ * });
+ *
+ * // Create without account (account can be set later)
+ * const client = createWalletClient();
+ * ```
+ * @category Blockchain
+ */
+declare const createWalletClient: (chainId?: keyof typeof chains, account?: Account) => WalletClient;
+
+export { createClient, createWalletClient, defaultFromBlocks, getDefaultFromBlock };

package/dist/core/client.js

@@ -0,0 +1,47 @@
+import {
+  createPublicClient,
+  http,
+  createWalletClient as viemCreateWalletClient
+} from "viem";
+import { chains, mokshaTestnet } from "../config/chains";
+const defaultFromBlocks = {
+  14800: BigInt(732312),
+  // Moksha Testnet - earliest contract deployment
+  1480: BigInt(758584)
+  // Vana Mainnet - earliest contract deployment
+};
+function getDefaultFromBlock(chainId) {
+  return defaultFromBlocks[chainId] || BigInt(0);
+}
+let _client;
+const createClient = (chainId = mokshaTestnet.id) => {
+  if (!_client || _client.chain?.id !== chainId) {
+    const chain = chains[chainId];
+    if (!chain) {
+      throw new Error(`Chain ${chainId} not found`);
+    }
+    _client = createPublicClient({
+      chain,
+      transport: http()
+    });
+  }
+  return _client;
+};
+const createWalletClient = (chainId = mokshaTestnet.id, account) => {
+  const chain = chains[chainId];
+  if (!chain) {
+    throw new Error(`Chain ${chainId} not found`);
+  }
+  return viemCreateWalletClient({
+    chain,
+    transport: http(),
+    account
+  });
+};
+export {
+  createClient,
+  createWalletClient,
+  defaultFromBlocks,
+  getDefaultFromBlock
+};
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/client.ts"],"sourcesContent":["import {\n  Chain,\n  createPublicClient,\n  http,\n  Account,\n  createWalletClient as viemCreateWalletClient,\n  PublicClient,\n  WalletClient,\n} from \"viem\";\nimport { chains, mokshaTestnet } from \"../config/chains\";\n\n/**\n * Default starting block numbers for querying blockchain events and data per chain.\n *\n * @remarks\n * These block numbers represent the earliest deployment of Vana protocol contracts\n * on each network. Using these as starting points for event queries significantly\n * improves performance by avoiding unnecessary queries of blocks before the\n * protocol existed.\n *\n * - Moksha Testnet (14800): Block 732312 - DataRegistry deployment\n * - Vana Mainnet (1480): Block 758584 - DataRegistry deployment\n *\n * @category Blockchain\n */\nexport const defaultFromBlocks: Record<number, bigint> = {\n  14800: BigInt(732312), // Moksha Testnet - earliest contract deployment\n  1480: BigInt(758584), // Vana Mainnet - earliest contract deployment\n};\n\n/**\n * Gets the default starting block for a specific chain.\n *\n * @param chainId - The chain ID to get the default from block for\n * @returns The default starting block for the chain, or 0n if not configured\n * @category Blockchain\n */\nexport function getDefaultFromBlock(chainId: number): bigint {\n  return defaultFromBlocks[chainId] || BigInt(0);\n}\n\n// Cache for clients\nlet _client: PublicClient & { chain: Chain };\n\n/**\n * Creates or retrieves a cached public client for blockchain read operations.\n *\n * @remarks\n * This function provides an optimized way to access blockchain data by maintaining\n * a cached client instance per chain. The client is used for reading contract state,\n * querying events, and other read-only blockchain operations. It automatically\n * handles HTTP transport configuration and chain switching.\n *\n * @param chainId - The chain ID to connect to (defaults to Moksha testnet)\n * @returns A public client configured for the specified chain with caching optimization\n * @throws {Error} When the specified chain ID is not supported by the SDK\n * @example\n * ```typescript\n * // Get client for default chain (Moksha testnet)\n * const client = createClient();\n *\n * // Get client for specific chain\n * const mainnetClient = createClient(14800);\n *\n * // Use client for blockchain reads\n * const blockNumber = await client.getBlockNumber();\n * ```\n * @category Blockchain\n */\nexport const createClient = (\n  chainId: keyof typeof chains = mokshaTestnet.id,\n): PublicClient & { chain: Chain } => {\n  if (!_client || _client.chain?.id !== chainId) {\n    const chain = chains[chainId];\n    if (!chain) {\n      throw new Error(`Chain ${chainId} not found`);\n    }\n\n    _client = createPublicClient({\n      chain,\n      transport: http(),\n    });\n  }\n\n  return _client;\n};\n\n/**\n * Creates a wallet client for blockchain transaction signing and submission.\n *\n * @remarks\n * This function creates a wallet client configured for transaction signing and\n * submission on the specified chain. Unlike the public client, wallet clients\n * are not cached and require an account for transaction signing. The client\n * handles HTTP transport configuration and provides access to wallet-specific\n * operations like signing transactions and messages.\n *\n * @param chainId - The chain ID to connect to (defaults to Moksha testnet)\n * @param account - Optional account for transaction signing (can be set later)\n * @returns A wallet client configured for the specified chain\n * @throws {Error} When the specified chain ID is not supported by the SDK\n * @example\n * ```typescript\n * import { privateKeyToAccount } from 'viem/accounts';\n *\n * // Create wallet client for default chain\n * const account = privateKeyToAccount('0x...');\n * const walletClient = createWalletClient(mokshaTestnet.id, account);\n *\n * // Use for transaction signing\n * const txHash = await walletClient.writeContract({\n *   address: contractAddress,\n *   abi: contractAbi,\n *   functionName: 'someFunction',\n *   args: []\n * });\n *\n * // Create without account (account can be set later)\n * const client = createWalletClient();\n * ```\n * @category Blockchain\n */\nexport const createWalletClient = (\n  chainId: keyof typeof chains = mokshaTestnet.id,\n  account?: Account,\n): WalletClient => {\n  const chain = chains[chainId];\n  if (!chain) {\n    throw new Error(`Chain ${chainId} not found`);\n  }\n\n  return viemCreateWalletClient({\n    chain,\n    transport: http(),\n    account,\n  });\n};\n"],"mappings":"AAAA;AAAA,EAEE;AAAA,EACA;AAAA,EAEA,sBAAsB;AAAA,OAGjB;AACP,SAAS,QAAQ,qBAAqB;AAgB/B,MAAM,oBAA4C;AAAA,EACvD,OAAO,OAAO,MAAM;AAAA;AAAA,EACpB,MAAM,OAAO,MAAM;AAAA;AACrB;AASO,SAAS,oBAAoB,SAAyB;AAC3D,SAAO,kBAAkB,OAAO,KAAK,OAAO,CAAC;AAC/C;AAGA,IAAI;AA2BG,MAAM,eAAe,CAC1B,UAA+B,cAAc,OACT;AACpC,MAAI,CAAC,WAAW,QAAQ,OAAO,OAAO,SAAS;AAC7C,UAAM,QAAQ,OAAO,OAAO;AAC5B,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,SAAS,OAAO,YAAY;AAAA,IAC9C;AAEA,cAAU,mBAAmB;AAAA,MAC3B;AAAA,MACA,WAAW,KAAK;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAqCO,MAAM,qBAAqB,CAChC,UAA+B,cAAc,IAC7C,YACiB;AACjB,QAAM,QAAQ,OAAO,OAAO;AAC5B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,SAAS,OAAO,YAAY;AAAA,EAC9C;AAEA,SAAO,uBAAuB;AAAA,IAC5B;AAAA,IACA,WAAW,KAAK;AAAA,IAChB;AAAA,EACF,CAAC;AACH;","names":[]}