@umbra-privacy/sdk 1.0.0 → 2.0.1

package/dist/{chunk-HOEXDXRC.cjs → chunk-BL6WXLPV.cjs}

@@ -1,358 +1,36 @@
 'use strict';
 
+var chunkQJAUUYZU_cjs = require('./chunk-QJAUUYZU.cjs');
 var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 
-// src/common/errors.ts
-var UmbraError = class _UmbraError extends Error {
+// src/arcium/errors.ts
+var ComputationMonitorError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
-    chunkPK6SKIKE_cjs.__name(this, "UmbraError");
-  }
-  /**
-   * A machine-readable error code for programmatic error handling.
-   *
-   * @remarks
-   * Defaults to `"UMBRA_ERROR"` when no code is supplied in the constructor options.
-   * Sub-classes or specific throw sites should supply a more specific code to allow
-   * callers to branch on error identity without string-matching `message`.
-   *
-   * @readonly
-   */
-  code;
-  /**
-   * Additional context about the error.
-   *
-   * @remarks
-   * A free-form key-value map of diagnostic data attached to the error at the throw site.
-   * Useful for logging and debugging — consumers should not rely on specific keys for
-   * control flow; use `code` for programmatic branching instead.
-   *
-   * Will be `undefined` when no context was provided to the constructor.
-   *
-   * @readonly
-   */
-  context;
-  /**
-   * The original error that caused this error, if any.
-   *
-   * @remarks
-   * When an SDK function wraps a lower-level error (e.g., a failed RPC call or a
-   * cryptographic library error), it sets `cause` to the original thrown value so
-   * callers can inspect the full error chain.
-   *
-   * Will be `undefined` when there is no underlying cause.
-   *
-   * @readonly
-   */
-  cause;
-  /**
-   * Creates a new UmbraError.
-   *
-   * @param message - Human-readable description of what went wrong. Should be
-   *   actionable and specific enough for a developer to understand the failure
-   *   without reading source code.
-   * @param options - Optional structured metadata attached to the error.
-   * @param options.code - Machine-readable error code for programmatic branching.
-   *   Defaults to `"UMBRA_ERROR"` if omitted.
-   * @param options.context - Free-form diagnostic key-value pairs. Omit or set to
-   *   `undefined` to leave the `context` property unset.
-   * @param options.cause - The original error that triggered this one. Enables
-   *   full error-chain inspection. Omit or set to `undefined` when there is no
-   *   underlying cause.
-   *
-   * @defaultValue `options` — `undefined` (all options optional)
-   * @defaultValue `options.code` — `"UMBRA_ERROR"`
-   */
-  constructor(message, options) {
-    super(message);
-    this.name = "UmbraError";
-    this.code = options?.code ?? "UMBRA_ERROR";
-    if (options?.context !== void 0) {
-      this.context = options.context;
-    }
-    if (options?.cause !== void 0) {
-      this.cause = options.cause;
-    }
-    Error.captureStackTrace(this, _UmbraError);
-  }
-};
-function isUmbraError(error) {
-  return error instanceof UmbraError;
-}
-chunkPK6SKIKE_cjs.__name(isUmbraError, "isUmbraError");
-var MathematicsAssertionError = class _MathematicsAssertionError extends Error {
-  static {
-    chunkPK6SKIKE_cjs.__name(this, "MathematicsAssertionError");
-  }
-  /**
-   * The actual value that failed the assertion.
-   *
-   * @remarks
-   * The runtime type reflects what was actually passed to the assertion function:
-   * - `bigint` for integer assertions (`assertU8`, `assertU256`, etc.)
-   * - `Uint8Array` for byte-array assertions (`assertU256LeBytes`, `assertU32LeBytes`, etc.)
-   * - Any other type when a non-numeric value was passed unexpectedly
-   *
-   * @readonly
-   */
-  value;
-  /**
-   * The type that was expected.
-   *
-   * @remarks
-   * Contains the branded type name exactly as it appears in the SDK type system,
-   * e.g., `"U8"`, `"U256"`, `"U32LeBytes"`. Use this for structured logging or
-   * to build user-facing error messages without parsing the `message` string.
-   *
-   * @readonly
-   */
-  expectedType;
-  /**
-   * Description of the constraint that was violated.
-   *
-   * @remarks
-   * Is `undefined` when only a type check failed (e.g., a `string` was passed where a
-   * `bigint` was expected). Contains a human-readable inequality or length rule when a
-   * value of the correct type was out of the allowed range.
-   *
-   * @example
-   * - `"0 <= value <= 255"` — U8 range violation
-   * - `"length === 32"` — U256LeBytes length violation
-   * - `"value >= 0"` — negative value passed to an unsigned integer assertion
-   *
-   * @readonly
-   */
-  constraint;
-  /**
-   * Creates a new MathematicsAssertionError.
-   *
-   * @param message - Human-readable description of the assertion failure. Should name
-   *   the assertion function, the expected type, and the constraint that was violated.
-   * @param options - Structured diagnostic details attached to the error.
-   * @param options.value - The actual value that was supplied and failed the assertion.
-   * @param options.expectedType - The name of the branded type that was expected
-   *   (e.g., `"U8"`, `"U256LeBytes"`).
-   * @param options.constraint - Optional human-readable constraint description
-   *   (e.g., `"0 <= value <= 255"`). Omit when the failure is a type mismatch rather
-   *   than a range violation.
-   */
-  constructor(message, options) {
-    super(message);
-    this.name = "MathematicsAssertionError";
-    this.value = options.value;
-    this.expectedType = options.expectedType;
-    this.constraint = options.constraint;
-    Error.captureStackTrace(this, _MathematicsAssertionError);
-    Object.setPrototypeOf(this, _MathematicsAssertionError.prototype);
-  }
-};
-var CryptographyAssertionError = class _CryptographyAssertionError extends Error {
-  static {
-    chunkPK6SKIKE_cjs.__name(this, "CryptographyAssertionError");
-  }
-  /**
-   * The actual value that failed the assertion.
-   *
-   * @remarks
-   * The runtime type reflects what was actually passed to the assertion function:
-   * - `bigint` for field element assertions (`assertBn254FieldElement`, etc.)
-   * - `Uint8Array` for byte-array assertions (`assertAesKey`, `assertX25519PrivateKey`, etc.)
-   * - Any other type when an entirely wrong value type was supplied
-   *
-   * @readonly
-   */
-  value;
-  /**
-   * The type that was expected (e.g., `"Bn254FieldElement"`, `"PoseidonKey"`, `"AesKey"`).
-   *
-   * @remarks
-   * Contains the branded type name exactly as it appears in the SDK type system.
-   * Use this property for structured logging without parsing the `message` string.
-   *
-   * @readonly
-   */
-  expectedType;
-  /**
-   * Description of the constraint that was violated.
-   *
-   * @remarks
-   * Is `undefined` for pure type-mismatch failures (e.g., `string` instead of `bigint`).
-   * Contains a human-readable constraint description for range and length violations
-   * (e.g., `"value < BN254_FIELD_PRIME"`, `"length === 32"`).
-   *
-   * @readonly
-   */
-  constraint;
-  /**
-   * Creates a new CryptographyAssertionError.
-   *
-   * @param message - Human-readable description of the assertion failure. Should name
-   *   the assertion function, the expected type, and the constraint that was violated.
-   * @param options - Structured diagnostic details attached to the error.
-   * @param options.value - The actual value that was supplied and failed the assertion.
-   * @param options.expectedType - The name of the branded cryptographic type that was
-   *   expected (e.g., `"Bn254FieldElement"`, `"AesKey"`).
-   * @param options.constraint - Optional human-readable constraint description.
-   *   Omit when the failure is a type mismatch rather than a range or length violation.
-   */
-  constructor(message, options) {
-    super(message);
-    this.name = "CryptographyAssertionError";
-    this.value = options.value;
-    this.expectedType = options.expectedType;
-    this.constraint = options.constraint;
-    Error.captureStackTrace(this, _CryptographyAssertionError);
-    Object.setPrototypeOf(this, _CryptographyAssertionError.prototype);
-  }
-};
-var SolanaAssertionError = class _SolanaAssertionError extends Error {
-  static {
-    chunkPK6SKIKE_cjs.__name(this, "SolanaAssertionError");
-  }
-  /**
-   * The actual value that failed the assertion.
-   *
-   * @remarks
-   * The runtime type reflects what was actually passed to the assertion function:
-   * - `string` for Base58-encoded assertions (`assertTransactionSignature`, etc.)
-   * - `Uint8Array` for byte-array assertions (`assertSignatureBytes`, etc.)
-   * - Any other type when a completely wrong value type was supplied
-   *
-   * @readonly
-   */
-  value;
-  /**
-   * The type that was expected (e.g., `"TransactionSignature"`, `"SignatureBytes"`).
-   *
-   * @remarks
-   * Contains the branded type name exactly as it appears in the SDK type system.
-   * Use this for structured logging without parsing the `message` string.
-   *
-   * @readonly
-   */
-  expectedType;
-  /**
-   * Description of the constraint that was violated.
-   *
-   * @remarks
-   * Is `undefined` for pure type-mismatch failures. Contains a human-readable rule
-   * for encoding or length violations (e.g., `"valid Base58"`, `"length === 64"`).
-   *
-   * @readonly
-   */
-  constraint;
-  /**
-   * Creates a new SolanaAssertionError.
-   *
-   * @param message - Human-readable description of the assertion failure. Should name
-   *   the assertion function, the expected type, and the constraint that was violated.
-   * @param options - Structured diagnostic details attached to the error.
-   * @param options.value - The actual value that was supplied and failed the assertion.
-   * @param options.expectedType - The name of the branded Solana type that was expected
-   *   (e.g., `"TransactionSignature"`, `"SignatureBytes"`).
-   * @param options.constraint - Optional human-readable constraint description.
-   *   Omit when the failure is a type mismatch rather than an encoding or length violation.
-   */
-  constructor(message, options) {
-    super(message);
-    this.name = "SolanaAssertionError";
-    this.value = options.value;
-    this.expectedType = options.expectedType;
-    this.constraint = options.constraint;
-    Error.captureStackTrace(this, _SolanaAssertionError);
-    Object.setPrototypeOf(this, _SolanaAssertionError.prototype);
-  }
-};
-var TemporalAssertionError = class extends Error {
-  static {
-    chunkPK6SKIKE_cjs.__name(this, "TemporalAssertionError");
-  }
-  /**
-   * The actual value that failed the assertion.
-   *
-   * @remarks
-   * Will be a `bigint` for all temporal assertions since the temporal types are
-   * BigInt-backed branded types (e.g., `Year`, `Month`, `Day`). May also be any
-   * other type when a non-bigint value was supplied unexpectedly.
-   *
-   * @readonly
-   */
-  value;
-  /**
-   * The type that was expected (e.g., `"Year"`, `"Month"`, `"Hour"`).
-   *
-   * @remarks
-   * Contains the branded temporal type name exactly as it appears in the SDK type system.
-   * Use this for structured logging without parsing the `message` string.
-   *
-   * @readonly
-   */
-  expectedType;
-  /**
-   * Description of the constraint that was violated.
-   *
-   * @remarks
-   * Contains a human-readable range rule for out-of-range values
-   * (e.g., `"1 <= value <= 12"` for a month violation). Is `undefined` only for
-   * pure type-mismatch failures (e.g., a `string` passed where a `bigint` was expected),
-   * which should not occur in normal usage.
-   *
-   * @readonly
-   */
-  constraint;
-  /**
-   * Creates a new TemporalAssertionError.
-   *
-   * @param message - Human-readable description of the assertion failure. Should name
-   *   the assertion function, the expected type, and the violated range constraint.
-   * @param details - Structured diagnostic details attached to the error.
-   * @param details.value - The actual `bigint` value (or other type) that was supplied
-   *   and failed the temporal assertion.
-   * @param details.expectedType - The name of the branded temporal type that was expected
-   *   (e.g., `"Year"`, `"Month"`, `"Hour"`).
-   * @param details.constraint - Optional human-readable range description
-   *   (e.g., `"1 <= value <= 12"`). Omit when the failure is a type mismatch.
-   */
-  constructor(message, details) {
-    super(message);
-    this.name = "TemporalAssertionError";
-    this.value = details.value;
-    this.expectedType = details.expectedType;
-    this.constraint = details.constraint;
-  }
-};
-
-// src/crypto/errors.ts
-var CryptographyError = class extends UmbraError {
-  static {
-    chunkPK6SKIKE_cjs.__name(this, "CryptographyError");
+    chunkPK6SKIKE_cjs.__name(this, "ComputationMonitorError");
   }
+  /** The monitoring stage where the failure occurred. */
+  stage;
   /**
-   * The cryptographic operation that failed.
+   * @param stage - The monitoring pipeline stage where the failure occurred.
+   * @param message - A human-readable description of the error.
+   * @param cause - The underlying error that caused this failure, if any.
    */
-  operation;
-  constructor(message, options) {
+  constructor(stage, message, cause) {
     super(message, {
-      code: options?.code ?? "CRYPTOGRAPHY_ERROR",
-      ...options?.context !== void 0 && {
-        context: options.context
-      },
-      ...options?.cause !== void 0 && {
-        cause: options.cause
-      }
+      code: `COMPUTATION_MONITOR_${stage.toUpperCase().replaceAll("-", "_")}`,
+      cause
     });
-    this.name = "CryptographyError";
-    if (options?.operation !== void 0) {
-      this.operation = options.operation;
-    }
+    this.name = "ComputationMonitorError";
+    this.stage = stage;
   }
 };
-function isCryptographyError(error) {
-  return error instanceof CryptographyError;
+function isComputationMonitorError(error) {
+  return error instanceof ComputationMonitorError;
 }
-chunkPK6SKIKE_cjs.__name(isCryptographyError, "isCryptographyError");
+chunkPK6SKIKE_cjs.__name(isComputationMonitorError, "isComputationMonitorError");
 
 // src/solana/errors.ts
-var InstructionError = class extends UmbraError {
+var InstructionError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "InstructionError");
   }
@@ -391,7 +69,7 @@ var InstructionError = class extends UmbraError {
     }
   }
 };
-var RpcError = class extends UmbraError {
+var RpcError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "RpcError");
   }
@@ -454,7 +132,7 @@ var RpcError = class extends UmbraError {
     }
   }
 };
-var TransactionError = class extends UmbraError {
+var TransactionError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "TransactionError");
   }
@@ -610,7 +288,7 @@ function isTransactionSigningError(error) {
 chunkPK6SKIKE_cjs.__name(isTransactionSigningError, "isTransactionSigningError");
 
 // src/umbra/errors.ts
-var EncryptedDepositError = class extends UmbraError {
+var EncryptedDepositError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "EncryptedDepositError");
   }
@@ -628,7 +306,7 @@ function isEncryptedDepositError(error) {
   return error instanceof EncryptedDepositError;
 }
 chunkPK6SKIKE_cjs.__name(isEncryptedDepositError, "isEncryptedDepositError");
-var EncryptedWithdrawalError = class extends UmbraError {
+var EncryptedWithdrawalError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "EncryptedWithdrawalError");
   }
@@ -646,7 +324,7 @@ function isEncryptedWithdrawalError(error) {
   return error instanceof EncryptedWithdrawalError;
 }
 chunkPK6SKIKE_cjs.__name(isEncryptedWithdrawalError, "isEncryptedWithdrawalError");
-var RegistrationError = class extends UmbraError {
+var RegistrationError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "RegistrationError");
   }
@@ -664,7 +342,7 @@ function isRegistrationError(error) {
   return error instanceof RegistrationError;
 }
 chunkPK6SKIKE_cjs.__name(isRegistrationError, "isRegistrationError");
-var ConversionError = class extends UmbraError {
+var ConversionError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "ConversionError");
   }
@@ -682,7 +360,7 @@ function isConversionError(error) {
   return error instanceof ConversionError;
 }
 chunkPK6SKIKE_cjs.__name(isConversionError, "isConversionError");
-var CreateUtxoError = class extends UmbraError {
+var CreateUtxoError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "CreateUtxoError");
   }
@@ -700,7 +378,7 @@ function isCreateUtxoError(error) {
   return error instanceof CreateUtxoError;
 }
 chunkPK6SKIKE_cjs.__name(isCreateUtxoError, "isCreateUtxoError");
-var FetchUtxosError = class extends UmbraError {
+var FetchUtxosError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "FetchUtxosError");
   }
@@ -718,7 +396,7 @@ function isFetchUtxosError(error) {
   return error instanceof FetchUtxosError;
 }
 chunkPK6SKIKE_cjs.__name(isFetchUtxosError, "isFetchUtxosError");
-var ClaimUtxoError = class extends UmbraError {
+var ClaimUtxoError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "ClaimUtxoError");
   }
@@ -736,7 +414,7 @@ function isClaimUtxoError(error) {
   return error instanceof ClaimUtxoError;
 }
 chunkPK6SKIKE_cjs.__name(isClaimUtxoError, "isClaimUtxoError");
-var QueryError = class extends UmbraError {
+var QueryError = class extends chunkQJAUUYZU_cjs.UmbraError {
   static {
     chunkPK6SKIKE_cjs.__name(this, "QueryError");
   }
@@ -756,28 +434,23 @@ function isQueryError(error) {
 chunkPK6SKIKE_cjs.__name(isQueryError, "isQueryError");
 
 exports.ClaimUtxoError = ClaimUtxoError;
+exports.ComputationMonitorError = ComputationMonitorError;
 exports.ConversionError = ConversionError;
 exports.CreateUtxoError = CreateUtxoError;
-exports.CryptographyAssertionError = CryptographyAssertionError;
-exports.CryptographyError = CryptographyError;
 exports.EncryptedDepositError = EncryptedDepositError;
 exports.EncryptedWithdrawalError = EncryptedWithdrawalError;
 exports.FetchUtxosError = FetchUtxosError;
 exports.InstructionError = InstructionError;
 exports.MasterSeedSigningRejectedError = MasterSeedSigningRejectedError;
-exports.MathematicsAssertionError = MathematicsAssertionError;
 exports.QueryError = QueryError;
 exports.RegistrationError = RegistrationError;
 exports.RpcError = RpcError;
-exports.SolanaAssertionError = SolanaAssertionError;
-exports.TemporalAssertionError = TemporalAssertionError;
 exports.TransactionError = TransactionError;
 exports.TransactionSigningError = TransactionSigningError;
-exports.UmbraError = UmbraError;
 exports.isClaimUtxoError = isClaimUtxoError;
+exports.isComputationMonitorError = isComputationMonitorError;
 exports.isConversionError = isConversionError;
 exports.isCreateUtxoError = isCreateUtxoError;
-exports.isCryptographyError = isCryptographyError;
 exports.isEncryptedDepositError = isEncryptedDepositError;
 exports.isEncryptedWithdrawalError = isEncryptedWithdrawalError;
 exports.isFetchUtxosError = isFetchUtxosError;
@@ -787,6 +460,5 @@ exports.isRegistrationError = isRegistrationError;
 exports.isRpcError = isRpcError;
 exports.isTransactionError = isTransactionError;
 exports.isTransactionSigningError = isTransactionSigningError;
-exports.isUmbraError = isUmbraError;
-//# sourceMappingURL=chunk-HOEXDXRC.cjs.map
-//# sourceMappingURL=chunk-HOEXDXRC.cjs.map
+//# sourceMappingURL=chunk-BL6WXLPV.cjs.map
+//# sourceMappingURL=chunk-BL6WXLPV.cjs.map

package/dist/chunk-BL6WXLPV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/arcium/errors.ts","../src/solana/errors.ts","../src/umbra/errors.ts"],"names":["UmbraError","__name"],"mappings":"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","file":"chunk-BL6WXLPV.cjs","sourcesContent":["/**\n * Arcium Error Classes\n *\n * Provides error classes for Arcium MPC computation monitoring failures.\n * Each error carries a {@link ComputationMonitorStage} field that identifies\n * exactly where in the monitoring pipeline the failure occurred.\n *\n * @module arcium/errors\n * @since 2.0.0\n */\n\nimport { UmbraError } from \"../common/errors\";\n\n// =============================================================================\n// COMPUTATION MONITOR\n// =============================================================================\n\n/**\n * Stage of the computation monitoring operation where an error occurred.\n *\n * @remarks\n * Each stage represents a distinct phase in the monitoring flow:\n *\n * - `subscription` — WebSocket subscription setup or notification stream failed\n * - `account-fetch` — HTTP RPC fetch of the ComputationAccount failed\n * - `account-decode` — Failed to decode the ComputationAccount from raw bytes\n * - `timeout` — Monitoring timed out before the computation finalized\n * - `signature-retrieval` — `getSignaturesForAddress` call failed after finalization\n *\n * @since 2.0.0\n * @public\n */\nexport type ComputationMonitorStage =\n  | \"subscription\"\n  | \"account-fetch\"\n  | \"account-decode\"\n  | \"timeout\"\n  | \"signature-retrieval\";\n\n/**\n * Error thrown when a computation monitoring operation fails.\n *\n * @remarks\n * Thrown by {@link ComputationMonitor} implementations when the monitoring\n * loop encounters an unrecoverable failure. The {@link stage} field identifies\n * exactly where in the monitoring pipeline the failure occurred, enabling\n * callers to implement targeted recovery strategies.\n *\n * The error code follows the format `COMPUTATION_MONITOR_{STAGE}` where\n * `{STAGE}` is the uppercase, underscore-delimited stage name.\n *\n * @example\n * ```typescript\n * try {\n *   const result = await monitor.awaitComputation(computationAddress, {\n *     timeoutMs: 60_000,\n *   });\n * } catch (error) {\n *   if (isComputationMonitorError(error)) {\n *     switch (error.stage) {\n *       case \"timeout\":\n *         console.log(\"MPC computation did not finalize in time\");\n *         break;\n *       case \"subscription\":\n *         console.log(\"WebSocket connection failed — try polling monitor\");\n *         break;\n *     }\n *   }\n * }\n * ```\n *\n * @since 2.0.0\n * @public\n */\nexport class ComputationMonitorError extends UmbraError {\n  /** The monitoring stage where the failure occurred. */\n  readonly stage: ComputationMonitorStage;\n\n  /**\n   * @param stage - The monitoring pipeline stage where the failure occurred.\n   * @param message - A human-readable description of the error.\n   * @param cause - The underlying error that caused this failure, if any.\n   */\n  constructor(stage: ComputationMonitorStage, message: string, cause?: Error) {\n    super(message, {\n      code: `COMPUTATION_MONITOR_${stage.toUpperCase().replaceAll(\"-\", \"_\")}`,\n      cause,\n    });\n    this.name = \"ComputationMonitorError\";\n    this.stage = stage;\n  }\n}\n\n/**\n * Type guard to check if a value is a {@link ComputationMonitorError}.\n *\n * @param error - The value to test.\n * @returns `true` and narrows `error` to {@link ComputationMonitorError} when\n *   the value is an instance of `ComputationMonitorError`.\n *\n * @example\n * ```typescript\n * catch (error) {\n *   if (isComputationMonitorError(error)) {\n *     console.log(error.stage); // TypeScript knows this is ComputationMonitorStage\n *   }\n * }\n * ```\n *\n * @since 2.0.0\n * @public\n */\nexport function isComputationMonitorError(error: unknown): error is ComputationMonitorError {\n  return error instanceof ComputationMonitorError;\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 `getUmbraClient`.\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 `getUmbraClient` 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 getUmbraClient({ 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 * @since 2.0.0\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  | \"proof-enrichment\";\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"]}