@opendatalabs/vana-sdk 0.1.0-alpha.ee24d86 → 0.1.0-alpha.eebb656

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["import type {\n  VanaConfig,\n  VanaConfigWithStorage,\n  RuntimeConfig,\n  VanaChainId,\n  StorageRequiredMarker,\n} from \"./types\";\nimport {\n  isWalletConfig,\n  isChainConfig,\n  isVanaChainId,\n  hasStorageConfig,\n} from \"./types\";\nimport type {\n  RelayerCallbacks,\n  DownloadRelayerCallbacks,\n} from \"./types/config\";\nimport { InvalidConfigurationError } from \"./errors\";\nimport type { ControllerContext } from \"./controllers/permissions\";\nimport { PermissionsController } from \"./controllers/permissions\";\nimport { DataController } from \"./controllers/data\";\nimport { SchemaController } from \"./controllers/schemas\";\nimport { ServerController } from \"./controllers/server\";\nimport { ProtocolController } from \"./controllers/protocol\";\nimport { StorageManager } from \"./storage\";\nimport { createWalletClient, createPublicClient, http } from \"viem\";\nimport type {\n  PublicClient,\n  WalletClient,\n  Address,\n  Hash,\n  TransactionReceipt,\n} from \"viem\";\nimport type {\n  Operation,\n  PollingOptions,\n  TransactionResult,\n  TransactionWaitOptions,\n} from \"./types/operations\";\nimport type {\n  Contract,\n  Fn,\n  TypedTransactionResult,\n} from \"./generated/event-types\";\nimport { chains } from \"./config/chains\";\nimport { getChainConfig } from \"./chains\";\nimport type { VanaPlatformAdapter } from \"./platform/interface\";\nimport {\n  encryptBlobWithSignedKey,\n  decryptBlobWithSignedKey,\n} from \"./utils/encryption\";\n\n/**\n * Factory functions for creating VanaCore instances with proper type safety\n */\nexport class VanaCoreFactory {\n  /**\n   * Creates a VanaCore instance that enforces storage requirements at compile time.\n   * Use this factory when you know you'll need storage-dependent operations.\n   *\n   * @param platform - The platform adapter for environment-specific operations\n   * @param config - Configuration that includes required storage providers\n   * @returns VanaCore instance with storage validation\n   * @example\n   * ```typescript\n   * const vanaCore = VanaCoreFactory.createWithStorage(platformAdapter, {\n   *   walletClient: myWalletClient,\n   *   storage: {\n   *     providers: { ipfs: new IPFSStorage() },\n   *     defaultProvider: 'ipfs'\n   *   }\n   * });\n   * ```\n   */\n  static createWithStorage(\n    platform: VanaPlatformAdapter,\n    config: VanaConfigWithStorage,\n  ): VanaCore & StorageRequiredMarker {\n    const core = new VanaCore(platform, config);\n    return core as VanaCore & StorageRequiredMarker;\n  }\n\n  /**\n   * Creates a VanaCore instance without storage requirements.\n   * Storage-dependent operations will fail at runtime if not configured.\n   *\n   * @param platform - The platform adapter for environment-specific operations\n   * @param config - Basic configuration without required storage\n   * @returns VanaCore instance\n   * @example\n   * ```typescript\n   * const vanaCore = VanaCoreFactory.create(platformAdapter, {\n   *   walletClient: myWalletClient\n   * });\n   * ```\n   */\n  static create(platform: VanaPlatformAdapter, config: VanaConfig): VanaCore {\n    return new VanaCore(platform, config);\n  }\n}\n\n/**\n * Provides the core SDK functionality for interacting with the Vana network.\n *\n * @remarks\n * This environment-agnostic class contains all SDK logic and accepts a platform\n * adapter to handle environment-specific operations. It initializes all controllers\n * and manages shared context between them, providing a unified interface for\n * data management, permissions, smart contracts, and storage operations.\n *\n * The class uses TypeScript overloading to enforce storage requirements at compile time.\n * Methods that require storage will throw `InvalidConfigurationError` at runtime if\n * storage providers are not configured, implementing a fail-fast approach to prevent\n * errors during expensive operations.\n *\n * **Core Architecture:**\n * - **Controllers**: Specialized modules for different Vana features (data, permissions, etc.)\n * - **Platform Adapters**: Environment-specific implementations (browser vs Node.js)\n * - **Storage Managers**: Abstraction layer for multiple storage providers\n * - **Context Sharing**: Unified configuration and services across all controllers\n *\n * For public usage, use the platform-specific factory functions:\n * - Browser: `import { Vana } from '@opendatalabs/vana-sdk/browser'`\n * - Node.js: `import { Vana } from '@opendatalabs/vana-sdk/node'`\n *\n * @example\n * ```typescript\n * // Direct instantiation (advanced usage)\n * import { VanaCore, BrowserPlatformAdapter } from '@opendatalabs/vana-sdk/browser';\n *\n * const core = new VanaCore(new BrowserPlatformAdapter(), {\n *   walletClient: myWalletClient,\n *   storage: {\n *     providers: { ipfs: new IPFSStorage() },\n *     defaultProvider: 'ipfs'\n *   }\n * });\n *\n * // Access all controllers\n * const files = await core.data.getUserFiles();\n * const permissions = await core.permissions.grant({\n *   grantee: '0x742d35...',\n *   operation: 'read'\n * });\n * ```\n * @category Core SDK\n */\nexport class VanaCore {\n  /** Manages gasless data access permissions and trusted server registry. */\n  public readonly permissions: PermissionsController;\n\n  /** Handles user data file operations. */\n  public readonly data: DataController;\n\n  /** Manages data schemas and refiners. */\n  public readonly schemas: SchemaController;\n\n  /** Provides personal server setup and trusted server interactions. */\n  public readonly server: ServerController;\n\n  /** Offers low-level access to Vana protocol smart contracts. */\n  public readonly protocol: ProtocolController;\n\n  /** Handles environment-specific operations like encryption and file systems. */\n  protected platform: VanaPlatformAdapter;\n\n  private readonly relayerCallbacks?: RelayerCallbacks;\n  private readonly downloadRelayer?: DownloadRelayerCallbacks;\n  private readonly storageManager?: StorageManager;\n  private readonly hasRequiredStorage: boolean;\n  private readonly ipfsGateways?: string[];\n  private readonly defaultPersonalServerUrl?: string;\n  private readonly publicClient: PublicClient;\n  private readonly walletClient: WalletClient;\n\n  /**\n   * Initializes a new VanaCore client instance with the provided configuration.\n   *\n   * @remarks\n   * The constructor validates the configuration, initializes storage providers if configured,\n   * creates wallet and public clients, and sets up all SDK controllers with shared context.\n   *\n   * IMPORTANT: This constructor will validate storage requirements at runtime to fail fast.\n   * Methods that require storage will throw runtime errors if storage is not configured.\n   *\n   * @param platform - The platform adapter for environment-specific operations\n   * @param config - The configuration object specifying wallet or chain settings\n   * @throws {InvalidConfigurationError} When the configuration is invalid or incomplete\n   * @example\n   * ```typescript\n   * // Direct instantiation (consider using factory methods instead)\n   * const vanaCore = new VanaCore(platformAdapter, {\n   *   walletClient: myWalletClient,\n   * });\n   * ```\n   */\n  constructor(platform: VanaPlatformAdapter, config: VanaConfig) {\n    // Store the platform adapter\n    this.platform = platform;\n\n    // Validate configuration\n    this.validateConfig(config);\n\n    // Store relayer callbacks if provided\n    this.relayerCallbacks = config.relayerCallbacks;\n\n    // Store download relayer if provided\n    this.downloadRelayer = config.downloadRelayer;\n\n    // Store IPFS gateways if provided\n    this.ipfsGateways = config.ipfsGateways;\n\n    // Store default personal server URL if provided\n    this.defaultPersonalServerUrl = config.defaultPersonalServerUrl;\n\n    // Check if storage is properly configured\n    this.hasRequiredStorage = hasStorageConfig(config);\n\n    // Initialize storage manager if storage providers are provided\n    if (config.storage?.providers) {\n      this.storageManager = new StorageManager();\n\n      // Register all provided storage providers\n      for (const [name, provider] of Object.entries(config.storage.providers)) {\n        const isDefault = name === config.storage.defaultProvider;\n        this.storageManager.register(name, provider, isDefault);\n      }\n\n      // If no default was explicitly set but providers exist, use the first one\n      if (\n        !config.storage.defaultProvider &&\n        Object.keys(config.storage.providers).length > 0\n      ) {\n        const firstProviderName = Object.keys(config.storage.providers)[0];\n        this.storageManager.setDefaultProvider(firstProviderName);\n      }\n    }\n\n    // Create wallet client based on configuration type\n    let walletClient;\n\n    if (isWalletConfig(config)) {\n      // Direct wallet client configuration\n      walletClient = config.walletClient;\n    } else if (isChainConfig(config)) {\n      // Chain configuration - create wallet client\n      if (!config.account) {\n        throw new InvalidConfigurationError(\n          \"Account is required when using ChainConfig\",\n        );\n      }\n\n      const chain = chains[config.chainId];\n      if (!chain) {\n        throw new InvalidConfigurationError(\n          `Unsupported chain ID: ${config.chainId}`,\n        );\n      }\n\n      walletClient = createWalletClient({\n        chain,\n        transport: http(config.rpcUrl ?? chain.rpcUrls.default.http[0]),\n        account: config.account,\n      });\n    } else {\n      throw new InvalidConfigurationError(\n        \"Invalid configuration: must be either WalletConfig or ChainConfig\",\n      );\n    }\n\n    // Create public client for reading contracts\n    const publicClient = createPublicClient({\n      chain: walletClient.chain,\n      transport: http(),\n    });\n\n    // Store the clients for later use\n    this.publicClient = publicClient;\n    this.walletClient = walletClient;\n\n    // Get default subgraph URL if not provided in config\n    const chainConfig = getChainConfig(walletClient.chain.id);\n    const subgraphUrl = config.subgraphUrl ?? chainConfig?.subgraphUrl;\n\n    // Create shared context for all controllers, now including the platform adapter\n    const sharedContext: ControllerContext = {\n      walletClient,\n      publicClient,\n      applicationClient: walletClient, // Using same wallet for now\n      relayerCallbacks: this.relayerCallbacks,\n      downloadRelayer: this.downloadRelayer,\n      storageManager: this.storageManager,\n      subgraphUrl,\n      platform: this.platform, // Pass the platform adapter to controllers\n      validateStorageRequired: this.validateStorageRequired.bind(this),\n      hasStorage: this.hasStorage.bind(this),\n      ipfsGateways: this.ipfsGateways,\n      defaultPersonalServerUrl: this.defaultPersonalServerUrl,\n      waitForTransactionEvents: this.waitForTransactionEvents.bind(this),\n      waitForOperation: this.waitForOperation.bind(this),\n    };\n\n    // Initialize controllers\n    this.permissions = new PermissionsController(sharedContext);\n    this.data = new DataController(sharedContext);\n    this.schemas = new SchemaController(sharedContext);\n    this.server = new ServerController(sharedContext);\n    this.protocol = new ProtocolController(sharedContext);\n  }\n\n  /**\n   * Validates that storage is available for storage-dependent operations.\n   * This method enforces the fail-fast principle by checking storage availability\n   * at method call time rather than during expensive operations.\n   *\n   * @throws {InvalidConfigurationError} When storage is required but not configured\n   * @example\n   * ```typescript\n   * // This will throw if storage is not configured\n   * vana.validateStorageRequired();\n   * await vana.data.uploadFile(file); // Safe to proceed\n   * ```\n   */\n  public validateStorageRequired(): void {\n    if (!this.hasRequiredStorage) {\n      throw new InvalidConfigurationError(\n        \"Storage configuration is required for this operation. \" +\n          \"Please configure storage providers in VanaConfig.storage, \" +\n          \"provide a relayerCallbacks.storeGrantFile implementation, \" +\n          \"or pass pre-stored URLs to avoid this dependency. \" +\n          \"\\n\\nFor better type safety, consider using VanaCoreFactory.createWithStorage() \" +\n          \"with VanaConfigWithStorage to catch this error at compile time.\",\n      );\n    }\n  }\n\n  /**\n   * Checks whether storage is configured without throwing an error.\n   *\n   * @returns True if storage is properly configured\n   * @example\n   * ```typescript\n   * if (vana.hasStorage()) {\n   *   await vana.data.uploadFile(file);\n   * } else {\n   *   console.warn('Storage not configured - using pre-stored URLs only');\n   * }\n   * ```\n   */\n  public hasStorage(): boolean {\n    return this.hasRequiredStorage;\n  }\n\n  /**\n   * Type guard to check if this instance has storage enabled at compile time.\n   * Use this when you need TypeScript to understand that storage is available.\n   *\n   * @returns True if storage is configured, with type narrowing\n   * @example\n   * ```typescript\n   * if (vana.isStorageEnabled()) {\n   *   // TypeScript knows storage is available here\n   *   await vana.data.uploadFile(file);\n   * }\n   * ```\n   */\n  public isStorageEnabled(): this is VanaCore & StorageRequiredMarker {\n    return this.hasRequiredStorage;\n  }\n\n  /**\n   * Validates the provided configuration object against all requirements.\n   *\n   * @remarks\n   * This method performs comprehensive validation of wallet client configuration,\n   * chain configuration, storage providers, and relayer callbacks.\n   * @param config - The configuration object to validate\n   * @throws {InvalidConfigurationError} When any configuration parameter is invalid\n   */\n  private validateConfig(config: VanaConfig): void {\n    if (!config) {\n      throw new InvalidConfigurationError(\"Configuration object is required\");\n    }\n\n    // Validate relayerCallbacks if provided\n    if (config.relayerCallbacks !== undefined) {\n      if (typeof config.relayerCallbacks !== \"object\") {\n        throw new InvalidConfigurationError(\n          \"relayerCallbacks must be an object\",\n        );\n      }\n    }\n\n    // Validate storage configuration if provided\n    if (config.storage?.providers) {\n      if (typeof config.storage.providers !== \"object\") {\n        throw new InvalidConfigurationError(\n          \"storage.providers must be an object\",\n        );\n      }\n\n      // Validate that all providers have required methods\n      for (const [name, provider] of Object.entries(config.storage.providers)) {\n        if (!provider || typeof provider !== \"object\") {\n          throw new InvalidConfigurationError(\n            `Storage provider '${name}' must be a valid StorageProvider object`,\n          );\n        }\n      }\n\n      // Validate default provider if specified\n      if (config.storage.defaultProvider) {\n        if (!(config.storage.defaultProvider in config.storage.providers)) {\n          throw new InvalidConfigurationError(\n            `Default storage provider '${config.storage.defaultProvider}' not found in providers`,\n          );\n        }\n      }\n    }\n\n    if (isWalletConfig(config)) {\n      // Validate WalletConfig\n      if (!config.walletClient) {\n        throw new InvalidConfigurationError(\"walletClient is required\");\n      }\n\n      // Validate that walletClient is actually a WalletClient\n      if (\n        typeof config.walletClient !== \"object\" ||\n        !config.walletClient.signTypedData\n      ) {\n        throw new InvalidConfigurationError(\n          \"walletClient must be a valid viem WalletClient\",\n        );\n      }\n\n      // Validate that wallet client has a chain\n      if (!config.walletClient.chain) {\n        throw new InvalidConfigurationError(\n          \"walletClient must have a chain configured\",\n        );\n      }\n\n      // Validate that the chain is supported\n      if (!isVanaChainId(config.walletClient.chain.id)) {\n        throw new InvalidConfigurationError(\n          `Unsupported chain ID: ${String(config.walletClient.chain.id)}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`,\n        );\n      }\n    } else if (isChainConfig(config)) {\n      // Validate ChainConfig\n      if (!isVanaChainId(config.chainId)) {\n        throw new InvalidConfigurationError(\n          `Unsupported chain ID: ${String(config.chainId)}. Supported chains: 14800 (Moksha testnet), 1480 (Vana mainnet)`,\n        );\n      }\n\n      // Validate rpcUrl if provided\n      if (config.rpcUrl) {\n        if (typeof config.rpcUrl !== \"string\") {\n          throw new InvalidConfigurationError(\"rpcUrl must be a string\");\n        }\n\n        if (config.rpcUrl.trim() === \"\") {\n          throw new InvalidConfigurationError(\"rpcUrl cannot be empty\");\n        }\n\n        // Basic URL validation for RPC URL\n        try {\n          new URL(config.rpcUrl);\n        } catch {\n          throw new InvalidConfigurationError(\"rpcUrl must be a valid URL\");\n        }\n      }\n\n      // Account is optional for ChainConfig, but if provided, validate it\n      if (config.account) {\n        if (typeof config.account !== \"object\" || !config.account.address) {\n          throw new InvalidConfigurationError(\n            \"account must be a valid viem Account object\",\n          );\n        }\n      }\n    } else {\n      throw new InvalidConfigurationError(\n        \"Configuration must be either WalletConfig or ChainConfig\",\n      );\n    }\n  }\n\n  /**\n   * Gets the current chain ID from the wallet client.\n   *\n   * @returns The numeric chain ID of the connected network\n   * @example\n   * ```typescript\n   * const chainId = vana.chainId;\n   * console.log(`Connected to chain: ${chainId}`); // e.g., \"Connected to chain: 14800\"\n   * ```\n   */\n  get chainId(): number {\n    return this.protocol.getChainId();\n  }\n\n  /**\n   * Gets the current chain name from the wallet client.\n   *\n   * @returns The human-readable name of the connected network\n   * @example\n   * ```typescript\n   * const chainName = vana.chainName;\n   * console.log(`Connected to: ${chainName}`); // e.g., \"Connected to: Moksha Testnet\"\n   * ```\n   */\n  get chainName(): string {\n    return this.protocol.getChainName();\n  }\n\n  /**\n   * Retrieves the user's wallet address from the connected client.\n   *\n   * @returns A Promise that resolves to the user's Ethereum address\n   * @example\n   * ```typescript\n   * const address = await vana.getUserAddress();\n   * console.log(`User address: ${address}`); // e.g., \"User address: 0x742d35...\"\n   * ```\n   */\n  async getUserAddress(): Promise<Address> {\n    if (!this.walletClient.account) {\n      throw new Error(\"No wallet account connected\");\n    }\n\n    const { account } = this.walletClient;\n\n    // Return the account address directly if available\n    if (typeof account === \"string\") {\n      return account as Address;\n    }\n\n    // If account is an object, get the address property\n    if (typeof account === \"object\" && account.address) {\n      return account.address;\n    }\n\n    throw new Error(\"Unable to determine wallet address\");\n  }\n\n  /**\n   * Retrieves comprehensive runtime configuration information.\n   *\n   * @returns The current runtime configuration including chain, storage, and relayer settings\n   * @example\n   * ```typescript\n   * const config = vana.getConfig();\n   * console.log(`Chain: ${config.chainName} (${config.chainId})`);\n   * console.log(`Storage providers: ${config.storageProviders.join(\", \")}`);\n   * ```\n   */\n  getConfig(): RuntimeConfig {\n    return {\n      chainId: this.chainId as VanaChainId,\n      chainName: this.chainName,\n      relayerCallbacks: this.relayerCallbacks,\n      storageProviders: this.storageManager?.getStorageProviders() ?? [],\n      defaultStorageProvider: this.storageManager?.getDefaultStorageProvider(),\n    };\n  }\n\n  /**\n   * Sets the platform adapter for environment-specific operations.\n   * This is useful for testing and advanced use cases where you need\n   * to override the default platform detection.\n   *\n   * @param adapter - The platform adapter to use\n   * @example\n   * ```typescript\n   * // For testing with a mock adapter\n   * const mockAdapter = new MockPlatformAdapter();\n   * vana.setPlatformAdapter(mockAdapter);\n   *\n   * // For advanced use cases with custom adapters\n   * const customAdapter = new CustomPlatformAdapter();\n   * vana.setPlatformAdapter(customAdapter);\n   * ```\n   */\n  setPlatformAdapter(adapter: VanaPlatformAdapter): void {\n    this.platform = adapter;\n\n    // Note: Controllers will use the new platform adapter on their next operation\n    // since they access this.platform from the shared context\n  }\n\n  /**\n   * Gets the current platform adapter.\n   * This is useful for advanced use cases where you need to access\n   * the platform adapter directly.\n   *\n   * @returns The current platform adapter\n   * @example\n   * ```typescript\n   * const adapter = vana.getPlatformAdapter();\n   * const encrypted = await adapter.encrypt(data, key);\n   * ```\n   */\n  getPlatformAdapter(): VanaPlatformAdapter {\n    return this.platform;\n  }\n\n  /**\n   * Encrypts data using the Vana protocol standard encryption.\n   *\n   * @remarks\n   * This method implements the Vana network's standard encryption protocol using\n   * platform-appropriate cryptographic libraries. It automatically handles different\n   * input types (string or Blob) and produces encrypted output suitable for secure\n   * storage or transmission. The encryption is compatible with the network's\n   * decryption protocols and can be decrypted by authorized parties.\n   *\n   * @param data - The data to encrypt (string or Blob)\n   * @param key - The encryption key (typically generated via `generateEncryptionKey`)\n   * @returns The encrypted data as a Blob\n   * @throws {Error} When encryption fails due to invalid key or data format\n   * @example\n   * ```typescript\n   * import { generateEncryptionKey } from '@opendatalabs/vana-sdk/node';\n   *\n   * // Generate encryption key from wallet signature\n   * const encryptionKey = await generateEncryptionKey(vana.walletClient);\n   *\n   * // Encrypt string data\n   * const sensitiveData = \"User's private information\";\n   * const encrypted = await vana.encryptBlob(sensitiveData, encryptionKey);\n   *\n   * // Encrypt file data\n   * const fileBlob = new Blob([fileContent], { type: 'application/json' });\n   * const encryptedFile = await vana.encryptBlob(fileBlob, encryptionKey);\n   *\n   * // Store encrypted data safely\n   * await storageProvider.upload(encrypted, 'encrypted-data.bin');\n   * ```\n   */\n  public async encryptBlob(data: string | Blob, key: string): Promise<Blob> {\n    return encryptBlobWithSignedKey(data, key, this.platform);\n  }\n\n  /**\n   * Decrypts data that was encrypted using the Vana protocol.\n   *\n   * @remarks\n   * This method decrypts data that was previously encrypted using the Vana network's\n   * standard encryption protocol. It requires the same wallet signature that was used\n   * for encryption and automatically uses the appropriate platform adapter for\n   * cryptographic operations. The decrypted output maintains the original data format.\n   *\n   * @param encryptedData - The encrypted data (string or Blob)\n   * @param walletSignature - The wallet signature used as decryption key\n   * @returns The decrypted data as a Blob\n   * @throws {Error} When decryption fails due to invalid signature or corrupted data\n   * @example\n   * ```typescript\n   * import { generateEncryptionKey } from '@opendatalabs/vana-sdk/node';\n   *\n   * // Retrieve encrypted data from storage\n   * const encryptedBlob = await storageProvider.download('encrypted-data.bin');\n   *\n   * // Generate the same key used for encryption\n   * const decryptionKey = await generateEncryptionKey(vana.walletClient);\n   *\n   * // Decrypt the data\n   * const decrypted = await vana.decryptBlob(encryptedBlob, decryptionKey);\n   *\n   * // Convert back to original format\n   * const originalText = await decrypted.text();\n   * const originalJson = JSON.parse(originalText);\n   *\n   * console.log('Decrypted data:', originalJson);\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Decrypt file downloaded from Vana network\n   * const userFiles = await vana.data.getUserFiles();\n   * const file = userFiles[0];\n   *\n   * // Download encrypted content\n   * const encrypted = await fetch(file.url).then(r => r.blob());\n   *\n   * // Decrypt with user's key\n   * const decryptionKey = await generateEncryptionKey(vana.walletClient);\n   * const decrypted = await vana.decryptBlob(encrypted, decryptionKey);\n   *\n   * // Process original data\n   * const fileContent = await decrypted.arrayBuffer();\n   * ```\n   */\n  public async decryptBlob(\n    encryptedData: string | Blob,\n    walletSignature: string,\n  ): Promise<Blob> {\n    return decryptBlobWithSignedKey(\n      encryptedData,\n      walletSignature,\n      this.platform,\n    );\n  }\n\n  /**\n   * Waits for an operation to complete and returns the final result.\n   *\n   * @remarks\n   * This method polls the operation status at regular intervals until it\n   * reaches a terminal state (succeeded, failed, or canceled). Supports\n   * ergonomic overloads to accept either an Operation object or just the ID.\n   *\n   * @param opOrId - Either an Operation object or operation ID string\n   * @param options - Optional polling configuration\n   * @returns The completed operation with result or error\n   * @throws {PersonalServerError} When the operation fails or times out\n   * @example\n   * ```typescript\n   * // Using operation object\n   * const operation = await vana.server.createOperation({ permissionId: 123 });\n   * const completed = await vana.waitForOperation(operation);\n   *\n   * // Using just the ID\n   * const completed = await vana.waitForOperation(\"op_abc123\");\n   *\n   * // With custom timeout\n   * const completed = await vana.waitForOperation(operation, {\n   *   timeout: 60000,\n   *   pollingInterval: 1000\n   * });\n   * ```\n   */\n  public async waitForOperation<T = unknown>(\n    opOrId: Operation<T> | string,\n    options?: PollingOptions,\n  ): Promise<Operation<T>> {\n    return this.server.waitForOperation(opOrId, options);\n  }\n\n  /**\n   * Waits for a transaction to be confirmed and returns the receipt.\n   *\n   * @remarks\n   * This method polls for transaction confirmation on the blockchain.\n   * Supports ergonomic overloads to accept either a transaction result\n   * object or just the hash string.\n   *\n   * @param hashOrObj - Either a TransactionResult object or hash string\n   * @param options - Optional wait configuration\n   * @returns The transaction receipt with logs and status\n   * @example\n   * ```typescript\n   * // Using transaction result object\n   * const tx = await vana.permissions.grant(params);\n   * const receipt = await vana.waitForTransactionReceipt(tx);\n   *\n   * // Using just the hash\n   * const receipt = await vana.waitForTransactionReceipt(\"0x123...\");\n   *\n   * // With custom confirmations\n   * const receipt = await vana.waitForTransactionReceipt(tx, {\n   *   confirmations: 3,\n   *   timeout: 60000\n   * });\n   * ```\n   */\n  public async waitForTransactionReceipt(\n    hashOrObj: TransactionResult | { hash: Hash } | Hash,\n    options?: TransactionWaitOptions,\n  ): Promise<TransactionReceipt> {\n    const hash = typeof hashOrObj === \"string\" ? hashOrObj : hashOrObj.hash;\n\n    return this.publicClient.waitForTransactionReceipt({\n      hash,\n      confirmations: options?.confirmations,\n      pollingInterval: options?.pollingInterval,\n      timeout: options?.timeout,\n    });\n  }\n\n  /**\n   * Waits for transaction confirmation and extracts blockchain event data.\n   *\n   * @remarks\n   * This method leverages the context-carrying POJO architecture. When passed a\n   * `TransactionResult` with an `operation` field, it automatically parses the\n   * correct events from the transaction logs. For legacy compatibility, it accepts\n   * raw hashes but will not parse events without operation context.\n   *\n   * @param transaction - Transaction result with operation context\n   * @param options - Optional confirmation and timeout settings\n   * @returns Parsed event data specific to the transaction's operation type\n   * @throws {NetworkError} When transaction confirmation times out\n   * @throws {BlockchainError} When expected events are not found in the transaction\n   *\n   * @example\n   * ```typescript\n   * // Recommended: Pass the transaction result for automatic event parsing\n   * const tx = await vana.permissions.submitAddServerFilesAndPermissions(params);\n   * const events = await vana.waitForTransactionEvents<{ permissionId: bigint }>(tx);\n   * console.log(`Permission ID: ${events.permissionId}`);\n   *\n   * // Legacy: Raw hash without event parsing (returns receipt)\n   * const receipt = await vana.waitForTransactionEvents(\"0x123...\");\n   * ```\n   *\n   * @see For understanding transaction flows, visit https://docs.vana.org/docs/transactions\n   */\n  public async waitForTransactionEvents<C extends Contract, F extends Fn<C>>(\n    transaction: TransactionResult<C, F>,\n    options?: TransactionWaitOptions,\n  ): Promise<TypedTransactionResult<C, F>> {\n    // Import the POJO-based parser\n    const { parseTransaction } = await import(\"./utils/parseTransactionPojo\");\n\n    // Wait for the transaction to be mined\n    const receipt = await this.waitForTransactionReceipt(\n      transaction.hash,\n      options,\n    );\n\n    // Parse events using our heuristic-free POJO system\n    const result = parseTransaction(transaction, receipt);\n\n    // Return the strongly-typed result\n    // TypeScript knows exactly what events are possible!\n    return result;\n  }\n}\n"],"mappings":"AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,iCAAiC;AAE1C,SAAS,6BAA6B;AACtC,SAAS,sBAAsB;AAC/B,SAAS,wBAAwB;AACjC,SAAS,wBAAwB;AACjC,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAC/B,SAAS,oBAAoB,oBAAoB,YAAY;AAmB7D,SAAS,cAAc;AACvB,SAAS,sBAAsB;AAE/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAKA,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmB3B,OAAO,kBACL,UACA,QACkC;AAClC,UAAM,OAAO,IAAI,SAAS,UAAU,MAAM;AAC1C,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,OAAO,UAA+B,QAA8B;AACzE,WAAO,IAAI,SAAS,UAAU,MAAM;AAAA,EACtC;AACF;AAgDO,MAAM,SAAS;AAAA;AAAA,EAEJ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGN;AAAA,EAEO;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBjB,YAAY,UAA+B,QAAoB;AAE7D,SAAK,WAAW;AAGhB,SAAK,eAAe,MAAM;AAG1B,SAAK,mBAAmB,OAAO;AAG/B,SAAK,kBAAkB,OAAO;AAG9B,SAAK,eAAe,OAAO;AAG3B,SAAK,2BAA2B,OAAO;AAGvC,SAAK,qBAAqB,iBAAiB,MAAM;AAGjD,QAAI,OAAO,SAAS,WAAW;AAC7B,WAAK,iBAAiB,IAAI,eAAe;AAGzC,iBAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,OAAO,QAAQ,SAAS,GAAG;AACvE,cAAM,YAAY,SAAS,OAAO,QAAQ;AAC1C,aAAK,eAAe,SAAS,MAAM,UAAU,SAAS;AAAA,MACxD;AAGA,UACE,CAAC,OAAO,QAAQ,mBAChB,OAAO,KAAK,OAAO,QAAQ,SAAS,EAAE,SAAS,GAC/C;AACA,cAAM,oBAAoB,OAAO,KAAK,OAAO,QAAQ,SAAS,EAAE,CAAC;AACjE,aAAK,eAAe,mBAAmB,iBAAiB;AAAA,MAC1D;AAAA,IACF;AAGA,QAAI;AAEJ,QAAI,eAAe,MAAM,GAAG;AAE1B,qBAAe,OAAO;AAAA,IACxB,WAAW,cAAc,MAAM,GAAG;AAEhC,UAAI,CAAC,OAAO,SAAS;AACnB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAEA,YAAM,QAAQ,OAAO,OAAO,OAAO;AACnC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI;AAAA,UACR,yBAAyB,OAAO,OAAO;AAAA,QACzC;AAAA,MACF;AAEA,qBAAe,mBAAmB;AAAA,QAChC;AAAA,QACA,WAAW,KAAK,OAAO,UAAU,MAAM,QAAQ,QAAQ,KAAK,CAAC,CAAC;AAAA,QAC9D,SAAS,OAAO;AAAA,MAClB,CAAC;AAAA,IACH,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAGA,UAAM,eAAe,mBAAmB;AAAA,MACtC,OAAO,aAAa;AAAA,MACpB,WAAW,KAAK;AAAA,IAClB,CAAC;AAGD,SAAK,eAAe;AACpB,SAAK,eAAe;AAGpB,UAAM,cAAc,eAAe,aAAa,MAAM,EAAE;AACxD,UAAM,cAAc,OAAO,eAAe,aAAa;AAGvD,UAAM,gBAAmC;AAAA,MACvC;AAAA,MACA;AAAA,MACA,mBAAmB;AAAA;AAAA,MACnB,kBAAkB,KAAK;AAAA,MACvB,iBAAiB,KAAK;AAAA,MACtB,gBAAgB,KAAK;AAAA,MACrB;AAAA,MACA,UAAU,KAAK;AAAA;AAAA,MACf,yBAAyB,KAAK,wBAAwB,KAAK,IAAI;AAAA,MAC/D,YAAY,KAAK,WAAW,KAAK,IAAI;AAAA,MACrC,cAAc,KAAK;AAAA,MACnB,0BAA0B,KAAK;AAAA,MAC/B,0BAA0B,KAAK,yBAAyB,KAAK,IAAI;AAAA,MACjE,kBAAkB,KAAK,iBAAiB,KAAK,IAAI;AAAA,IACnD;AAGA,SAAK,cAAc,IAAI,sBAAsB,aAAa;AAC1D,SAAK,OAAO,IAAI,eAAe,aAAa;AAC5C,SAAK,UAAU,IAAI,iBAAiB,aAAa;AACjD,SAAK,SAAS,IAAI,iBAAiB,aAAa;AAChD,SAAK,WAAW,IAAI,mBAAmB,aAAa;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,0BAAgC;AACrC,QAAI,CAAC,KAAK,oBAAoB;AAC5B,YAAM,IAAI;AAAA,QACR;AAAA,MAMF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,aAAsB;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,mBAA6D;AAClE,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,eAAe,QAA0B;AAC/C,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,0BAA0B,kCAAkC;AAAA,IACxE;AAGA,QAAI,OAAO,qBAAqB,QAAW;AACzC,UAAI,OAAO,OAAO,qBAAqB,UAAU;AAC/C,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,QAAI,OAAO,SAAS,WAAW;AAC7B,UAAI,OAAO,OAAO,QAAQ,cAAc,UAAU;AAChD,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAGA,iBAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,OAAO,QAAQ,SAAS,GAAG;AACvE,YAAI,CAAC,YAAY,OAAO,aAAa,UAAU;AAC7C,gBAAM,IAAI;AAAA,YACR,qBAAqB,IAAI;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAGA,UAAI,OAAO,QAAQ,iBAAiB;AAClC,YAAI,EAAE,OAAO,QAAQ,mBAAmB,OAAO,QAAQ,YAAY;AACjE,gBAAM,IAAI;AAAA,YACR,6BAA6B,OAAO,QAAQ,eAAe;AAAA,UAC7D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,QAAI,eAAe,MAAM,GAAG;AAE1B,UAAI,CAAC,OAAO,cAAc;AACxB,cAAM,IAAI,0BAA0B,0BAA0B;AAAA,MAChE;AAGA,UACE,OAAO,OAAO,iBAAiB,YAC/B,CAAC,OAAO,aAAa,eACrB;AACA,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAGA,UAAI,CAAC,OAAO,aAAa,OAAO;AAC9B,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAGA,UAAI,CAAC,cAAc,OAAO,aAAa,MAAM,EAAE,GAAG;AAChD,cAAM,IAAI;AAAA,UACR,yBAAyB,OAAO,OAAO,aAAa,MAAM,EAAE,CAAC;AAAA,QAC/D;AAAA,MACF;AAAA,IACF,WAAW,cAAc,MAAM,GAAG;AAEhC,UAAI,CAAC,cAAc,OAAO,OAAO,GAAG;AAClC,cAAM,IAAI;AAAA,UACR,yBAAyB,OAAO,OAAO,OAAO,CAAC;AAAA,QACjD;AAAA,MACF;AAGA,UAAI,OAAO,QAAQ;AACjB,YAAI,OAAO,OAAO,WAAW,UAAU;AACrC,gBAAM,IAAI,0BAA0B,yBAAyB;AAAA,QAC/D;AAEA,YAAI,OAAO,OAAO,KAAK,MAAM,IAAI;AAC/B,gBAAM,IAAI,0BAA0B,wBAAwB;AAAA,QAC9D;AAGA,YAAI;AACF,cAAI,IAAI,OAAO,MAAM;AAAA,QACvB,QAAQ;AACN,gBAAM,IAAI,0BAA0B,4BAA4B;AAAA,QAClE;AAAA,MACF;AAGA,UAAI,OAAO,SAAS;AAClB,YAAI,OAAO,OAAO,YAAY,YAAY,CAAC,OAAO,QAAQ,SAAS;AACjE,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,IAAI,UAAkB;AACpB,WAAO,KAAK,SAAS,WAAW;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,IAAI,YAAoB;AACtB,WAAO,KAAK,SAAS,aAAa;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,iBAAmC;AACvC,QAAI,CAAC,KAAK,aAAa,SAAS;AAC9B,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AAEA,UAAM,EAAE,QAAQ,IAAI,KAAK;AAGzB,QAAI,OAAO,YAAY,UAAU;AAC/B,aAAO;AAAA,IACT;AAGA,QAAI,OAAO,YAAY,YAAY,QAAQ,SAAS;AAClD,aAAO,QAAQ;AAAA,IACjB;AAEA,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,YAA2B;AACzB,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,WAAW,KAAK;AAAA,MAChB,kBAAkB,KAAK;AAAA,MACvB,kBAAkB,KAAK,gBAAgB,oBAAoB,KAAK,CAAC;AAAA,MACjE,wBAAwB,KAAK,gBAAgB,0BAA0B;AAAA,IACzE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,mBAAmB,SAAoC;AACrD,SAAK,WAAW;AAAA,EAIlB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,qBAA0C;AACxC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCA,MAAa,YAAY,MAAqB,KAA4B;AACxE,WAAO,yBAAyB,MAAM,KAAK,KAAK,QAAQ;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoDA,MAAa,YACX,eACA,iBACe;AACf,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,MAAa,iBACX,QACA,SACuB;AACvB,WAAO,KAAK,OAAO,iBAAiB,QAAQ,OAAO;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BA,MAAa,0BACX,WACA,SAC6B;AAC7B,UAAM,OAAO,OAAO,cAAc,WAAW,YAAY,UAAU;AAEnE,WAAO,KAAK,aAAa,0BAA0B;AAAA,MACjD;AAAA,MACA,eAAe,SAAS;AAAA,MACxB,iBAAiB,SAAS;AAAA,MAC1B,SAAS,SAAS;AAAA,IACpB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,MAAa,yBACX,aACA,SACuC;AAEvC,UAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,8BAA8B;AAGxE,UAAM,UAAU,MAAM,KAAK;AAAA,MACzB,YAAY;AAAA,MACZ;AAAA,IACF;AAGA,UAAM,SAAS,iBAAiB,aAAa,OAAO;AAIpD,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/crypto/ecies/__tests__/base.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for BaseECIES protected methods and utilities
+ */
+export {};

package/dist/crypto/ecies/__tests__/compatibility.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ECIES Compatibility Test Suite
+ *
+ * Verifies that our new ECIES implementation is 100% compatible with eccrypto.
+ * Uses pre-generated test vectors from eccrypto to ensure backward compatibility
+ * with existing encrypted data in the Vana network.
+ */
+export {};

package/dist/crypto/ecies/__tests__/constants.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for ECIES constants and validation helpers
+ */
+export {};

package/dist/crypto/ecies/__tests__/native-parity.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Native secp256k1 Parity Tests
+ *
+ * Critical tests to ensure native secp256k1 produces identical results
+ * to @noble/secp256k1, especially for ECDH operations.
+ */
+export {};

package/dist/crypto/ecies/__tests__/normalization.test.d.ts

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

package/dist/crypto/ecies/__tests__/test-vectors.cjs

@@ -0,0 +1,102 @@
+"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 test_vectors_exports = {};
+__export(test_vectors_exports, {
+  eccryptoFormat: () => eccryptoFormat,
+  eccryptoTestVectors: () => eccryptoTestVectors
+});
+module.exports = __toCommonJS(test_vectors_exports);
+const eccryptoTestVectors = [
+  {
+    name: "Simple text message",
+    privateKey: "1878693c39d810ce44ee40f9fdd068a0414615e74a7ff58adaba74063b2402e4",
+    publicKey: "0486c0312c4609fc3d53c35cbd1b7af82c8900c056a0389e1697720e3b60284aa2996a6c16c9b65eeb830c9016c5ab49481a406c88666de95f8fc236d0cbb7bb79",
+    message: "48656c6c6f2c20454349455321",
+    encrypted: {
+      iv: "9da6a7f84a8a192eeb787fd5907bf23a",
+      ephemPublicKey: "0442fdf37e36007921c07e5447bdae847f04a46e7bde3f3c8cca37d2766633d8e52c734a183d5e61f24bd50c677c8bd9491ba46a29c97b5d3c4dce93477c66deb6",
+      ciphertext: "44070d8d4d2dc7ac70c77732c22b87aa",
+      mac: "901a65fb7c13995727904e99618d73de370d37913e0c33fc38c9c87737ccdf8a"
+    }
+  },
+  {
+    name: "Binary data (64 bytes)",
+    privateKey: "21796c4692ba9d34b7f273c0099b96625e8dec49ada0390724d23dc35f4986d1",
+    publicKey: "04ab33f0e766d672f89c844633eb491e1ce75bce281423c11e1247503374e42f4b3877fab9a5b762ac78c8a639a0277d178280e580ffa992056b6d2ed3679f18ef",
+    message: "0b35fb489cd6f2bd6ab923382053a2cffc1054371a8009cae0009a8fc4c75ecc52e937d6571ea9e29d40c29cffd2cf2a0a14021871017a6ac171e48d7feda637",
+    encrypted: {
+      iv: "a9e389c20c31d8aed19da6367a7d28e8",
+      ephemPublicKey: "04fd61f7e70726779fd8e13bcbd5a41d2d8d7e3d24053eef6493bbae390e05e1a6fce46b6012549edcc267c5b6aa64f747b9466bcf086695c5a1344dcb187c41a2",
+      ciphertext: "1c233cdaa6514370daaf3371c2f566522181c115bb445883caa0e97d205a46741c1d0726901da59978c346da826ccd7ff4c1d92742f43adef98faf5f7498c3ad811d3dda1f5e8be425051d4fb973bc3c",
+      mac: "f18a5a0338c4a9c1b5242949873095a6d0ef2707918d05d89f745f27ed119c73"
+    }
+  },
+  {
+    name: "Large data (1KB)",
+    privateKey: "ae1a9ea14589c1d18c6f4c9683d4ee970d389cac2844cece049e1a2f5ee3f62e",
+    publicKey: "045c0e8e526fba2c2aa05834c06db12d737bcb899f7763d46690f36eadb490c3ba4cdaf0bcb8799b903378dc5f9d350bbe3b935e5f323be3d477c9deb4fdb05212",
+    message: "faab9c147b1f99687b418fd3e3fc5b9365aa16b5098c32e9db14ff0e79cc1fa36ab8454686a5ef2484479d1e4eb9a611996c26d3a0db5783dc152fa375114ca9fda31db7f7d3fa4db79b8607797cb3c7e5b8964f9ac65e1c4f2f039d39c4ac4ea708f37f578a19efe03b502a44d1aa092530f3f1129ba9972af48ff22376605bb9b9070602f6cc1f929129dff4c1a41c91339b613014e5aedf4ac83e67353e6005bc6c432610b10aa1d3a57a4e4083d57994f47e0b10dca68e7a7759e882ccc07712407d428b3236aca46c0d33e05cde10731f205dd89982afa2bd3df9ee04677de68e3a8fb8ec3cb18add7ff94b5dfc6eaf8d3df9650703ffe00349af79495059e7de7805813d51616228a5e4d18e85967b3c9838141b286be56ccb373f53952fbbc99f0e3bfbdf4107c917ab5ea6cd87bba0a0cef53ff3b64580a843005426d685a467196707386e52b3f1aa0af2dacf8e8df5479bc1a26923c5c39469ac562798357ecea355e740bc370ae623acadfeac0f42e3bf8ee2dac60cd1898bbcfea1ddbc54b3acebf5dd089fdbe9764d1577bec35b31ec14260ae62bbbad3e8748025abfece65a5986e1bd86446ca7c56789b6e7356538a75ac56c8ac14450ef62ae19fab518061cba066b90ac3e380d7526d8ab0e82bfa13a65dd0e5994610fb2beb1f324ca7beff4ca1466bc74e0a5f8d548a3f8f5681979130b890f03473564dc5a3b1374ca9e39def4ecde100e484816af89ed4d59aef54ffc51b075fa917d28412ad49eb3a79fb036b5caa101f46a61936cd7cf68dfd943547d3f34b19b6ae7c3a73cbebca8189708fa9a78a42f7ca121683a7f1dba1e70ac79fb7b51bae3392f5ea7872f11b74fdb135e090834136048680a077ab4cbfd9da21f39f51b26d83aed8786da2d803994089706518254beaff040a50b565d5d8ee7d93923102dcbb2514bf54f61d1546e88da96b407eda179ef7fbc2535342e24ae12fb4e7835c611b3ac588e2c2419b1215083e7b4023d2926e67aed81d475618b819c941e4f279d237b50cfff94149dc1f6066bdcdf808d14b7e7dddfd319202755494df8e06f677209c9f864fcf15247b947eca71d87e7d6f77581bbec95363e8ed6b5dc601f206cb61309c7d440fa6941bcd00b20ac45f42916712e9ec7951bd3e4d3d97382f570b0679519a8cde90a6a2ff37b5c34ecc155be5f8a900aad21e69ecf605cc5a30a8cb11e7ec748ade5033e2ef649b1bc0f09e910589dbd8f8144138365e636474dad70edcc8b83ba5f83bf5123a2cf40d3409fcc8927cea503780c7d0f2a34496a3c2669ca1f26a4bcfe5dc008e4504a226e0a38735c1b78a628e6283e4808718f304ebbcb9fa84c6c3c4080a9e6a4c252582e508d2336080a461fc2dc6216a2e006d2d35cbb837b7f85282d110c37bd5710d3fe388f7edca3e17a334a85",
+    encrypted: {
+      iv: "fb1452dae55b431b99a88376dbd732b8",
+      ephemPublicKey: "04698c369bf59ef9477d1aa837cd384eb7768e76de2de7fc37d5b5abe1c7f81cd37453359979b7fc3947dd2bd499fe01bcaab265b0970f99150380f48ecfe5fc13",
+      ciphertext: "87eb187e200fe08714ff110586afcce49f3f98045f44b6c5f752b25550cc96323808200b7e766cbc8af9b704252eaca6aeddbd4fc1da03118afb525c8fda4fdd354250f965a8ab02d1d66fb624ccaffa033aa7db4e151833075a81ecd43483f05e4bb8f46e4f1e5ea780ff0bcee3bc31d0d41851a43184e9e0bd499b03750445b8467a4085b056381ac04a11fda032b96fb1c90cf3c05bc3470a319568b8ddc993f822f7366e11ce326b5d9da9c72039a6e8746382f10c8bd8e1637d61c75bec11121457e29fabcc2a17ac613f5c8a2dcab3f3c1b2687f5c66deb29f95f0f4e1c83ce2c8d65a7f5139c04110f691e8d4eafa4f6891a6da1fa5f575e5c4fe7c350bffbd43df796b40b7d2804b883572695c2d1a384517500a42b10ecb512f4fba28f90a7c745f2dcd7193dfe91439aa54864be5273cd18e07c28c9fd117682765a78f8aae43edc378388098622628fbc7b7824a70dc8599400d45a850130e52363e8e1818626079e31593e67a2f5e1a5eae17dd52ca03680676b7db18bd0295a8f24ced48e5b57b7112fd4931898a5f8866b08ad4f647925586e16a3bb775316cde7bc298725e4c0fb0d66421e6dfde9d495bc3e4f7eea20fa184e2befd7499158e135e43afff610d310c9318a7c61858b09d51a7878dec4976d7647ab548819e91abb01971a77869ee16282b18cf323d3853846e509434a69fce2f378e286fa9a85f43938d961b9b95c9936f21e70a2164db96d6d6e6fa23ea742559abc01ea1b82ff8bb855cb350d894581818640e0d563bdf8e14dd80a43f46f8213e18377be29f4bea6ce2b2f3038be944a61cd8d82c3bf738f3800189e5aa41e1ddad4d6c2fca33c67bc11d9fec2296e8bab773bbc8b1127b74764ba16fcfd40d28ca43f8e8fc9bca197d5571196296e674091ff2ac93839a01d5650d1dbf851cfb6726c65847b39b4ec781794e1f54e12ec837cf773b4313566f665f80a0db3f299891b7c25bb733d52f7c2199b614669a4ae2eff3e2bd99806487178864c7acab76fdf09a406ca117d83f0f412af66e05152d4339f3d2f705976419cb5e75bc5d5e13b279e3b6065b83f61a0bd891d7932dbe802ee5390fc7b7ca3d117c14f6c3786e3578545583eef5107ea4fadf306c460c93bc1f96df692c988e9ce22329eec36bafbb8cfa3ddb30e3e33d71eb86830f54cf2a680b127f65e96b3842f966c466c705ce64450ab8d885f68c645046fbff85914f94ed72b92937d70f686abd933183974dc1086af958322d375d1728cea8902e00a0600f12c6b593f1382c61f97233bba6cd45392690a1c5d03f1b4aadacd1e723a5785850bb79d9e3f341e388b099947b61cf9ac83db5b8f01c888f245ed6a23f8dc519920b52576670ee567a923e68bd32a7c2ac364c342551060de4efcba0a078c40c7a8ec9db4a03bf5cc578ece351c6da0553341bbc89bb871c90ab2a45",
+      mac: "faafe7a325f36260015408ef2d859f71628cb7ff5287c6f3ccf6eadba27abe3f"
+    }
+  },
+  {
+    name: "UTF-8 text with special characters",
+    privateKey: "d447811abc5bae2fd9c53f97569c50338108154cfa36f18fdbc300bcad37f493",
+    publicKey: "045cb6eecff8afd418c2e590a956dae270a0342a9b1c9180f1500f7719da4b17702eed93f08415ebcf65036af2dc14f677e79aaa1cff54828285ff8686bc6c72bc",
+    message: "48656c6c6f20e4b896e7958c2120f09f8e89205370656369616c2063686172733a20c3a0c3a9c3aec3b5c3bc",
+    messageText: "Hello \u4E16\u754C! \u{1F389} Special chars: \xE0\xE9\xEE\xF5\xFC",
+    encrypted: {
+      iv: "a6f108c025f8e041a79f085aa42e2a92",
+      ephemPublicKey: "041cfe2092b3d086b60b15a74ab9850878d02dfb0b72976e593027fb6cfdef2634fffdd67639b02bd8c1ed222d22f3eaf8b2f262c38415ddc97629fc7c818670d7",
+      ciphertext: "5b675b04b3a7d93883a9dc0962b47d421966a8fe400c2125b17d30e93b6a8999fb8fe7e82bf7c63fd08092debaafba3c",
+      mac: "e786868550c316b5f31f696bf1aa2f7c59b795033456205f71603cc4d3a0a95b"
+    }
+  },
+  {
+    name: "Known private key test",
+    privateKey: "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    publicKey: "04bb50e2d89a4ed70663d080659fe0ad4b9bc3e06c17a227433966cb59ceee020decddbf6e00192011648d13b1c00af770c0c1bb609d4d3a5c98a43772e0e18ef4",
+    message: "54657374206d6573736167652077697468206b6e6f776e206b6579",
+    messageText: "Test message with known key",
+    encrypted: {
+      iv: "c8dffc7f392098524aa6acec38f36835",
+      ephemPublicKey: "04b663805d764f8cde462c54019dc76d2f4ec6389f2ee5ca6bf9e13d12fc75c059390c624ae7d35ef2fd6bea4f5a93ccc0fc3a505d222490d9091de379cf2bd3c4",
+      ciphertext: "2beecd177fffa8e07bd1119a208d3303a5a4b24f516b03876bbd319f4b32f1ec",
+      mac: "ace56259ef19fe19aee629eac25327a6b4832ae258521e4dc41823dde910e86d"
+    }
+  }
+];
+const eccryptoFormat = {
+  ivLength: 16,
+  ephemPublicKeyLength: 65,
+  // Uncompressed
+  macLength: 32,
+  // Format: iv || ephemPublicKey || ciphertext || mac
+  getFormatLength: (ciphertextLength) => 16 + 65 + ciphertextLength + 32
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  eccryptoFormat,
+  eccryptoTestVectors
+});
+//# sourceMappingURL=test-vectors.cjs.map

package/dist/crypto/ecies/__tests__/test-vectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/crypto/ecies/__tests__/test-vectors.ts"],"sourcesContent":["/**\n * Test vectors generated from eccrypto for compatibility verification\n * Generated on: 2025-08-17T15:03:45.067Z\n * eccrypto version: 1.1.6\n *\n * These vectors ensure our ECIES implementation is compatible with eccrypto\n */\n\nexport const eccryptoTestVectors = [\n  {\n    name: \"Simple text message\",\n    privateKey:\n      \"1878693c39d810ce44ee40f9fdd068a0414615e74a7ff58adaba74063b2402e4\",\n    publicKey:\n      \"0486c0312c4609fc3d53c35cbd1b7af82c8900c056a0389e1697720e3b60284aa2996a6c16c9b65eeb830c9016c5ab49481a406c88666de95f8fc236d0cbb7bb79\",\n    message: \"48656c6c6f2c20454349455321\",\n    encrypted: {\n      iv: \"9da6a7f84a8a192eeb787fd5907bf23a\",\n      ephemPublicKey:\n        \"0442fdf37e36007921c07e5447bdae847f04a46e7bde3f3c8cca37d2766633d8e52c734a183d5e61f24bd50c677c8bd9491ba46a29c97b5d3c4dce93477c66deb6\",\n      ciphertext: \"44070d8d4d2dc7ac70c77732c22b87aa\",\n      mac: \"901a65fb7c13995727904e99618d73de370d37913e0c33fc38c9c87737ccdf8a\",\n    },\n  },\n  {\n    name: \"Binary data (64 bytes)\",\n    privateKey:\n      \"21796c4692ba9d34b7f273c0099b96625e8dec49ada0390724d23dc35f4986d1\",\n    publicKey:\n      \"04ab33f0e766d672f89c844633eb491e1ce75bce281423c11e1247503374e42f4b3877fab9a5b762ac78c8a639a0277d178280e580ffa992056b6d2ed3679f18ef\",\n    message:\n      \"0b35fb489cd6f2bd6ab923382053a2cffc1054371a8009cae0009a8fc4c75ecc52e937d6571ea9e29d40c29cffd2cf2a0a14021871017a6ac171e48d7feda637\",\n    encrypted: {\n      iv: \"a9e389c20c31d8aed19da6367a7d28e8\",\n      ephemPublicKey:\n        \"04fd61f7e70726779fd8e13bcbd5a41d2d8d7e3d24053eef6493bbae390e05e1a6fce46b6012549edcc267c5b6aa64f747b9466bcf086695c5a1344dcb187c41a2\",\n      ciphertext:\n        \"1c233cdaa6514370daaf3371c2f566522181c115bb445883caa0e97d205a46741c1d0726901da59978c346da826ccd7ff4c1d92742f43adef98faf5f7498c3ad811d3dda1f5e8be425051d4fb973bc3c\",\n      mac: \"f18a5a0338c4a9c1b5242949873095a6d0ef2707918d05d89f745f27ed119c73\",\n    },\n  },\n  {\n    name: \"Large data (1KB)\",\n    privateKey:\n      \"ae1a9ea14589c1d18c6f4c9683d4ee970d389cac2844cece049e1a2f5ee3f62e\",\n    publicKey:\n      \"045c0e8e526fba2c2aa05834c06db12d737bcb899f7763d46690f36eadb490c3ba4cdaf0bcb8799b903378dc5f9d350bbe3b935e5f323be3d477c9deb4fdb05212\",\n    message:\n      \"faab9c147b1f99687b418fd3e3fc5b9365aa16b5098c32e9db14ff0e79cc1fa36ab8454686a5ef2484479d1e4eb9a611996c26d3a0db5783dc152fa375114ca9fda31db7f7d3fa4db79b8607797cb3c7e5b8964f9ac65e1c4f2f039d39c4ac4ea708f37f578a19efe03b502a44d1aa092530f3f1129ba9972af48ff22376605bb9b9070602f6cc1f929129dff4c1a41c91339b613014e5aedf4ac83e67353e6005bc6c432610b10aa1d3a57a4e4083d57994f47e0b10dca68e7a7759e882ccc07712407d428b3236aca46c0d33e05cde10731f205dd89982afa2bd3df9ee04677de68e3a8fb8ec3cb18add7ff94b5dfc6eaf8d3df9650703ffe00349af79495059e7de7805813d51616228a5e4d18e85967b3c9838141b286be56ccb373f53952fbbc99f0e3bfbdf4107c917ab5ea6cd87bba0a0cef53ff3b64580a843005426d685a467196707386e52b3f1aa0af2dacf8e8df5479bc1a26923c5c39469ac562798357ecea355e740bc370ae623acadfeac0f42e3bf8ee2dac60cd1898bbcfea1ddbc54b3acebf5dd089fdbe9764d1577bec35b31ec14260ae62bbbad3e8748025abfece65a5986e1bd86446ca7c56789b6e7356538a75ac56c8ac14450ef62ae19fab518061cba066b90ac3e380d7526d8ab0e82bfa13a65dd0e5994610fb2beb1f324ca7beff4ca1466bc74e0a5f8d548a3f8f5681979130b890f03473564dc5a3b1374ca9e39def4ecde100e484816af89ed4d59aef54ffc51b075fa917d28412ad49eb3a79fb036b5caa101f46a61936cd7cf68dfd943547d3f34b19b6ae7c3a73cbebca8189708fa9a78a42f7ca121683a7f1dba1e70ac79fb7b51bae3392f5ea7872f11b74fdb135e090834136048680a077ab4cbfd9da21f39f51b26d83aed8786da2d803994089706518254beaff040a50b565d5d8ee7d93923102dcbb2514bf54f61d1546e88da96b407eda179ef7fbc2535342e24ae12fb4e7835c611b3ac588e2c2419b1215083e7b4023d2926e67aed81d475618b819c941e4f279d237b50cfff94149dc1f6066bdcdf808d14b7e7dddfd319202755494df8e06f677209c9f864fcf15247b947eca71d87e7d6f77581bbec95363e8ed6b5dc601f206cb61309c7d440fa6941bcd00b20ac45f42916712e9ec7951bd3e4d3d97382f570b0679519a8cde90a6a2ff37b5c34ecc155be5f8a900aad21e69ecf605cc5a30a8cb11e7ec748ade5033e2ef649b1bc0f09e910589dbd8f8144138365e636474dad70edcc8b83ba5f83bf5123a2cf40d3409fcc8927cea503780c7d0f2a34496a3c2669ca1f26a4bcfe5dc008e4504a226e0a38735c1b78a628e6283e4808718f304ebbcb9fa84c6c3c4080a9e6a4c252582e508d2336080a461fc2dc6216a2e006d2d35cbb837b7f85282d110c37bd5710d3fe388f7edca3e17a334a85\",\n    encrypted: {\n      iv: \"fb1452dae55b431b99a88376dbd732b8\",\n      ephemPublicKey:\n        \"04698c369bf59ef9477d1aa837cd384eb7768e76de2de7fc37d5b5abe1c7f81cd37453359979b7fc3947dd2bd499fe01bcaab265b0970f99150380f48ecfe5fc13\",\n      ciphertext:\n        \"87eb187e200fe08714ff110586afcce49f3f98045f44b6c5f752b25550cc96323808200b7e766cbc8af9b704252eaca6aeddbd4fc1da03118afb525c8fda4fdd354250f965a8ab02d1d66fb624ccaffa033aa7db4e151833075a81ecd43483f05e4bb8f46e4f1e5ea780ff0bcee3bc31d0d41851a43184e9e0bd499b03750445b8467a4085b056381ac04a11fda032b96fb1c90cf3c05bc3470a319568b8ddc993f822f7366e11ce326b5d9da9c72039a6e8746382f10c8bd8e1637d61c75bec11121457e29fabcc2a17ac613f5c8a2dcab3f3c1b2687f5c66deb29f95f0f4e1c83ce2c8d65a7f5139c04110f691e8d4eafa4f6891a6da1fa5f575e5c4fe7c350bffbd43df796b40b7d2804b883572695c2d1a384517500a42b10ecb512f4fba28f90a7c745f2dcd7193dfe91439aa54864be5273cd18e07c28c9fd117682765a78f8aae43edc378388098622628fbc7b7824a70dc8599400d45a850130e52363e8e1818626079e31593e67a2f5e1a5eae17dd52ca03680676b7db18bd0295a8f24ced48e5b57b7112fd4931898a5f8866b08ad4f647925586e16a3bb775316cde7bc298725e4c0fb0d66421e6dfde9d495bc3e4f7eea20fa184e2befd7499158e135e43afff610d310c9318a7c61858b09d51a7878dec4976d7647ab548819e91abb01971a77869ee16282b18cf323d3853846e509434a69fce2f378e286fa9a85f43938d961b9b95c9936f21e70a2164db96d6d6e6fa23ea742559abc01ea1b82ff8bb855cb350d894581818640e0d563bdf8e14dd80a43f46f8213e18377be29f4bea6ce2b2f3038be944a61cd8d82c3bf738f3800189e5aa41e1ddad4d6c2fca33c67bc11d9fec2296e8bab773bbc8b1127b74764ba16fcfd40d28ca43f8e8fc9bca197d5571196296e674091ff2ac93839a01d5650d1dbf851cfb6726c65847b39b4ec781794e1f54e12ec837cf773b4313566f665f80a0db3f299891b7c25bb733d52f7c2199b614669a4ae2eff3e2bd99806487178864c7acab76fdf09a406ca117d83f0f412af66e05152d4339f3d2f705976419cb5e75bc5d5e13b279e3b6065b83f61a0bd891d7932dbe802ee5390fc7b7ca3d117c14f6c3786e3578545583eef5107ea4fadf306c460c93bc1f96df692c988e9ce22329eec36bafbb8cfa3ddb30e3e33d71eb86830f54cf2a680b127f65e96b3842f966c466c705ce64450ab8d885f68c645046fbff85914f94ed72b92937d70f686abd933183974dc1086af958322d375d1728cea8902e00a0600f12c6b593f1382c61f97233bba6cd45392690a1c5d03f1b4aadacd1e723a5785850bb79d9e3f341e388b099947b61cf9ac83db5b8f01c888f245ed6a23f8dc519920b52576670ee567a923e68bd32a7c2ac364c342551060de4efcba0a078c40c7a8ec9db4a03bf5cc578ece351c6da0553341bbc89bb871c90ab2a45\",\n      mac: \"faafe7a325f36260015408ef2d859f71628cb7ff5287c6f3ccf6eadba27abe3f\",\n    },\n  },\n  {\n    name: \"UTF-8 text with special characters\",\n    privateKey:\n      \"d447811abc5bae2fd9c53f97569c50338108154cfa36f18fdbc300bcad37f493\",\n    publicKey:\n      \"045cb6eecff8afd418c2e590a956dae270a0342a9b1c9180f1500f7719da4b17702eed93f08415ebcf65036af2dc14f677e79aaa1cff54828285ff8686bc6c72bc\",\n    message:\n      \"48656c6c6f20e4b896e7958c2120f09f8e89205370656369616c2063686172733a20c3a0c3a9c3aec3b5c3bc\",\n    messageText: \"Hello 世界! 🎉 Special chars: àéîõü\",\n    encrypted: {\n      iv: \"a6f108c025f8e041a79f085aa42e2a92\",\n      ephemPublicKey:\n        \"041cfe2092b3d086b60b15a74ab9850878d02dfb0b72976e593027fb6cfdef2634fffdd67639b02bd8c1ed222d22f3eaf8b2f262c38415ddc97629fc7c818670d7\",\n      ciphertext:\n        \"5b675b04b3a7d93883a9dc0962b47d421966a8fe400c2125b17d30e93b6a8999fb8fe7e82bf7c63fd08092debaafba3c\",\n      mac: \"e786868550c316b5f31f696bf1aa2f7c59b795033456205f71603cc4d3a0a95b\",\n    },\n  },\n  {\n    name: \"Known private key test\",\n    privateKey:\n      \"1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n    publicKey:\n      \"04bb50e2d89a4ed70663d080659fe0ad4b9bc3e06c17a227433966cb59ceee020decddbf6e00192011648d13b1c00af770c0c1bb609d4d3a5c98a43772e0e18ef4\",\n    message: \"54657374206d6573736167652077697468206b6e6f776e206b6579\",\n    messageText: \"Test message with known key\",\n    encrypted: {\n      iv: \"c8dffc7f392098524aa6acec38f36835\",\n      ephemPublicKey:\n        \"04b663805d764f8cde462c54019dc76d2f4ec6389f2ee5ca6bf9e13d12fc75c059390c624ae7d35ef2fd6bea4f5a93ccc0fc3a505d222490d9091de379cf2bd3c4\",\n      ciphertext:\n        \"2beecd177fffa8e07bd1119a208d3303a5a4b24f516b03876bbd319f4b32f1ec\",\n      mac: \"ace56259ef19fe19aee629eac25327a6b4832ae258521e4dc41823dde910e86d\",\n    },\n  },\n];\n\nexport const eccryptoFormat = {\n  ivLength: 16,\n  ephemPublicKeyLength: 65, // Uncompressed\n  macLength: 32,\n  // Format: iv || ephemPublicKey || ciphertext || mac\n  getFormatLength: (ciphertextLength: number) =>\n    16 + 65 + ciphertextLength + 32,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,MAAM,sBAAsB;AAAA,EACjC;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SAAS;AAAA,IACT,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YAAY;AAAA,MACZ,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,aAAa;AAAA,IACb,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SAAS;AAAA,IACT,aAAa;AAAA,IACb,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AACF;AAEO,MAAM,iBAAiB;AAAA,EAC5B,UAAU;AAAA,EACV,sBAAsB;AAAA;AAAA,EACtB,WAAW;AAAA;AAAA,EAEX,iBAAiB,CAAC,qBAChB,KAAK,KAAK,mBAAmB;AACjC;","names":[]}

package/dist/crypto/ecies/__tests__/test-vectors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Test vectors generated from eccrypto for compatibility verification
+ * Generated on: 2025-08-17T15:03:45.067Z
+ * eccrypto version: 1.1.6
+ *
+ * These vectors ensure our ECIES implementation is compatible with eccrypto
+ */
+export declare const eccryptoTestVectors: ({
+    name: string;
+    privateKey: string;
+    publicKey: string;
+    message: string;
+    encrypted: {
+        iv: string;
+        ephemPublicKey: string;
+        ciphertext: string;
+        mac: string;
+    };
+    messageText?: undefined;
+} | {
+    name: string;
+    privateKey: string;
+    publicKey: string;
+    message: string;
+    messageText: string;
+    encrypted: {
+        iv: string;
+        ephemPublicKey: string;
+        ciphertext: string;
+        mac: string;
+    };
+})[];
+export declare const eccryptoFormat: {
+    ivLength: number;
+    ephemPublicKeyLength: number;
+    macLength: number;
+    getFormatLength: (ciphertextLength: number) => number;
+};

package/dist/crypto/ecies/__tests__/test-vectors.js

@@ -0,0 +1,77 @@
+const eccryptoTestVectors = [
+  {
+    name: "Simple text message",
+    privateKey: "1878693c39d810ce44ee40f9fdd068a0414615e74a7ff58adaba74063b2402e4",
+    publicKey: "0486c0312c4609fc3d53c35cbd1b7af82c8900c056a0389e1697720e3b60284aa2996a6c16c9b65eeb830c9016c5ab49481a406c88666de95f8fc236d0cbb7bb79",
+    message: "48656c6c6f2c20454349455321",
+    encrypted: {
+      iv: "9da6a7f84a8a192eeb787fd5907bf23a",
+      ephemPublicKey: "0442fdf37e36007921c07e5447bdae847f04a46e7bde3f3c8cca37d2766633d8e52c734a183d5e61f24bd50c677c8bd9491ba46a29c97b5d3c4dce93477c66deb6",
+      ciphertext: "44070d8d4d2dc7ac70c77732c22b87aa",
+      mac: "901a65fb7c13995727904e99618d73de370d37913e0c33fc38c9c87737ccdf8a"
+    }
+  },
+  {
+    name: "Binary data (64 bytes)",
+    privateKey: "21796c4692ba9d34b7f273c0099b96625e8dec49ada0390724d23dc35f4986d1",
+    publicKey: "04ab33f0e766d672f89c844633eb491e1ce75bce281423c11e1247503374e42f4b3877fab9a5b762ac78c8a639a0277d178280e580ffa992056b6d2ed3679f18ef",
+    message: "0b35fb489cd6f2bd6ab923382053a2cffc1054371a8009cae0009a8fc4c75ecc52e937d6571ea9e29d40c29cffd2cf2a0a14021871017a6ac171e48d7feda637",
+    encrypted: {
+      iv: "a9e389c20c31d8aed19da6367a7d28e8",
+      ephemPublicKey: "04fd61f7e70726779fd8e13bcbd5a41d2d8d7e3d24053eef6493bbae390e05e1a6fce46b6012549edcc267c5b6aa64f747b9466bcf086695c5a1344dcb187c41a2",
+      ciphertext: "1c233cdaa6514370daaf3371c2f566522181c115bb445883caa0e97d205a46741c1d0726901da59978c346da826ccd7ff4c1d92742f43adef98faf5f7498c3ad811d3dda1f5e8be425051d4fb973bc3c",
+      mac: "f18a5a0338c4a9c1b5242949873095a6d0ef2707918d05d89f745f27ed119c73"
+    }
+  },
+  {
+    name: "Large data (1KB)",
+    privateKey: "ae1a9ea14589c1d18c6f4c9683d4ee970d389cac2844cece049e1a2f5ee3f62e",
+    publicKey: "045c0e8e526fba2c2aa05834c06db12d737bcb899f7763d46690f36eadb490c3ba4cdaf0bcb8799b903378dc5f9d350bbe3b935e5f323be3d477c9deb4fdb05212",
+    message: "faab9c147b1f99687b418fd3e3fc5b9365aa16b5098c32e9db14ff0e79cc1fa36ab8454686a5ef2484479d1e4eb9a611996c26d3a0db5783dc152fa375114ca9fda31db7f7d3fa4db79b8607797cb3c7e5b8964f9ac65e1c4f2f039d39c4ac4ea708f37f578a19efe03b502a44d1aa092530f3f1129ba9972af48ff22376605bb9b9070602f6cc1f929129dff4c1a41c91339b613014e5aedf4ac83e67353e6005bc6c432610b10aa1d3a57a4e4083d57994f47e0b10dca68e7a7759e882ccc07712407d428b3236aca46c0d33e05cde10731f205dd89982afa2bd3df9ee04677de68e3a8fb8ec3cb18add7ff94b5dfc6eaf8d3df9650703ffe00349af79495059e7de7805813d51616228a5e4d18e85967b3c9838141b286be56ccb373f53952fbbc99f0e3bfbdf4107c917ab5ea6cd87bba0a0cef53ff3b64580a843005426d685a467196707386e52b3f1aa0af2dacf8e8df5479bc1a26923c5c39469ac562798357ecea355e740bc370ae623acadfeac0f42e3bf8ee2dac60cd1898bbcfea1ddbc54b3acebf5dd089fdbe9764d1577bec35b31ec14260ae62bbbad3e8748025abfece65a5986e1bd86446ca7c56789b6e7356538a75ac56c8ac14450ef62ae19fab518061cba066b90ac3e380d7526d8ab0e82bfa13a65dd0e5994610fb2beb1f324ca7beff4ca1466bc74e0a5f8d548a3f8f5681979130b890f03473564dc5a3b1374ca9e39def4ecde100e484816af89ed4d59aef54ffc51b075fa917d28412ad49eb3a79fb036b5caa101f46a61936cd7cf68dfd943547d3f34b19b6ae7c3a73cbebca8189708fa9a78a42f7ca121683a7f1dba1e70ac79fb7b51bae3392f5ea7872f11b74fdb135e090834136048680a077ab4cbfd9da21f39f51b26d83aed8786da2d803994089706518254beaff040a50b565d5d8ee7d93923102dcbb2514bf54f61d1546e88da96b407eda179ef7fbc2535342e24ae12fb4e7835c611b3ac588e2c2419b1215083e7b4023d2926e67aed81d475618b819c941e4f279d237b50cfff94149dc1f6066bdcdf808d14b7e7dddfd319202755494df8e06f677209c9f864fcf15247b947eca71d87e7d6f77581bbec95363e8ed6b5dc601f206cb61309c7d440fa6941bcd00b20ac45f42916712e9ec7951bd3e4d3d97382f570b0679519a8cde90a6a2ff37b5c34ecc155be5f8a900aad21e69ecf605cc5a30a8cb11e7ec748ade5033e2ef649b1bc0f09e910589dbd8f8144138365e636474dad70edcc8b83ba5f83bf5123a2cf40d3409fcc8927cea503780c7d0f2a34496a3c2669ca1f26a4bcfe5dc008e4504a226e0a38735c1b78a628e6283e4808718f304ebbcb9fa84c6c3c4080a9e6a4c252582e508d2336080a461fc2dc6216a2e006d2d35cbb837b7f85282d110c37bd5710d3fe388f7edca3e17a334a85",
+    encrypted: {
+      iv: "fb1452dae55b431b99a88376dbd732b8",
+      ephemPublicKey: "04698c369bf59ef9477d1aa837cd384eb7768e76de2de7fc37d5b5abe1c7f81cd37453359979b7fc3947dd2bd499fe01bcaab265b0970f99150380f48ecfe5fc13",
+      ciphertext: "87eb187e200fe08714ff110586afcce49f3f98045f44b6c5f752b25550cc96323808200b7e766cbc8af9b704252eaca6aeddbd4fc1da03118afb525c8fda4fdd354250f965a8ab02d1d66fb624ccaffa033aa7db4e151833075a81ecd43483f05e4bb8f46e4f1e5ea780ff0bcee3bc31d0d41851a43184e9e0bd499b03750445b8467a4085b056381ac04a11fda032b96fb1c90cf3c05bc3470a319568b8ddc993f822f7366e11ce326b5d9da9c72039a6e8746382f10c8bd8e1637d61c75bec11121457e29fabcc2a17ac613f5c8a2dcab3f3c1b2687f5c66deb29f95f0f4e1c83ce2c8d65a7f5139c04110f691e8d4eafa4f6891a6da1fa5f575e5c4fe7c350bffbd43df796b40b7d2804b883572695c2d1a384517500a42b10ecb512f4fba28f90a7c745f2dcd7193dfe91439aa54864be5273cd18e07c28c9fd117682765a78f8aae43edc378388098622628fbc7b7824a70dc8599400d45a850130e52363e8e1818626079e31593e67a2f5e1a5eae17dd52ca03680676b7db18bd0295a8f24ced48e5b57b7112fd4931898a5f8866b08ad4f647925586e16a3bb775316cde7bc298725e4c0fb0d66421e6dfde9d495bc3e4f7eea20fa184e2befd7499158e135e43afff610d310c9318a7c61858b09d51a7878dec4976d7647ab548819e91abb01971a77869ee16282b18cf323d3853846e509434a69fce2f378e286fa9a85f43938d961b9b95c9936f21e70a2164db96d6d6e6fa23ea742559abc01ea1b82ff8bb855cb350d894581818640e0d563bdf8e14dd80a43f46f8213e18377be29f4bea6ce2b2f3038be944a61cd8d82c3bf738f3800189e5aa41e1ddad4d6c2fca33c67bc11d9fec2296e8bab773bbc8b1127b74764ba16fcfd40d28ca43f8e8fc9bca197d5571196296e674091ff2ac93839a01d5650d1dbf851cfb6726c65847b39b4ec781794e1f54e12ec837cf773b4313566f665f80a0db3f299891b7c25bb733d52f7c2199b614669a4ae2eff3e2bd99806487178864c7acab76fdf09a406ca117d83f0f412af66e05152d4339f3d2f705976419cb5e75bc5d5e13b279e3b6065b83f61a0bd891d7932dbe802ee5390fc7b7ca3d117c14f6c3786e3578545583eef5107ea4fadf306c460c93bc1f96df692c988e9ce22329eec36bafbb8cfa3ddb30e3e33d71eb86830f54cf2a680b127f65e96b3842f966c466c705ce64450ab8d885f68c645046fbff85914f94ed72b92937d70f686abd933183974dc1086af958322d375d1728cea8902e00a0600f12c6b593f1382c61f97233bba6cd45392690a1c5d03f1b4aadacd1e723a5785850bb79d9e3f341e388b099947b61cf9ac83db5b8f01c888f245ed6a23f8dc519920b52576670ee567a923e68bd32a7c2ac364c342551060de4efcba0a078c40c7a8ec9db4a03bf5cc578ece351c6da0553341bbc89bb871c90ab2a45",
+      mac: "faafe7a325f36260015408ef2d859f71628cb7ff5287c6f3ccf6eadba27abe3f"
+    }
+  },
+  {
+    name: "UTF-8 text with special characters",
+    privateKey: "d447811abc5bae2fd9c53f97569c50338108154cfa36f18fdbc300bcad37f493",
+    publicKey: "045cb6eecff8afd418c2e590a956dae270a0342a9b1c9180f1500f7719da4b17702eed93f08415ebcf65036af2dc14f677e79aaa1cff54828285ff8686bc6c72bc",
+    message: "48656c6c6f20e4b896e7958c2120f09f8e89205370656369616c2063686172733a20c3a0c3a9c3aec3b5c3bc",
+    messageText: "Hello \u4E16\u754C! \u{1F389} Special chars: \xE0\xE9\xEE\xF5\xFC",
+    encrypted: {
+      iv: "a6f108c025f8e041a79f085aa42e2a92",
+      ephemPublicKey: "041cfe2092b3d086b60b15a74ab9850878d02dfb0b72976e593027fb6cfdef2634fffdd67639b02bd8c1ed222d22f3eaf8b2f262c38415ddc97629fc7c818670d7",
+      ciphertext: "5b675b04b3a7d93883a9dc0962b47d421966a8fe400c2125b17d30e93b6a8999fb8fe7e82bf7c63fd08092debaafba3c",
+      mac: "e786868550c316b5f31f696bf1aa2f7c59b795033456205f71603cc4d3a0a95b"
+    }
+  },
+  {
+    name: "Known private key test",
+    privateKey: "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    publicKey: "04bb50e2d89a4ed70663d080659fe0ad4b9bc3e06c17a227433966cb59ceee020decddbf6e00192011648d13b1c00af770c0c1bb609d4d3a5c98a43772e0e18ef4",
+    message: "54657374206d6573736167652077697468206b6e6f776e206b6579",
+    messageText: "Test message with known key",
+    encrypted: {
+      iv: "c8dffc7f392098524aa6acec38f36835",
+      ephemPublicKey: "04b663805d764f8cde462c54019dc76d2f4ec6389f2ee5ca6bf9e13d12fc75c059390c624ae7d35ef2fd6bea4f5a93ccc0fc3a505d222490d9091de379cf2bd3c4",
+      ciphertext: "2beecd177fffa8e07bd1119a208d3303a5a4b24f516b03876bbd319f4b32f1ec",
+      mac: "ace56259ef19fe19aee629eac25327a6b4832ae258521e4dc41823dde910e86d"
+    }
+  }
+];
+const eccryptoFormat = {
+  ivLength: 16,
+  ephemPublicKeyLength: 65,
+  // Uncompressed
+  macLength: 32,
+  // Format: iv || ephemPublicKey || ciphertext || mac
+  getFormatLength: (ciphertextLength) => 16 + 65 + ciphertextLength + 32
+};
+export {
+  eccryptoFormat,
+  eccryptoTestVectors
+};
+//# sourceMappingURL=test-vectors.js.map

package/dist/crypto/ecies/__tests__/test-vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/crypto/ecies/__tests__/test-vectors.ts"],"sourcesContent":["/**\n * Test vectors generated from eccrypto for compatibility verification\n * Generated on: 2025-08-17T15:03:45.067Z\n * eccrypto version: 1.1.6\n *\n * These vectors ensure our ECIES implementation is compatible with eccrypto\n */\n\nexport const eccryptoTestVectors = [\n  {\n    name: \"Simple text message\",\n    privateKey:\n      \"1878693c39d810ce44ee40f9fdd068a0414615e74a7ff58adaba74063b2402e4\",\n    publicKey:\n      \"0486c0312c4609fc3d53c35cbd1b7af82c8900c056a0389e1697720e3b60284aa2996a6c16c9b65eeb830c9016c5ab49481a406c88666de95f8fc236d0cbb7bb79\",\n    message: \"48656c6c6f2c20454349455321\",\n    encrypted: {\n      iv: \"9da6a7f84a8a192eeb787fd5907bf23a\",\n      ephemPublicKey:\n        \"0442fdf37e36007921c07e5447bdae847f04a46e7bde3f3c8cca37d2766633d8e52c734a183d5e61f24bd50c677c8bd9491ba46a29c97b5d3c4dce93477c66deb6\",\n      ciphertext: \"44070d8d4d2dc7ac70c77732c22b87aa\",\n      mac: \"901a65fb7c13995727904e99618d73de370d37913e0c33fc38c9c87737ccdf8a\",\n    },\n  },\n  {\n    name: \"Binary data (64 bytes)\",\n    privateKey:\n      \"21796c4692ba9d34b7f273c0099b96625e8dec49ada0390724d23dc35f4986d1\",\n    publicKey:\n      \"04ab33f0e766d672f89c844633eb491e1ce75bce281423c11e1247503374e42f4b3877fab9a5b762ac78c8a639a0277d178280e580ffa992056b6d2ed3679f18ef\",\n    message:\n      \"0b35fb489cd6f2bd6ab923382053a2cffc1054371a8009cae0009a8fc4c75ecc52e937d6571ea9e29d40c29cffd2cf2a0a14021871017a6ac171e48d7feda637\",\n    encrypted: {\n      iv: \"a9e389c20c31d8aed19da6367a7d28e8\",\n      ephemPublicKey:\n        \"04fd61f7e70726779fd8e13bcbd5a41d2d8d7e3d24053eef6493bbae390e05e1a6fce46b6012549edcc267c5b6aa64f747b9466bcf086695c5a1344dcb187c41a2\",\n      ciphertext:\n        \"1c233cdaa6514370daaf3371c2f566522181c115bb445883caa0e97d205a46741c1d0726901da59978c346da826ccd7ff4c1d92742f43adef98faf5f7498c3ad811d3dda1f5e8be425051d4fb973bc3c\",\n      mac: \"f18a5a0338c4a9c1b5242949873095a6d0ef2707918d05d89f745f27ed119c73\",\n    },\n  },\n  {\n    name: \"Large data (1KB)\",\n    privateKey:\n      \"ae1a9ea14589c1d18c6f4c9683d4ee970d389cac2844cece049e1a2f5ee3f62e\",\n    publicKey:\n      \"045c0e8e526fba2c2aa05834c06db12d737bcb899f7763d46690f36eadb490c3ba4cdaf0bcb8799b903378dc5f9d350bbe3b935e5f323be3d477c9deb4fdb05212\",\n    message:\n      \"faab9c147b1f99687b418fd3e3fc5b9365aa16b5098c32e9db14ff0e79cc1fa36ab8454686a5ef2484479d1e4eb9a611996c26d3a0db5783dc152fa375114ca9fda31db7f7d3fa4db79b8607797cb3c7e5b8964f9ac65e1c4f2f039d39c4ac4ea708f37f578a19efe03b502a44d1aa092530f3f1129ba9972af48ff22376605bb9b9070602f6cc1f929129dff4c1a41c91339b613014e5aedf4ac83e67353e6005bc6c432610b10aa1d3a57a4e4083d57994f47e0b10dca68e7a7759e882ccc07712407d428b3236aca46c0d33e05cde10731f205dd89982afa2bd3df9ee04677de68e3a8fb8ec3cb18add7ff94b5dfc6eaf8d3df9650703ffe00349af79495059e7de7805813d51616228a5e4d18e85967b3c9838141b286be56ccb373f53952fbbc99f0e3bfbdf4107c917ab5ea6cd87bba0a0cef53ff3b64580a843005426d685a467196707386e52b3f1aa0af2dacf8e8df5479bc1a26923c5c39469ac562798357ecea355e740bc370ae623acadfeac0f42e3bf8ee2dac60cd1898bbcfea1ddbc54b3acebf5dd089fdbe9764d1577bec35b31ec14260ae62bbbad3e8748025abfece65a5986e1bd86446ca7c56789b6e7356538a75ac56c8ac14450ef62ae19fab518061cba066b90ac3e380d7526d8ab0e82bfa13a65dd0e5994610fb2beb1f324ca7beff4ca1466bc74e0a5f8d548a3f8f5681979130b890f03473564dc5a3b1374ca9e39def4ecde100e484816af89ed4d59aef54ffc51b075fa917d28412ad49eb3a79fb036b5caa101f46a61936cd7cf68dfd943547d3f34b19b6ae7c3a73cbebca8189708fa9a78a42f7ca121683a7f1dba1e70ac79fb7b51bae3392f5ea7872f11b74fdb135e090834136048680a077ab4cbfd9da21f39f51b26d83aed8786da2d803994089706518254beaff040a50b565d5d8ee7d93923102dcbb2514bf54f61d1546e88da96b407eda179ef7fbc2535342e24ae12fb4e7835c611b3ac588e2c2419b1215083e7b4023d2926e67aed81d475618b819c941e4f279d237b50cfff94149dc1f6066bdcdf808d14b7e7dddfd319202755494df8e06f677209c9f864fcf15247b947eca71d87e7d6f77581bbec95363e8ed6b5dc601f206cb61309c7d440fa6941bcd00b20ac45f42916712e9ec7951bd3e4d3d97382f570b0679519a8cde90a6a2ff37b5c34ecc155be5f8a900aad21e69ecf605cc5a30a8cb11e7ec748ade5033e2ef649b1bc0f09e910589dbd8f8144138365e636474dad70edcc8b83ba5f83bf5123a2cf40d3409fcc8927cea503780c7d0f2a34496a3c2669ca1f26a4bcfe5dc008e4504a226e0a38735c1b78a628e6283e4808718f304ebbcb9fa84c6c3c4080a9e6a4c252582e508d2336080a461fc2dc6216a2e006d2d35cbb837b7f85282d110c37bd5710d3fe388f7edca3e17a334a85\",\n    encrypted: {\n      iv: \"fb1452dae55b431b99a88376dbd732b8\",\n      ephemPublicKey:\n        \"04698c369bf59ef9477d1aa837cd384eb7768e76de2de7fc37d5b5abe1c7f81cd37453359979b7fc3947dd2bd499fe01bcaab265b0970f99150380f48ecfe5fc13\",\n      ciphertext:\n        \"87eb187e200fe08714ff110586afcce49f3f98045f44b6c5f752b25550cc96323808200b7e766cbc8af9b704252eaca6aeddbd4fc1da03118afb525c8fda4fdd354250f965a8ab02d1d66fb624ccaffa033aa7db4e151833075a81ecd43483f05e4bb8f46e4f1e5ea780ff0bcee3bc31d0d41851a43184e9e0bd499b03750445b8467a4085b056381ac04a11fda032b96fb1c90cf3c05bc3470a319568b8ddc993f822f7366e11ce326b5d9da9c72039a6e8746382f10c8bd8e1637d61c75bec11121457e29fabcc2a17ac613f5c8a2dcab3f3c1b2687f5c66deb29f95f0f4e1c83ce2c8d65a7f5139c04110f691e8d4eafa4f6891a6da1fa5f575e5c4fe7c350bffbd43df796b40b7d2804b883572695c2d1a384517500a42b10ecb512f4fba28f90a7c745f2dcd7193dfe91439aa54864be5273cd18e07c28c9fd117682765a78f8aae43edc378388098622628fbc7b7824a70dc8599400d45a850130e52363e8e1818626079e31593e67a2f5e1a5eae17dd52ca03680676b7db18bd0295a8f24ced48e5b57b7112fd4931898a5f8866b08ad4f647925586e16a3bb775316cde7bc298725e4c0fb0d66421e6dfde9d495bc3e4f7eea20fa184e2befd7499158e135e43afff610d310c9318a7c61858b09d51a7878dec4976d7647ab548819e91abb01971a77869ee16282b18cf323d3853846e509434a69fce2f378e286fa9a85f43938d961b9b95c9936f21e70a2164db96d6d6e6fa23ea742559abc01ea1b82ff8bb855cb350d894581818640e0d563bdf8e14dd80a43f46f8213e18377be29f4bea6ce2b2f3038be944a61cd8d82c3bf738f3800189e5aa41e1ddad4d6c2fca33c67bc11d9fec2296e8bab773bbc8b1127b74764ba16fcfd40d28ca43f8e8fc9bca197d5571196296e674091ff2ac93839a01d5650d1dbf851cfb6726c65847b39b4ec781794e1f54e12ec837cf773b4313566f665f80a0db3f299891b7c25bb733d52f7c2199b614669a4ae2eff3e2bd99806487178864c7acab76fdf09a406ca117d83f0f412af66e05152d4339f3d2f705976419cb5e75bc5d5e13b279e3b6065b83f61a0bd891d7932dbe802ee5390fc7b7ca3d117c14f6c3786e3578545583eef5107ea4fadf306c460c93bc1f96df692c988e9ce22329eec36bafbb8cfa3ddb30e3e33d71eb86830f54cf2a680b127f65e96b3842f966c466c705ce64450ab8d885f68c645046fbff85914f94ed72b92937d70f686abd933183974dc1086af958322d375d1728cea8902e00a0600f12c6b593f1382c61f97233bba6cd45392690a1c5d03f1b4aadacd1e723a5785850bb79d9e3f341e388b099947b61cf9ac83db5b8f01c888f245ed6a23f8dc519920b52576670ee567a923e68bd32a7c2ac364c342551060de4efcba0a078c40c7a8ec9db4a03bf5cc578ece351c6da0553341bbc89bb871c90ab2a45\",\n      mac: \"faafe7a325f36260015408ef2d859f71628cb7ff5287c6f3ccf6eadba27abe3f\",\n    },\n  },\n  {\n    name: \"UTF-8 text with special characters\",\n    privateKey:\n      \"d447811abc5bae2fd9c53f97569c50338108154cfa36f18fdbc300bcad37f493\",\n    publicKey:\n      \"045cb6eecff8afd418c2e590a956dae270a0342a9b1c9180f1500f7719da4b17702eed93f08415ebcf65036af2dc14f677e79aaa1cff54828285ff8686bc6c72bc\",\n    message:\n      \"48656c6c6f20e4b896e7958c2120f09f8e89205370656369616c2063686172733a20c3a0c3a9c3aec3b5c3bc\",\n    messageText: \"Hello 世界! 🎉 Special chars: àéîõü\",\n    encrypted: {\n      iv: \"a6f108c025f8e041a79f085aa42e2a92\",\n      ephemPublicKey:\n        \"041cfe2092b3d086b60b15a74ab9850878d02dfb0b72976e593027fb6cfdef2634fffdd67639b02bd8c1ed222d22f3eaf8b2f262c38415ddc97629fc7c818670d7\",\n      ciphertext:\n        \"5b675b04b3a7d93883a9dc0962b47d421966a8fe400c2125b17d30e93b6a8999fb8fe7e82bf7c63fd08092debaafba3c\",\n      mac: \"e786868550c316b5f31f696bf1aa2f7c59b795033456205f71603cc4d3a0a95b\",\n    },\n  },\n  {\n    name: \"Known private key test\",\n    privateKey:\n      \"1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef\",\n    publicKey:\n      \"04bb50e2d89a4ed70663d080659fe0ad4b9bc3e06c17a227433966cb59ceee020decddbf6e00192011648d13b1c00af770c0c1bb609d4d3a5c98a43772e0e18ef4\",\n    message: \"54657374206d6573736167652077697468206b6e6f776e206b6579\",\n    messageText: \"Test message with known key\",\n    encrypted: {\n      iv: \"c8dffc7f392098524aa6acec38f36835\",\n      ephemPublicKey:\n        \"04b663805d764f8cde462c54019dc76d2f4ec6389f2ee5ca6bf9e13d12fc75c059390c624ae7d35ef2fd6bea4f5a93ccc0fc3a505d222490d9091de379cf2bd3c4\",\n      ciphertext:\n        \"2beecd177fffa8e07bd1119a208d3303a5a4b24f516b03876bbd319f4b32f1ec\",\n      mac: \"ace56259ef19fe19aee629eac25327a6b4832ae258521e4dc41823dde910e86d\",\n    },\n  },\n];\n\nexport const eccryptoFormat = {\n  ivLength: 16,\n  ephemPublicKeyLength: 65, // Uncompressed\n  macLength: 32,\n  // Format: iv || ephemPublicKey || ciphertext || mac\n  getFormatLength: (ciphertextLength: number) =>\n    16 + 65 + ciphertextLength + 32,\n};\n"],"mappings":"AAQO,MAAM,sBAAsB;AAAA,EACjC;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SAAS;AAAA,IACT,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YAAY;AAAA,MACZ,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SACE;AAAA,IACF,aAAa;AAAA,IACb,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YACE;AAAA,IACF,WACE;AAAA,IACF,SAAS;AAAA,IACT,aAAa;AAAA,IACb,WAAW;AAAA,MACT,IAAI;AAAA,MACJ,gBACE;AAAA,MACF,YACE;AAAA,MACF,KAAK;AAAA,IACP;AAAA,EACF;AACF;AAEO,MAAM,iBAAiB;AAAA,EAC5B,UAAU;AAAA,EACV,sBAAsB;AAAA;AAAA,EACtB,WAAW;AAAA;AAAA,EAEX,iBAAiB,CAAC,qBAChB,KAAK,KAAK,mBAAmB;AACjC;","names":[]}

package/dist/crypto/ecies/base.cjs

@@ -0,0 +1,232 @@
+"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 base_exports = {};
+__export(base_exports, {
+  BaseECIESUint8: () => BaseECIESUint8
+});
+module.exports = __toCommonJS(base_exports);
+var import_interface = require("./interface");
+var import_constants = require("./constants");
+var import_utils = require("./utils");
+var import_viem = require("viem");
+class BaseECIESUint8 {
+  // Cache for validated public keys to avoid repeated validation
+  static validatedKeys = /* @__PURE__ */ new WeakMap();
+  /**
+   * Normalizes a public key to uncompressed format.
+   *
+   * @param publicKey - Public key in any format.
+   * @returns Uncompressed public key (65 bytes).
+   * @throws {ECIESError} If key format is invalid.
+   */
+  normalizePublicKey(publicKey) {
+    if (BaseECIESUint8.validatedKeys.has(publicKey)) {
+      return publicKey;
+    }
+    if (publicKey.length === import_constants.CURVE.UNCOMPRESSED_PUBLIC_KEY_LENGTH) {
+      if (publicKey[0] !== import_constants.CURVE.PREFIX.UNCOMPRESSED) {
+        throw new import_interface.ECIESError(
+          "Invalid uncompressed public key prefix",
+          "INVALID_KEY"
+        );
+      }
+      if (!this.validatePublicKey(publicKey)) {
+        throw new import_interface.ECIESError("Invalid public key", "INVALID_KEY");
+      }
+      BaseECIESUint8.validatedKeys.set(publicKey, true);
+      return publicKey;
+    }
+    if (publicKey.length === import_constants.CURVE.COMPRESSED_PUBLIC_KEY_LENGTH) {
+      const decompressed = this.decompressPublicKey(publicKey);
+      if (!decompressed) {
+        throw new import_interface.ECIESError("Failed to decompress public key", "INVALID_KEY");
+      }
+      BaseECIESUint8.validatedKeys.set(decompressed, true);
+      return decompressed;
+    }
+    throw new import_interface.ECIESError(
+      `Invalid public key length: ${publicKey.length}`,
+      "INVALID_KEY"
+    );
+  }
+  /**
+   * Encrypts data using ECIES.
+   *
+   * @param publicKey - The recipient's public key (compressed or uncompressed)
+   * @param message - The data to encrypt
+   * @returns Promise resolving to encrypted data structure
+   */
+  async encrypt(publicKey, message) {
+    try {
+      if (!(publicKey instanceof Uint8Array)) {
+        throw new import_interface.ECIESError("Public key must be a Uint8Array", "INVALID_KEY");
+      }
+      if (!(message instanceof Uint8Array)) {
+        throw new import_interface.ECIESError(
+          "Message must be a Uint8Array",
+          "ENCRYPTION_FAILED"
+        );
+      }
+      if (publicKey.length === 0) {
+        throw new import_interface.ECIESError("Public key cannot be empty", "INVALID_KEY");
+      }
+      const pubKey = this.normalizePublicKey(publicKey);
+      let ephemeralPrivateKey;
+      do {
+        ephemeralPrivateKey = this.generateRandomBytes(
+          import_constants.CURVE.PRIVATE_KEY_LENGTH
+        );
+      } while (!this.verifyPrivateKey(ephemeralPrivateKey));
+      const ephemeralPublicKey = this.createPublicKey(
+        ephemeralPrivateKey,
+        false
+      );
+      if (!ephemeralPublicKey) {
+        throw new import_interface.ECIESError(
+          "Failed to generate ephemeral public key",
+          "ENCRYPTION_FAILED"
+        );
+      }
+      const sharedSecret = this.performECDH(pubKey, ephemeralPrivateKey);
+      const kdf = this.sha512(sharedSecret);
+      const encryptionKey = kdf.slice(
+        import_constants.KDF.ENCRYPTION_KEY_OFFSET,
+        import_constants.KDF.ENCRYPTION_KEY_OFFSET + import_constants.KDF.ENCRYPTION_KEY_LENGTH
+      );
+      const macKey = kdf.slice(
+        import_constants.KDF.MAC_KEY_OFFSET,
+        import_constants.KDF.MAC_KEY_OFFSET + import_constants.KDF.MAC_KEY_LENGTH
+      );
+      const iv = this.generateRandomBytes(import_constants.CIPHER.IV_LENGTH);
+      const ciphertext = await this.aesEncrypt(encryptionKey, iv, message);
+      const macData = (0, import_viem.concat)([iv, ephemeralPublicKey, ciphertext]);
+      const mac = this.hmacSha256(macKey, macData);
+      this.clearBuffer(ephemeralPrivateKey);
+      this.clearBuffer(sharedSecret);
+      this.clearBuffer(kdf);
+      return {
+        iv,
+        ephemPublicKey: ephemeralPublicKey,
+        ciphertext,
+        mac
+      };
+    } catch (error) {
+      if (error instanceof import_interface.ECIESError) throw error;
+      throw new import_interface.ECIESError(
+        `Encryption failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "ENCRYPTION_FAILED",
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
+  /**
+   * Decrypts ECIES encrypted data.
+   *
+   * @param privateKey - The recipient's private key (32 bytes)
+   * @param encrypted - The encrypted data structure from encrypt()
+   * @returns Promise resolving to the original plaintext
+   */
+  async decrypt(privateKey, encrypted) {
+    try {
+      if (!(privateKey instanceof Uint8Array)) {
+        throw new import_interface.ECIESError("Private key must be a Uint8Array", "INVALID_KEY");
+      }
+      if (!(0, import_interface.isECIESEncrypted)(encrypted)) {
+        throw new import_interface.ECIESError(
+          "Invalid encrypted data structure",
+          "DECRYPTION_FAILED"
+        );
+      }
+      if (privateKey.length !== import_constants.CURVE.PRIVATE_KEY_LENGTH) {
+        throw new import_interface.ECIESError(
+          `Invalid private key length: ${privateKey.length}`,
+          "INVALID_KEY"
+        );
+      }
+      if (!this.verifyPrivateKey(privateKey)) {
+        throw new import_interface.ECIESError("Invalid private key", "INVALID_KEY");
+      }
+      const ephemeralPublicKey = this.normalizePublicKey(
+        encrypted.ephemPublicKey
+      );
+      const sharedSecret = this.performECDH(ephemeralPublicKey, privateKey);
+      const kdf = this.sha512(sharedSecret);
+      const encryptionKey = kdf.slice(
+        import_constants.KDF.ENCRYPTION_KEY_OFFSET,
+        import_constants.KDF.ENCRYPTION_KEY_OFFSET + import_constants.KDF.ENCRYPTION_KEY_LENGTH
+      );
+      const macKey = kdf.slice(
+        import_constants.KDF.MAC_KEY_OFFSET,
+        import_constants.KDF.MAC_KEY_OFFSET + import_constants.KDF.MAC_KEY_LENGTH
+      );
+      const macData = (0, import_viem.concat)([
+        encrypted.iv,
+        encrypted.ephemPublicKey,
+        encrypted.ciphertext
+      ]);
+      const expectedMac = this.hmacSha256(macKey, macData);
+      if (!(0, import_utils.constantTimeEqual)(encrypted.mac, expectedMac)) {
+        throw new import_interface.ECIESError("MAC verification failed", "MAC_MISMATCH");
+      }
+      const decrypted = await this.aesDecrypt(
+        encryptionKey,
+        encrypted.iv,
+        encrypted.ciphertext
+      );
+      this.clearBuffer(sharedSecret);
+      this.clearBuffer(kdf);
+      return decrypted;
+    } catch (error) {
+      if (error instanceof import_interface.ECIESError) throw error;
+      throw new import_interface.ECIESError(
+        `Decryption failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "DECRYPTION_FAILED",
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
+  /**
+   * Clears sensitive data from memory using multi-pass overwrite.
+   *
+   * @remarks
+   * Uses multiple passes with different patterns to make it harder
+   * for JIT compilers to optimize away the operation. While not
+   * guaranteed in JavaScript, this is a best-effort approach to
+   * clear sensitive data from memory.
+   *
+   * @param buffer - The buffer to clear
+   */
+  clearBuffer(buffer) {
+    if (buffer && buffer.length > 0) {
+      buffer.fill(0);
+      buffer.fill(255);
+      buffer.fill(170);
+      buffer.fill(0);
+      for (let i = 0; i < buffer.length; i++) {
+        buffer[i] = i & 255 ^ 90;
+      }
+      buffer.fill(0);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseECIESUint8
+});
+//# sourceMappingURL=base.cjs.map