@opendatalabs/vana-sdk 2.3.0 → 3.0.0

package/dist/utils/schemaValidation.js

@@ -1,219 +0,0 @@
-import Ajv from "ajv";
-import addFormats from "ajv-formats";
-import dataSchemaSchema from "../schemas/dataSchema.schema.json";
-class SchemaValidationError extends Error {
-  constructor(message, errors) {
-    super(message);
-    this.errors = errors;
-    this.name = "SchemaValidationError";
-  }
-}
-class SchemaValidator {
-  ajv;
-  dataSchemaValidator;
-  constructor() {
-    this.ajv = new Ajv({
-      allErrors: true,
-      verbose: true,
-      strict: false
-    });
-    addFormats(this.ajv);
-    this.dataSchemaValidator = this.ajv.compile(dataSchemaSchema);
-  }
-  /**
-   * Validates a data schema definition against the Vana meta-schema
-   *
-   * @param schema - The data schema definition to validate
-   * @throws SchemaValidationError if invalid
-   * @example
-   * ```typescript
-   * const validator = new SchemaValidator();
-   *
-   * const schema = {
-   *   name: "User Profile",
-   *   version: "1.0.0",
-   *   dialect: "json",
-   *   schema: {
-   *     type: "object",
-   *     properties: {
-   *       name: { type: "string" },
-   *       age: { type: "number" }
-   *     }
-   *   }
-   * };
-   *
-   * validator.validateDataSchemaAgainstMetaSchema(schema); // throws if invalid
-   * ```
-   */
-  validateDataSchemaAgainstMetaSchema(schema) {
-    const isValid = this.dataSchemaValidator(schema);
-    if (!isValid) {
-      const errors = this.dataSchemaValidator.errors ?? [];
-      const errorMessage = `Data schema validation failed: ${errors.map((e) => `${e.instancePath} ${e.message}`).join(", ")}`;
-      throw new SchemaValidationError(errorMessage, errors);
-    }
-    const typedSchema = schema;
-    if (typedSchema.dialect === "json" && typeof typedSchema.schema === "object") {
-      try {
-        this.ajv.compile(typedSchema.schema);
-      } catch (error) {
-        const errorMessage = `Invalid JSON Schema in data schema: ${error instanceof Error ? error.message : "Unknown schema compilation error"}`;
-        throw new SchemaValidationError(errorMessage, []);
-      }
-    } else if (typedSchema.dialect === "sqlite" && typeof typedSchema.schema === "string") {
-      this.validateSQLiteDDL(typedSchema.schema, typedSchema.dialectVersion);
-    }
-  }
-  /**
-   * Validates data against a JSON Schema
-   *
-   * @param data - The data to validate
-   * @param schema - The schema containing the validation rules (must have been validated or fetched from chain)
-   * @throws SchemaValidationError if invalid
-   * @example
-   * ```typescript
-   * const validator = new SchemaValidator();
-   *
-   * // Works with Schema from schemas.get()
-   * const schema = await vana.schemas.get(1);
-   * validator.validateDataAgainstSchema(userData, schema);
-   *
-   * // Also works with pre-validated DataSchema object
-   * const dataSchema = validator.validateDataSchemaAgainstMetaSchema({
-   *   name: "User Profile",
-   *   version: "1.0.0",
-   *   dialect: "json",
-   *   schema: { type: "object", properties: { name: { type: "string" } } }
-   * });
-   * validator.validateDataAgainstSchema(userData, dataSchema);
-   * ```
-   */
-  validateDataAgainstSchema(data, schema) {
-    if (schema.dialect !== "json") {
-      console.warn(
-        `[SchemaValidator] Data validation skipped: dialect '${schema.dialect}' does not support data validation. Only JSON schemas can validate data structure.`
-      );
-      return;
-    }
-    if (typeof schema.schema !== "object") {
-      throw new SchemaValidationError(
-        "JSON dialect schemas must have an object schema",
-        []
-      );
-    }
-    const dataValidator = this.ajv.compile(schema.schema);
-    const isValid = dataValidator(data);
-    if (!isValid) {
-      const errors = dataValidator.errors ?? [];
-      const errorMessage = `Data validation failed: ${errors.map((e) => `${e.instancePath} ${e.message}`).join(", ")}`;
-      throw new SchemaValidationError(errorMessage, errors);
-    }
-  }
-  /**
-   * Validates a SQLite DDL string for basic syntax
-   * Note: This is a basic validation, full SQL parsing would require a proper SQL parser
-   *
-   * @param ddl - The DDL string to validate
-   * @param dialectVersion - Optional SQLite version (e.g., "3" for SQLite v3)
-   * @throws SchemaValidationError if invalid
-   */
-  validateSQLiteDDL(ddl, dialectVersion) {
-    if (typeof ddl !== "string" || ddl.trim().length === 0) {
-      throw new SchemaValidationError(
-        "SQLite DDL must be a non-empty string",
-        []
-      );
-    }
-    if (dialectVersion !== void 0) {
-      const supportedVersions = ["3"];
-      if (!supportedVersions.includes(dialectVersion)) {
-        throw new SchemaValidationError(
-          `Unsupported SQLite dialect version: ${dialectVersion}. Supported versions: ${supportedVersions.join(", ")}`,
-          []
-        );
-      }
-    }
-    const normalizedDDL = ddl.trim().toUpperCase();
-    if (!normalizedDDL.includes("CREATE TABLE")) {
-      throw new SchemaValidationError(
-        "SQLite DDL must contain at least one CREATE TABLE statement",
-        []
-      );
-    }
-    let parenCount = 0;
-    for (const char of ddl) {
-      if (char === "(") parenCount++;
-      if (char === ")") parenCount--;
-      if (parenCount < 0) {
-        throw new SchemaValidationError(
-          "SQLite DDL has unbalanced parentheses",
-          []
-        );
-      }
-    }
-    if (parenCount !== 0) {
-      throw new SchemaValidationError(
-        "SQLite DDL has unbalanced parentheses",
-        []
-      );
-    }
-  }
-  /**
-   * Fetches and validates a data schema from a URL
-   *
-   * @param url - The URL to fetch the data schema from
-   * @param downloadRelayer - Optional download relayer for CORS bypass
-   * @param downloadRelayer.proxyDownload - Function to proxy downloads through application server
-   * @returns The validated data schema
-   * @throws SchemaValidationError if invalid or fetch fails
-   * @example
-   * ```typescript
-   * const validator = new SchemaValidator();
-   * const schema = await validator.fetchAndValidateSchema("https://example.com/schema.json");
-   * ```
-   */
-  async fetchAndValidateSchema(url, downloadRelayer) {
-    try {
-      const { universalFetch } = await import("./download");
-      const response = await universalFetch(url, downloadRelayer);
-      if (!response.ok) {
-        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-      }
-      const schema = await response.json();
-      this.validateDataSchemaAgainstMetaSchema(schema);
-      if (schema.dialect === "sqlite" && typeof schema.schema === "string") {
-        this.validateSQLiteDDL(schema.schema, schema.dialectVersion);
-      }
-      return schema;
-    } catch (error) {
-      if (error instanceof SchemaValidationError) {
-        throw error;
-      }
-      throw new SchemaValidationError(
-        `Failed to fetch and validate schema from ${url}: ${error instanceof Error ? error.message : "Unknown error"}`,
-        []
-      );
-    }
-  }
-}
-const schemaValidator = new SchemaValidator();
-function validateDataSchemaAgainstMetaSchema(schema) {
-  const validator = schemaValidator;
-  validator.validateDataSchemaAgainstMetaSchema(schema);
-  return schema;
-}
-function validateDataAgainstSchema(data, schema) {
-  schemaValidator.validateDataAgainstSchema(data, schema);
-}
-function fetchAndValidateSchema(url, downloadRelayer) {
-  return schemaValidator.fetchAndValidateSchema(url, downloadRelayer);
-}
-export {
-  SchemaValidationError,
-  SchemaValidator,
-  fetchAndValidateSchema,
-  schemaValidator,
-  validateDataAgainstSchema,
-  validateDataSchemaAgainstMetaSchema
-};
-//# sourceMappingURL=schemaValidation.js.map

package/dist/utils/schemaValidation.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/schemaValidation.ts"],"sourcesContent":["import Ajv, { type ValidateFunction } from \"ajv\";\nimport addFormats from \"ajv-formats\";\nimport dataSchemaSchema from \"../schemas/dataSchema.schema.json\";\nimport type { Schema } from \"../types/data\";\n\n/**\n * Data schema interface following the Vana schema specification\n *\n * @category Configuration\n */\nexport interface DataSchema {\n  /** The name of the data schema */\n  name: string;\n  /** The version of the data schema */\n  version: string;\n  /** Optional description of the data schema */\n  description?: string;\n  /** The dialect type - either SQLite or JSON */\n  dialect: \"sqlite\" | \"json\";\n  /** Optional version of the dialect */\n  dialectVersion?: string;\n  /** The actual schema definition as string or object */\n  schema: string | object;\n}\n\n/**\n * Error thrown when schema validation fails\n */\nexport class SchemaValidationError extends Error {\n  constructor(\n    message: string,\n    public errors: Array<{\n      instancePath: string;\n      schemaPath: string;\n      keyword: string;\n      params: Record<string, unknown>;\n      message?: string;\n    }>,\n  ) {\n    super(message);\n    this.name = \"SchemaValidationError\";\n  }\n}\n\n/**\n * Data schema validation utility class\n */\nexport class SchemaValidator {\n  private ajv: Ajv;\n  private dataSchemaValidator: ValidateFunction;\n\n  constructor() {\n    this.ajv = new Ajv({\n      allErrors: true,\n      verbose: true,\n      strict: false,\n    });\n\n    // Add format validation (e.g., date, email, uri)\n    addFormats(this.ajv);\n\n    // Compile the data schema meta-schema validator\n    this.dataSchemaValidator = this.ajv.compile(dataSchemaSchema);\n  }\n\n  /**\n   * Validates a data schema definition against the Vana meta-schema\n   *\n   * @param schema - The data schema definition to validate\n   * @throws SchemaValidationError if invalid\n   * @example\n   * ```typescript\n   * const validator = new SchemaValidator();\n   *\n   * const schema = {\n   *   name: \"User Profile\",\n   *   version: \"1.0.0\",\n   *   dialect: \"json\",\n   *   schema: {\n   *     type: \"object\",\n   *     properties: {\n   *       name: { type: \"string\" },\n   *       age: { type: \"number\" }\n   *     }\n   *   }\n   * };\n   *\n   * validator.validateDataSchemaAgainstMetaSchema(schema); // throws if invalid\n   * ```\n   */\n  validateDataSchemaAgainstMetaSchema(\n    schema: unknown,\n  ): asserts schema is DataSchema {\n    const isValid = this.dataSchemaValidator(schema);\n\n    if (!isValid) {\n      const errors = this.dataSchemaValidator.errors ?? [];\n      const errorMessage = `Data schema validation failed: ${errors.map((e) => `${e.instancePath} ${e.message}`).join(\", \")}`;\n      throw new SchemaValidationError(errorMessage, errors);\n    }\n\n    // Additional validation based on dialect\n    const typedSchema = schema as DataSchema;\n    if (\n      typedSchema.dialect === \"json\" &&\n      typeof typedSchema.schema === \"object\"\n    ) {\n      // Validate that the embedded JSON Schema is actually valid\n      try {\n        this.ajv.compile(typedSchema.schema);\n      } catch (error) {\n        const errorMessage = `Invalid JSON Schema in data schema: ${error instanceof Error ? error.message : \"Unknown schema compilation error\"}`;\n        throw new SchemaValidationError(errorMessage, []);\n      }\n    } else if (\n      typedSchema.dialect === \"sqlite\" &&\n      typeof typedSchema.schema === \"string\"\n    ) {\n      // Validate SQLite DDL syntax\n      this.validateSQLiteDDL(typedSchema.schema, typedSchema.dialectVersion);\n    }\n  }\n\n  /**\n   * Validates data against a JSON Schema\n   *\n   * @param data - The data to validate\n   * @param schema - The schema containing the validation rules (must have been validated or fetched from chain)\n   * @throws SchemaValidationError if invalid\n   * @example\n   * ```typescript\n   * const validator = new SchemaValidator();\n   *\n   * // Works with Schema from schemas.get()\n   * const schema = await vana.schemas.get(1);\n   * validator.validateDataAgainstSchema(userData, schema);\n   *\n   * // Also works with pre-validated DataSchema object\n   * const dataSchema = validator.validateDataSchemaAgainstMetaSchema({\n   *   name: \"User Profile\",\n   *   version: \"1.0.0\",\n   *   dialect: \"json\",\n   *   schema: { type: \"object\", properties: { name: { type: \"string\" } } }\n   * });\n   * validator.validateDataAgainstSchema(userData, dataSchema);\n   * ```\n   */\n  validateDataAgainstSchema(data: unknown, schema: DataSchema | Schema): void {\n    if (schema.dialect !== \"json\") {\n      console.warn(\n        `[SchemaValidator] Data validation skipped: dialect '${schema.dialect}' does not support data validation. ` +\n          `Only JSON schemas can validate data structure.`,\n      );\n      return;\n    }\n\n    if (typeof schema.schema !== \"object\") {\n      throw new SchemaValidationError(\n        \"JSON dialect schemas must have an object schema\",\n        [],\n      );\n    }\n\n    // Compile and validate against the data schema\n    const dataValidator = this.ajv.compile(schema.schema);\n    const isValid = dataValidator(data);\n\n    if (!isValid) {\n      const errors = dataValidator.errors ?? [];\n      const errorMessage = `Data validation failed: ${errors.map((e) => `${e.instancePath} ${e.message}`).join(\", \")}`;\n      throw new SchemaValidationError(errorMessage, errors);\n    }\n  }\n\n  /**\n   * Validates a SQLite DDL string for basic syntax\n   * Note: This is a basic validation, full SQL parsing would require a proper SQL parser\n   *\n   * @param ddl - The DDL string to validate\n   * @param dialectVersion - Optional SQLite version (e.g., \"3\" for SQLite v3)\n   * @throws SchemaValidationError if invalid\n   */\n  validateSQLiteDDL(ddl: string, dialectVersion?: string): void {\n    if (typeof ddl !== \"string\" || ddl.trim().length === 0) {\n      throw new SchemaValidationError(\n        \"SQLite DDL must be a non-empty string\",\n        [],\n      );\n    }\n\n    // Validate dialectVersion if provided\n    if (dialectVersion !== undefined) {\n      const supportedVersions = [\"3\"];\n      if (!supportedVersions.includes(dialectVersion)) {\n        throw new SchemaValidationError(\n          `Unsupported SQLite dialect version: ${dialectVersion}. Supported versions: ${supportedVersions.join(\", \")}`,\n          [],\n        );\n      }\n    }\n\n    // Basic validation - check for CREATE TABLE statements\n    const normalizedDDL = ddl.trim().toUpperCase();\n    if (!normalizedDDL.includes(\"CREATE TABLE\")) {\n      throw new SchemaValidationError(\n        \"SQLite DDL must contain at least one CREATE TABLE statement\",\n        [],\n      );\n    }\n\n    // Check for balanced parentheses\n    let parenCount = 0;\n    for (const char of ddl) {\n      if (char === \"(\") parenCount++;\n      if (char === \")\") parenCount--;\n      if (parenCount < 0) {\n        throw new SchemaValidationError(\n          \"SQLite DDL has unbalanced parentheses\",\n          [],\n        );\n      }\n    }\n\n    if (parenCount !== 0) {\n      throw new SchemaValidationError(\n        \"SQLite DDL has unbalanced parentheses\",\n        [],\n      );\n    }\n  }\n\n  /**\n   * Fetches and validates a data schema from a URL\n   *\n   * @param url - The URL to fetch the data schema from\n   * @param downloadRelayer - Optional download relayer for CORS bypass\n   * @param downloadRelayer.proxyDownload - Function to proxy downloads through application server\n   * @returns The validated data schema\n   * @throws SchemaValidationError if invalid or fetch fails\n   * @example\n   * ```typescript\n   * const validator = new SchemaValidator();\n   * const schema = await validator.fetchAndValidateSchema(\"https://example.com/schema.json\");\n   * ```\n   */\n  async fetchAndValidateSchema(\n    url: string,\n    downloadRelayer?: { proxyDownload: (url: string) => Promise<Blob> },\n  ): Promise<DataSchema> {\n    try {\n      const { universalFetch } = await import(\"./download\");\n      const response = await universalFetch(url, downloadRelayer);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const schema = await response.json();\n      this.validateDataSchemaAgainstMetaSchema(schema);\n\n      // Additional validation based on dialect\n      if (schema.dialect === \"sqlite\" && typeof schema.schema === \"string\") {\n        this.validateSQLiteDDL(schema.schema, schema.dialectVersion);\n      }\n\n      return schema;\n    } catch (error) {\n      if (error instanceof SchemaValidationError) {\n        throw error;\n      }\n\n      throw new SchemaValidationError(\n        `Failed to fetch and validate schema from ${url}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        [],\n      );\n    }\n  }\n}\n\n/**\n * Global schema validator instance\n */\nexport const schemaValidator = new SchemaValidator();\n\n/**\n * Convenience function to validate a data schema definition against the Vana meta-schema\n *\n * @param schema - The data schema definition to validate\n * @returns The validated DataSchema\n * @throws SchemaValidationError if invalid\n * @example\n * ```typescript\n * const schemaDefinition = {\n *   name: \"User Profile\",\n *   version: \"1.0.0\",\n *   dialect: \"json\",\n *   schema: { type: \"object\", properties: { name: { type: \"string\" } } }\n * };\n *\n * const validatedSchema = validateDataSchemaAgainstMetaSchema(schemaDefinition);\n * ```\n */\nexport function validateDataSchemaAgainstMetaSchema(\n  schema: unknown,\n): DataSchema {\n  const validator: SchemaValidator = schemaValidator;\n  validator.validateDataSchemaAgainstMetaSchema(schema);\n  // If we get here, schema is valid and typed as DataSchema\n  return schema;\n}\n\n/**\n * Convenience function to validate data against a schema\n *\n * @param data - The data to validate\n * @param schema - The data schema containing the schema\n * @returns void - Function doesn't return a value\n * @throws SchemaValidationError if invalid\n */\nexport function validateDataAgainstSchema(\n  data: unknown,\n  schema: DataSchema | Schema,\n): void {\n  schemaValidator.validateDataAgainstSchema(data, schema);\n}\n\n/**\n * Convenience function to fetch and validate a data schema from a URL\n *\n * @param url - The URL to fetch the data schema from\n * @param downloadRelayer - Optional download relayer for CORS bypass\n * @param downloadRelayer.proxyDownload - Function to proxy downloads through application server\n * @returns The validated data schema\n * @throws SchemaValidationError if invalid or fetch fails\n */\nexport function fetchAndValidateSchema(\n  url: string,\n  downloadRelayer?: { proxyDownload: (url: string) => Promise<Blob> },\n): Promise<DataSchema> {\n  return schemaValidator.fetchAndValidateSchema(url, downloadRelayer);\n}\n"],"mappings":"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","names":[]}

package/dist/utils/signatureCache.cjs

@@ -1,192 +0,0 @@
-"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 signatureCache_exports = {};
-__export(signatureCache_exports, {
-  SignatureCache: () => SignatureCache,
-  withSignatureCache: () => withSignatureCache
-});
-module.exports = __toCommonJS(signatureCache_exports);
-var import_viem = require("viem");
-var import_sha256 = require("@noble/hashes/sha256");
-class SignatureCache {
-  static PREFIX = "vana_sig_";
-  static DEFAULT_TTL_HOURS = 2;
-  /**
-   * Get a cached signature if it exists and hasn't expired
-   *
-   * @param cache - Platform cache adapter instance
-   * @param walletAddress - Wallet address that created the signature
-   * @param messageHash - Hash of the message that was signed
-   * @returns The cached signature if valid, null if expired or not found
-   * @example
-   * ```typescript
-   * const messageHash = SignatureCache.hashMessage(typedData);
-   * const cached = SignatureCache.get(cache, '0x123...', messageHash);
-   * if (cached) {
-   *   console.log('Using cached signature:', cached);
-   * }
-   * ```
-   */
-  static get(cache, walletAddress, messageHash) {
-    const key = this.getCacheKey(walletAddress, messageHash);
-    try {
-      const stored = cache.get(key);
-      if (!stored) return null;
-      const cached = JSON.parse(stored);
-      if (Date.now() > cached.expires) {
-        cache.delete(key);
-        return null;
-      }
-      return cached.signature;
-    } catch {
-      try {
-        cache.delete(key);
-      } catch {
-      }
-      return null;
-    }
-  }
-  /**
-   * Store a signature in the cache with configurable TTL
-   *
-   * @param cache - Platform cache adapter instance
-   * @param walletAddress - Wallet address that created the signature
-   * @param messageHash - Hash of the message that was signed
-   * @param signature - The signature to cache
-   * @param ttlHours - Time to live in hours (default: 2)
-   * @example
-   * ```typescript
-   * const signature = await wallet.signTypedData(typedData);
-   * const messageHash = SignatureCache.hashMessage(typedData);
-   *
-   * // Cache for default 2 hours
-   * SignatureCache.set(cache, walletAddress, messageHash, signature);
-   *
-   * // Cache for 24 hours
-   * SignatureCache.set(cache, walletAddress, messageHash, signature, 24);
-   * ```
-   */
-  static set(cache, walletAddress, messageHash, signature, ttlHours = this.DEFAULT_TTL_HOURS) {
-    const key = this.getCacheKey(walletAddress, messageHash);
-    const cached = {
-      signature,
-      expires: Date.now() + ttlHours * 36e5
-      // Convert hours to milliseconds
-    };
-    try {
-      cache.set(key, JSON.stringify(cached));
-    } catch {
-    }
-  }
-  /**
-   * Clear all cached signatures (useful for testing or explicit cleanup)
-   *
-   * @param cache - Platform cache adapter instance
-   * @example
-   * ```typescript
-   * // Clear all signatures when user logs out
-   * SignatureCache.clear(cache);
-   *
-   * // Clear before running tests
-   * beforeEach(() => {
-   *   SignatureCache.clear(cache);
-   * });
-   * ```
-   */
-  static clear(cache) {
-    try {
-      cache.clear();
-    } catch {
-    }
-  }
-  static getCacheKey(walletAddress, messageHash) {
-    return `${this.PREFIX}${(0, import_viem.getAddress)(walletAddress)}:${messageHash}`;
-  }
-  /**
-   * Generate a deterministic hash of a message object for cache key generation
-   *
-   * @remarks
-   * Creates a cryptographically secure hash from complex objects including EIP-712 typed data.
-   * Uses SHA-256 for collision resistance and deterministic key generation.
-   * Handles BigInt serialization and sorts object keys for consistency.
-   *
-   * @param message - The message object to hash (typically EIP-712 typed data)
-   * @returns A hex string hash (SHA-256) suitable for cache keys
-   * @example
-   * ```typescript
-   * const typedData = {
-   *   domain: { name: 'Vana', version: '1' },
-   *   message: { nonce: 123n, grant: '...' }
-   * };
-   *
-   * const hash = SignatureCache.hashMessage(typedData);
-   * // Returns SHA-256 hash like: "a1b2c3d4e5f6..."
-   * ```
-   */
-  static hashMessage(message) {
-    const jsonString = JSON.stringify(message, this.deterministicReplacer);
-    const hashBytes = (0, import_sha256.sha256)(new TextEncoder().encode(jsonString));
-    return (0, import_viem.toHex)(hashBytes);
-  }
-  /**
-   * Deterministic JSON replacer for consistent cache key generation.
-   *
-   * @remarks
-   * Handles BigInt serialization and sorts object keys to ensure
-   * identical objects always produce the same hash regardless of
-   * property order.
-   *
-   * @param _key - The object key being serialized (unused)
-   * @param value - The value to serialize
-   * @returns The serialized value with sorted keys for objects
-   *
-   * @internal
-   */
-  static deterministicReplacer(_key, value) {
-    if (typeof value === "bigint") {
-      return `__BIGINT__${value.toString()}`;
-    }
-    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
-      return Object.keys(value).sort().reduce(
-        (sorted, key) => {
-          sorted[key] = value[key];
-          return sorted;
-        },
-        {}
-      );
-    }
-    return value;
-  }
-}
-async function withSignatureCache(cache, walletAddress, typedData, signFn, ttlHours) {
-  const messageHash = SignatureCache.hashMessage(typedData);
-  const cached = SignatureCache.get(cache, walletAddress, messageHash);
-  if (cached) {
-    return cached;
-  }
-  const signature = await signFn();
-  SignatureCache.set(cache, walletAddress, messageHash, signature, ttlHours);
-  return signature;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SignatureCache,
-  withSignatureCache
-});
-//# sourceMappingURL=signatureCache.cjs.map

package/dist/utils/signatureCache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/signatureCache.ts"],"sourcesContent":["/**\n * Provides signature caching to improve UX by avoiding repeated wallet prompts.\n *\n * @remarks\n * This module implements a secure signature cache that stores signed messages\n * temporarily to avoid repeatedly prompting users for the same signature.\n * It uses platform-appropriate storage (sessionStorage in browser, memory in Node.js)\n * and includes automatic expiration and cleanup.\n *\n * @category Utilities\n * @module utils/signatureCache\n */\n\nimport type { Hash } from \"viem\";\nimport { getAddress, toHex } from \"viem\";\nimport type { VanaCacheAdapter } from \"../platform/interface\";\nimport { sha256 } from \"@noble/hashes/sha256\";\n\n/**\n * Represents a cached signature with expiration metadata.\n *\n * @internal\n */\ninterface CachedSignature {\n  /** The cached signature hash */\n  signature: Hash;\n  /** Unix timestamp when this cache entry expires */\n  expires: number;\n}\n\n/**\n * Simple signature cache using platform cache adapter to avoid repeated signing of identical messages.\n *\n * @remarks\n * This cache significantly improves UX by avoiding repeated wallet signature prompts\n * for identical operations. It's particularly useful for operations that may be\n * retried or called multiple times with the same parameters.\n *\n * Features:\n * - Platform-appropriate storage (sessionStorage in browser, memory in Node.js)\n * - Configurable TTL (default 2 hours)\n * - Automatic cleanup of expired entries\n * - Cache keys based on wallet address + message hash\n *\n * @example\n * ```typescript\n * // Check cache before requesting signature\n * const cached = SignatureCache.get(cache, walletAddress, messageHash);\n * if (cached) {\n *   return cached;\n * }\n *\n * // Request signature and cache it\n * const signature = await wallet.signTypedData(typedData);\n * SignatureCache.set(cache, walletAddress, messageHash, signature);\n * ```\n * @category Utilities\n */\nexport class SignatureCache {\n  private static readonly PREFIX = \"vana_sig_\";\n  private static readonly DEFAULT_TTL_HOURS = 2;\n\n  /**\n   * Get a cached signature if it exists and hasn't expired\n   *\n   * @param cache - Platform cache adapter instance\n   * @param walletAddress - Wallet address that created the signature\n   * @param messageHash - Hash of the message that was signed\n   * @returns The cached signature if valid, null if expired or not found\n   * @example\n   * ```typescript\n   * const messageHash = SignatureCache.hashMessage(typedData);\n   * const cached = SignatureCache.get(cache, '0x123...', messageHash);\n   * if (cached) {\n   *   console.log('Using cached signature:', cached);\n   * }\n   * ```\n   */\n  static get(\n    cache: VanaCacheAdapter,\n    walletAddress: string,\n    messageHash: string,\n  ): Hash | null {\n    const key = this.getCacheKey(walletAddress, messageHash);\n\n    try {\n      const stored = cache.get(key);\n      if (!stored) return null;\n\n      const cached: CachedSignature = JSON.parse(stored);\n\n      // Check if expired\n      if (Date.now() > cached.expires) {\n        cache.delete(key);\n        return null;\n      }\n\n      return cached.signature;\n    } catch {\n      // Invalid JSON or storage error, clean up\n      try {\n        cache.delete(key);\n      } catch {\n        // Ignore cache cleanup errors\n      }\n      return null;\n    }\n  }\n\n  /**\n   * Store a signature in the cache with configurable TTL\n   *\n   * @param cache - Platform cache adapter instance\n   * @param walletAddress - Wallet address that created the signature\n   * @param messageHash - Hash of the message that was signed\n   * @param signature - The signature to cache\n   * @param ttlHours - Time to live in hours (default: 2)\n   * @example\n   * ```typescript\n   * const signature = await wallet.signTypedData(typedData);\n   * const messageHash = SignatureCache.hashMessage(typedData);\n   *\n   * // Cache for default 2 hours\n   * SignatureCache.set(cache, walletAddress, messageHash, signature);\n   *\n   * // Cache for 24 hours\n   * SignatureCache.set(cache, walletAddress, messageHash, signature, 24);\n   * ```\n   */\n  static set(\n    cache: VanaCacheAdapter,\n    walletAddress: string,\n    messageHash: string,\n    signature: Hash,\n    ttlHours: number = this.DEFAULT_TTL_HOURS,\n  ): void {\n    const key = this.getCacheKey(walletAddress, messageHash);\n    const cached: CachedSignature = {\n      signature,\n      expires: Date.now() + ttlHours * 3600000, // Convert hours to milliseconds\n    };\n\n    try {\n      cache.set(key, JSON.stringify(cached));\n    } catch {\n      // Storage quota exceeded or other error, ignore silently\n      // Better to continue without caching than to fail\n    }\n  }\n\n  /**\n   * Clear all cached signatures (useful for testing or explicit cleanup)\n   *\n   * @param cache - Platform cache adapter instance\n   * @example\n   * ```typescript\n   * // Clear all signatures when user logs out\n   * SignatureCache.clear(cache);\n   *\n   * // Clear before running tests\n   * beforeEach(() => {\n   *   SignatureCache.clear(cache);\n   * });\n   * ```\n   */\n  static clear(cache: VanaCacheAdapter): void {\n    try {\n      cache.clear();\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  private static getCacheKey(\n    walletAddress: string,\n    messageHash: string,\n  ): string {\n    return `${this.PREFIX}${getAddress(walletAddress)}:${messageHash}`;\n  }\n\n  /**\n   * Generate a deterministic hash of a message object for cache key generation\n   *\n   * @remarks\n   * Creates a cryptographically secure hash from complex objects including EIP-712 typed data.\n   * Uses SHA-256 for collision resistance and deterministic key generation.\n   * Handles BigInt serialization and sorts object keys for consistency.\n   *\n   * @param message - The message object to hash (typically EIP-712 typed data)\n   * @returns A hex string hash (SHA-256) suitable for cache keys\n   * @example\n   * ```typescript\n   * const typedData = {\n   *   domain: { name: 'Vana', version: '1' },\n   *   message: { nonce: 123n, grant: '...' }\n   * };\n   *\n   * const hash = SignatureCache.hashMessage(typedData);\n   * // Returns SHA-256 hash like: \"a1b2c3d4e5f6...\"\n   * ```\n   */\n  static hashMessage(message: object): string {\n    // Deterministically stringify the object with sorted keys\n    const jsonString = JSON.stringify(message, this.deterministicReplacer);\n\n    // Use SHA-256 for cryptographic hashing\n    const hashBytes = sha256(new TextEncoder().encode(jsonString));\n    return toHex(hashBytes);\n  }\n\n  /**\n   * Deterministic JSON replacer for consistent cache key generation.\n   *\n   * @remarks\n   * Handles BigInt serialization and sorts object keys to ensure\n   * identical objects always produce the same hash regardless of\n   * property order.\n   *\n   * @param _key - The object key being serialized (unused)\n   * @param value - The value to serialize\n   * @returns The serialized value with sorted keys for objects\n   *\n   * @internal\n   */\n  private static deterministicReplacer(_key: string, value: unknown): unknown {\n    if (typeof value === \"bigint\") {\n      return `__BIGINT__${value.toString()}`;\n    }\n    // Sort object keys for deterministic serialization\n    if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n      return Object.keys(value as Record<string, unknown>)\n        .sort()\n        .reduce(\n          (sorted, key) => {\n            sorted[key] = (value as Record<string, unknown>)[key];\n            return sorted;\n          },\n          {} as Record<string, unknown>,\n        );\n    }\n    return value;\n  }\n}\n\n/**\n * Wraps signature operations with caching to avoid repeated prompts.\n *\n * @remarks\n * This helper function checks the cache before requesting a signature\n * and stores new signatures for future use. It significantly improves\n * UX for operations that may be retried or called multiple times.\n *\n * @param cache - The cache adapter to use for storage.\n *   Obtain from platform adapter.\n * @param walletAddress - The wallet address signing the message.\n *   Obtain from wallet connection.\n * @param typedData - The EIP-712 typed data being signed.\n *   Typically permission or grant data.\n * @param signFn - Async function that performs the actual signing.\n *   Usually calls wallet.signTypedData().\n * @param ttlHours - Cache TTL in hours.\n *   Defaults to 2 hours.\n * @returns The signature (cached or newly generated)\n *\n * @example\n * ```typescript\n * const signature = await withSignatureCache(\n *   platformAdapter.cache,\n *   walletAddress,\n *   typedData,\n *   async () => wallet.signTypedData(typedData),\n *   24 // Cache for 24 hours\n * );\n * ```\n *\n * @category Utilities\n */\nexport async function withSignatureCache(\n  cache: VanaCacheAdapter,\n  walletAddress: string,\n  typedData: Record<string, unknown>,\n  signFn: () => Promise<Hash>,\n  ttlHours?: number,\n): Promise<Hash> {\n  // Create a hash of the typed data for the cache key\n  const messageHash = SignatureCache.hashMessage(typedData);\n\n  // Try to get from cache first\n  const cached = SignatureCache.get(cache, walletAddress, messageHash);\n  if (cached) {\n    return cached;\n  }\n\n  // Not in cache, sign and store\n  const signature = await signFn();\n  SignatureCache.set(cache, walletAddress, messageHash, signature, ttlHours);\n\n  return signature;\n}\n"],"mappings":"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","names":[]}

package/dist/utils/signatureCache.d.ts

@@ -1,172 +0,0 @@
-/**
- * Provides signature caching to improve UX by avoiding repeated wallet prompts.
- *
- * @remarks
- * This module implements a secure signature cache that stores signed messages
- * temporarily to avoid repeatedly prompting users for the same signature.
- * It uses platform-appropriate storage (sessionStorage in browser, memory in Node.js)
- * and includes automatic expiration and cleanup.
- *
- * @category Utilities
- * @module utils/signatureCache
- */
-import type { Hash } from "viem";
-import type { VanaCacheAdapter } from "../platform/interface";
-/**
- * Simple signature cache using platform cache adapter to avoid repeated signing of identical messages.
- *
- * @remarks
- * This cache significantly improves UX by avoiding repeated wallet signature prompts
- * for identical operations. It's particularly useful for operations that may be
- * retried or called multiple times with the same parameters.
- *
- * Features:
- * - Platform-appropriate storage (sessionStorage in browser, memory in Node.js)
- * - Configurable TTL (default 2 hours)
- * - Automatic cleanup of expired entries
- * - Cache keys based on wallet address + message hash
- *
- * @example
- * ```typescript
- * // Check cache before requesting signature
- * const cached = SignatureCache.get(cache, walletAddress, messageHash);
- * if (cached) {
- *   return cached;
- * }
- *
- * // Request signature and cache it
- * const signature = await wallet.signTypedData(typedData);
- * SignatureCache.set(cache, walletAddress, messageHash, signature);
- * ```
- * @category Utilities
- */
-export declare class SignatureCache {
-    private static readonly PREFIX;
-    private static readonly DEFAULT_TTL_HOURS;
-    /**
-     * Get a cached signature if it exists and hasn't expired
-     *
-     * @param cache - Platform cache adapter instance
-     * @param walletAddress - Wallet address that created the signature
-     * @param messageHash - Hash of the message that was signed
-     * @returns The cached signature if valid, null if expired or not found
-     * @example
-     * ```typescript
-     * const messageHash = SignatureCache.hashMessage(typedData);
-     * const cached = SignatureCache.get(cache, '0x123...', messageHash);
-     * if (cached) {
-     *   console.log('Using cached signature:', cached);
-     * }
-     * ```
-     */
-    static get(cache: VanaCacheAdapter, walletAddress: string, messageHash: string): Hash | null;
-    /**
-     * Store a signature in the cache with configurable TTL
-     *
-     * @param cache - Platform cache adapter instance
-     * @param walletAddress - Wallet address that created the signature
-     * @param messageHash - Hash of the message that was signed
-     * @param signature - The signature to cache
-     * @param ttlHours - Time to live in hours (default: 2)
-     * @example
-     * ```typescript
-     * const signature = await wallet.signTypedData(typedData);
-     * const messageHash = SignatureCache.hashMessage(typedData);
-     *
-     * // Cache for default 2 hours
-     * SignatureCache.set(cache, walletAddress, messageHash, signature);
-     *
-     * // Cache for 24 hours
-     * SignatureCache.set(cache, walletAddress, messageHash, signature, 24);
-     * ```
-     */
-    static set(cache: VanaCacheAdapter, walletAddress: string, messageHash: string, signature: Hash, ttlHours?: number): void;
-    /**
-     * Clear all cached signatures (useful for testing or explicit cleanup)
-     *
-     * @param cache - Platform cache adapter instance
-     * @example
-     * ```typescript
-     * // Clear all signatures when user logs out
-     * SignatureCache.clear(cache);
-     *
-     * // Clear before running tests
-     * beforeEach(() => {
-     *   SignatureCache.clear(cache);
-     * });
-     * ```
-     */
-    static clear(cache: VanaCacheAdapter): void;
-    private static getCacheKey;
-    /**
-     * Generate a deterministic hash of a message object for cache key generation
-     *
-     * @remarks
-     * Creates a cryptographically secure hash from complex objects including EIP-712 typed data.
-     * Uses SHA-256 for collision resistance and deterministic key generation.
-     * Handles BigInt serialization and sorts object keys for consistency.
-     *
-     * @param message - The message object to hash (typically EIP-712 typed data)
-     * @returns A hex string hash (SHA-256) suitable for cache keys
-     * @example
-     * ```typescript
-     * const typedData = {
-     *   domain: { name: 'Vana', version: '1' },
-     *   message: { nonce: 123n, grant: '...' }
-     * };
-     *
-     * const hash = SignatureCache.hashMessage(typedData);
-     * // Returns SHA-256 hash like: "a1b2c3d4e5f6..."
-     * ```
-     */
-    static hashMessage(message: object): string;
-    /**
-     * Deterministic JSON replacer for consistent cache key generation.
-     *
-     * @remarks
-     * Handles BigInt serialization and sorts object keys to ensure
-     * identical objects always produce the same hash regardless of
-     * property order.
-     *
-     * @param _key - The object key being serialized (unused)
-     * @param value - The value to serialize
-     * @returns The serialized value with sorted keys for objects
-     *
-     * @internal
-     */
-    private static deterministicReplacer;
-}
-/**
- * Wraps signature operations with caching to avoid repeated prompts.
- *
- * @remarks
- * This helper function checks the cache before requesting a signature
- * and stores new signatures for future use. It significantly improves
- * UX for operations that may be retried or called multiple times.
- *
- * @param cache - The cache adapter to use for storage.
- *   Obtain from platform adapter.
- * @param walletAddress - The wallet address signing the message.
- *   Obtain from wallet connection.
- * @param typedData - The EIP-712 typed data being signed.
- *   Typically permission or grant data.
- * @param signFn - Async function that performs the actual signing.
- *   Usually calls wallet.signTypedData().
- * @param ttlHours - Cache TTL in hours.
- *   Defaults to 2 hours.
- * @returns The signature (cached or newly generated)
- *
- * @example
- * ```typescript
- * const signature = await withSignatureCache(
- *   platformAdapter.cache,
- *   walletAddress,
- *   typedData,
- *   async () => wallet.signTypedData(typedData),
- *   24 // Cache for 24 hours
- * );
- * ```
- *
- * @category Utilities
- */
-export declare function withSignatureCache(cache: VanaCacheAdapter, walletAddress: string, typedData: Record<string, unknown>, signFn: () => Promise<Hash>, ttlHours?: number): Promise<Hash>;