@jibidieuw/dexes 0.0.2 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cryptogram Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Address, TransactionReceipt, PublicClient, WalletClient, BlockTag } from 'viem';
+import { Address, TransactionReceipt, PublicClient, Transport, Chain, WalletClient, BlockTag } from 'viem';
 import * as openpgp from 'openpgp';
 
 declare class InvalidHexError extends Error {
@@ -141,7 +141,7 @@ declare class FlatFee implements IFlatFee {
      * @param client A Viem public client for interacting with the blockchain.
      * @param walletClient Optional Viem wallet client for signing transactions.
      */
-    constructor(address: Address, client: PublicClient, walletClient?: WalletClient);
+    constructor(address: Address, client: PublicClient<Transport, Chain | undefined>, walletClient?: WalletClient);
     /*****************************************************************************************************************/
     /*****************************************************************************************************************/
     /**
@@ -159,7 +159,7 @@ declare class FlatFee implements IFlatFee {
     /**
      * Sets the Viem public client.
      */
-    set client(client: PublicClient);
+    set client(client: PublicClient<Transport, Chain | undefined>);
     /**
      * Gets the Viem wallet client.
      */
@@ -667,13 +667,14 @@ interface IWeb3PGPService {
      *
      * @description
      * This method:
-     * 1. Verifies the provided public key and subkeys have a valid signature, are not expired and not revoked.
+     * 1. (If not insecure) Verifies the provided public key and subkeys have a valid signature, are not expired and not revoked.
      * 2. Extracts the primary key fingerprint and subkey fingerprints
      * 3. Ensures the key and its subkeys are not registered on-chain (enforced by smart contract).
      * 4. Serializes the key into the OpenPGP binary format.
      * 5. Registers the key on-chain via the Web3PGP contract
      *
      * @param key The OpenPGP public key to register (may include subkeys)
+     * @param insecure If true, skips cryptographic verifications of the key and subkeys. Defaults to false.
      * @returns Transaction receipt after successful registration
      *
      * @throws Error if the key or one of its subkeys are invalid
@@ -689,7 +690,7 @@ interface IWeb3PGPService {
      * console.log(`Key registered at block ${receipt.blockNumber}`);
      * ```
      */
-    register(key: openpgp.PublicKey): Promise<TransactionReceipt>;
+    register(key: openpgp.PublicKey, insecure?: boolean): Promise<TransactionReceipt>;
     /**
      * Update an existing OpenPGP public key on the blockchain to add or revoke user ID packets,
      * change preferences or update key expiration.
@@ -1980,7 +1981,7 @@ declare class Web3PGP extends FlatFee implements IWeb3PGP {
     private static readonly OWNERSHIP_PROVED_EVENT;
     private static readonly KEY_CERTIFIED_EVENT;
     private static readonly KEY_CERTIFICATION_REVOKED_EVENT;
-    constructor(address: `0x${string}`, client: PublicClient, walletClient?: WalletClient);
+    constructor(address: `0x${string}`, client: PublicClient<Transport, Chain | undefined>, walletClient?: WalletClient);
     /*****************************************************************************************************************/
     /*****************************************************************************************************************/
     /**
@@ -2300,8 +2301,8 @@ declare class Web3PGPServiceError extends Error {
  * This error indicates a serious problem that prevents the operation from continuing such as network failures and others has occurred.
  */
 declare class Web3PGPServiceCriticalError extends Web3PGPServiceError {
-    readonly cause?: Error | undefined;
-    constructor(message: string, cause?: Error | undefined);
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
 }
 /**
  * Error thrown when key or blockchain data validation fails.
@@ -2406,7 +2407,7 @@ declare class Web3PGPService implements IWeb3PGPService {
      * console.log(`Key registered at block ${receipt.blockNumber}`);
      * ```
      */
-    register(key: openpgp.PublicKey): Promise<TransactionReceipt>;
+    register(key: openpgp.PublicKey, insecure?: boolean): Promise<TransactionReceipt>;
     /**
      * Update an existing OpenPGP public key on the blockchain to add or revoke user ID packets,
      * change preferences or update key expiration.
@@ -2747,42 +2748,42 @@ declare class Web3PGPService implements IWeb3PGPService {
      */
     extractFromKeyRevokedLog(log: KeyRevokedLog, skipCryptographicVerifications?: boolean): Promise<[openpgp.PublicKey | undefined, string | undefined]>;
     /**
- * Validate and extract the updated public key from a KeyUpdatedLog event.
- *
- * @description
- * This method:
- * 1. Validates the log data contains required fields
- * 2. Extracts and parses the OpenPGP message from the log
- * 3. Verifies the primary key fingerprint matches the declared one
- * 4. (if verifications are enabled) Verifies the primary key has a valid signature, is not expired and is not
- *    revoked at the time of update (uses the block timestamp).
- *
- * Cryptographic verifications of the key (step 4) can be skipped by setting the `skipCryptographicVerifications`
- * parameter to true. This is useful when users want to extract and parse the OpenPGP key material in order to perform
- * custom validations or inspections in case the verification fails, is expected to fail or is performed by an external
- * OpenPGP toolkit.
- *
- * @param log The KeyUpdatedLog event data from the blockchain
- * @param skipCryptographicVerifications If true, skips cryptographic verifications of key. Defaults to false.
- * @returns The validated OpenPGP public key extracted from the log
- *
- * @throws Web3PGPServiceValidationError if the log data is invalid or missing required fields
- * @throws Web3PGPServiceValidationError if the extracted OpenPGP message is invalid or corrupted
- * @throws Web3PGPServiceValidationError if the primary key fingerprint does not match the log data
- *
- * @example
- * ```typescript
- * const logs = await web3pgp.searchKeyUpdatedLogs();
- * for (const log of logs) {
- *   try {
- *     const publicKey = await service.extractFromKeyUpdatedLog(log);
- *     console.log(`Valid updated key: ${publicKey.getFingerprint()}`);
- *   } catch (err) {
- *     console.warn(`Invalid log data: ${err.message}`);
- *   }
- * }
- * ```
- */
+     * Validate and extract the updated public key from a KeyUpdatedLog event.
+     *
+     * @description
+     * This method:
+     * 1. Validates the log data contains required fields
+     * 2. Extracts and parses the OpenPGP message from the log
+     * 3. Verifies the primary key fingerprint matches the declared one
+     * 4. (if verifications are enabled) Verifies the primary key has a valid signature, is not expired and is not
+     *    revoked at the time of update (uses the block timestamp).
+     *
+     * Cryptographic verifications of the key (step 4) can be skipped by setting the `skipCryptographicVerifications`
+     * parameter to true. This is useful when users want to extract and parse the OpenPGP key material in order to perform
+     * custom validations or inspections in case the verification fails, is expected to fail or is performed by an external
+     * OpenPGP toolkit.
+     *
+     * @param log The KeyUpdatedLog event data from the blockchain
+     * @param skipCryptographicVerifications If true, skips cryptographic verifications of key. Defaults to false.
+     * @returns The validated OpenPGP public key extracted from the log
+     *
+     * @throws Web3PGPServiceValidationError if the log data is invalid or missing required fields
+     * @throws Web3PGPServiceValidationError if the extracted OpenPGP message is invalid or corrupted
+     * @throws Web3PGPServiceValidationError if the primary key fingerprint does not match the log data
+     *
+     * @example
+     * ```typescript
+     * const logs = await web3pgp.searchKeyUpdatedLogs();
+     * for (const log of logs) {
+     *   try {
+     *     const publicKey = await service.extractFromKeyUpdatedLog(log);
+     *     console.log(`Valid updated key: ${publicKey.getFingerprint()}`);
+     *   } catch (err) {
+     *     console.warn(`Invalid log data: ${err.message}`);
+     *   }
+     * }
+     * ```
+     */
     extractFromKeyUpdatedLog(log: KeyUpdatedLog, skipCryptographicVerifications?: boolean): Promise<openpgp.PublicKey>;
     /**
      * Validate and extract the certified public key from a KeyCertifiedLog event.
@@ -2940,9 +2941,9 @@ declare enum EventType {
     COPY = 1
 }
 /**
- * Constants representing the different event types emitted by the Web3Doc smart contract.
+ * Constants representing the different event types emitted by the Web3Sign smart contract.
  */
-declare const Web3DocEvents: {
+declare const Web3SignEvents: {
     readonly Document: "Document";
     readonly Copy: "Copy";
     readonly Notification: "Notification";
@@ -2962,7 +2963,7 @@ declare const Web3DocEvents: {
  * @property mimeType Optional, The MIME type of the document and additional attributes (RFC6838)
  */
 type DocumentLog = BaseLog & {
-    type: typeof Web3DocEvents.Document;
+    type: typeof Web3SignEvents.Document;
     id: bigint;
     emitter: `0x${string}`;
     dochash: `0x${string}`;
@@ -2981,7 +2982,7 @@ type DocumentLog = BaseLog & {
  * @property uri The URI which can be used to download the binary OpenPGP message containing the document from an off-chain storage.
  */
 type CopyLog = BaseLog & {
-    type: typeof Web3DocEvents.Copy;
+    type: typeof Web3SignEvents.Copy;
     copy: bigint;
     original: bigint;
     emitter: `0x${string}`;
@@ -2998,7 +2999,7 @@ type CopyLog = BaseLog & {
  * @property signatureRequested If true, the recipient is prompted by the emitter to sign the document.
  */
 type NotificationLog = BaseLog & {
-    type: typeof Web3DocEvents.Notification;
+    type: typeof Web3SignEvents.Notification;
     id: bigint;
     emitter: `0x${string}`;
     recipient: `0x${string}`;
@@ -3014,7 +3015,7 @@ type NotificationLog = BaseLog & {
  * @property signature The binary OpenPGP message which contains the detached signature over the document.
  */
 type SignatureLog = BaseLog & {
-    type: typeof Web3DocEvents.Signature;
+    type: typeof Web3SignEvents.Signature;
     id: bigint;
     emitter: `0x${string}`;
     signatureHash: `0x${string}`;
@@ -3029,7 +3030,7 @@ type SignatureLog = BaseLog & {
  * @property signature A detached binary OpenPGP signature created over the signature hash.
  */
 type SignatureRevocationLog = BaseLog & {
-    type: typeof Web3DocEvents.SignatureRevocation;
+    type: typeof Web3SignEvents.SignatureRevocation;
     id: bigint;
     emitter: `0x${string}`;
     signatureHash: `0x${string}`;
@@ -3044,7 +3045,7 @@ type SignatureRevocationLog = BaseLog & {
  * @property signature A detached binary OpenPGP signature created over the keccak256 hash of the document.
  */
 type TimestampLog = BaseLog & {
-    type: typeof Web3DocEvents.Timestamp;
+    type: typeof Web3SignEvents.Timestamp;
     id: bigint;
     emitter: `0x${string}`;
     dochash: `0x${string}`;
@@ -3052,11 +3053,11 @@ type TimestampLog = BaseLog & {
 };
 
 /**
- * TypeScript interface for the Web3Doc smart contract.
+ * TypeScript interface for the Web3Sign smart contract.
  *
- * This interface provides low-level bindings to interact with the Web3Doc contract deployed on the blockchain.
+ * This interface provides low-level bindings to interact with the Web3Sign contract deployed on the blockchain.
  */
-interface IWeb3Doc extends IFlatFee {
+interface IWeb3Sign extends IFlatFee {
     /*****************************************************************************************************************/
     /*****************************************************************************************************************/
     /**
@@ -3377,17 +3378,17 @@ interface IWeb3Doc extends IFlatFee {
 }
 
 /**
- * Interface representing the Web3Doc service for managing documents on the blockchain.
+ * Interface representing the Web3Sign service for managing documents on the blockchain.
  *
  * Higher order bindings are provided and involve OpenPGP operations in order to ease the overall developer experience.
  *
  * @todo Add methods for document exchange (sendDocument, sendCopy, notifyRecipients, ...)
  */
-interface IWeb3DocService {
+interface IWeb3SignService {
     /*****************************************************************************************************************/
     /*****************************************************************************************************************/
     /**
-     * This function allows submitting the data needed to timestamp a document to the Web3Doc smart contract.
+     * This function allows submitting the data needed to timestamp a document to the Web3Sign smart contract.
      *
      * The function will download and verify the emitter's public key using the Web3PGP contract and then it will verify
      * the provided detached signature over the keccak256 hash of the document. If the signature is valid, it will submit
@@ -3404,7 +3405,7 @@ interface IWeb3DocService {
     timestamp(hash: Uint8Array, signature: openpgp.Signature, emitter: `0x${string}`): Promise<[bigint, TransactionReceipt]>;
     /**
      * Verifies a timestamp entry on the blockchain by its ID. The function retrieves the timestamp data from the
-     * Web3Doc smart contract and verifies the detached signature over the document hash using the emitter's public key.
+     * Web3Sign smart contract and verifies the detached signature over the document hash using the emitter's public key.
      *
      * The function returns the document hash, the signature, and the public key used for verification.
      *
@@ -3432,12 +3433,12 @@ interface IWeb3DocService {
 }
 
 /**
- * Implementation of the Web3Doc contract interface.
+ * Implementation of the Web3Sign contract interface.
  *
- * This class provides low-level bindings to interact with the Web3Doc contract deployed on the blockchain.
+ * This class provides low-level bindings to interact with the Web3Sign contract deployed on the blockchain.
  * Extends FlatFee to inherit fee management and access control functionality.
  */
-declare class Web3Doc extends FlatFee implements IWeb3Doc {
+declare class Web3Sign extends FlatFee implements IWeb3Sign {
     static readonly abi: readonly [{
         readonly type: "constructor";
         readonly inputs: readonly [];
@@ -3479,7 +3480,7 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
         }, {
             readonly name: "recipients";
             readonly type: "tuple[]";
-            readonly internalType: "struct IWeb3Doc.Recipient[]";
+            readonly internalType: "struct IWeb3Sign.Recipient[]";
             readonly components: readonly [{
                 readonly name: "fingerprint";
                 readonly type: "bytes32";
@@ -3510,7 +3511,7 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
         }, {
             readonly name: "recipients";
             readonly type: "tuple[]";
-            readonly internalType: "struct IWeb3Doc.Recipient[]";
+            readonly internalType: "struct IWeb3Sign.Recipient[]";
             readonly components: readonly [{
                 readonly name: "fingerprint";
                 readonly type: "bytes32";
@@ -3759,7 +3760,7 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
         }, {
             readonly name: "recipients";
             readonly type: "tuple[]";
-            readonly internalType: "struct IWeb3Doc.Recipient[]";
+            readonly internalType: "struct IWeb3Sign.Recipient[]";
             readonly components: readonly [{
                 readonly name: "fingerprint";
                 readonly type: "bytes32";
@@ -3798,7 +3799,7 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
         }, {
             readonly name: "recipients";
             readonly type: "tuple[]";
-            readonly internalType: "struct IWeb3Doc.Recipient[]";
+            readonly internalType: "struct IWeb3Sign.Recipient[]";
             readonly components: readonly [{
                 readonly name: "fingerprint";
                 readonly type: "bytes32";
@@ -4034,7 +4035,7 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
             readonly name: "source";
             readonly type: "uint8";
             readonly indexed: false;
-            readonly internalType: "enum IWeb3Doc.EventType";
+            readonly internalType: "enum IWeb3Sign.EventType";
         }, {
             readonly name: "signatureRequested";
             readonly type: "bool";
@@ -4290,9 +4291,9 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
     private static readonly SIGNATURE_REVOCATION_EVENT;
     private static readonly TIMESTAMP_EVENT;
     /**
-     * Creates a new Web3Doc instance.
+     * Creates a new Web3Sign instance.
      *
-     * @param address The address of the Web3Doc smart contract.
+     * @param address The address of the Web3Sign smart contract.
      * @param web3pgp An instance implementing the IWeb3PGP interface for public key operations.
      * @param client A Viem public client for interacting with the blockchain.
      * @param walletClient Optional Viem wallet client for signing transactions.
@@ -4617,37 +4618,9 @@ declare class Web3Doc extends FlatFee implements IWeb3Doc {
 /*****************************************************************************************************************/
 /*****************************************************************************************************************/
 /**
- * Base error class for Web3DocService errors.
- */
-declare class Web3DocServiceError extends Error {
-    constructor(message: string);
-}
-/**
- * Error thrown when a critical failure occurs during service operations.
- *
- * This error indicates a serious problem that prevents the operation from continuing such as network failures and others has occurred.
- */
-declare class Web3DocServiceCriticalError extends Web3DocServiceError {
-    readonly cause?: Error | undefined;
-    constructor(message: string, cause?: Error | undefined);
-}
-/**
- * Error thrown when document or blockchain data validation fails.
- *
- * This can happen because the smart contract does not validate the data it stores, they
- * have to be verified by the client application. Furthermore, as anyone can submit documents,
- * malformed or invalid data may be submitted by malicious actors.
- */
-declare class Web3DocServiceValidationError extends Web3DocServiceError {
-    readonly cause?: Error | undefined;
-    constructor(message: string, cause?: Error | undefined);
-}
-/*****************************************************************************************************************/
-/*****************************************************************************************************************/
-/**
- * Configuration options for Web3DocService.
+ * Configuration options for Web3SignService.
  */
-interface Web3DocServiceOptions {
+interface Web3SignServiceOptions {
     /**
      * Maximum number of concurrent operations performed when processing documents and verifying signatures.
      *
@@ -4659,30 +4632,30 @@ interface Web3DocServiceOptions {
     concurrencyLimit?: number;
 }
 /**
- * Implementation of the Web3Doc service interface.
+ * Implementation of the Web3Sign service interface.
  *
  * This service provides high-level functions for managing documents on the blockchain with integrated
  * OpenPGP operations to ease developer experience.
  */
-declare class Web3DocService implements IWeb3DocService {
+declare class Web3SignService implements IWeb3SignService {
     private _web3pgpService;
-    private _web3doc;
+    private _web3sign;
     private _options;
     /**
-     * Creates a new Web3DocService instance.
+     * Creates a new Web3SignService instance.
      *
-     * @param web3doc An instance implementing the IWeb3Doc interface.
+     * @param web3sign An instance implementing the IWeb3Sign interface.
      * @param options Optional configuration options for the service.
      */
-    constructor(web3doc: IWeb3Doc, web3pgpService: IWeb3PGPService, options?: Web3DocServiceOptions);
+    constructor(web3sign: IWeb3Sign, web3pgpService: IWeb3PGPService, options?: Web3SignServiceOptions);
     /**
-     * Gets the Web3Doc instance.
+     * Gets the Web3Sign instance.
      */
-    get web3doc(): IWeb3Doc;
+    get web3sign(): IWeb3Sign;
     /**
-     * Sets the Web3Doc instance.
+     * Sets the Web3Sign instance.
      */
-    set web3doc(value: IWeb3Doc);
+    set web3sign(value: IWeb3Sign);
     /**
      * Gets the Web3PGP service instance.
      */
@@ -4694,15 +4667,15 @@ declare class Web3DocService implements IWeb3DocService {
     /**
      * Gets the service configuration options.
      */
-    get options(): Required<Web3DocServiceOptions>;
+    get options(): Required<Web3SignServiceOptions>;
     /**
      * Sets the service configuration options.
      */
-    set options(value: Required<Web3DocServiceOptions>);
+    set options(value: Required<Web3SignServiceOptions>);
     /*****************************************************************************************************************/
     /*****************************************************************************************************************/
     /**
-     * This function allows submitting the data needed to timestamp a document to the Web3Doc smart contract.
+     * This function allows submitting the data needed to timestamp a document to the Web3Sign smart contract.
      *
      * The function will download and verify the emitter's public key using the Web3PGP contract and then it will verify
      * the provided detached signature over the keccak256 hash of the document. If the signature is valid, it will submit
@@ -4719,7 +4692,7 @@ declare class Web3DocService implements IWeb3DocService {
     timestamp(hash: Uint8Array, signature: openpgp.Signature, emitter: `0x${string}`): Promise<[bigint, TransactionReceipt]>;
     /**
      * Verifies a timestamp entry on the blockchain by its ID. The function retrieves the timestamp data from the
-     * Web3Doc smart contract and verifies the detached signature over the document hash using the emitter's public key.
+     * Web3Sign smart contract and verifies the detached signature over the document hash using the emitter's public key.
      *
      * The function returns the document hash, the signature, and the public key used for verification.
      *
@@ -4746,4 +4719,73 @@ declare class Web3DocService implements IWeb3DocService {
     findTimestampsByHash(hash: Uint8Array): Promise<bigint[]>;
 }
 
-export { BYTES32_ZERO, type CopyLog, type DocumentLog, EventType, type FeesWithdrawnLog, FlatFee, HexTooLongError, type IFlatFee, type IWeb3Doc, type IWeb3DocService, type IWeb3PGP, type IWeb3PGPService, InvalidHexError, type KeyCertificationRevokedLog, type KeyCertifiedLog, type KeyRegisteredLog, type KeyRevokedLog, type KeyUpdatedLog, type NotificationLog, type OwnershipChallengedLog, type OwnershipProvedLog, type Recipient, type RequestedFeeUpdatedLog, type SignatureLog, type SignatureRevocationLog, type SubkeyAddedLog, type TimestampLog, Web3Doc, Web3DocEvents, Web3DocService, Web3DocServiceCriticalError, Web3DocServiceError, type Web3DocServiceOptions, Web3DocServiceValidationError, Web3PGP, type Web3PGPEventLog, Web3PGPEvents, Web3PGPService, Web3PGPServiceCriticalError, Web3PGPServiceError, type Web3PGPServiceOptions, Web3PGPServiceValidationError, to0x, toBytes32 };
+/**
+ * Base error class for all Web3Sign-related errors.
+ * Extends the native Error class to provide consistent error handling across the Web3Sign system.
+ */
+declare class Web3SignError extends Error {
+    /**
+     * Optional underlying error that caused this error.
+     */
+    cause?: Error | undefined;
+    /**
+     * Creates a new Web3SignError instance.
+     * @param message - Human-readable error description
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Critical error class for unrecoverable Web3Sign errors.
+ * Used when the system encounters a fatal condition that requires immediate attention.
+ */
+declare class Web3SignCriticalError extends Web3SignError {
+    /**
+     * Creates a new Web3SignCriticalError instance.
+     * @param message - Human-readable error description
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Base error class for Web3Sign service-related errors.
+ * Used for errors that occur during service operations.
+ */
+declare class Web3SignServiceError extends Error {
+    /**
+     * Optional underlying error that caused this error.
+     */
+    cause?: Error | undefined;
+    /**
+     * Creates a new Web3SignServiceError instance.
+     * @param message - Human-readable error description
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Validation error class for Web3Sign service validation failures.
+ * Thrown when input validation fails or data does not meet required criteria.
+ */
+declare class Web3SignServiceValidationError extends Web3SignServiceError {
+    /**
+     * Creates a new Web3SignServiceValidationError instance.
+     * @param message - Human-readable error description
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Critical service error class for unrecoverable Web3Sign service errors.
+ * Used when a service encounters a fatal condition that prevents continued operation.
+ */
+declare class Web3SignServiceCriticalError extends Web3SignServiceError {
+    /**
+     * Creates a new Web3SignServiceCriticalError instance.
+     * @param message - Human-readable error description
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, cause?: Error);
+}
+
+export { BYTES32_ZERO, type CopyLog, type DocumentLog, EventType, type FeesWithdrawnLog, FlatFee, HexTooLongError, type IFlatFee, type IWeb3PGP, type IWeb3PGPService, type IWeb3Sign, type IWeb3SignService, InvalidHexError, type KeyCertificationRevokedLog, type KeyCertifiedLog, type KeyRegisteredLog, type KeyRevokedLog, type KeyUpdatedLog, type NotificationLog, type OwnershipChallengedLog, type OwnershipProvedLog, type Recipient, type RequestedFeeUpdatedLog, type SignatureLog, type SignatureRevocationLog, type SubkeyAddedLog, type TimestampLog, Web3PGP, type Web3PGPEventLog, Web3PGPEvents, Web3PGPService, Web3PGPServiceCriticalError, Web3PGPServiceError, type Web3PGPServiceOptions, Web3PGPServiceValidationError, Web3Sign, Web3SignCriticalError, Web3SignError, Web3SignEvents, Web3SignService, Web3SignServiceCriticalError, Web3SignServiceError, Web3SignServiceValidationError, to0x, toBytes32 };