@umbra-privacy/sdk 1.0.0 → 2.0.1

package/dist/chunk-WVHQ46DD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/common/errors.ts","../src/crypto/errors.ts","../src/solana/errors.ts","../src/umbra/errors.ts"],"names":[],"mappings":"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","file":"chunk-WVHQ46DD.js","sourcesContent":["/**\n * Error Classes\n *\n * Centralized error hierarchy for the Umbra SDK.\n * Contains the base `UmbraError` and all domain-specific assertion error classes.\n *\n * @remarks\n * The SDK uses a two-level error hierarchy:\n *\n * 1. `UmbraError` — top-level base class for all SDK errors. Consumers can use\n *    `instanceof UmbraError` (or the `isUmbraError` type guard) to distinguish SDK errors\n *    from third-party or built-in errors in a catch block.\n *\n * 2. Domain assertion errors — thrown by type-assertion functions when a value fails\n *    validation. Each domain has its own class to make it easy to catch errors from a\n *    specific subsystem:\n *    - `MathematicsAssertionError` — thrown by `assertU8`, `assertU256`, etc.\n *    - `CryptographyAssertionError` — thrown by `assertBn254FieldElement`, `assertAesKey`, etc.\n *    - `SolanaAssertionError` — thrown by Solana-type assertion functions.\n *    - `TemporalAssertionError` — thrown by `assertYear`, `assertMonth`, etc.\n *\n * All four assertion error classes share the same three properties:\n * - `value` — the actual value that failed\n * - `expectedType` — the name of the expected branded type\n * - `constraint` — optional human-readable constraint description\n *\n * @packageDocumentation\n * @module common/errors\n */\n\n/* =============================================================================\n * BASE ERROR\n *\n * The root error class for all Umbra SDK errors.\n * ============================================================================= */\n\n/**\n * Base error class for all Umbra SDK errors.\n *\n * All errors thrown by the SDK extend this class, allowing consumers\n * to distinguish SDK errors from other errors using `instanceof`.\n *\n * @remarks\n * Prefer using the `isUmbraError` type guard over `instanceof UmbraError` when writing\n * defensive catch handlers — the type guard also works across module boundaries and\n * iframe/realm boundaries where `instanceof` may fail due to different class references.\n *\n * Sub-classes (domain assertion errors) extend this class so callers can catch either\n * all SDK errors at once (`instanceof UmbraError`) or only a specific domain's failures\n * (e.g., `instanceof MathematicsAssertionError`).\n *\n * @example\n * ```typescript\n * try {\n *   await umbraClient.register();\n * } catch (error) {\n *   if (error instanceof UmbraError) {\n *     console.log('SDK error:', error.message);\n *     console.log('Error code:', error.code);\n *   } else {\n *     throw error; // Re-throw non-SDK errors\n *   }\n * }\n * ```\n *\n * @see {@link isUmbraError}\n * @public\n */\nexport class UmbraError extends Error {\n  /**\n   * A machine-readable error code for programmatic error handling.\n   *\n   * @remarks\n   * Defaults to `\"UMBRA_ERROR\"` when no code is supplied in the constructor options.\n   * Sub-classes or specific throw sites should supply a more specific code to allow\n   * callers to branch on error identity without string-matching `message`.\n   *\n   * @readonly\n   */\n  readonly code: string;\n\n  /**\n   * Additional context about the error.\n   *\n   * @remarks\n   * A free-form key-value map of diagnostic data attached to the error at the throw site.\n   * Useful for logging and debugging — consumers should not rely on specific keys for\n   * control flow; use `code` for programmatic branching instead.\n   *\n   * Will be `undefined` when no context was provided to the constructor.\n   *\n   * @readonly\n   */\n  readonly context?: Record<string, unknown>;\n\n  /**\n   * The original error that caused this error, if any.\n   *\n   * @remarks\n   * When an SDK function wraps a lower-level error (e.g., a failed RPC call or a\n   * cryptographic library error), it sets `cause` to the original thrown value so\n   * callers can inspect the full error chain.\n   *\n   * Will be `undefined` when there is no underlying cause.\n   *\n   * @readonly\n   */\n  override readonly cause?: unknown;\n\n  /**\n   * Creates a new UmbraError.\n   *\n   * @param message - Human-readable description of what went wrong. Should be\n   *   actionable and specific enough for a developer to understand the failure\n   *   without reading source code.\n   * @param options - Optional structured metadata attached to the error.\n   * @param options.code - Machine-readable error code for programmatic branching.\n   *   Defaults to `\"UMBRA_ERROR\"` if omitted.\n   * @param options.context - Free-form diagnostic key-value pairs. Omit or set to\n   *   `undefined` to leave the `context` property unset.\n   * @param options.cause - The original error that triggered this one. Enables\n   *   full error-chain inspection. Omit or set to `undefined` when there is no\n   *   underlying cause.\n   *\n   * @defaultValue `options` — `undefined` (all options optional)\n   * @defaultValue `options.code` — `\"UMBRA_ERROR\"`\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message);\n    this.name = \"UmbraError\";\n    this.code = options?.code ?? \"UMBRA_ERROR\";\n    if (options?.context !== undefined) {\n      this.context = options.context;\n    }\n    if (options?.cause !== undefined) {\n      this.cause = options.cause;\n    }\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    Error.captureStackTrace(this, UmbraError);\n  }\n}\n\n/**\n * Type guard to check if an error is an UmbraError.\n *\n * @remarks\n * Prefer this guard over `error instanceof UmbraError` in generic catch handlers because\n * it is safe to call with any value (including `null`, primitives, and non-Error objects)\n * and narrows the type to `UmbraError` for TypeScript's type system in the true branch.\n *\n * @param error - The value to test. Typically the caught value in a `catch (error)` block,\n *   typed as `unknown`.\n * @returns `true` and narrows `error` to `UmbraError` when the value is an instance of\n *   `UmbraError` (or any sub-class such as `MathematicsAssertionError`). Returns `false`\n *   for all other values.\n *\n * @example\n * ```typescript\n * try {\n *   await operation();\n * } catch (error) {\n *   if (isUmbraError(error)) {\n *     // error is narrowed to UmbraError here\n *     console.log('SDK error code:', error.code);\n *     console.log('SDK error context:', error.context);\n *   }\n * }\n * ```\n *\n * @see {@link UmbraError}\n * @public\n */\nexport function isUmbraError(error: unknown): error is UmbraError {\n  return error instanceof UmbraError;\n}\n\n/* =============================================================================\n * MATHEMATICS ASSERTION ERROR\n *\n * Error thrown when mathematical type assertions fail.\n * ============================================================================= */\n\n/**\n * Error thrown when a value fails a mathematical type assertion.\n *\n * This error provides detailed information about why an assertion failed,\n * including the actual value, the expected type, and the constraint that\n * was violated.\n *\n * @remarks\n * All assertion functions in the mathematics module (e.g., `assertU8`, `assertU256`,\n * `assertU32LeBytes`) throw this error type on failure. Catch it specifically to handle\n * mathematical type validation failures differently from cryptographic or Solana errors.\n *\n * The three diagnostic properties together allow automated logging pipelines to produce\n * structured records without parsing the `message` string:\n * - `value` — the actual value that was supplied\n * - `expectedType` — the branded type name (e.g., `\"U8\"`, `\"U256LeBytes\"`)\n * - `constraint` — the violated range or length rule, or `undefined` for type mismatches\n *\n * Note that this class does NOT extend `UmbraError`. It extends `Error` directly to keep\n * the assertion error classes lightweight and independent of the UmbraError hierarchy.\n * Use `isUmbraError` only to detect top-level SDK operational errors; use\n * `instanceof MathematicsAssertionError` for assertion failures.\n *\n * @example\n * ```typescript\n * import { assertU8, MathematicsAssertionError } from \"./mathematics\";\n *\n * try {\n *     const value = assertU8(256n); // Will throw\n * } catch (error) {\n *     if (error instanceof MathematicsAssertionError) {\n *         console.error(`Assertion failed for ${error.expectedType}`);\n *         console.error(`Value: ${error.value}`);\n *         console.error(`Constraint: ${error.constraint}`);\n *         // Output:\n *         // Assertion failed for U8\n *         // Value: 256\n *         // Constraint: 0 <= value <= 255\n *     }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Safe parse pattern — returns null instead of throwing\n * function safeParseU8(value: bigint): U8 | null {\n *     try {\n *         return assertU8(value);\n *     } catch (error) {\n *         if (error instanceof MathematicsAssertionError) {\n *             console.warn(`Invalid U8 value: ${value}`);\n *             return null;\n *         }\n *         throw error; // Re-throw unexpected errors\n *     }\n * }\n * ```\n *\n * @sealed\n * @public\n */\nexport class MathematicsAssertionError extends Error {\n  /**\n   * The actual value that failed the assertion.\n   *\n   * @remarks\n   * The runtime type reflects what was actually passed to the assertion function:\n   * - `bigint` for integer assertions (`assertU8`, `assertU256`, etc.)\n   * - `Uint8Array` for byte-array assertions (`assertU256LeBytes`, `assertU32LeBytes`, etc.)\n   * - Any other type when a non-numeric value was passed unexpectedly\n   *\n   * @readonly\n   */\n  public readonly value: unknown;\n\n  /**\n   * The type that was expected.\n   *\n   * @remarks\n   * Contains the branded type name exactly as it appears in the SDK type system,\n   * e.g., `\"U8\"`, `\"U256\"`, `\"U32LeBytes\"`. Use this for structured logging or\n   * to build user-facing error messages without parsing the `message` string.\n   *\n   * @readonly\n   */\n  public readonly expectedType: string;\n\n  /**\n   * Description of the constraint that was violated.\n   *\n   * @remarks\n   * Is `undefined` when only a type check failed (e.g., a `string` was passed where a\n   * `bigint` was expected). Contains a human-readable inequality or length rule when a\n   * value of the correct type was out of the allowed range.\n   *\n   * @example\n   * - `\"0 <= value <= 255\"` — U8 range violation\n   * - `\"length === 32\"` — U256LeBytes length violation\n   * - `\"value >= 0\"` — negative value passed to an unsigned integer assertion\n   *\n   * @readonly\n   */\n  public readonly constraint: string | undefined;\n\n  /**\n   * Creates a new MathematicsAssertionError.\n   *\n   * @param message - Human-readable description of the assertion failure. Should name\n   *   the assertion function, the expected type, and the constraint that was violated.\n   * @param options - Structured diagnostic details attached to the error.\n   * @param options.value - The actual value that was supplied and failed the assertion.\n   * @param options.expectedType - The name of the branded type that was expected\n   *   (e.g., `\"U8\"`, `\"U256LeBytes\"`).\n   * @param options.constraint - Optional human-readable constraint description\n   *   (e.g., `\"0 <= value <= 255\"`). Omit when the failure is a type mismatch rather\n   *   than a range violation.\n   */\n  constructor(\n    message: string,\n    options: {\n      value: unknown;\n      expectedType: string;\n      constraint?: string;\n    },\n  ) {\n    super(message);\n    this.name = \"MathematicsAssertionError\";\n    this.value = options.value;\n    this.expectedType = options.expectedType;\n    this.constraint = options.constraint;\n\n    // Maintains proper stack trace for where our error was thrown (V8 only)\n    Error.captureStackTrace(this, MathematicsAssertionError);\n\n    // Set the prototype explicitly for proper instanceof checks\n    Object.setPrototypeOf(this, MathematicsAssertionError.prototype);\n  }\n}\n\n/* =============================================================================\n * CRYPTOGRAPHY ASSERTION ERROR\n *\n * Error thrown when cryptographic type assertions fail.\n * ============================================================================= */\n\n/**\n * Error thrown when a value fails a cryptographic type assertion.\n *\n * This error provides detailed information about why an assertion failed,\n * including the actual value, the expected type, and the constraint that\n * was violated.\n *\n * @remarks\n * Thrown by assertion functions in the cryptography module, such as\n * `assertBn254FieldElement`, `assertAesKey`, `assertX25519PrivateKey`, and similar.\n * Each function validates that a value conforms to a branded cryptographic type,\n * throwing this error with a precise `expectedType` and `constraint` when it does not.\n *\n * Common reasons for failure:\n * - A `bigint` field element exceeds the BN254 or Curve25519 field prime\n * - A byte array has the wrong length (e.g., a 31-byte array passed as an AES-256 key)\n * - A wrong JavaScript type was supplied (e.g., a `number` instead of a `bigint`)\n *\n * @example\n * ```typescript\n * import { assertBn254FieldElement, CryptographyAssertionError } from \"./cryptography\";\n *\n * try {\n *     assertBn254FieldElement(invalidValue); // Will throw\n * } catch (error) {\n *     if (error instanceof CryptographyAssertionError) {\n *         console.error(`Assertion failed for ${error.expectedType}`);\n *         console.error(`Value: ${error.value}`);\n *         console.error(`Constraint: ${error.constraint}`);\n *     }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Distinguish cryptographic assertion failures from mathematical ones\n * try {\n *     const key = assertAesKey(rawBytes);\n * } catch (error) {\n *     if (error instanceof CryptographyAssertionError) {\n *         console.warn(\"Crypto assertion failed:\", error.expectedType, error.constraint);\n *     } else if (error instanceof MathematicsAssertionError) {\n *         console.warn(\"Math assertion failed:\", error.expectedType, error.constraint);\n *     }\n * }\n * ```\n *\n * @see {@link MathematicsAssertionError}\n * @see {@link SolanaAssertionError}\n * @see {@link TemporalAssertionError}\n * @sealed\n * @public\n */\nexport class CryptographyAssertionError extends Error {\n  /**\n   * The actual value that failed the assertion.\n   *\n   * @remarks\n   * The runtime type reflects what was actually passed to the assertion function:\n   * - `bigint` for field element assertions (`assertBn254FieldElement`, etc.)\n   * - `Uint8Array` for byte-array assertions (`assertAesKey`, `assertX25519PrivateKey`, etc.)\n   * - Any other type when an entirely wrong value type was supplied\n   *\n   * @readonly\n   */\n  public readonly value: unknown;\n\n  /**\n   * The type that was expected (e.g., `\"Bn254FieldElement\"`, `\"PoseidonKey\"`, `\"AesKey\"`).\n   *\n   * @remarks\n   * Contains the branded type name exactly as it appears in the SDK type system.\n   * Use this property for structured logging without parsing the `message` string.\n   *\n   * @readonly\n   */\n  public readonly expectedType: string;\n\n  /**\n   * Description of the constraint that was violated.\n   *\n   * @remarks\n   * Is `undefined` for pure type-mismatch failures (e.g., `string` instead of `bigint`).\n   * Contains a human-readable constraint description for range and length violations\n   * (e.g., `\"value < BN254_FIELD_PRIME\"`, `\"length === 32\"`).\n   *\n   * @readonly\n   */\n  public readonly constraint: string | undefined;\n\n  /**\n   * Creates a new CryptographyAssertionError.\n   *\n   * @param message - Human-readable description of the assertion failure. Should name\n   *   the assertion function, the expected type, and the constraint that was violated.\n   * @param options - Structured diagnostic details attached to the error.\n   * @param options.value - The actual value that was supplied and failed the assertion.\n   * @param options.expectedType - The name of the branded cryptographic type that was\n   *   expected (e.g., `\"Bn254FieldElement\"`, `\"AesKey\"`).\n   * @param options.constraint - Optional human-readable constraint description.\n   *   Omit when the failure is a type mismatch rather than a range or length violation.\n   */\n  constructor(\n    message: string,\n    options: {\n      value: unknown;\n      expectedType: string;\n      constraint?: string;\n    },\n  ) {\n    super(message);\n    this.name = \"CryptographyAssertionError\";\n    this.value = options.value;\n    this.expectedType = options.expectedType;\n    this.constraint = options.constraint;\n\n    Error.captureStackTrace(this, CryptographyAssertionError);\n\n    Object.setPrototypeOf(this, CryptographyAssertionError.prototype);\n  }\n}\n\n/* =============================================================================\n * SOLANA ASSERTION ERROR\n *\n * Error thrown when Solana type assertions fail.\n * ============================================================================= */\n\n/**\n * Error thrown when a Solana type assertion fails.\n *\n * This error provides detailed information about why the assertion failed,\n * including the actual value, expected type, and constraint that was violated.\n *\n * @remarks\n * Thrown by assertion functions for Solana-specific branded types, such as\n * `assertTransactionSignature`, `assertSignatureBytes`, and similar validators.\n * These assertions verify that string or byte-array values conform to Solana's\n * encoding and length conventions (e.g., Base58-encoded 64-byte Ed25519 signatures).\n *\n * Common reasons for failure:\n * - A string that fails Base58 decoding or has the wrong decoded length\n * - A `Uint8Array` with the wrong byte length for a signature or public key\n * - A wrong JavaScript type (e.g., `number` instead of `string`)\n *\n * @example\n * ```typescript\n * import { assertTransactionSignature, SolanaAssertionError } from \"./solana\";\n *\n * try {\n *     assertTransactionSignature(\"invalid!signature\"); // Will throw\n * } catch (error) {\n *     if (error instanceof SolanaAssertionError) {\n *         console.error(`Assertion failed for ${error.expectedType}`);\n *         console.error(`Value: ${error.value}`);\n *         console.error(`Constraint: ${error.constraint}`);\n *     }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Safe parse pattern — returns null on failure\n * function tryParseSignature(raw: unknown): TransactionSignature | null {\n *     try {\n *         return assertTransactionSignature(raw);\n *     } catch (error) {\n *         if (error instanceof SolanaAssertionError) return null;\n *         throw error;\n *     }\n * }\n * ```\n *\n * @see {@link MathematicsAssertionError}\n * @see {@link CryptographyAssertionError}\n * @see {@link TemporalAssertionError}\n * @sealed\n * @public\n */\nexport class SolanaAssertionError extends Error {\n  /**\n   * The actual value that failed the assertion.\n   *\n   * @remarks\n   * The runtime type reflects what was actually passed to the assertion function:\n   * - `string` for Base58-encoded assertions (`assertTransactionSignature`, etc.)\n   * - `Uint8Array` for byte-array assertions (`assertSignatureBytes`, etc.)\n   * - Any other type when a completely wrong value type was supplied\n   *\n   * @readonly\n   */\n  public readonly value: unknown;\n\n  /**\n   * The type that was expected (e.g., `\"TransactionSignature\"`, `\"SignatureBytes\"`).\n   *\n   * @remarks\n   * Contains the branded type name exactly as it appears in the SDK type system.\n   * Use this for structured logging without parsing the `message` string.\n   *\n   * @readonly\n   */\n  public readonly expectedType: string;\n\n  /**\n   * Description of the constraint that was violated.\n   *\n   * @remarks\n   * Is `undefined` for pure type-mismatch failures. Contains a human-readable rule\n   * for encoding or length violations (e.g., `\"valid Base58\"`, `\"length === 64\"`).\n   *\n   * @readonly\n   */\n  public readonly constraint: string | undefined;\n\n  /**\n   * Creates a new SolanaAssertionError.\n   *\n   * @param message - Human-readable description of the assertion failure. Should name\n   *   the assertion function, the expected type, and the constraint that was violated.\n   * @param options - Structured diagnostic details attached to the error.\n   * @param options.value - The actual value that was supplied and failed the assertion.\n   * @param options.expectedType - The name of the branded Solana type that was expected\n   *   (e.g., `\"TransactionSignature\"`, `\"SignatureBytes\"`).\n   * @param options.constraint - Optional human-readable constraint description.\n   *   Omit when the failure is a type mismatch rather than an encoding or length violation.\n   */\n  constructor(\n    message: string,\n    options: {\n      value: unknown;\n      expectedType: string;\n      constraint?: string;\n    },\n  ) {\n    super(message);\n    this.name = \"SolanaAssertionError\";\n    this.value = options.value;\n    this.expectedType = options.expectedType;\n    this.constraint = options.constraint;\n\n    Error.captureStackTrace(this, SolanaAssertionError);\n\n    Object.setPrototypeOf(this, SolanaAssertionError.prototype);\n  }\n}\n\n/* =============================================================================\n * TEMPORAL ASSERTION ERROR\n *\n * Error thrown when temporal type assertions fail.\n * ============================================================================= */\n\n/**\n * Error thrown when a temporal type assertion fails.\n *\n * This error provides detailed information about why an assertion failed,\n * including the actual value, the expected type, and the constraint that\n * was violated.\n *\n * @remarks\n * Thrown by assertion functions for branded temporal types: `assertYear`, `assertMonth`,\n * `assertDay`, `assertHour`, `assertMinute`, and `assertSecond`. These functions validate\n * that a `bigint` value falls within the calendar range appropriate for each component\n * (e.g., months must be in `[1, 12]`, hours in `[0, 23]`).\n *\n * Temporal assertions are used to validate the output of UTC timestamp extraction before\n * the components are used in time-scoped viewing key derivation. In normal operation they\n * should never throw (JavaScript's `Date` always produces in-range values), but callers\n * that construct components manually can encounter these errors.\n *\n * @example\n * ```typescript\n * import { assertMonth, TemporalAssertionError } from \"./temporal\";\n *\n * try {\n *     assertMonth(13n); // Will throw — month must be 1–12\n * } catch (error) {\n *     if (error instanceof TemporalAssertionError) {\n *         console.error(`Assertion failed for ${error.expectedType}`);\n *         console.error(`Value: ${error.value}`);\n *         console.error(`Constraint: ${error.constraint}`);\n *         // Output:\n *         // Assertion failed for Month\n *         // Value: 13\n *         // Constraint: 1 <= value <= 12\n *     }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Safe parse of a user-supplied year value\n * function tryParseYear(raw: bigint): Year | null {\n *     try {\n *         return assertYear(raw);\n *     } catch (error) {\n *         if (error instanceof TemporalAssertionError) return null;\n *         throw error;\n *     }\n * }\n * ```\n *\n * @see {@link MathematicsAssertionError}\n * @see {@link CryptographyAssertionError}\n * @see {@link SolanaAssertionError}\n * @sealed\n * @public\n */\nexport class TemporalAssertionError extends Error {\n  /**\n   * The actual value that failed the assertion.\n   *\n   * @remarks\n   * Will be a `bigint` for all temporal assertions since the temporal types are\n   * BigInt-backed branded types (e.g., `Year`, `Month`, `Day`). May also be any\n   * other type when a non-bigint value was supplied unexpectedly.\n   *\n   * @readonly\n   */\n  public readonly value: unknown;\n\n  /**\n   * The type that was expected (e.g., `\"Year\"`, `\"Month\"`, `\"Hour\"`).\n   *\n   * @remarks\n   * Contains the branded temporal type name exactly as it appears in the SDK type system.\n   * Use this for structured logging without parsing the `message` string.\n   *\n   * @readonly\n   */\n  public readonly expectedType: string;\n\n  /**\n   * Description of the constraint that was violated.\n   *\n   * @remarks\n   * Contains a human-readable range rule for out-of-range values\n   * (e.g., `\"1 <= value <= 12\"` for a month violation). Is `undefined` only for\n   * pure type-mismatch failures (e.g., a `string` passed where a `bigint` was expected),\n   * which should not occur in normal usage.\n   *\n   * @readonly\n   */\n  public readonly constraint: string | undefined;\n\n  /**\n   * Creates a new TemporalAssertionError.\n   *\n   * @param message - Human-readable description of the assertion failure. Should name\n   *   the assertion function, the expected type, and the violated range constraint.\n   * @param details - Structured diagnostic details attached to the error.\n   * @param details.value - The actual `bigint` value (or other type) that was supplied\n   *   and failed the temporal assertion.\n   * @param details.expectedType - The name of the branded temporal type that was expected\n   *   (e.g., `\"Year\"`, `\"Month\"`, `\"Hour\"`).\n   * @param details.constraint - Optional human-readable range description\n   *   (e.g., `\"1 <= value <= 12\"`). Omit when the failure is a type mismatch.\n   */\n  constructor(\n    message: string,\n    details: {\n      value: unknown;\n      expectedType: string;\n      constraint?: string;\n    },\n  ) {\n    super(message);\n    this.name = \"TemporalAssertionError\";\n    this.value = details.value;\n    this.expectedType = details.expectedType;\n    this.constraint = details.constraint;\n  }\n}\n","/**\n * Cryptography Error Classes\n *\n * This module provides error classes for cryptographic operation failures\n * in the Umbra SDK.\n *\n * @module crypto/errors\n */\n\nimport { UmbraError } from \"../common/errors\";\n\n/**\n * Error thrown when a cryptographic operation fails.\n *\n * This includes key derivation failures, encryption/decryption errors,\n * hash computation failures, and ZK proof generation errors.\n *\n * @example\n * ```typescript\n * try {\n *   const commitment = await generateUserCommitment(mvk, index, seed);\n * } catch (error) {\n *   if (error instanceof CryptographyError) {\n *     console.log('Crypto operation failed:', error.operation);\n *   }\n * }\n * ```\n */\nexport class CryptographyError extends UmbraError {\n  /**\n   * The cryptographic operation that failed.\n   */\n  readonly operation?: string;\n\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      operation?: string;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: options?.code ?? \"CRYPTOGRAPHY_ERROR\",\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"CryptographyError\";\n    if (options?.operation !== undefined) {\n      this.operation = options.operation;\n    }\n  }\n}\n\n/**\n * Type guard to check if an error is a CryptographyError.\n */\nexport function isCryptographyError(error: unknown): error is CryptographyError {\n  return error instanceof CryptographyError;\n}\n","/**\n * Solana-Specific Error Classes.\n *\n * This module defines the structured error hierarchy for Solana-related failures\n * in the Umbra SDK. All classes extend `UmbraError` from `../common/errors` and\n * carry structured context that makes programmatic error handling and logging\n * straightforward.\n *\n * @remarks\n * The error hierarchy is:\n * ```\n * UmbraError (base)\n * ├── InstructionError        — instruction build/validation failures\n * ├── RpcError                — JSON-RPC request failures\n * └── TransactionError        — transaction lifecycle failures\n *     ├── TransactionSigningError        — signing-phase failures\n *     │   └── MasterSeedSigningRejectedError  — master seed derivation rejection\n * ```\n *\n * **Type guards** — Each concrete error class has a matching `is*` type guard\n * function ({@link isInstructionError}, {@link isRpcError},\n * {@link isTransactionError}, {@link isTransactionSigningError}). Prefer these\n * over `instanceof` checks in code that may cross module or bundle boundaries,\n * where `instanceof` can fail due to different class references.\n *\n * **Recovery strategies by error type:**\n *\n * - `InstructionError` — inspect `instructionName` and `context` to determine\n *   which account is missing or which parameter is invalid; fix the call site.\n *\n * - `RpcError` — check `statusCode` (HTTP) and `rpcErrorCode` (JSON-RPC) to\n *   distinguish rate limiting (429), node overload (503), or invalid request\n *   (400). Transient errors are typically retryable.\n *\n * - `TransactionError` — check `simulationLogs` for program error messages that\n *   identify the on-chain failure. If `signature` is set, the transaction landed\n *   on-chain but was reverted.\n *\n * - `TransactionSigningError` — check `wasRejected` to distinguish a deliberate\n *   user rejection from a hardware wallet communication failure.\n *\n * - `MasterSeedSigningRejectedError` — the user declined the master seed\n *   derivation message; prompt the user and retry with `getUmbraClientFromSigner`.\n *\n * @packageDocumentation\n */\n\nimport { UmbraError } from \"../common/errors\";\n\n/**\n * Error thrown when building or validating a Solana instruction fails.\n *\n * This error is raised during the instruction-construction phase — before any\n * RPC or network interaction occurs. Common causes include missing required\n * accounts, invalid parameter values, PDA derivation failures, and instruction\n * serialization errors.\n *\n * @remarks\n * The `instructionName` field identifies which instruction failed, which is\n * particularly useful when a single SDK operation constructs multiple\n * instructions. The `context` field (inherited from `UmbraError`) carries\n * arbitrary key-value pairs for additional diagnostic information, such as\n * the list of missing accounts or the conflicting parameter values.\n *\n * **Default error code** — `\"INSTRUCTION_ERROR\"`. Sub-classes or callers may\n * override this via the `code` option.\n *\n * @example\n * Catching and inspecting an instruction build failure:\n * ```typescript\n * import { isInstructionError } from \"@umbra-privacy/sdk\";\n *\n * try {\n *   const instruction = buildRegisterInstruction(params);\n * } catch (error) {\n *   if (isInstructionError(error)) {\n *     console.error(`Instruction \"${error.instructionName}\" failed: ${error.message}`);\n *     console.error(\"Context:\", error.context);\n *   }\n * }\n * ```\n *\n * @example\n * Throwing an `InstructionError` from a builder:\n * ```typescript\n * import { InstructionError } from \"@umbra-privacy/sdk\";\n *\n * throw new InstructionError(\"Required account 'poolConfig' not found\", {\n *   instructionName: \"encryptedDeposit\",\n *   context: { missingAccounts: [\"poolConfig\"], providedMint: mint.toString() },\n * });\n * ```\n *\n * @see {@link isInstructionError} for the corresponding type guard\n * @public\n */\nexport class InstructionError extends UmbraError {\n  /**\n   * The name of the instruction that failed during construction or validation.\n   *\n   * @remarks\n   * Matches the Anchor instruction name (camelCase), e.g. `\"encryptedDeposit\"`,\n   * `\"initUserAccount\"`. May be `undefined` if the failing instruction could\n   * not be identified at the throw site.\n   */\n  readonly instructionName?: string;\n\n  /**\n   * Creates a new `InstructionError`.\n   *\n   * @param message - Human-readable description of the instruction failure.\n   * @param options - Optional structured metadata.\n   * @param options.code - Error code string. Defaults to `\"INSTRUCTION_ERROR\"`.\n   * @param options.instructionName - The name of the failing instruction.\n   * @param options.context - Arbitrary key-value pairs for diagnostic context.\n   * @param options.cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      instructionName?: string;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: options?.code ?? \"INSTRUCTION_ERROR\",\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"InstructionError\";\n    if (options?.instructionName !== undefined) {\n      this.instructionName = options.instructionName;\n    }\n  }\n}\n\n/**\n * Error thrown when a Solana JSON-RPC request fails.\n *\n * This error covers all network-level and protocol-level failures that occur\n * while communicating with a Solana RPC node: unreachable endpoints, HTTP\n * errors, rate limiting, malformed responses, and JSON-RPC error objects\n * returned by the node.\n *\n * @remarks\n * **HTTP errors** — Use `statusCode` to check for common HTTP failure modes:\n * - `429` — rate limited; back off and retry with exponential delay\n * - `503` — node overloaded or temporarily unavailable; retry after a pause\n * - `400` — malformed request; usually a client bug, not retryable\n *\n * **JSON-RPC errors** — Use `rpcErrorCode` to distinguish Solana-specific\n * error codes returned in the `error.code` field of an RPC response body.\n * Common codes: `-32002` (transaction not found), `-32005` (node behind),\n * `-32007` (slot skipped).\n *\n * **Retryability** — `statusCode >= 500` or `statusCode === 429` generally\n * indicates a transient error. Client-side errors (`statusCode === 400`) are\n * not retryable without fixing the request.\n *\n * **Default error code** — `\"RPC_ERROR\"`.\n *\n * @example\n * Distinguishing rate-limit errors from other RPC failures:\n * ```typescript\n * import { isRpcError } from \"@umbra-privacy/sdk\";\n *\n * try {\n *   const account = await rpc.getAccountInfo(address);\n * } catch (error) {\n *   if (isRpcError(error)) {\n *     if (error.statusCode === 429) {\n *       console.warn(\"Rate limited — retry after delay\");\n *     } else {\n *       console.error(`RPC failure at ${error.endpoint}: ${error.message}`);\n *     }\n *   }\n * }\n * ```\n *\n * @example\n * Constructing an `RpcError`:\n * ```typescript\n * import { RpcError } from \"@umbra-privacy/sdk\";\n *\n * throw new RpcError(\"Failed to fetch account\", {\n *   endpoint: \"https://api.mainnet-beta.solana.com\",\n *   statusCode: 503,\n *   cause: originalError,\n * });\n * ```\n *\n * @see {@link isRpcError} for the corresponding type guard\n * @public\n */\nexport class RpcError extends UmbraError {\n  /**\n   * The RPC endpoint URL that was called when the error occurred.\n   *\n   * @remarks\n   * May be `undefined` if the endpoint was not known at the throw site (e.g.,\n   * when the error originates deep within `@solana/kit` internals).\n   */\n  readonly endpoint?: string;\n\n  /**\n   * The HTTP status code returned by the RPC node, if applicable.\n   *\n   * @remarks\n   * `undefined` for network-level failures (e.g., DNS resolution failure,\n   * connection refused) where no HTTP response was received.\n   */\n  readonly statusCode?: number;\n\n  /**\n   * The JSON-RPC error code from the response body, if any.\n   *\n   * @remarks\n   * Set when the RPC node returns a well-formed JSON-RPC error object with a\n   * numeric `code` field. `undefined` for HTTP-level failures or when the node\n   * returns a malformed response body.\n   */\n  readonly rpcErrorCode?: number;\n\n  /**\n   * Creates a new `RpcError`.\n   *\n   * @param message - Human-readable description of the RPC failure.\n   * @param options - Optional structured metadata.\n   * @param options.code - Error code string. Defaults to `\"RPC_ERROR\"`.\n   * @param options.endpoint - The RPC endpoint URL that was called.\n   * @param options.statusCode - HTTP status code from the response, if any.\n   * @param options.rpcErrorCode - JSON-RPC error code from the response, if any.\n   * @param options.context - Arbitrary key-value pairs for diagnostic context.\n   * @param options.cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      endpoint?: string;\n      statusCode?: number;\n      rpcErrorCode?: number;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: options?.code ?? \"RPC_ERROR\",\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"RpcError\";\n    if (options?.endpoint !== undefined) {\n      this.endpoint = options.endpoint;\n    }\n    if (options?.statusCode !== undefined) {\n      this.statusCode = options.statusCode;\n    }\n    if (options?.rpcErrorCode !== undefined) {\n      this.rpcErrorCode = options.rpcErrorCode;\n    }\n  }\n}\n\n/**\n * Error thrown when a transaction operation fails.\n *\n * This error covers failures across the full transaction lifecycle: building the\n * transaction message, running preflight simulation, submitting to the network,\n * and waiting for confirmation. It is the base class for more specific\n * transaction-related errors.\n *\n * @remarks\n * **Simulation logs** — When available, `simulationLogs` contain the program\n * log output from a failed preflight simulation. These logs often include the\n * Anchor error code and a human-readable message describing why the on-chain\n * program rejected the transaction.\n *\n * **Signature** — When `signature` is present, the transaction was accepted by\n * the network and executed but the execution itself failed (on-chain error).\n * When `signature` is absent, the transaction was rejected before reaching the\n * network (e.g., preflight failure, malformed transaction).\n *\n * **Default error code** — `\"TRANSACTION_ERROR\"`.\n *\n * @example\n * Inspecting simulation logs on failure:\n * ```typescript\n * import { isTransactionError } from \"@umbra-privacy/sdk\";\n *\n * try {\n *   const signatures = await forwarder.forwardSequentially([signedTx]);\n * } catch (error) {\n *   if (isTransactionError(error)) {\n *     console.error(\"Transaction failed:\", error.message);\n *     if (error.simulationLogs) {\n *       console.error(\"Simulation logs:\");\n *       for (const log of error.simulationLogs) {\n *         console.error(\" \", log);\n *       }\n *     }\n *     if (error.signature) {\n *       console.error(\"Failed signature:\", error.signature);\n *     }\n *   }\n * }\n * ```\n *\n * @example\n * Constructing a `TransactionError`:\n * ```typescript\n * import { TransactionError } from \"@umbra-privacy/sdk\";\n *\n * throw new TransactionError(\"Transaction simulation failed\", {\n *   simulationLogs: [\"Program log: AnchorError: Error Code: 6001\"],\n *   cause: originalError,\n * });\n * ```\n *\n * @see {@link isTransactionError} for the corresponding type guard\n * @see {@link TransactionSigningError} for signing-phase failures\n * @public\n */\nexport class TransactionError extends UmbraError {\n  /**\n   * The transaction signature, if available.\n   *\n   * @remarks\n   * Base58-encoded signature string. Present when the transaction was submitted\n   * to the network but failed during execution. Use this to look up the failed\n   * transaction in a block explorer.\n   */\n  readonly signature?: string;\n\n  /**\n   * Simulation log output from the transaction preflight, if available.\n   *\n   * @remarks\n   * Each entry in the array is one line of program log output (e.g.,\n   * `\"Program log: ...\"` or `\"Program <address> failed: ...\"`). Anchor programs\n   * emit error codes and names here when constraints are violated.\n   */\n  readonly simulationLogs?: string[];\n\n  /**\n   * Creates a new `TransactionError`.\n   *\n   * @param message - Human-readable description of the transaction failure.\n   * @param options - Optional structured metadata.\n   * @param options.code - Error code string. Defaults to `\"TRANSACTION_ERROR\"`.\n   * @param options.signature - Base58-encoded transaction signature, if available.\n   * @param options.simulationLogs - Program log output from preflight simulation.\n   * @param options.context - Arbitrary key-value pairs for diagnostic context.\n   * @param options.cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      signature?: string;\n      simulationLogs?: string[];\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: options?.code ?? \"TRANSACTION_ERROR\",\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"TransactionError\";\n    if (options?.signature !== undefined) {\n      this.signature = options.signature;\n    }\n    if (options?.simulationLogs !== undefined) {\n      this.simulationLogs = options.simulationLogs;\n    }\n  }\n}\n\n/**\n * Error thrown when transaction signing fails.\n *\n * This is a specific sub-class of {@link TransactionError} that occurs during\n * the signing phase — after the transaction is built but before it is submitted\n * to the network. Common causes include explicit user rejection in a wallet UI,\n * hardware wallet disconnection or timeout, and missing key material.\n *\n * @remarks\n * **User rejection** — When `wasRejected` is `true`, the user deliberately\n * declined to sign in the wallet prompt. This is not an error condition in the\n * traditional sense — the user made an intentional choice. UIs should catch this\n * and show a user-friendly cancellation message rather than an error dialog.\n *\n * **Hardware wallet issues** — When `wasRejected` is `false`, the failure was\n * not deliberate. It may indicate a disconnected Ledger, a timeout waiting for\n * the user to confirm on-device, or an incompatible app version on the device.\n *\n * **Signer address** — `signerAddress` identifies which signer's key was needed\n * at the time of failure. In multi-signer flows this helps identify which party\n * must re-sign.\n *\n * **Default error code** — `\"TRANSACTION_SIGNING_ERROR\"`.\n *\n * @example\n * Handling user rejection gracefully:\n * ```typescript\n * import { isTransactionSigningError } from \"@umbra-privacy/sdk\";\n *\n * try {\n *   const signedTx = await walletSigner.signTransaction(tx);\n * } catch (error) {\n *   if (isTransactionSigningError(error)) {\n *     if (error.wasRejected) {\n *       showToast(\"Transaction cancelled by user\");\n *     } else {\n *       showToast(`Signing failed: ${error.message}`);\n *     }\n *   }\n * }\n * ```\n *\n * @example\n * Constructing a `TransactionSigningError`:\n * ```typescript\n * import { TransactionSigningError } from \"@umbra-privacy/sdk\";\n *\n * throw new TransactionSigningError(\"User rejected the transaction\", {\n *   wasRejected: true,\n *   signerAddress: wallet.publicKey.toString(),\n * });\n * ```\n *\n * @see {@link isTransactionSigningError} for the corresponding type guard\n * @see {@link MasterSeedSigningRejectedError} for the master seed rejection sub-class\n * @public\n */\nexport class TransactionSigningError extends TransactionError {\n  /**\n   * Whether the signing was explicitly rejected by the user.\n   *\n   * @remarks\n   * `true` when the wallet UI presented a sign request and the user actively\n   * clicked \"Reject\" or equivalent. `false` when the failure was due to a\n   * technical issue (disconnected device, timeout, missing key).\n   *\n   * @defaultValue `false`\n   */\n  readonly wasRejected: boolean;\n\n  /**\n   * The address of the signer that failed to produce a signature.\n   *\n   * @remarks\n   * Base58-encoded public key string. May be `undefined` if the failing signer\n   * could not be identified at the throw site.\n   */\n  readonly signerAddress?: string;\n\n  /**\n   * Creates a new `TransactionSigningError`.\n   *\n   * @param message - Human-readable description of the signing failure.\n   * @param options - Optional structured metadata.\n   * @param options.code - Error code string. Defaults to `\"TRANSACTION_SIGNING_ERROR\"`.\n   * @param options.wasRejected - Whether the user deliberately rejected. Defaults to `false`.\n   * @param options.signerAddress - Base58 address of the signer that failed.\n   * @param options.signature - Transaction signature, if the transaction was partially signed.\n   * @param options.context - Arbitrary key-value pairs for diagnostic context.\n   * @param options.cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: string;\n      wasRejected?: boolean;\n      signerAddress?: string;\n      signature?: string;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: options?.code ?? \"TRANSACTION_SIGNING_ERROR\",\n      ...(options?.signature !== undefined && {\n        signature: options.signature,\n      }),\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"TransactionSigningError\";\n    this.wasRejected = options?.wasRejected ?? false;\n    if (options?.signerAddress !== undefined) {\n      this.signerAddress = options.signerAddress;\n    }\n  }\n}\n\n/**\n * Error thrown when master seed signing is rejected by the user.\n *\n * The Umbra privacy protocol derives a deterministic master seed by asking the\n * user's wallet to sign a fixed message. This seed is the root of the key\n * hierarchy used for encrypting and decrypting confidential balances. If the\n * user declines to sign this message, no Umbra operations that require private\n * key material can proceed.\n *\n * @remarks\n * This error always has `wasRejected: true` because it is only thrown when the\n * user deliberately declines — hardware wallet failures or timeouts during the\n * seed derivation flow produce a generic {@link TransactionSigningError} instead.\n *\n * **Recovery** — Prompt the user to explain that the Umbra seed derivation\n * signature is used only to derive encryption keys locally and is never\n * broadcast to the network. Then call `getUmbraClientFromSigner` again.\n *\n * **Default error code** — `\"MASTER_SEED_SIGNING_REJECTED\"`.\n *\n * @example\n * Distinguishing master seed rejection from other signing errors:\n * ```typescript\n * import {\n *   MasterSeedSigningRejectedError,\n *   isTransactionSigningError,\n * } from \"@umbra-privacy/sdk\";\n *\n * try {\n *   const client = await getUmbraClientFromSigner({ signer });\n * } catch (error) {\n *   if (error instanceof MasterSeedSigningRejectedError) {\n *     showModal(\n *       \"Umbra needs a signature to derive your private keys locally. \" +\n *       \"This signature is never sent to the network.\",\n *     );\n *   } else if (isTransactionSigningError(error)) {\n *     showToast(`Signing error: ${error.message}`);\n *   }\n * }\n * ```\n *\n * @see {@link TransactionSigningError} for the parent class\n * @public\n */\nexport class MasterSeedSigningRejectedError extends TransactionSigningError {\n  /**\n   * Creates a new `MasterSeedSigningRejectedError`.\n   *\n   * @param message - Human-readable description. Defaults to a standard rejection\n   *   message explaining that the user declined the required derivation signature.\n   * @param options - Optional structured metadata.\n   * @param options.signerAddress - Base58 address of the wallet that rejected.\n   * @param options.context - Arbitrary key-value pairs for diagnostic context.\n   * @param options.cause - The underlying error that caused this failure, if any.\n   */\n  constructor(\n    message = \"Master seed derivation was rejected. The user declined to sign the required message.\",\n    options?: {\n      signerAddress?: string;\n      context?: Record<string, unknown>;\n      cause?: unknown;\n    },\n  ) {\n    super(message, {\n      code: \"MASTER_SEED_SIGNING_REJECTED\",\n      wasRejected: true,\n      ...(options?.signerAddress !== undefined && {\n        signerAddress: options.signerAddress,\n      }),\n      ...(options?.context !== undefined && {\n        context: options.context,\n      }),\n      ...(options?.cause !== undefined && {\n        cause: options.cause,\n      }),\n    });\n    this.name = \"MasterSeedSigningRejectedError\";\n  }\n}\n\n/**\n * Type guard to check whether an unknown value is an {@link InstructionError}.\n *\n * @remarks\n * Prefer this function over `instanceof InstructionError` in code that may\n * cross module or bundle boundaries where the class reference might differ.\n *\n * @param error - The value to test.\n * @returns `true` if `error` is an instance of `InstructionError`, narrowing\n *   the type accordingly.\n *\n * @example\n * ```typescript\n * if (isInstructionError(error)) {\n *   console.error(\"Instruction:\", error.instructionName);\n * }\n * ```\n *\n * @see {@link InstructionError}\n * @public\n */\nexport function isInstructionError(error: unknown): error is InstructionError {\n  return error instanceof InstructionError;\n}\n\n/**\n * Type guard to check whether an unknown value is an {@link RpcError}.\n *\n * @remarks\n * Prefer this function over `instanceof RpcError` in code that may cross\n * module or bundle boundaries where the class reference might differ.\n *\n * @param error - The value to test.\n * @returns `true` if `error` is an instance of `RpcError`, narrowing the type\n *   accordingly.\n *\n * @example\n * ```typescript\n * if (isRpcError(error) && error.statusCode === 429) {\n *   await sleep(backoffMs);\n *   return retry();\n * }\n * ```\n *\n * @see {@link RpcError}\n * @public\n */\nexport function isRpcError(error: unknown): error is RpcError {\n  return error instanceof RpcError;\n}\n\n/**\n * Type guard to check whether an unknown value is a {@link TransactionError}.\n *\n * @remarks\n * Because {@link TransactionSigningError} and {@link MasterSeedSigningRejectedError}\n * extend `TransactionError`, this guard returns `true` for those sub-classes as\n * well. Use the more specific guards ({@link isTransactionSigningError}) when the\n * sub-type matters.\n *\n * @param error - The value to test.\n * @returns `true` if `error` is an instance of `TransactionError` or any of its\n *   sub-classes, narrowing the type accordingly.\n *\n * @example\n * ```typescript\n * if (isTransactionError(error) && error.simulationLogs) {\n *   console.error(\"Simulation logs:\", error.simulationLogs.join(\"\\n\"));\n * }\n * ```\n *\n * @see {@link TransactionError}\n * @see {@link isTransactionSigningError}\n * @public\n */\nexport function isTransactionError(error: unknown): error is TransactionError {\n  return error instanceof TransactionError;\n}\n\n/**\n * Type guard to check whether an unknown value is a {@link TransactionSigningError}.\n *\n * @remarks\n * Because {@link MasterSeedSigningRejectedError} extends `TransactionSigningError`,\n * this guard returns `true` for that sub-class as well.\n *\n * @param error - The value to test.\n * @returns `true` if `error` is an instance of `TransactionSigningError` or any\n *   of its sub-classes, narrowing the type accordingly.\n *\n * @example\n * ```typescript\n * if (isTransactionSigningError(error) && error.wasRejected) {\n *   showCancellationMessage();\n * }\n * ```\n *\n * @see {@link TransactionSigningError}\n * @see {@link MasterSeedSigningRejectedError}\n * @public\n */\nexport function isTransactionSigningError(error: unknown): error is TransactionSigningError {\n  return error instanceof TransactionSigningError;\n}\n","/**\n * Umbra Error Classes\n *\n * This module provides error classes for all Umbra SDK operation failures,\n * each carrying a `stage` field that identifies exactly where in the pipeline\n * the failure occurred.\n *\n * @module umbra/errors\n */\n\nimport { UmbraError } from \"../common/errors\";\n\n// =============================================================================\n// DEPOSIT\n// =============================================================================\n\n/**\n * Stage of the encrypted deposit operation where an error occurred.\n *\n * Each stage represents a distinct phase in the deposit flow:\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `validation` | Input parameter validation failed |\n * | `mint-fetch` | Failed to fetch mint account data |\n * | `fee-calculation` | Failed to calculate transfer fee |\n * | `pda-derivation` | PDA address generation failed |\n * | `account-fetch` | Failed to fetch account data from RPC |\n * | `instruction-build` | Failed to build the deposit instruction |\n * | `transaction-build` | Failed to build transaction message |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Failed to sign the transaction |\n * | `transaction-validate` | Transaction validation failed |\n * | `transaction-send` | Failed to send or confirm the transaction |\n */\nexport type EncryptedDepositStage =\n  | \"initialization\"\n  | \"validation\"\n  | \"mint-fetch\"\n  | \"fee-calculation\"\n  | \"pda-derivation\"\n  | \"account-fetch\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-validate\"\n  | \"transaction-send\";\n\n/** Error thrown when an encrypted deposit operation fails. */\nexport class EncryptedDepositError extends UmbraError {\n  readonly stage: EncryptedDepositStage;\n\n  constructor(stage: EncryptedDepositStage, message: string, cause?: Error) {\n    super(message, {\n      code: `ENCRYPTED_DEPOSIT_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"EncryptedDepositError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is an EncryptedDepositError. */\nexport function isEncryptedDepositError(error: unknown): error is EncryptedDepositError {\n  return error instanceof EncryptedDepositError;\n}\n\n// =============================================================================\n// WITHDRAWAL\n// =============================================================================\n\n/**\n * Stage of the encrypted withdrawal operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `validation` | Input parameter validation failed |\n * | `mint-fetch` | Failed to fetch mint account data |\n * | `pda-derivation` | PDA address generation failed |\n * | `instruction-build` | Failed to build the withdrawal instruction |\n * | `transaction-build` | Failed to build transaction message |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Failed to sign the transaction |\n * | `transaction-send` | Failed to send or confirm the transaction |\n */\nexport type EncryptedWithdrawalStage =\n  | \"initialization\"\n  | \"validation\"\n  | \"mint-fetch\"\n  | \"pda-derivation\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-send\";\n\n/** Error thrown when an encrypted withdrawal operation fails. */\nexport class EncryptedWithdrawalError extends UmbraError {\n  readonly stage: EncryptedWithdrawalStage;\n\n  constructor(stage: EncryptedWithdrawalStage, message: string, cause?: Error) {\n    super(message, {\n      code: `ENCRYPTED_WITHDRAWAL_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"EncryptedWithdrawalError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is an EncryptedWithdrawalError. */\nexport function isEncryptedWithdrawalError(error: unknown): error is EncryptedWithdrawalError {\n  return error instanceof EncryptedWithdrawalError;\n}\n\n// =============================================================================\n// REGISTRATION\n// =============================================================================\n\n/**\n * Stage of the user registration operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `master-seed-derivation` | Master seed signing was rejected or failed |\n * | `account-fetch` | RPC call to read existing registration state failed |\n * | `key-derivation` | Cryptographic key derivation from master seed failed |\n * | `zk-proof-generation` | Groth16 proof generation failed (anonymous step) |\n * | `pda-derivation` | PDA address generation failed |\n * | `instruction-build` | Failed to build an instruction |\n * | `transaction-build` | Blockhash fetch or transaction assembly failed |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Wallet rejected signing |\n * | `transaction-validate` | Pre-flight simulation failed |\n * | `transaction-send` | Transaction sent but confirmation timed out |\n */\nexport type RegistrationStage =\n  | \"initialization\"\n  | \"master-seed-derivation\"\n  | \"account-fetch\"\n  | \"key-derivation\"\n  | \"zk-proof-generation\"\n  | \"pda-derivation\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-validate\"\n  | \"transaction-send\";\n\n/** Error thrown when a user registration operation fails. */\nexport class RegistrationError extends UmbraError {\n  readonly stage: RegistrationStage;\n\n  constructor(stage: RegistrationStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `REGISTRATION_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"RegistrationError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a RegistrationError. */\nexport function isRegistrationError(error: unknown): error is RegistrationError {\n  return error instanceof RegistrationError;\n}\n\n// =============================================================================\n// CONVERSION\n// =============================================================================\n\n/**\n * Stage of the MXE-to-Shared conversion operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `account-fetch` | Batch RPC fetch of token account PDAs failed |\n * | `pda-derivation` | PDA address generation failed |\n * | `instruction-build` | Failed to build a conversion instruction |\n * | `transaction-build` | Blockhash fetch or transaction assembly failed |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Wallet rejected signing for a per-mint transaction |\n * | `transaction-validate` | Pre-flight simulation failed |\n * | `transaction-send` | Transaction sent but confirmation timed out |\n */\nexport type ConversionStage =\n  | \"initialization\"\n  | \"account-fetch\"\n  | \"pda-derivation\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-validate\"\n  | \"transaction-send\";\n\n/** Error thrown when an MXE-to-Shared conversion operation fails. */\nexport class ConversionError extends UmbraError {\n  readonly stage: ConversionStage;\n\n  constructor(stage: ConversionStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `CONVERSION_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"ConversionError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a ConversionError. */\nexport function isConversionError(error: unknown): error is ConversionError {\n  return error instanceof ConversionError;\n}\n\n// =============================================================================\n// CREATE UTXO\n// =============================================================================\n\n/**\n * Stage of a UTXO creation operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `validation` | Input parameter validation failed |\n * | `account-fetch` | Failed to fetch recipient or token account data |\n * | `mint-fetch` | Failed to fetch mint account data |\n * | `fee-calculation` | Token-2022 transfer fee calculation failed |\n * | `key-derivation` | Key derivation from master seed failed |\n * | `zk-proof-generation` | Groth16 proof generation failed |\n * | `pda-derivation` | PDA address generation failed |\n * | `instruction-build` | Failed to build an instruction |\n * | `transaction-build` | Blockhash fetch or transaction assembly failed |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Wallet rejected signing |\n * | `transaction-validate` | Pre-flight simulation failed |\n * | `transaction-send` | Transaction sent but confirmation timed out |\n */\nexport type CreateUtxoStage =\n  | \"initialization\"\n  | \"validation\"\n  | \"account-fetch\"\n  | \"mint-fetch\"\n  | \"fee-calculation\"\n  | \"key-derivation\"\n  | \"zk-proof-generation\"\n  | \"pda-derivation\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-validate\"\n  | \"transaction-send\";\n\n/** Error thrown when a UTXO creation operation fails. */\nexport class CreateUtxoError extends UmbraError {\n  readonly stage: CreateUtxoStage;\n\n  constructor(stage: CreateUtxoStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `CREATE_UTXO_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"CreateUtxoError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a CreateUtxoError. */\nexport function isCreateUtxoError(error: unknown): error is CreateUtxoError {\n  return error instanceof CreateUtxoError;\n}\n\n// =============================================================================\n// FETCH UTXOS\n// =============================================================================\n\n/**\n * Stage of a UTXO fetch operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory construction failed — missing indexerApiEndpoint |\n * | `validation` | Invalid tree index or insertion index parameters |\n * | `key-derivation` | X25519 private key derivation from master seed failed |\n * | `indexer-fetch` | Indexer HTTP call failed |\n * | `proof-fetch` | Merkle proof HTTP call failed |\n */\nexport type FetchUtxosStage =\n  | \"initialization\"\n  | \"validation\"\n  | \"key-derivation\"\n  | \"indexer-fetch\"\n  | \"proof-fetch\";\n\n/** Error thrown when a UTXO fetch operation fails. */\nexport class FetchUtxosError extends UmbraError {\n  readonly stage: FetchUtxosStage;\n\n  constructor(stage: FetchUtxosStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `FETCH_UTXOS_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"FetchUtxosError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a FetchUtxosError. */\nexport function isFetchUtxosError(error: unknown): error is FetchUtxosError {\n  return error instanceof FetchUtxosError;\n}\n\n// =============================================================================\n// CLAIM UTXO\n// =============================================================================\n\n/**\n * Stage of a UTXO claim operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `validation` | Invalid UTXO data or Merkle proof parameters |\n * | `key-derivation` | Key derivation from master seed failed |\n * | `zk-proof-generation` | Groth16 proof generation failed |\n * | `pda-derivation` | PDA address generation failed |\n * | `instruction-build` | Failed to build an instruction |\n * | `transaction-build` | Blockhash fetch or transaction assembly failed |\n * | `transaction-compile` | Failed to compile the transaction |\n * | `transaction-sign` | Wallet rejected signing |\n * | `transaction-validate` | Pre-flight simulation failed — also surfaces stale Merkle proof |\n * | `transaction-send` | Transaction sent but confirmation timed out |\n */\nexport type ClaimUtxoStage =\n  | \"initialization\"\n  | \"validation\"\n  | \"key-derivation\"\n  | \"zk-proof-generation\"\n  | \"pda-derivation\"\n  | \"instruction-build\"\n  | \"transaction-build\"\n  | \"transaction-compile\"\n  | \"transaction-sign\"\n  | \"transaction-validate\"\n  | \"transaction-send\";\n\n/** Error thrown when a UTXO claim operation fails. */\nexport class ClaimUtxoError extends UmbraError {\n  readonly stage: ClaimUtxoStage;\n\n  constructor(stage: ClaimUtxoStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `CLAIM_UTXO_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"ClaimUtxoError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a ClaimUtxoError. */\nexport function isClaimUtxoError(error: unknown): error is ClaimUtxoError {\n  return error instanceof ClaimUtxoError;\n}\n\n// =============================================================================\n// QUERY\n// =============================================================================\n\n/**\n * Stage of a query operation where an error occurred.\n *\n * | Stage | Description |\n * |-------|-------------|\n * | `initialization` | Factory-level validation failed |\n * | `pda-derivation` | PDA address generation failed |\n * | `account-fetch` | RPC fetch failed |\n * | `account-decode` | On-chain account data could not be decoded |\n * | `key-derivation` | X25519 key derivation failed (encrypted balance query) |\n * | `decryption` | Rescue cipher decryption failed (encrypted balance query) |\n */\nexport type QueryStage =\n  | \"initialization\"\n  | \"pda-derivation\"\n  | \"account-fetch\"\n  | \"account-decode\"\n  | \"key-derivation\"\n  | \"decryption\";\n\n/** Error thrown when a query operation fails. */\nexport class QueryError extends UmbraError {\n  readonly stage: QueryStage;\n\n  constructor(stage: QueryStage, message: string, cause?: unknown) {\n    super(message, {\n      code: `QUERY_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"QueryError\";\n    this.stage = stage;\n  }\n}\n\n/** Type guard to check if an error is a QueryError. */\nexport function isQueryError(error: unknown): error is QueryError {\n  return error instanceof QueryError;\n}\n"]}