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

package/dist/types/utils.js

@@ -0,0 +1 @@
+//# sourceMappingURL=utils.js.map

package/dist/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types.cjs

@@ -0,0 +1,23 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+__reExport(types_exports, require("./types/index"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./types/index")
+});
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the new modular structure\nexport * from \"./types/index\";\n\n// Also re-export legacy types for backward compatibility\n// These were previously defined in this file and are now in the types module\nimport type { Address } from \"viem\";\n\n/**\n * Represents a user's registered data file.\n */\nexport interface UserFile {\n  /** Unique identifier for the file */\n  id: number;\n  /** URL where the file is stored */\n  url: string;\n  /** EVM address of the file owner */\n  ownerAddress: Address;\n  /** Block number when the file was added to the registry */\n  addedAtBlock: bigint;\n}\n\n/**\n * Parameters for the `vana.permissions.grant` method.\n */\nexport interface GrantPermissionParams {\n  /** The on-chain identity of the application */\n  grantee: Address;\n  /** The class of computation, e.g., \"llm_inference\" */\n  operation: string;\n  /** Array of file IDs to grant permission for */\n  files: number[];\n  /** The full, off-chain parameters (e.g., LLM prompt) */\n  parameters: Record<string, unknown>;\n  /** Optional pre-stored grant URL to avoid duplicate IPFS storage */\n  grantUrl?: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AACA,0BAAc,0BADd;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,54 @@
+export { BaseConfig, BaseConfigWithStorage, ChainConfig, ChainConfigWithStorage, ConfigValidationOptions, ConfigValidationResult, DownloadRelayerCallbacks, RelayerCallbacks, RuntimeConfig, StorageConfig, StorageRequiredMarker, VanaConfig, VanaConfigWithStorage, WalletConfig, WalletConfigWithStorage, hasStorageConfig, isChainConfig, isWalletConfig } from './types/config.cjs';
+export { VanaChain, VanaChainId, isVanaChain, isVanaChainId } from './types/chains.cjs';
+export { ContractAddresses, ContractDeployment, ContractInfo, ContractMethodParams, ContractMethodReturnType, VanaContractInstance, VanaContractName } from './types/contracts.cjs';
+export { StorageError, StorageFile, StorageListOptions, StorageProvider, StorageProviderConfig, StorageUploadResult } from './types/storage.cjs';
+export { AddRefinerParams, AddRefinerResult, AddSchemaParams, AddSchemaResult, BatchUploadParams, BatchUploadResult, CompleteSchema, DeleteFileParams, DeleteFileResult, DownloadFileParams, DownloadFileResult, EncryptedUploadParams, EncryptionInfo, FileAccessPermissions, FileMetadata, FilePermissionParams, FileSharingConfig, GetFileParams, GetUserFilesParams, GetUserTrustedServersParams, LegacyPermissionParams, Refiner, Schema, SchemaMetadata, TrustedServer, UnencryptedUploadParams, UpdateSchemaIdParams, UpdateSchemaIdResult, UploadEncryptedFileResult, UploadFileParams, UploadFileResult, UploadParams, UploadResult } from './types/data.cjs';
+export { CreateSchemaParams, CreateSchemaResult } from './controllers/schemas.cjs';
+export { DataSchema, SchemaValidationError, SchemaValidator, fetchAndValidateSchema, validateDataAgainstSchema, validateDataSchemaAgainstMetaSchema } from './utils/schemaValidation.cjs';
+export { AddAndTrustServerInput, AddAndTrustServerParams, AddAndTrustServerTypedData, BatchServerInfoResult, CheckPermissionParams, GenericTypedData, GetUserPermissionsOptions, GrantFile, GrantedPermission, Grantee, GranteeInfo, GranteeQueryOptions, OnChainPermissionGrant, PaginatedGrantees, PaginatedTrustedServers, Permission, PermissionAnalytics, PermissionCheckResult, PermissionEvent, PermissionGrantDomain, PermissionGrantMessage, PermissionGrantTypedData, PermissionInfo, PermissionInputMessage, PermissionOperation, PermissionQueryResult, PermissionStatus, QueryPermissionsParams, RegisterGranteeInput, RegisterGranteeParams, RegisterGranteeTypedData, RevokePermissionInput, RevokePermissionParams, RevokePermissionTypedData, Server, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, ServerInfo, ServerTrustStatus, SimplifiedPermissionMessage, SpecificTypedData, TrustServerInput, TrustServerParams, TrustServerTypedData, TrustedServerInfo, TrustedServerQueryOptions, TypedDataPrimaryType, UntrustServerInput, UntrustServerParams, UntrustServerTypedData } from './types/permissions.cjs';
+export { CreateOperationParams, InitPersonalServerParams, PersonalServerIdentity, PostRequestParams } from './types/personal.cjs';
+export { AuthenticationErrorResponse, BlockchainErrorResponse, ComputeErrorResponse, CreateOperationRequest, CreateOperationResponse, DecryptionErrorResponse, ErrorResponse, FileAccessErrorResponse, GetOperationResponse, GrantValidationErrorResponse, IdentityResponseModel, InternalServerErrorResponse, NotFoundErrorResponse, OperationErrorResponse, PersonalServerModel, ValidationErrorResponse } from './generated/server/server-exports.cjs';
+export { APIResponse, PinataListResponse, PinataPin, PinataUploadResponse, ReplicateAPIResponse, ReplicateStatus, isAPIResponse, isReplicateAPIResponse, parseReplicateOutput, safeParseJSON } from './types/external-apis.cjs';
+export { RelayerConfig, RelayerErrorResponse, RelayerMetrics, RelayerQueueInfo, RelayerRequestOptions, RelayerStatus, RelayerStorageResponse, RelayerStoreParams, RelayerSubmitParams, RelayerTransactionResponse, RelayerTransactionStatus, RelayerWebhookConfig, RelayerWebhookPayload } from './types/relayer.cjs';
+export { ApiResponse, Awaited, BlockRange, CacheConfig, GasEstimate, MaybeArray, MaybePromise, NetworkInfo, PaginationParams, PaginationResult, PartialExcept, RateLimitInfo, RequiredExcept, StatusInfo, TimeRange, TransactionOptions, TransactionReceipt, UploadProgress, ValidationResult } from './types/utils.cjs';
+export { AllKeys, AsyncResult, Brand, Cache, ConditionalOptional, ContractCall, Controller, ControllerContext, DeepPartial, DeepReadonly, EventFilter, EventLog, Factory, GenericRequest, GenericResponse, Middleware, Nominal, NonNullable, Observable, Observer, OmitByType, OptionalKeys, PickByType, Plugin, PromiseResult, RateLimiterConfig, Repository, RequireKeys, RetryConfig, Service, StateMachine, Transformer, Validator } from './types/generics.cjs';
+import { Address } from 'viem';
+export { Abi, Account, Address, Chain, GetContractReturnType, Hash, PublicClient, WalletClient } from 'viem';
+export { $defs, components as ServerComponents, $defs as ServerDefs, operations as ServerOperations, paths as ServerPaths, webhooks as ServerWebhooks, components, operations, paths, webhooks } from './generated/server/server.cjs';
+import './types/transactionResults.cjs';
+import './types/controller-context.cjs';
+import './platform/interface.cjs';
+import './storage/manager.cjs';
+import './types/operations.cjs';
+import './generated/event-types.cjs';
+
+/**
+ * Represents a user's registered data file.
+ */
+interface UserFile {
+    /** Unique identifier for the file */
+    id: number;
+    /** URL where the file is stored */
+    url: string;
+    /** EVM address of the file owner */
+    ownerAddress: Address;
+    /** Block number when the file was added to the registry */
+    addedAtBlock: bigint;
+}
+/**
+ * Parameters for the `vana.permissions.grant` method.
+ */
+interface GrantPermissionParams {
+    /** The on-chain identity of the application */
+    grantee: Address;
+    /** The class of computation, e.g., "llm_inference" */
+    operation: string;
+    /** Array of file IDs to grant permission for */
+    files: number[];
+    /** The full, off-chain parameters (e.g., LLM prompt) */
+    parameters: Record<string, unknown>;
+    /** Optional pre-stored grant URL to avoid duplicate IPFS storage */
+    grantUrl?: string;
+}
+
+export type { GrantPermissionParams, UserFile };

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export { BaseConfig, BaseConfigWithStorage, ChainConfig, ChainConfigWithStorage, ConfigValidationOptions, ConfigValidationResult, DownloadRelayerCallbacks, RelayerCallbacks, RuntimeConfig, StorageConfig, StorageRequiredMarker, VanaConfig, VanaConfigWithStorage, WalletConfig, WalletConfigWithStorage, hasStorageConfig, isChainConfig, isWalletConfig } from './types/config.js';
+export { VanaChain, VanaChainId, isVanaChain, isVanaChainId } from './types/chains.js';
+export { ContractAddresses, ContractDeployment, ContractInfo, ContractMethodParams, ContractMethodReturnType, VanaContractInstance, VanaContractName } from './types/contracts.js';
+export { StorageError, StorageFile, StorageListOptions, StorageProvider, StorageProviderConfig, StorageUploadResult } from './types/storage.js';
+export { AddRefinerParams, AddRefinerResult, AddSchemaParams, AddSchemaResult, BatchUploadParams, BatchUploadResult, CompleteSchema, DeleteFileParams, DeleteFileResult, DownloadFileParams, DownloadFileResult, EncryptedUploadParams, EncryptionInfo, FileAccessPermissions, FileMetadata, FilePermissionParams, FileSharingConfig, GetFileParams, GetUserFilesParams, GetUserTrustedServersParams, LegacyPermissionParams, Refiner, Schema, SchemaMetadata, TrustedServer, UnencryptedUploadParams, UpdateSchemaIdParams, UpdateSchemaIdResult, UploadEncryptedFileResult, UploadFileParams, UploadFileResult, UploadParams, UploadResult } from './types/data.js';
+export { CreateSchemaParams, CreateSchemaResult } from './controllers/schemas.js';
+export { DataSchema, SchemaValidationError, SchemaValidator, fetchAndValidateSchema, validateDataAgainstSchema, validateDataSchemaAgainstMetaSchema } from './utils/schemaValidation.js';
+export { AddAndTrustServerInput, AddAndTrustServerParams, AddAndTrustServerTypedData, BatchServerInfoResult, CheckPermissionParams, GenericTypedData, GetUserPermissionsOptions, GrantFile, GrantedPermission, Grantee, GranteeInfo, GranteeQueryOptions, OnChainPermissionGrant, PaginatedGrantees, PaginatedTrustedServers, Permission, PermissionAnalytics, PermissionCheckResult, PermissionEvent, PermissionGrantDomain, PermissionGrantMessage, PermissionGrantTypedData, PermissionInfo, PermissionInputMessage, PermissionOperation, PermissionQueryResult, PermissionStatus, QueryPermissionsParams, RegisterGranteeInput, RegisterGranteeParams, RegisterGranteeTypedData, RevokePermissionInput, RevokePermissionParams, RevokePermissionTypedData, Server, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, ServerInfo, ServerTrustStatus, SimplifiedPermissionMessage, SpecificTypedData, TrustServerInput, TrustServerParams, TrustServerTypedData, TrustedServerInfo, TrustedServerQueryOptions, TypedDataPrimaryType, UntrustServerInput, UntrustServerParams, UntrustServerTypedData } from './types/permissions.js';
+export { CreateOperationParams, InitPersonalServerParams, PersonalServerIdentity, PostRequestParams } from './types/personal.js';
+export { AuthenticationErrorResponse, BlockchainErrorResponse, ComputeErrorResponse, CreateOperationRequest, CreateOperationResponse, DecryptionErrorResponse, ErrorResponse, FileAccessErrorResponse, GetOperationResponse, GrantValidationErrorResponse, IdentityResponseModel, InternalServerErrorResponse, NotFoundErrorResponse, OperationErrorResponse, PersonalServerModel, ValidationErrorResponse } from './generated/server/server-exports.js';
+export { APIResponse, PinataListResponse, PinataPin, PinataUploadResponse, ReplicateAPIResponse, ReplicateStatus, isAPIResponse, isReplicateAPIResponse, parseReplicateOutput, safeParseJSON } from './types/external-apis.js';
+export { RelayerConfig, RelayerErrorResponse, RelayerMetrics, RelayerQueueInfo, RelayerRequestOptions, RelayerStatus, RelayerStorageResponse, RelayerStoreParams, RelayerSubmitParams, RelayerTransactionResponse, RelayerTransactionStatus, RelayerWebhookConfig, RelayerWebhookPayload } from './types/relayer.js';
+export { ApiResponse, Awaited, BlockRange, CacheConfig, GasEstimate, MaybeArray, MaybePromise, NetworkInfo, PaginationParams, PaginationResult, PartialExcept, RateLimitInfo, RequiredExcept, StatusInfo, TimeRange, TransactionOptions, TransactionReceipt, UploadProgress, ValidationResult } from './types/utils.js';
+export { AllKeys, AsyncResult, Brand, Cache, ConditionalOptional, ContractCall, Controller, ControllerContext, DeepPartial, DeepReadonly, EventFilter, EventLog, Factory, GenericRequest, GenericResponse, Middleware, Nominal, NonNullable, Observable, Observer, OmitByType, OptionalKeys, PickByType, Plugin, PromiseResult, RateLimiterConfig, Repository, RequireKeys, RetryConfig, Service, StateMachine, Transformer, Validator } from './types/generics.js';
+import { Address } from 'viem';
+export { Abi, Account, Address, Chain, GetContractReturnType, Hash, PublicClient, WalletClient } from 'viem';
+export { $defs, components as ServerComponents, $defs as ServerDefs, operations as ServerOperations, paths as ServerPaths, webhooks as ServerWebhooks, components, operations, paths, webhooks } from './generated/server/server.js';
+import './types/transactionResults.js';
+import './types/controller-context.js';
+import './platform/interface.js';
+import './storage/manager.js';
+import './types/operations.js';
+import './generated/event-types.js';
+
+/**
+ * Represents a user's registered data file.
+ */
+interface UserFile {
+    /** Unique identifier for the file */
+    id: number;
+    /** URL where the file is stored */
+    url: string;
+    /** EVM address of the file owner */
+    ownerAddress: Address;
+    /** Block number when the file was added to the registry */
+    addedAtBlock: bigint;
+}
+/**
+ * Parameters for the `vana.permissions.grant` method.
+ */
+interface GrantPermissionParams {
+    /** The on-chain identity of the application */
+    grantee: Address;
+    /** The class of computation, e.g., "llm_inference" */
+    operation: string;
+    /** Array of file IDs to grant permission for */
+    files: number[];
+    /** The full, off-chain parameters (e.g., LLM prompt) */
+    parameters: Record<string, unknown>;
+    /** Optional pre-stored grant URL to avoid duplicate IPFS storage */
+    grantUrl?: string;
+}
+
+export type { GrantPermissionParams, UserFile };

package/dist/types.js

@@ -0,0 +1,2 @@
+export * from "./types/index";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the new modular structure\nexport * from \"./types/index\";\n\n// Also re-export legacy types for backward compatibility\n// These were previously defined in this file and are now in the types module\nimport type { Address } from \"viem\";\n\n/**\n * Represents a user's registered data file.\n */\nexport interface UserFile {\n  /** Unique identifier for the file */\n  id: number;\n  /** URL where the file is stored */\n  url: string;\n  /** EVM address of the file owner */\n  ownerAddress: Address;\n  /** Block number when the file was added to the registry */\n  addedAtBlock: bigint;\n}\n\n/**\n * Parameters for the `vana.permissions.grant` method.\n */\nexport interface GrantPermissionParams {\n  /** The on-chain identity of the application */\n  grantee: Address;\n  /** The class of computation, e.g., \"llm_inference\" */\n  operation: string;\n  /** Array of file IDs to grant permission for */\n  files: number[];\n  /** The full, off-chain parameters (e.g., LLM prompt) */\n  parameters: Record<string, unknown>;\n  /** Optional pre-stored grant URL to avoid duplicate IPFS storage */\n  grantUrl?: string;\n}\n"],"mappings":"AACA,cAAc;","names":[]}

package/dist/utils/blockchain/registry.cjs

@@ -0,0 +1,81 @@
+"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 registry_exports = {};
+__export(registry_exports, {
+  fetchSchemaCountFromChain: () => fetchSchemaCountFromChain,
+  fetchSchemaFromChain: () => fetchSchemaFromChain
+});
+module.exports = __toCommonJS(registry_exports);
+var import_viem = require("viem");
+var import_addresses = require("../../config/addresses");
+var import_abi = require("../../generated/abi");
+async function fetchSchemaFromChain(context, schemaId) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = (0, import_addresses.getContractAddress)(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = (0, import_abi.getAbi)("DataRefinerRegistry");
+  const dataRefinerRegistry = (0, import_viem.getContract)({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);
+  if (!schemaData) {
+    throw new Error(`Schema with ID ${schemaId} not found`);
+  }
+  const schemaObj = schemaData;
+  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {
+    throw new Error("Incomplete schema data");
+  }
+  return {
+    id: schemaId,
+    name: schemaObj.name,
+    dialect: schemaObj.dialect,
+    definitionUrl: schemaObj.definitionUrl
+  };
+}
+async function fetchSchemaCountFromChain(context) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = (0, import_addresses.getContractAddress)(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = (0, import_abi.getAbi)("DataRefinerRegistry");
+  const dataRefinerRegistry = (0, import_viem.getContract)({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const count = await dataRefinerRegistry.read.schemasCount();
+  return Number(count);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchSchemaCountFromChain,
+  fetchSchemaFromChain
+});
+//# sourceMappingURL=registry.cjs.map

package/dist/utils/blockchain/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/blockchain/registry.ts"],"sourcesContent":["import { getContract } from \"viem\";\nimport { PublicClient, WalletClient } from \"viem\";\nimport { getContractAddress } from \"../../config/addresses\";\nimport { getAbi } from \"../../generated/abi\";\nimport { SchemaMetadata } from \"../../types/index\";\n\n/**\n * Shared context for blockchain operations.\n * Only includes the minimal required fields to avoid coupling.\n */\ninterface BlockchainContext {\n  walletClient: WalletClient;\n  publicClient: PublicClient;\n}\n\n/**\n * Contract data structure returned by the blockchain.\n *\n * @internal\n */\ninterface SchemaContractData {\n  name: string;\n  dialect: string;\n  definitionUrl: string;\n}\n\n/**\n * Fetches schema metadata from the blockchain by its ID.\n *\n * @param context - The blockchain context containing wallet and public clients\n * @param schemaId - The ID of the schema to fetch\n * @returns The schema metadata with id, name, dialect, and definitionUrl\n * @throws Error if chain ID is not available, schema not found, or data is incomplete\n *\n * @internal\n */\nexport async function fetchSchemaFromChain(\n  context: BlockchainContext,\n  schemaId: number,\n): Promise<SchemaMetadata> {\n  const chainId = context.walletClient.chain?.id;\n  if (!chainId) {\n    throw new Error(\"Chain ID not available\");\n  }\n\n  const dataRefinerRegistryAddress = getContractAddress(\n    chainId,\n    \"DataRefinerRegistry\",\n  );\n  const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n  const dataRefinerRegistry = getContract({\n    address: dataRefinerRegistryAddress,\n    abi: dataRefinerRegistryAbi,\n    client: context.publicClient,\n  });\n\n  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);\n\n  if (!schemaData) {\n    throw new Error(`Schema with ID ${schemaId} not found`);\n  }\n\n  const schemaObj = schemaData as unknown as SchemaContractData;\n\n  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {\n    throw new Error(\"Incomplete schema data\");\n  }\n\n  return {\n    id: schemaId,\n    name: schemaObj.name,\n    dialect: schemaObj.dialect as \"json\" | \"sqlite\",\n    definitionUrl: schemaObj.definitionUrl,\n  };\n}\n\n/**\n * Fetches the total count of schemas from the blockchain.\n *\n * @param context - The blockchain context containing wallet and public clients\n * @returns The total number of schemas\n * @throws Error if chain ID is not available or operation fails\n *\n * @internal\n */\nexport async function fetchSchemaCountFromChain(\n  context: BlockchainContext,\n): Promise<number> {\n  const chainId = context.walletClient.chain?.id;\n  if (!chainId) {\n    throw new Error(\"Chain ID not available\");\n  }\n\n  const dataRefinerRegistryAddress = getContractAddress(\n    chainId,\n    \"DataRefinerRegistry\",\n  );\n  const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n  const dataRefinerRegistry = getContract({\n    address: dataRefinerRegistryAddress,\n    abi: dataRefinerRegistryAbi,\n    client: context.publicClient,\n  });\n\n  const count = await dataRefinerRegistry.read.schemasCount();\n  return Number(count);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA4B;AAE5B,uBAAmC;AACnC,iBAAuB;AAiCvB,eAAsB,qBACpB,SACA,UACyB;AACzB,QAAM,UAAU,QAAQ,aAAa,OAAO;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,QAAM,iCAA6B;AAAA,IACjC;AAAA,IACA;AAAA,EACF;AACA,QAAM,6BAAyB,mBAAO,qBAAqB;AAE3D,QAAM,0BAAsB,yBAAY;AAAA,IACtC,SAAS;AAAA,IACT,KAAK;AAAA,IACL,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,QAAM,aAAa,MAAM,oBAAoB,KAAK,QAAQ,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE5E,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,kBAAkB,QAAQ,YAAY;AAAA,EACxD;AAEA,QAAM,YAAY;AAElB,MAAI,CAAC,UAAU,QAAQ,CAAC,UAAU,WAAW,CAAC,UAAU,eAAe;AACrE,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,UAAU;AAAA,IAChB,SAAS,UAAU;AAAA,IACnB,eAAe,UAAU;AAAA,EAC3B;AACF;AAWA,eAAsB,0BACpB,SACiB;AACjB,QAAM,UAAU,QAAQ,aAAa,OAAO;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,QAAM,iCAA6B;AAAA,IACjC;AAAA,IACA;AAAA,EACF;AACA,QAAM,6BAAyB,mBAAO,qBAAqB;AAE3D,QAAM,0BAAsB,yBAAY;AAAA,IACtC,SAAS;AAAA,IACT,KAAK;AAAA,IACL,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,QAAM,QAAQ,MAAM,oBAAoB,KAAK,aAAa;AAC1D,SAAO,OAAO,KAAK;AACrB;","names":[]}

package/dist/utils/blockchain/registry.d.cts

@@ -0,0 +1,34 @@
+import { WalletClient, PublicClient } from 'viem';
+import { SchemaMetadata } from '../../types/data.cjs';
+
+/**
+ * Shared context for blockchain operations.
+ * Only includes the minimal required fields to avoid coupling.
+ */
+interface BlockchainContext {
+    walletClient: WalletClient;
+    publicClient: PublicClient;
+}
+/**
+ * Fetches schema metadata from the blockchain by its ID.
+ *
+ * @param context - The blockchain context containing wallet and public clients
+ * @param schemaId - The ID of the schema to fetch
+ * @returns The schema metadata with id, name, dialect, and definitionUrl
+ * @throws Error if chain ID is not available, schema not found, or data is incomplete
+ *
+ * @internal
+ */
+declare function fetchSchemaFromChain(context: BlockchainContext, schemaId: number): Promise<SchemaMetadata>;
+/**
+ * Fetches the total count of schemas from the blockchain.
+ *
+ * @param context - The blockchain context containing wallet and public clients
+ * @returns The total number of schemas
+ * @throws Error if chain ID is not available or operation fails
+ *
+ * @internal
+ */
+declare function fetchSchemaCountFromChain(context: BlockchainContext): Promise<number>;
+
+export { fetchSchemaCountFromChain, fetchSchemaFromChain };

package/dist/utils/blockchain/registry.d.ts

@@ -0,0 +1,34 @@
+import { WalletClient, PublicClient } from 'viem';
+import { SchemaMetadata } from '../../types/data.js';
+
+/**
+ * Shared context for blockchain operations.
+ * Only includes the minimal required fields to avoid coupling.
+ */
+interface BlockchainContext {
+    walletClient: WalletClient;
+    publicClient: PublicClient;
+}
+/**
+ * Fetches schema metadata from the blockchain by its ID.
+ *
+ * @param context - The blockchain context containing wallet and public clients
+ * @param schemaId - The ID of the schema to fetch
+ * @returns The schema metadata with id, name, dialect, and definitionUrl
+ * @throws Error if chain ID is not available, schema not found, or data is incomplete
+ *
+ * @internal
+ */
+declare function fetchSchemaFromChain(context: BlockchainContext, schemaId: number): Promise<SchemaMetadata>;
+/**
+ * Fetches the total count of schemas from the blockchain.
+ *
+ * @param context - The blockchain context containing wallet and public clients
+ * @returns The total number of schemas
+ * @throws Error if chain ID is not available or operation fails
+ *
+ * @internal
+ */
+declare function fetchSchemaCountFromChain(context: BlockchainContext): Promise<number>;
+
+export { fetchSchemaCountFromChain, fetchSchemaFromChain };

package/dist/utils/blockchain/registry.js

@@ -0,0 +1,56 @@
+import { getContract } from "viem";
+import { getContractAddress } from "../../config/addresses";
+import { getAbi } from "../../generated/abi";
+async function fetchSchemaFromChain(context, schemaId) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = getContractAddress(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
+  const dataRefinerRegistry = getContract({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);
+  if (!schemaData) {
+    throw new Error(`Schema with ID ${schemaId} not found`);
+  }
+  const schemaObj = schemaData;
+  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {
+    throw new Error("Incomplete schema data");
+  }
+  return {
+    id: schemaId,
+    name: schemaObj.name,
+    dialect: schemaObj.dialect,
+    definitionUrl: schemaObj.definitionUrl
+  };
+}
+async function fetchSchemaCountFromChain(context) {
+  const chainId = context.walletClient.chain?.id;
+  if (!chainId) {
+    throw new Error("Chain ID not available");
+  }
+  const dataRefinerRegistryAddress = getContractAddress(
+    chainId,
+    "DataRefinerRegistry"
+  );
+  const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
+  const dataRefinerRegistry = getContract({
+    address: dataRefinerRegistryAddress,
+    abi: dataRefinerRegistryAbi,
+    client: context.publicClient
+  });
+  const count = await dataRefinerRegistry.read.schemasCount();
+  return Number(count);
+}
+export {
+  fetchSchemaCountFromChain,
+  fetchSchemaFromChain
+};
+//# sourceMappingURL=registry.js.map

package/dist/utils/blockchain/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/blockchain/registry.ts"],"sourcesContent":["import { getContract } from \"viem\";\nimport { PublicClient, WalletClient } from \"viem\";\nimport { getContractAddress } from \"../../config/addresses\";\nimport { getAbi } from \"../../generated/abi\";\nimport { SchemaMetadata } from \"../../types/index\";\n\n/**\n * Shared context for blockchain operations.\n * Only includes the minimal required fields to avoid coupling.\n */\ninterface BlockchainContext {\n  walletClient: WalletClient;\n  publicClient: PublicClient;\n}\n\n/**\n * Contract data structure returned by the blockchain.\n *\n * @internal\n */\ninterface SchemaContractData {\n  name: string;\n  dialect: string;\n  definitionUrl: string;\n}\n\n/**\n * Fetches schema metadata from the blockchain by its ID.\n *\n * @param context - The blockchain context containing wallet and public clients\n * @param schemaId - The ID of the schema to fetch\n * @returns The schema metadata with id, name, dialect, and definitionUrl\n * @throws Error if chain ID is not available, schema not found, or data is incomplete\n *\n * @internal\n */\nexport async function fetchSchemaFromChain(\n  context: BlockchainContext,\n  schemaId: number,\n): Promise<SchemaMetadata> {\n  const chainId = context.walletClient.chain?.id;\n  if (!chainId) {\n    throw new Error(\"Chain ID not available\");\n  }\n\n  const dataRefinerRegistryAddress = getContractAddress(\n    chainId,\n    \"DataRefinerRegistry\",\n  );\n  const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n  const dataRefinerRegistry = getContract({\n    address: dataRefinerRegistryAddress,\n    abi: dataRefinerRegistryAbi,\n    client: context.publicClient,\n  });\n\n  const schemaData = await dataRefinerRegistry.read.schemas([BigInt(schemaId)]);\n\n  if (!schemaData) {\n    throw new Error(`Schema with ID ${schemaId} not found`);\n  }\n\n  const schemaObj = schemaData as unknown as SchemaContractData;\n\n  if (!schemaObj.name || !schemaObj.dialect || !schemaObj.definitionUrl) {\n    throw new Error(\"Incomplete schema data\");\n  }\n\n  return {\n    id: schemaId,\n    name: schemaObj.name,\n    dialect: schemaObj.dialect as \"json\" | \"sqlite\",\n    definitionUrl: schemaObj.definitionUrl,\n  };\n}\n\n/**\n * Fetches the total count of schemas from the blockchain.\n *\n * @param context - The blockchain context containing wallet and public clients\n * @returns The total number of schemas\n * @throws Error if chain ID is not available or operation fails\n *\n * @internal\n */\nexport async function fetchSchemaCountFromChain(\n  context: BlockchainContext,\n): Promise<number> {\n  const chainId = context.walletClient.chain?.id;\n  if (!chainId) {\n    throw new Error(\"Chain ID not available\");\n  }\n\n  const dataRefinerRegistryAddress = getContractAddress(\n    chainId,\n    \"DataRefinerRegistry\",\n  );\n  const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n  const dataRefinerRegistry = getContract({\n    address: dataRefinerRegistryAddress,\n    abi: dataRefinerRegistryAbi,\n    client: context.publicClient,\n  });\n\n  const count = await dataRefinerRegistry.read.schemasCount();\n  return Number(count);\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAE5B,SAAS,0BAA0B;AACnC,SAAS,cAAc;AAiCvB,eAAsB,qBACpB,SACA,UACyB;AACzB,QAAM,UAAU,QAAQ,aAAa,OAAO;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,QAAM,6BAA6B;AAAA,IACjC;AAAA,IACA;AAAA,EACF;AACA,QAAM,yBAAyB,OAAO,qBAAqB;AAE3D,QAAM,sBAAsB,YAAY;AAAA,IACtC,SAAS;AAAA,IACT,KAAK;AAAA,IACL,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,QAAM,aAAa,MAAM,oBAAoB,KAAK,QAAQ,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE5E,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,kBAAkB,QAAQ,YAAY;AAAA,EACxD;AAEA,QAAM,YAAY;AAElB,MAAI,CAAC,UAAU,QAAQ,CAAC,UAAU,WAAW,CAAC,UAAU,eAAe;AACrE,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,UAAU;AAAA,IAChB,SAAS,UAAU;AAAA,IACnB,eAAe,UAAU;AAAA,EAC3B;AACF;AAWA,eAAsB,0BACpB,SACiB;AACjB,QAAM,UAAU,QAAQ,aAAa,OAAO;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,QAAM,6BAA6B;AAAA,IACjC;AAAA,IACA;AAAA,EACF;AACA,QAAM,yBAAyB,OAAO,qBAAqB;AAE3D,QAAM,sBAAsB,YAAY;AAAA,IACtC,SAAS;AAAA,IACT,KAAK;AAAA,IACL,QAAQ,QAAQ;AAAA,EAClB,CAAC;AAED,QAAM,QAAQ,MAAM,oBAAoB,KAAK,aAAa;AAC1D,SAAO,OAAO,KAAK;AACrB;","names":[]}

package/dist/utils/crypto-utils.cjs

@@ -0,0 +1,120 @@
+"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 crypto_utils_exports = {};
+__export(crypto_utils_exports, {
+  assertUncompressedPublicKey: () => assertUncompressedPublicKey,
+  bytesEqual: () => bytesEqual,
+  concatBytes: () => concatBytes,
+  copyBytes: () => copyBytes,
+  generateSeed: () => generateSeed,
+  isValidPrivateKeyFormat: () => isValidPrivateKeyFormat,
+  isValidPublicKeyFormat: () => isValidPublicKeyFormat,
+  parseEncryptedDataBuffer: () => parseEncryptedDataBuffer,
+  processWalletPrivateKey: () => processWalletPrivateKey,
+  processWalletPublicKey: () => processWalletPublicKey
+});
+module.exports = __toCommonJS(crypto_utils_exports);
+var import_viem = require("viem");
+function concatBytes(...arrays) {
+  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+  const result = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const arr of arrays) {
+    result.set(arr, offset);
+    offset += arr.length;
+  }
+  return result;
+}
+function processWalletPublicKey(publicKey) {
+  return typeof publicKey === "string" ? (0, import_viem.fromHex)(
+    publicKey.startsWith("0x") ? publicKey : `0x${publicKey}`,
+    "bytes"
+  ) : publicKey;
+}
+function processWalletPrivateKey(privateKey) {
+  return typeof privateKey === "string" ? (0, import_viem.fromHex)(
+    privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`,
+    "bytes"
+  ) : privateKey;
+}
+function parseEncryptedDataBuffer(encryptedBuffer) {
+  return {
+    iv: encryptedBuffer.slice(0, 16),
+    ephemPublicKey: encryptedBuffer.slice(16, 81),
+    // 65 bytes for uncompressed public key
+    ciphertext: encryptedBuffer.slice(81, -32),
+    mac: encryptedBuffer.slice(-32)
+  };
+}
+function generateSeed(message) {
+  const encoder = new TextEncoder();
+  return encoder.encode(message);
+}
+function bytesEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+function copyBytes(bytes) {
+  return new Uint8Array(bytes);
+}
+function isValidPublicKeyFormat(publicKey) {
+  const len = publicKey.length;
+  if (len === 33) {
+    return publicKey[0] === 2 || publicKey[0] === 3;
+  }
+  if (len === 65) {
+    return publicKey[0] === 4;
+  }
+  if (len === 64) {
+    return true;
+  }
+  return false;
+}
+function isValidPrivateKeyFormat(privateKey) {
+  return privateKey.length === 32;
+}
+function assertUncompressedPublicKey(publicKey) {
+  if (publicKey.length !== 65) {
+    throw new Error(
+      `Public key must be uncompressed (65 bytes), got ${publicKey.length} bytes. Use provider.normalizeToUncompressed() to convert compressed keys.`
+    );
+  }
+  if (publicKey[0] !== 4) {
+    throw new Error(
+      `Uncompressed public key must start with 0x04 prefix, got 0x${publicKey[0].toString(16).padStart(2, "0")}`
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertUncompressedPublicKey,
+  bytesEqual,
+  concatBytes,
+  copyBytes,
+  generateSeed,
+  isValidPrivateKeyFormat,
+  isValidPublicKeyFormat,
+  parseEncryptedDataBuffer,
+  processWalletPrivateKey,
+  processWalletPublicKey
+});
+//# sourceMappingURL=crypto-utils.cjs.map

package/dist/utils/crypto-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/crypto-utils.ts"],"sourcesContent":["/**\n * Provides platform-agnostic cryptographic utility functions.\n *\n * @remarks\n * This module contains utility functions for cryptographic operations that work\n * consistently across Node.js and browser environments. All functions use `Uint8Array`\n * exclusively for binary data to ensure cross-platform compatibility.\n *\n * @category Cryptography\n */\n\nimport { fromHex } from \"viem\";\n\n/**\n * Concatenates multiple Uint8Arrays into a single array.\n *\n * @param arrays - The byte arrays to concatenate in order.\n * @returns A new Uint8Array containing all input arrays concatenated.\n *\n * @example\n * ```typescript\n * const combined = concatBytes(\n *   new Uint8Array([1, 2]),\n *   new Uint8Array([3, 4])\n * );\n * console.log(combined); // Uint8Array([1, 2, 3, 4])\n * ```\n */\nexport function concatBytes(...arrays: Uint8Array[]): Uint8Array {\n  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const arr of arrays) {\n    result.set(arr, offset);\n    offset += arr.length;\n  }\n  return result;\n}\n\n/**\n * Processes a wallet public key for cryptographic operations.\n *\n * @remarks\n * Converts hex string public keys to Uint8Array format.\n * For normalization to uncompressed format, use the crypto provider's\n * normalizeToUncompressed method.\n *\n * @param publicKey - The wallet public key as hex string or byte array.\n * @returns The public key as a Uint8Array.\n *\n * @example\n * ```typescript\n * const keyBytes = processWalletPublicKey(\"0x04...\");\n * const normalized = provider.normalizeToUncompressed(keyBytes);\n * ```\n */\nexport function processWalletPublicKey(\n  publicKey: string | Uint8Array,\n): Uint8Array {\n  // Convert to bytes if hex string\n  return typeof publicKey === \"string\"\n    ? fromHex(\n        (publicKey.startsWith(\"0x\")\n          ? publicKey\n          : `0x${publicKey}`) as `0x${string}`,\n        \"bytes\",\n      )\n    : publicKey;\n}\n\n/**\n * Processes a wallet private key for cryptographic operations.\n *\n * @param privateKey - The wallet private key as hex string or byte array.\n * @returns The private key as a Uint8Array.\n *\n * @example\n * ```typescript\n * const key = processWalletPrivateKey(\"0x...\");\n * console.log(key.length); // 32 (secp256k1 private key)\n * ```\n */\nexport function processWalletPrivateKey(\n  privateKey: string | Uint8Array,\n): Uint8Array {\n  // Convert to bytes\n  return typeof privateKey === \"string\"\n    ? fromHex(\n        (privateKey.startsWith(\"0x\")\n          ? privateKey\n          : `0x${privateKey}`) as `0x${string}`,\n        \"bytes\",\n      )\n    : privateKey;\n}\n\n/**\n * Parses legacy eccrypto-format encrypted data buffer.\n * Format: [iv(16)][ephemPublicKey(65)][ciphertext(variable)][mac(32)]\n *\n * @param encryptedBuffer - Buffer containing encrypted data in eccrypto format\n * @returns Parsed encrypted data components\n */\nexport function parseEncryptedDataBuffer(encryptedBuffer: Uint8Array): {\n  iv: Uint8Array;\n  ephemPublicKey: Uint8Array;\n  ciphertext: Uint8Array;\n  mac: Uint8Array;\n} {\n  return {\n    iv: encryptedBuffer.slice(0, 16),\n    ephemPublicKey: encryptedBuffer.slice(16, 81), // 65 bytes for uncompressed public key\n    ciphertext: encryptedBuffer.slice(81, -32),\n    mac: encryptedBuffer.slice(-32),\n  };\n}\n\n/**\n * Generates a deterministic seed from a message for key derivation\n *\n * @param message - Message to derive seed from\n * @returns Seed as Uint8Array\n */\nexport function generateSeed(message: string): Uint8Array {\n  // Use encoding utils for consistent string-to-bytes conversion\n  const encoder = new TextEncoder();\n  return encoder.encode(message);\n}\n\n/**\n * Compares two Uint8Arrays for equality\n *\n * @param a - First array\n * @param b - Second array\n * @returns True if arrays are equal\n */\nexport function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Creates a copy of a Uint8Array\n *\n * @param bytes - Array to copy\n * @returns New array with same contents\n */\nexport function copyBytes(bytes: Uint8Array): Uint8Array {\n  return new Uint8Array(bytes);\n}\n\n/**\n * Validates a secp256k1 public key format\n *\n * @param publicKey - Public key to validate\n * @returns True if valid format (33, 65, or 64 bytes)\n */\nexport function isValidPublicKeyFormat(publicKey: Uint8Array): boolean {\n  const len = publicKey.length;\n\n  // Compressed (33 bytes)\n  if (len === 33) {\n    return publicKey[0] === 0x02 || publicKey[0] === 0x03;\n  }\n\n  // Uncompressed (65 bytes)\n  if (len === 65) {\n    return publicKey[0] === 0x04;\n  }\n\n  // Raw coordinates (64 bytes - no prefix)\n  if (len === 64) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Validates a secp256k1 private key format\n *\n * @param privateKey - Private key to validate\n * @returns True if valid format (32 bytes)\n */\nexport function isValidPrivateKeyFormat(privateKey: Uint8Array): boolean {\n  return privateKey.length === 32;\n}\n\n/**\n * Asserts that a public key is in uncompressed format (65 bytes with 0x04 prefix).\n * This validation function only checks format, it does not transform keys.\n * For key normalization (including decompression), use the crypto provider's\n * normalizeToUncompressed method.\n *\n * @param publicKey - Public key to validate\n * @throws {Error} When public key is not in uncompressed format\n */\nexport function assertUncompressedPublicKey(publicKey: Uint8Array): void {\n  if (publicKey.length !== 65) {\n    throw new Error(\n      `Public key must be uncompressed (65 bytes), got ${publicKey.length} bytes. ` +\n        `Use provider.normalizeToUncompressed() to convert compressed keys.`,\n    );\n  }\n\n  if (publicKey[0] !== 0x04) {\n    throw new Error(\n      `Uncompressed public key must start with 0x04 prefix, got 0x${publicKey[0].toString(16).padStart(2, \"0\")}`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,kBAAwB;AAiBjB,SAAS,eAAe,QAAkC;AAC/D,QAAM,cAAc,OAAO,OAAO,CAAC,KAAK,QAAQ,MAAM,IAAI,QAAQ,CAAC;AACnE,QAAM,SAAS,IAAI,WAAW,WAAW;AACzC,MAAI,SAAS;AACb,aAAW,OAAO,QAAQ;AACxB,WAAO,IAAI,KAAK,MAAM;AACtB,cAAU,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAmBO,SAAS,uBACd,WACY;AAEZ,SAAO,OAAO,cAAc,eACxB;AAAA,IACG,UAAU,WAAW,IAAI,IACtB,YACA,KAAK,SAAS;AAAA,IAClB;AAAA,EACF,IACA;AACN;AAcO,SAAS,wBACd,YACY;AAEZ,SAAO,OAAO,eAAe,eACzB;AAAA,IACG,WAAW,WAAW,IAAI,IACvB,aACA,KAAK,UAAU;AAAA,IACnB;AAAA,EACF,IACA;AACN;AASO,SAAS,yBAAyB,iBAKvC;AACA,SAAO;AAAA,IACL,IAAI,gBAAgB,MAAM,GAAG,EAAE;AAAA,IAC/B,gBAAgB,gBAAgB,MAAM,IAAI,EAAE;AAAA;AAAA,IAC5C,YAAY,gBAAgB,MAAM,IAAI,GAAG;AAAA,IACzC,KAAK,gBAAgB,MAAM,GAAG;AAAA,EAChC;AACF;AAQO,SAAS,aAAa,SAA6B;AAExD,QAAM,UAAU,IAAI,YAAY;AAChC,SAAO,QAAQ,OAAO,OAAO;AAC/B;AASO,SAAS,WAAW,GAAe,GAAwB;AAChE,MAAI,EAAE,WAAW,EAAE,OAAQ,QAAO;AAClC,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;AACjC,QAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAG,QAAO;AAAA,EAC5B;AACA,SAAO;AACT;AAQO,SAAS,UAAU,OAA+B;AACvD,SAAO,IAAI,WAAW,KAAK;AAC7B;AAQO,SAAS,uBAAuB,WAAgC;AACrE,QAAM,MAAM,UAAU;AAGtB,MAAI,QAAQ,IAAI;AACd,WAAO,UAAU,CAAC,MAAM,KAAQ,UAAU,CAAC,MAAM;AAAA,EACnD;AAGA,MAAI,QAAQ,IAAI;AACd,WAAO,UAAU,CAAC,MAAM;AAAA,EAC1B;AAGA,MAAI,QAAQ,IAAI;AACd,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAQO,SAAS,wBAAwB,YAAiC;AACvE,SAAO,WAAW,WAAW;AAC/B;AAWO,SAAS,4BAA4B,WAA6B;AACvE,MAAI,UAAU,WAAW,IAAI;AAC3B,UAAM,IAAI;AAAA,MACR,mDAAmD,UAAU,MAAM;AAAA,IAErE;AAAA,EACF;AAEA,MAAI,UAAU,CAAC,MAAM,GAAM;AACzB,UAAM,IAAI;AAAA,MACR,8DAA8D,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC;AAAA,IAC1G;AAAA,EACF;AACF;","names":[]}

package/dist/utils/crypto-utils.d.cts

@@ -0,0 +1,118 @@
+/**
+ * Provides platform-agnostic cryptographic utility functions.
+ *
+ * @remarks
+ * This module contains utility functions for cryptographic operations that work
+ * consistently across Node.js and browser environments. All functions use `Uint8Array`
+ * exclusively for binary data to ensure cross-platform compatibility.
+ *
+ * @category Cryptography
+ */
+/**
+ * Concatenates multiple Uint8Arrays into a single array.
+ *
+ * @param arrays - The byte arrays to concatenate in order.
+ * @returns A new Uint8Array containing all input arrays concatenated.
+ *
+ * @example
+ * ```typescript
+ * const combined = concatBytes(
+ *   new Uint8Array([1, 2]),
+ *   new Uint8Array([3, 4])
+ * );
+ * console.log(combined); // Uint8Array([1, 2, 3, 4])
+ * ```
+ */
+declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Processes a wallet public key for cryptographic operations.
+ *
+ * @remarks
+ * Converts hex string public keys to Uint8Array format.
+ * For normalization to uncompressed format, use the crypto provider's
+ * normalizeToUncompressed method.
+ *
+ * @param publicKey - The wallet public key as hex string or byte array.
+ * @returns The public key as a Uint8Array.
+ *
+ * @example
+ * ```typescript
+ * const keyBytes = processWalletPublicKey("0x04...");
+ * const normalized = provider.normalizeToUncompressed(keyBytes);
+ * ```
+ */
+declare function processWalletPublicKey(publicKey: string | Uint8Array): Uint8Array;
+/**
+ * Processes a wallet private key for cryptographic operations.
+ *
+ * @param privateKey - The wallet private key as hex string or byte array.
+ * @returns The private key as a Uint8Array.
+ *
+ * @example
+ * ```typescript
+ * const key = processWalletPrivateKey("0x...");
+ * console.log(key.length); // 32 (secp256k1 private key)
+ * ```
+ */
+declare function processWalletPrivateKey(privateKey: string | Uint8Array): Uint8Array;
+/**
+ * Parses legacy eccrypto-format encrypted data buffer.
+ * Format: [iv(16)][ephemPublicKey(65)][ciphertext(variable)][mac(32)]
+ *
+ * @param encryptedBuffer - Buffer containing encrypted data in eccrypto format
+ * @returns Parsed encrypted data components
+ */
+declare function parseEncryptedDataBuffer(encryptedBuffer: Uint8Array): {
+    iv: Uint8Array;
+    ephemPublicKey: Uint8Array;
+    ciphertext: Uint8Array;
+    mac: Uint8Array;
+};
+/**
+ * Generates a deterministic seed from a message for key derivation
+ *
+ * @param message - Message to derive seed from
+ * @returns Seed as Uint8Array
+ */
+declare function generateSeed(message: string): Uint8Array;
+/**
+ * Compares two Uint8Arrays for equality
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns True if arrays are equal
+ */
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Creates a copy of a Uint8Array
+ *
+ * @param bytes - Array to copy
+ * @returns New array with same contents
+ */
+declare function copyBytes(bytes: Uint8Array): Uint8Array;
+/**
+ * Validates a secp256k1 public key format
+ *
+ * @param publicKey - Public key to validate
+ * @returns True if valid format (33, 65, or 64 bytes)
+ */
+declare function isValidPublicKeyFormat(publicKey: Uint8Array): boolean;
+/**
+ * Validates a secp256k1 private key format
+ *
+ * @param privateKey - Private key to validate
+ * @returns True if valid format (32 bytes)
+ */
+declare function isValidPrivateKeyFormat(privateKey: Uint8Array): boolean;
+/**
+ * Asserts that a public key is in uncompressed format (65 bytes with 0x04 prefix).
+ * This validation function only checks format, it does not transform keys.
+ * For key normalization (including decompression), use the crypto provider's
+ * normalizeToUncompressed method.
+ *
+ * @param publicKey - Public key to validate
+ * @throws {Error} When public key is not in uncompressed format
+ */
+declare function assertUncompressedPublicKey(publicKey: Uint8Array): void;
+
+export { assertUncompressedPublicKey, bytesEqual, concatBytes, copyBytes, generateSeed, isValidPrivateKeyFormat, isValidPublicKeyFormat, parseEncryptedDataBuffer, processWalletPrivateKey, processWalletPublicKey };