@rhea-finance/cross-chain-aggregation-dex 2.1.6 → 2.1.8

package/dist/executors/tron.mjs

@@ -1,3 +1,5 @@
+// src/core/catchLog.ts
+
 // src/core/errors.ts
 var SwapSdkError = class extends Error {
   constructor(code, stage, message, options = {}) {
@@ -86,52 +88,168 @@ function isUserRejection(error, adapter) {
 function createTronExecutor(adapter) {
   return {
     ...exposeExecutorSigner("tron", adapter),
-    kinds: ["tron-transfer"],
+    kinds: ["tron-transfer", "tron-transaction"],
     async validate(execution, context) {
       throwIfAborted(context.signal, "sign");
       assertChain(execution.chain, await adapter.getChain());
-      if (!adapter.isAddress(execution.depositAddress)) {
-        throw invalid("Invalid Tron deposit address");
-      }
-      if (!isNative(execution)) {
-        if (!execution.tokenAddress || execution.tokenAddress.toLowerCase().startsWith("nep141:") || !adapter.isAddress(execution.tokenAddress)) {
-          throw invalid("Invalid TRC20 token contract address");
-        }
+      if (execution.kind === "tron-transaction") {
+        validateTronTransaction(adapter, execution);
+        return;
       }
+      validateTronTransfer(adapter, execution);
     },
     async execute(execution, context) {
-      const native = isNative(execution);
-      await requestSignApproval(context, execution.chain, execution.kind, {
-        amount: execution.amount,
-        depositAddress: execution.depositAddress,
-        standard: native ? "native" : execution.standard ?? "trc20",
-        tokenAddress: execution.tokenAddress
-      });
-      let submission;
-      try {
-        submission = native ? await adapter.sendNativeTransfer({
-          amount: execution.amount,
-          depositAddress: execution.depositAddress,
-          signal: context.signal
-        }) : await adapter.sendTokenTransfer({
-          amount: execution.amount,
-          depositAddress: execution.depositAddress,
-          tokenAddress: execution.tokenAddress,
-          signal: context.signal
-        });
-      } catch (error) {
-        throw mapExecutorError(
-          error,
-          adapter,
-          "broadcast",
-          "BROADCAST_FAILED",
-          "Failed to broadcast Tron transfer"
-        );
-      }
-      return confirm(adapter, submission, context);
+      return execution.kind === "tron-transaction" ? executeTronTransaction(adapter, execution, context) : executeTronTransfer(adapter, execution, context);
     }
   };
 }
+function validateTronTransfer(adapter, execution) {
+  if (!adapter.isAddress(execution.depositAddress)) {
+    throw invalid("Invalid Tron deposit address");
+  }
+  if (!isNative(execution)) {
+    if (!execution.tokenAddress || execution.tokenAddress.toLowerCase().startsWith("nep141:") || !adapter.isAddress(execution.tokenAddress)) {
+      throw invalid("Invalid TRC20 token contract address");
+    }
+  }
+}
+function validateTronTransaction(adapter, execution) {
+  if (!adapter.signAndSendTransaction) {
+    throw invalid(
+      "Tron wallet adapter must implement signAndSendTransaction for tron-raw-data builds"
+    );
+  }
+  assertTronUnsignedTransaction(execution.transaction, "transaction");
+  if (execution.approval) {
+    assertTronUnsignedTransaction(
+      execution.approval.transaction,
+      "approval.transaction"
+    );
+  }
+}
+async function executeTronTransfer(adapter, execution, context) {
+  const native = isNative(execution);
+  await requestSignApproval(context, execution.chain, execution.kind, {
+    amount: execution.amount,
+    depositAddress: execution.depositAddress,
+    standard: native ? "native" : execution.standard ?? "trc20",
+    tokenAddress: execution.tokenAddress
+  });
+  let submission;
+  try {
+    submission = native ? await adapter.sendNativeTransfer({
+      amount: execution.amount,
+      depositAddress: execution.depositAddress,
+      signal: context.signal
+    }) : await adapter.sendTokenTransfer({
+      amount: execution.amount,
+      depositAddress: execution.depositAddress,
+      tokenAddress: execution.tokenAddress,
+      signal: context.signal
+    });
+  } catch (error) {
+    throw mapExecutorError(
+      error,
+      adapter,
+      "broadcast",
+      "BROADCAST_FAILED",
+      "Failed to broadcast Tron transfer"
+    );
+  }
+  return confirm(adapter, submission, context, "transfer");
+}
+async function executeTronTransaction(adapter, execution, context) {
+  await executeApprovalIfRequired(adapter, execution, context);
+  await requestSignApproval(context, execution.chain, execution.kind, {
+    format: execution.format,
+    txID: execution.transaction.txID
+  });
+  let submission;
+  try {
+    submission = await requireSignAndSend(adapter)({
+      transaction: execution.transaction,
+      signal: context.signal
+    });
+  } catch (error) {
+    throw mapExecutorError(
+      error,
+      adapter,
+      "broadcast",
+      "BROADCAST_FAILED",
+      "Failed to sign or broadcast Tron transaction"
+    );
+  }
+  return confirm(adapter, submission, context, "transaction");
+}
+async function executeApprovalIfRequired(adapter, execution, context) {
+  if (!execution.approval) return;
+  let approvalRequired;
+  try {
+    approvalRequired = adapter.isApprovalRequired ? await adapter.isApprovalRequired(execution.approval) : true;
+  } catch (error) {
+    throw mapExecutorError(
+      error,
+      adapter,
+      "approve",
+      "APPROVAL_FAILED",
+      "Failed to determine Tron approval requirement"
+    );
+  }
+  if (!approvalRequired) return;
+  context.emit({
+    type: "approval-requested",
+    executionId: context.executionId
+  });
+  await requestSignApproval(context, execution.chain, "tron-approval", {
+    txID: execution.approval.transaction.txID
+  });
+  try {
+    const submission = await requireSignAndSend(adapter)({
+      transaction: execution.approval.transaction,
+      signal: context.signal
+    });
+    context.emit({
+      type: "approval-submitted",
+      executionId: context.executionId,
+      txHash: submission.txHash
+    });
+    const confirmation = await adapter.waitForTransaction(submission.txHash, {
+      signal: context.signal
+    });
+    assertTransactionConfirmed(confirmation, {
+      code: "APPROVAL_FAILED",
+      stage: "approve",
+      message: "Tron approval transaction failed"
+    });
+  } catch (error) {
+    throw mapExecutorError(
+      error,
+      adapter,
+      "approve",
+      "APPROVAL_FAILED",
+      "Failed to approve TRC20 token"
+    );
+  }
+}
+function requireSignAndSend(adapter) {
+  if (!adapter.signAndSendTransaction) {
+    throw invalid(
+      "Tron wallet adapter must implement signAndSendTransaction for tron-raw-data builds"
+    );
+  }
+  return adapter.signAndSendTransaction.bind(adapter);
+}
+function assertTronUnsignedTransaction(transaction, label) {
+  if (!transaction.txID?.trim()) {
+    throw invalid(`Missing Tron ${label}.txID`);
+  }
+  if (!transaction.raw_data_hex?.trim()) {
+    throw invalid(`Missing Tron ${label}.raw_data_hex`);
+  }
+  if (typeof transaction.raw_data !== "object" || transaction.raw_data === null) {
+    throw invalid(`Missing Tron ${label}.raw_data`);
+  }
+}
 function isNative(execution) {
   const standard = execution.standard?.trim().toLowerCase();
   if (standard === "native" || standard === "trx") return true;
@@ -141,7 +259,7 @@ function isNative(execution) {
 function invalid(message) {
   return new SwapSdkError("INVALID_TRANSACTION", "sign", message);
 }
-async function confirm(adapter, submission, context) {
+async function confirm(adapter, submission, context, kind) {
   if (context.waitFor === "submitted") {
     return {
       status: "submitted",
@@ -169,7 +287,7 @@ async function confirm(adapter, submission, context) {
       adapter,
       "broadcast",
       "BROADCAST_FAILED",
-      "Failed while confirming Tron transfer"
+      kind === "transfer" ? "Failed while confirming Tron transfer" : "Failed while confirming Tron transaction"
     );
   }
 }

package/dist/executors/tron.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/tron/index.ts"],"names":[],"mappings":"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","file":"tron.mjs","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport type { SwapExecution } from \"../../types/execution\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\ntype TronExecution = Extract<SwapExecution, { kind: \"tron-transfer\" }>;\n\nexport interface TronWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendNativeTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  sendTokenTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    tokenAddress: string;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createTronExecutor(\n  adapter: TronWalletAdapter\n): ChainExecutor<\"tron-transfer\"> {\n  return {\n    ...exposeExecutorSigner(\"tron\", adapter),\n    kinds: [\"tron-transfer\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (!adapter.isAddress(execution.depositAddress)) {\n        throw invalid(\"Invalid Tron deposit address\");\n      }\n      if (!isNative(execution)) {\n        if (\n          !execution.tokenAddress ||\n          execution.tokenAddress.toLowerCase().startsWith(\"nep141:\") ||\n          !adapter.isAddress(execution.tokenAddress)\n        ) {\n          throw invalid(\"Invalid TRC20 token contract address\");\n        }\n      }\n    },\n\n    async execute(execution, context) {\n      const native = isNative(execution);\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        amount: execution.amount,\n        depositAddress: execution.depositAddress,\n        standard: native ? \"native\" : execution.standard ?? \"trc20\",\n        tokenAddress: execution.tokenAddress,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = native\n          ? await adapter.sendNativeTransfer({\n              amount: execution.amount,\n              depositAddress: execution.depositAddress,\n              signal: context.signal,\n            })\n          : await adapter.sendTokenTransfer({\n              amount: execution.amount,\n              depositAddress: execution.depositAddress,\n              tokenAddress: execution.tokenAddress!,\n              signal: context.signal,\n            });\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to broadcast Tron transfer\"\n        );\n      }\n      return confirm(adapter, submission, context);\n    },\n  };\n}\n\nfunction isNative(execution: TronExecution): boolean {\n  const standard = execution.standard?.trim().toLowerCase();\n  if (standard === \"native\" || standard === \"trx\") return true;\n  if (standard === \"trc20\" || standard === \"token\") return false;\n  return !execution.tokenAddress;\n}\n\nfunction invalid(message: string): SwapSdkError {\n  return new SwapSdkError(\"INVALID_TRANSACTION\", \"sign\", message);\n}\n\nasync function confirm(\n  adapter: TronWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Tron transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Tron transfer\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/tron/index.ts"],"names":[],"mappings":"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","file":"tron.mjs","sourcesContent":["import { logSdkCaughtError } from \"./catchLog\";\n\nexport type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  logSdkCaughtError(`asSwapSdkError:${stage}`, error);\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\nimport { logSdkCaughtError } from \"../core/catchLog\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  logSdkCaughtError(`executor.mapExecutorError:${stage}:${code}`, error);\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport type {\n  SwapExecution,\n  TronApproval,\n  TronUnsignedTransaction,\n} from \"../../types/execution\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\nimport { logSdkCaughtError } from \"../../core/catchLog\";\n\ntype TronTransferExecution = Extract<SwapExecution, { kind: \"tron-transfer\" }>;\ntype TronTransactionExecution = Extract<\n  SwapExecution,\n  { kind: \"tron-transaction\" }\n>;\n\nexport interface TronWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendNativeTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  sendTokenTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    tokenAddress: string;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  /** Required for RHEA `tron-raw-data` / TriggerSmartContract builds. */\n  signAndSendTransaction?(input: {\n    transaction: TronUnsignedTransaction;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  isApprovalRequired?(approval: TronApproval): boolean | Promise<boolean>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createTronExecutor(\n  adapter: TronWalletAdapter\n): ChainExecutor<\"tron-transfer\" | \"tron-transaction\"> {\n  return {\n    ...exposeExecutorSigner(\"tron\", adapter),\n    kinds: [\"tron-transfer\", \"tron-transaction\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (execution.kind === \"tron-transaction\") {\n        validateTronTransaction(adapter, execution);\n        return;\n      }\n      validateTronTransfer(adapter, execution);\n    },\n\n    async execute(execution, context) {\n      return execution.kind === \"tron-transaction\"\n        ? executeTronTransaction(adapter, execution, context)\n        : executeTronTransfer(adapter, execution, context);\n    },\n  };\n}\n\nfunction validateTronTransfer(\n  adapter: TronWalletAdapter,\n  execution: TronTransferExecution\n): void {\n  if (!adapter.isAddress(execution.depositAddress)) {\n    throw invalid(\"Invalid Tron deposit address\");\n  }\n  if (!isNative(execution)) {\n    if (\n      !execution.tokenAddress ||\n      execution.tokenAddress.toLowerCase().startsWith(\"nep141:\") ||\n      !adapter.isAddress(execution.tokenAddress)\n    ) {\n      throw invalid(\"Invalid TRC20 token contract address\");\n    }\n  }\n}\n\nfunction validateTronTransaction(\n  adapter: TronWalletAdapter,\n  execution: TronTransactionExecution\n): void {\n  if (!adapter.signAndSendTransaction) {\n    throw invalid(\n      \"Tron wallet adapter must implement signAndSendTransaction for tron-raw-data builds\"\n    );\n  }\n  assertTronUnsignedTransaction(execution.transaction, \"transaction\");\n  if (execution.approval) {\n    assertTronUnsignedTransaction(\n      execution.approval.transaction,\n      \"approval.transaction\"\n    );\n  }\n}\n\nasync function executeTronTransfer(\n  adapter: TronWalletAdapter,\n  execution: TronTransferExecution,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  const native = isNative(execution);\n  await requestSignApproval(context, execution.chain, execution.kind, {\n    amount: execution.amount,\n    depositAddress: execution.depositAddress,\n    standard: native ? \"native\" : execution.standard ?? \"trc20\",\n    tokenAddress: execution.tokenAddress,\n  });\n  let submission: TransactionSubmission;\n  try {\n    submission = native\n      ? await adapter.sendNativeTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          signal: context.signal,\n        })\n      : await adapter.sendTokenTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          tokenAddress: execution.tokenAddress!,\n          signal: context.signal,\n        });\n  } catch (error) {\n    logSdkCaughtError(\"executors/tron/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed to broadcast Tron transfer\"\n    );\n  }\n  return confirm(adapter, submission, context, \"transfer\");\n}\n\nasync function executeTronTransaction(\n  adapter: TronWalletAdapter,\n  execution: TronTransactionExecution,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  await executeApprovalIfRequired(adapter, execution, context);\n\n  await requestSignApproval(context, execution.chain, execution.kind, {\n    format: execution.format,\n    txID: execution.transaction.txID,\n  });\n\n  let submission: TransactionSubmission;\n  try {\n    submission = await requireSignAndSend(adapter)({\n      transaction: execution.transaction,\n      signal: context.signal,\n    });\n  } catch (error) {\n    logSdkCaughtError(\"executors/tron/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed to sign or broadcast Tron transaction\"\n    );\n  }\n\n  return confirm(adapter, submission, context, \"transaction\");\n}\n\nasync function executeApprovalIfRequired(\n  adapter: TronWalletAdapter,\n  execution: TronTransactionExecution,\n  context: ExecutionContext\n): Promise<void> {\n  if (!execution.approval) return;\n\n  let approvalRequired: boolean;\n  try {\n    approvalRequired = adapter.isApprovalRequired\n      ? await adapter.isApprovalRequired(execution.approval)\n      : true;\n  } catch (error) {\n    logSdkCaughtError(\"executors/tron/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"approve\",\n      \"APPROVAL_FAILED\",\n      \"Failed to determine Tron approval requirement\"\n    );\n  }\n  if (!approvalRequired) return;\n\n  context.emit({\n    type: \"approval-requested\",\n    executionId: context.executionId,\n  });\n  await requestSignApproval(context, execution.chain, \"tron-approval\", {\n    txID: execution.approval.transaction.txID,\n  });\n  try {\n    const submission = await requireSignAndSend(adapter)({\n      transaction: execution.approval.transaction,\n      signal: context.signal,\n    });\n    context.emit({\n      type: \"approval-submitted\",\n      executionId: context.executionId,\n      txHash: submission.txHash,\n    });\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    assertTransactionConfirmed(confirmation, {\n      code: \"APPROVAL_FAILED\",\n      stage: \"approve\",\n      message: \"Tron approval transaction failed\",\n    });\n  } catch (error) {\n    logSdkCaughtError(\"executors/tron/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"approve\",\n      \"APPROVAL_FAILED\",\n      \"Failed to approve TRC20 token\"\n    );\n  }\n}\n\nfunction requireSignAndSend(\n  adapter: TronWalletAdapter\n): NonNullable<TronWalletAdapter[\"signAndSendTransaction\"]> {\n  if (!adapter.signAndSendTransaction) {\n    throw invalid(\n      \"Tron wallet adapter must implement signAndSendTransaction for tron-raw-data builds\"\n    );\n  }\n  return adapter.signAndSendTransaction.bind(adapter);\n}\n\nfunction assertTronUnsignedTransaction(\n  transaction: TronUnsignedTransaction,\n  label: string\n): void {\n  if (!transaction.txID?.trim()) {\n    throw invalid(`Missing Tron ${label}.txID`);\n  }\n  if (!transaction.raw_data_hex?.trim()) {\n    throw invalid(`Missing Tron ${label}.raw_data_hex`);\n  }\n  if (\n    typeof transaction.raw_data !== \"object\" ||\n    transaction.raw_data === null\n  ) {\n    throw invalid(`Missing Tron ${label}.raw_data`);\n  }\n}\n\nfunction isNative(execution: TronTransferExecution): boolean {\n  const standard = execution.standard?.trim().toLowerCase();\n  if (standard === \"native\" || standard === \"trx\") return true;\n  if (standard === \"trc20\" || standard === \"token\") return false;\n  return !execution.tokenAddress;\n}\n\nfunction invalid(message: string): SwapSdkError {\n  return new SwapSdkError(\"INVALID_TRANSACTION\", \"sign\", message);\n}\n\nasync function confirm(\n  adapter: TronWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext,\n  kind: \"transfer\" | \"transaction\"\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Tron transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    logSdkCaughtError(\"executors/tron/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      kind === \"transfer\"\n        ? \"Failed while confirming Tron transfer\"\n        : \"Failed while confirming Tron transaction\"\n    );\n  }\n}\n"]}

package/dist/executors/zcash.d.mts

@@ -1,4 +1,4 @@
-import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-DpC8G2U4.mjs';
+import { af as ExecutorErrorAdapter, C as ChainRef, ag as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-v1w63b8X.mjs';
 
 interface ZcashWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/zcash.d.ts

@@ -1,4 +1,4 @@
-import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-DpC8G2U4.js';
+import { af as ExecutorErrorAdapter, C as ChainRef, ag as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-v1w63b8X.js';
 
 interface ZcashWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/zcash.js

@@ -1,5 +1,7 @@
 'use strict';
 
+// src/core/catchLog.ts
+
 // src/core/errors.ts
 var SwapSdkError = class extends Error {
   constructor(code, stage, message, options = {}) {

package/dist/executors/zcash.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/zcash/index.ts"],"names":[],"mappings":"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","file":"zcash.js","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface ZcashWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    decimals?: number;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createZcashExecutor(\n  adapter: ZcashWalletAdapter\n): ChainExecutor<\"zcash-transfer\"> {\n  return {\n    ...exposeExecutorSigner(\"zcash\", adapter),\n    kinds: [\"zcash-transfer\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (!adapter.isAddress(execution.depositAddress)) {\n        throw new SwapSdkError(\n          \"INVALID_TRANSACTION\",\n          \"sign\",\n          \"Invalid Zcash transparent deposit address\"\n        );\n      }\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        amount: execution.amount,\n        depositAddress: execution.depositAddress,\n        decimals: execution.decimals,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.sendTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          ...(execution.decimals !== undefined\n            ? { decimals: execution.decimals }\n            : {}),\n          signal: context.signal,\n        });\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to submit Zcash transfer\"\n        );\n      }\n      if (!submission.txHash?.trim()) {\n        throw new SwapSdkError(\n          \"BROADCAST_FAILED\",\n          \"broadcast\",\n          \"Zcash wallet returned no transaction hash\"\n        );\n      }\n      return confirm(adapter, submission.txHash, submission.raw, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: ZcashWalletAdapter,\n  txHash: string,\n  raw: unknown,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Zcash transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash,\n      raw: confirmationRaw ?? raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Zcash transfer\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/zcash/index.ts"],"names":[],"mappings":"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","file":"zcash.js","sourcesContent":["import { logSdkCaughtError } from \"./catchLog\";\n\nexport type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  logSdkCaughtError(`asSwapSdkError:${stage}`, error);\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\nimport { logSdkCaughtError } from \"../core/catchLog\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  logSdkCaughtError(`executor.mapExecutorError:${stage}:${code}`, error);\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\nimport { logSdkCaughtError } from \"../../core/catchLog\";\n\nexport interface ZcashWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    decimals?: number;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createZcashExecutor(\n  adapter: ZcashWalletAdapter\n): ChainExecutor<\"zcash-transfer\"> {\n  return {\n    ...exposeExecutorSigner(\"zcash\", adapter),\n    kinds: [\"zcash-transfer\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (!adapter.isAddress(execution.depositAddress)) {\n        throw new SwapSdkError(\n          \"INVALID_TRANSACTION\",\n          \"sign\",\n          \"Invalid Zcash transparent deposit address\"\n        );\n      }\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        amount: execution.amount,\n        depositAddress: execution.depositAddress,\n        decimals: execution.decimals,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.sendTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          ...(execution.decimals !== undefined\n            ? { decimals: execution.decimals }\n            : {}),\n          signal: context.signal,\n        });\n      } catch (error) {\n        logSdkCaughtError(\"executors/zcash/index.ts\", error);\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to submit Zcash transfer\"\n        );\n      }\n      if (!submission.txHash?.trim()) {\n        throw new SwapSdkError(\n          \"BROADCAST_FAILED\",\n          \"broadcast\",\n          \"Zcash wallet returned no transaction hash\"\n        );\n      }\n      return confirm(adapter, submission.txHash, submission.raw, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: ZcashWalletAdapter,\n  txHash: string,\n  raw: unknown,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Zcash transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash,\n      raw: confirmationRaw ?? raw,\n    };\n  } catch (error) {\n    logSdkCaughtError(\"executors/zcash/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Zcash transfer\"\n    );\n  }\n}\n"]}

package/dist/executors/zcash.mjs

@@ -1,3 +1,5 @@
+// src/core/catchLog.ts
+
 // src/core/errors.ts
 var SwapSdkError = class extends Error {
   constructor(code, stage, message, options = {}) {

package/dist/executors/zcash.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/zcash/index.ts"],"names":[],"mappings":";AA0CO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EAGtC,YACW,IAAA,EACA,KAAA,EACT,OAAA,EACS,OAAA,GAA+B,EAAC,EACzC;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AALJ,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAEA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AANX,IAAA,IAAA,CAAS,IAAA,GAAO,cAAA;AASd,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AAAA,EAEA,IAAI,SAAA,GAAqB;AACvB,IAAA,OAAO,IAAA,CAAK,QAAQ,SAAA,IAAa,KAAA;AAAA,EACnC;AAAA,EAEA,IAAI,KAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,OAAA,CAAQ,KAAA;AAAA,EACtB;AAAA,EAEA,IAAI,OAAA,GAA+C;AACjD,IAAA,OAAO,KAAK,OAAA,CAAQ,OAAA;AAAA,EACtB;AACF,CAAA;;;AC9BO,SAAS,oBAAA,CACd,aACA,OAAA,EAIA;AACA,EAAA,OAAO;AAAA,IACL,WAAA;AAAA,IACA,GAAI,OAAA,CAAQ,cAAA,GACR,EAAE,cAAA,EAAgB,MAAM,OAAA,CAAQ,cAAA,EAAgB,EAAE,GAClD,EAAC;AAAA,IACL,GAAI,QAAQ,WAAA,GACR;AAAA,MACE,aAAa,CACX,OAAA,EACA,YACG,OAAA,CAAQ,WAAA,CAAa,SAAS,OAAO;AAAA,QAE5C;AAAC,GACP;AACF;AAEO,SAAS,cAAA,CACd,MAAA,EACA,KAAA,GAAwB,MAAA,EAClB;AACN,EAAA,IAAI,CAAC,QAAQ,OAAA,EAAS;AACtB,EAAA,MAAM,IAAI,YAAA,CAAa,iBAAA,EAAmB,KAAA,EAAO,uBAAA,EAAyB;AAAA,IACxE,OAAO,MAAA,CAAO;AAAA,GACf,CAAA;AACH;AAEO,SAAS,WAAA,CACd,QAAA,EACA,MAAA,EACA,KAAA,GAAwB,MAAA,EAClB;AACN,EAAA,IAAI,aAAa,MAAA,EAAQ;AACzB,EAAA,MAAM,IAAI,YAAA;AAAA,IACR,gBAAA;AAAA,IACA,KAAA;AAAA,IACA,CAAA,gBAAA,EAAmB,MAAM,CAAA,gCAAA,EAAmC,QAAQ,CAAA,CAAA;AAAA,IACpE,EAAE,OAAA,EAAS,EAAE,QAAA,EAAU,QAAO;AAAE,GAClC;AACF;AAEA,eAAsB,mBAAA,CACpB,OAAA,EACA,KAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,cAAA,CAAe,OAAA,CAAQ,QAAQ,MAAM,CAAA;AACrC,EAAA,MAAM,QAAQ,UAAA,GAAa,EAAE,KAAA,EAAO,IAAA,EAAM,SAAS,CAAA;AACnD,EAAA,cAAA,CAAe,OAAA,CAAQ,QAAQ,MAAM,CAAA;AACvC;AAEO,SAAS,gBAAA,CACd,KAAA,EACA,OAAA,EACA,KAAA,EACA,MACA,OAAA,EACc;AACd,EAAA,IAAI,KAAA,YAAiB,cAAc,OAAO,KAAA;AAC1C,EAAA,IAAI,eAAA,CAAgB,KAAA,EAAO,OAAO,CAAA,EAAG;AACnC,IAAA,OAAO,IAAI,YAAA,CAAa,eAAA,EAAiB,KAAA,EAAO,2BAAA,EAA6B;AAAA,MAC3E,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH;AACA,EAAA,OAAO,IAAI,aAAa,IAAA,EAAM,KAAA,EAAO,SAAS,EAAE,KAAA,EAAO,OAAO,CAAA;AAChE;AAEO,SAAS,0BAAA,CACd,cACA,OAAA,EAKS;AACT,EAAA,IAAI,YAAA,EAAc,WAAW,WAAA,EAAa;AACxC,IAAA,OAAO,YAAA,CAAa,GAAA;AAAA,EACtB;AACA,EAAA,MAAM,MAAA,GACJ,YAAA,IACA,OAAO,YAAA,KAAiB,QAAA,IACxB,YAAY,YAAA,GACR,MAAA,CAAO,YAAA,CAAa,MAAM,CAAA,GAC1B,SAAA;AACN,EAAA,MAAM,IAAI,YAAA;AAAA,IACR,OAAA,CAAQ,IAAA;AAAA,IACR,OAAA,CAAQ,KAAA;AAAA,IACR,CAAA,EAAG,OAAA,CAAQ,OAAO,CAAA,gCAAA,EAAmC,MAAM,CAAA,CAAA;AAAA,IAC3D;AAAA,MACE,KAAA,EACE,gBACA,OAAO,YAAA,KAAiB,YACxB,KAAA,IAAS,YAAA,GACL,aAAa,GAAA,GACb,YAAA;AAAA,MACN,OAAA,EAAS,EAAE,kBAAA,EAAoB,MAAA;AAAO;AACxC,GACF;AACF;AAEA,SAAS,eAAA,CACP,OACA,OAAA,EACS;AACT,EAAA,IAAI,OAAA,CAAQ,eAAA,GAAkB,KAAK,CAAA,EAAG,OAAO,IAAA;AAC7C,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,IAAA,GAAO,MAAA,IAAU,KAAA,GAAQ,KAAA,CAAM,IAAA,GAAO,MAAA;AAC5C,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,iBAAA,EAAmB,OAAO,IAAA;AACxD,EAAA,MAAM,OAAA,GACJ,SAAA,IAAa,KAAA,IAAS,OAAO,KAAA,CAAM,YAAY,QAAA,GAC3C,KAAA,CAAM,OAAA,CAAQ,WAAA,EAAY,GAC1B,EAAA;AACN,EAAA,OAAO,2DAAA,CAA4D,KAAK,OAAO,CAAA;AACjF;;;AC1HO,SAAS,oBACd,OAAA,EACiC;AACjC,EAAA,OAAO;AAAA,IACL,GAAG,oBAAA,CAAqB,OAAA,EAAS,OAAO,CAAA;AAAA,IACxC,KAAA,EAAO,CAAC,gBAAgB,CAAA;AAAA,IAExB,MAAM,QAAA,CAAS,SAAA,EAAW,OAAA,EAAS;AACjC,MAAA,cAAA,CAAe,OAAA,CAAQ,QAAQ,MAAM,CAAA;AACrC,MAAA,WAAA,CAAY,SAAA,CAAU,KAAA,EAAO,MAAM,OAAA,CAAQ,UAAU,CAAA;AACrD,MAAA,IAAI,CAAC,OAAA,CAAQ,SAAA,CAAU,SAAA,CAAU,cAAc,CAAA,EAAG;AAChD,QAAA,MAAM,IAAI,YAAA;AAAA,UACR,qBAAA;AAAA,UACA,MAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,OAAA,CAAQ,SAAA,EAAW,OAAA,EAAS;AAChC,MAAA,MAAM,mBAAA,CAAoB,OAAA,EAAS,SAAA,CAAU,KAAA,EAAO,UAAU,IAAA,EAAM;AAAA,QAClE,QAAQ,SAAA,CAAU,MAAA;AAAA,QAClB,gBAAgB,SAAA,CAAU,cAAA;AAAA,QAC1B,UAAU,SAAA,CAAU;AAAA,OACrB,CAAA;AACD,MAAA,IAAI,UAAA;AACJ,MAAA,IAAI;AACF,QAAA,UAAA,GAAa,MAAM,QAAQ,YAAA,CAAa;AAAA,UACtC,QAAQ,SAAA,CAAU,MAAA;AAAA,UAClB,gBAAgB,SAAA,CAAU,cAAA;AAAA,UAC1B,GAAI,UAAU,QAAA,KAAa,KAAA,CAAA,GACvB,EAAE,QAAA,EAAU,SAAA,CAAU,QAAA,EAAS,GAC/B,EAAC;AAAA,UACL,QAAQ,OAAA,CAAQ;AAAA,SACjB,CAAA;AAAA,MACH,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,gBAAA;AAAA,UACJ,KAAA;AAAA,UACA,OAAA;AAAA,UACA,WAAA;AAAA,UACA,kBAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AACA,MAAA,IAAI,CAAC,UAAA,CAAW,MAAA,EAAQ,IAAA,EAAK,EAAG;AAC9B,QAAA,MAAM,IAAI,YAAA;AAAA,UACR,kBAAA;AAAA,UACA,WAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AACA,MAAA,OAAO,QAAQ,OAAA,EAAS,UAAA,CAAW,MAAA,EAAQ,UAAA,CAAW,KAAK,OAAO,CAAA;AAAA,IACpE;AAAA,GACF;AACF;AAEA,eAAe,OAAA,CACb,OAAA,EACA,MAAA,EACA,GAAA,EACA,OAAA,EAC+B;AAC/B,EAAA,IAAI,OAAA,CAAQ,YAAY,WAAA,EAAa;AACnC,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,WAAA;AAAA,MACR,MAAA;AAAA,MACA,GAAI,GAAA,KAAQ,MAAA,GAAY,EAAE,GAAA,KAAQ;AAAC,KACrC;AAAA,EACF;AACA,EAAA,IAAI;AACF,IAAA,MAAM,YAAA,GAAe,MAAM,OAAA,CAAQ,kBAAA,CAAmB,MAAA,EAAQ;AAAA,MAC5D,QAAQ,OAAA,CAAQ;AAAA,KACjB,CAAA;AACD,IAAA,MAAM,eAAA,GAAkB,2BAA2B,YAAA,EAAc;AAAA,MAC/D,IAAA,EAAM,kBAAA;AAAA,MACN,KAAA,EAAO,WAAA;AAAA,MACP,OAAA,EAAS;AAAA,KACV,CAAA;AACD,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,kBAAA;AAAA,MACR,MAAA;AAAA,MACA,KAAK,eAAA,IAAmB;AAAA,KAC1B;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,gBAAA;AAAA,MACJ,KAAA;AAAA,MACA,OAAA;AAAA,MACA,WAAA;AAAA,MACA,kBAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF","file":"zcash.mjs","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface ZcashWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    decimals?: number;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createZcashExecutor(\n  adapter: ZcashWalletAdapter\n): ChainExecutor<\"zcash-transfer\"> {\n  return {\n    ...exposeExecutorSigner(\"zcash\", adapter),\n    kinds: [\"zcash-transfer\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (!adapter.isAddress(execution.depositAddress)) {\n        throw new SwapSdkError(\n          \"INVALID_TRANSACTION\",\n          \"sign\",\n          \"Invalid Zcash transparent deposit address\"\n        );\n      }\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        amount: execution.amount,\n        depositAddress: execution.depositAddress,\n        decimals: execution.decimals,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.sendTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          ...(execution.decimals !== undefined\n            ? { decimals: execution.decimals }\n            : {}),\n          signal: context.signal,\n        });\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to submit Zcash transfer\"\n        );\n      }\n      if (!submission.txHash?.trim()) {\n        throw new SwapSdkError(\n          \"BROADCAST_FAILED\",\n          \"broadcast\",\n          \"Zcash wallet returned no transaction hash\"\n        );\n      }\n      return confirm(adapter, submission.txHash, submission.raw, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: ZcashWalletAdapter,\n  txHash: string,\n  raw: unknown,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Zcash transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash,\n      raw: confirmationRaw ?? raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Zcash transfer\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/zcash/index.ts"],"names":[],"mappings":"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","file":"zcash.mjs","sourcesContent":["import { logSdkCaughtError } from \"./catchLog\";\n\nexport type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  logSdkCaughtError(`asSwapSdkError:${stage}`, error);\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\nimport { logSdkCaughtError } from \"../core/catchLog\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  logSdkCaughtError(`executor.mapExecutorError:${stage}:${code}`, error);\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import { SwapSdkError } from \"../../core/errors\";\nimport type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\nimport { logSdkCaughtError } from \"../../core/catchLog\";\n\nexport interface ZcashWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  isAddress(address: string): boolean;\n  sendTransfer(input: {\n    amount: string;\n    depositAddress: string;\n    decimals?: number;\n    signal?: AbortSignal;\n  }): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createZcashExecutor(\n  adapter: ZcashWalletAdapter\n): ChainExecutor<\"zcash-transfer\"> {\n  return {\n    ...exposeExecutorSigner(\"zcash\", adapter),\n    kinds: [\"zcash-transfer\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n      if (!adapter.isAddress(execution.depositAddress)) {\n        throw new SwapSdkError(\n          \"INVALID_TRANSACTION\",\n          \"sign\",\n          \"Invalid Zcash transparent deposit address\"\n        );\n      }\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        amount: execution.amount,\n        depositAddress: execution.depositAddress,\n        decimals: execution.decimals,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.sendTransfer({\n          amount: execution.amount,\n          depositAddress: execution.depositAddress,\n          ...(execution.decimals !== undefined\n            ? { decimals: execution.decimals }\n            : {}),\n          signal: context.signal,\n        });\n      } catch (error) {\n        logSdkCaughtError(\"executors/zcash/index.ts\", error);\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to submit Zcash transfer\"\n        );\n      }\n      if (!submission.txHash?.trim()) {\n        throw new SwapSdkError(\n          \"BROADCAST_FAILED\",\n          \"broadcast\",\n          \"Zcash wallet returned no transaction hash\"\n        );\n      }\n      return confirm(adapter, submission.txHash, submission.raw, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: ZcashWalletAdapter,\n  txHash: string,\n  raw: unknown,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash,\n      ...(raw !== undefined ? { raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Zcash transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash,\n      raw: confirmationRaw ?? raw,\n    };\n  } catch (error) {\n    logSdkCaughtError(\"executors/zcash/index.ts\", error);\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Zcash transfer\"\n    );\n  }\n}\n"]}

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, l as SwapHistoryAuthChallengeRequestRaw, m as SwapHistoryAuthChallengeRaw, n as SwapHistoryAuthVerifyRequestRaw, o as SwapHistoryAuthTokenRaw, p as SwapFromTokensDataRaw, q as SwapCrossChainToTokensDataRaw, Q as QuoteRequest, r as Quote, s as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, t as SwapLifecycleEvent, u as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, v as SwapHistoryRecordRaw, w as ChainExecutor, E as ExecutorRegistry, x as SwapBuild, y as ExecuteSwapInput, z as SwapInput, D as OrderReference, F as OrderStatusResult, G as WaitForOrderInput, H as SwapHistoryAuthProofRaw, N as NearTransaction, I as SwapMcaRelayerRequestRaw } from './shared-DpC8G2U4.mjs';
-export { ac as BuildContext, _ as ChainExecutionResult, a8 as DepositInfo, a5 as EvmApproval, a6 as EvmSigningRequest, a4 as EvmTx, $ as ExecutionContext, a1 as ExecutorIdentityProvider, a2 as ExecutorMessageSigner, a0 as MessageSignOptions, Y as OrderStatus, ab as RouteSummary, X as SignRequestPreview, a7 as SolanaMetadata, J as SwapApiResponse, K as SwapApiTokenMetaRaw, R as SwapBuildApproveRaw, aa as SwapExecution, U as SwapHistoryWalletChainFamilyRaw, M as SwapMcaSignerPayloadRaw, a9 as SwapReportContext, P as SwapSigningRequestRaw, L as SwapTokenListRowRaw, V as SwapWarning, T as TransactionConfirmation, a3 as assertBaseUnitAmount, Z as normalizeOrderStatus } from './shared-DpC8G2U4.mjs';
+import { S as SwapQuoteRequestRaw, a as SwapQuoteDataRaw, b as SwapBuildRequestRaw, c as SwapBuildDataRaw, d as SwapOrderSubmitRequestRaw, e as SwapOrderSubmitDataRaw, f as SwapOrderStatusParamsRaw, g as SwapOrderStatusDataRaw, h as SwapReportRequestRaw, i as SwapReportDataRaw, j as SwapHistoryParamsRaw, k as SwapHistoryDataRaw, l as SwapHistoryAuthChallengeRequestRaw, m as SwapHistoryAuthChallengeRaw, n as SwapHistoryAuthVerifyRequestRaw, o as SwapHistoryAuthTokenRaw, p as SwapFromTokensDataRaw, q as SwapCrossChainToTokensDataRaw, Q as QuoteRequest, r as Quote, s as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, t as SwapLifecycleEvent, u as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, v as SwapHistoryRecordRaw, w as ChainExecutor, E as ExecutorRegistry, x as SwapBuild, y as ExecuteSwapInput, z as SwapInput, D as OrderReference, F as OrderStatusResult, G as WaitForOrderInput, H as SwapHistoryAuthProofRaw, N as NearTransaction, I as SwapMcaRelayerRequestRaw } from './shared-v1w63b8X.mjs';
+export { ae as BuildContext, _ as ChainExecutionResult, aa as DepositInfo, a5 as EvmApproval, a6 as EvmSigningRequest, a4 as EvmTx, $ as ExecutionContext, a1 as ExecutorIdentityProvider, a2 as ExecutorMessageSigner, a0 as MessageSignOptions, Y as OrderStatus, ad as RouteSummary, X as SignRequestPreview, a7 as SolanaMetadata, J as SwapApiResponse, K as SwapApiTokenMetaRaw, R as SwapBuildApproveRaw, ac as SwapExecution, U as SwapHistoryWalletChainFamilyRaw, M as SwapMcaSignerPayloadRaw, ab as SwapReportContext, P as SwapSigningRequestRaw, L as SwapTokenListRowRaw, V as SwapWarning, T as TransactionConfirmation, a9 as TronApproval, a8 as TronUnsignedTransaction, a3 as assertBaseUnitAmount, Z as normalizeOrderStatus } from './shared-v1w63b8X.mjs';
 
 type SwapErrorCode = "HTTP_ERROR" | "API_ERROR" | "RATE_LIMITED" | "AUTH_FAILED" | "REQUEST_ABORTED" | "REQUEST_TIMEOUT" | "INVALID_REQUEST" | "INVALID_API_RESPONSE" | "QUOTE_EXPIRED" | "ROUTE_NOT_FOUND" | "EXECUTOR_NOT_FOUND" | "UNSUPPORTED_CHAIN" | "CHAIN_MISMATCH" | "INVALID_TRANSACTION" | "USER_REJECTED" | "INSUFFICIENT_BALANCE" | "APPROVAL_FAILED" | "SIGNING_FAILED" | "BROADCAST_FAILED" | "ORDER_SUBMIT_FAILED" | "ORDER_TIMEOUT" | "REPORT_FAILED";
 type SwapErrorStage = "quote" | "build" | "approve" | "sign" | "broadcast" | "submit" | "report" | "status" | "tokens" | "history";
@@ -42,6 +42,8 @@ interface ApiClientConfig {
     headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
     timeoutMs?: number;
     logger?: SdkLogger;
+    /** Dump catch-site errors to console. Default false. */
+    debugCatchLogging?: boolean;
 }
 interface ApiRequestOptions {
     signal?: AbortSignal;
@@ -279,6 +281,17 @@ declare class SwapClient {
     private createReportRequest;
 }
 
+/**
+ * Debug helper: dump SDK catch sites to the console (browser / Node).
+ * Off by default — enable via {@link setSdkCatchLogging} or
+ * `SwapClient({ debugCatchLogging: true })`.
+ * Filter DevTools by `[cross-chain-aggregation-dex]`.
+ */
+/** Enable or disable catch-site console dumping. Default: off. */
+declare function setSdkCatchLogging(enabled: boolean): void;
+declare function isSdkCatchLoggingEnabled(): boolean;
+declare function logSdkCaughtError(scope: string, error: unknown): void;
+
 declare function normalizeBuild(raw: SwapBuildDataRaw, executionId?: string, request?: SwapBuildRequestRaw): SwapBuild;
 declare function createExecutionId(): string;
 
@@ -396,4 +409,4 @@ declare function resolveSourceTxHash(input: {
 declare function parseUnits(value: string, decimals: number): BaseUnitAmount;
 declare function formatUnits(value: BaseUnitAmount, decimals: number): string;
 
-export { ApiClient, type ApiClientConfig, type ApiRequestOptions, AssetRef, BaseUnitAmount, type BuildMcaWithdrawRelayerRequestInput, type BuildNearMcaWithdrawTransactionsInput, type BuildSwapInput, ChainExecutor, ChainRef, DEFAULT_MCA_SIGNER_PRIORITY, ExecuteSwapInput, ExecutorRegistry, type ExtractMcaWithdrawDepositAddressInput, type HistoryRequest, type HistoryStatus, type McaDepositCollateral, type McaDepositQuote, type McaDepositQuoteRequest, type McaFlow, type McaQuote, type McaQuoteRequest, type McaSignerChain, type McaSignerIdentity, type McaSwapInput, type McaSwapResult, type McaWalletDescriptor, type McaWalletKey, type McaWithdrawCollateral, type McaWithdrawNearQuote, type McaWithdrawQuoteRequest, type McaWithdrawRelayerQuote, NearTransaction, OrderPollingOptions, OrderReference, type OrderStatusLookup, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaRequiredCollateralDecreaseInput, type ResolveMcaWithdrawPolicyInput, type SdkLogEntry, type SdkLogLevel, type SdkLogger, SwapBuild, SwapBuildDataRaw, SwapBuildRequestRaw, SwapClient, type SwapClientConfig, SwapCrossChainToTokensDataRaw, type SwapErrorCode, type SwapErrorStage, SwapExecutionResult, SwapFromTokensDataRaw, SwapHistoryAuthChallengeRaw, SwapHistoryAuthChallengeRequestRaw, SwapHistoryAuthProofRaw, SwapHistoryAuthTokenRaw, SwapHistoryAuthVerifyRequestRaw, SwapHistoryDataRaw, type SwapHistoryItem, type SwapHistoryPage, SwapHistoryParamsRaw, SwapHistoryRecordRaw, SwapInput, SwapLifecycleEvent, SwapMcaPayloadRaw, SwapMcaRelayerRequestRaw, SwapOrderStatusDataRaw, SwapOrderStatusParamsRaw, SwapOrderSubmitDataRaw, SwapOrderSubmitRequestRaw, SwapQuoteDataRaw, SwapQuoteRequestRaw, SwapReportDataRaw, SwapReportRequestRaw, SwapSdkError, type SwapSdkErrorOptions, type SwapTokenListItem, type TokenListRequest, WaitForOrderInput, WaitMode, asSwapSdkError, assertOrderStatusParams, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, buildOrderStatusQuery, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, normalizeBuild, normalizeCrossChainToTokenList, normalizeFromTokenList, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, orderStatusParamsFromHistoryItem, parseUnits, resolveMcaDecreaseCollateral, resolveMcaRequiredCollateralDecrease, resolveMcaWithdrawPolicy, resolveOrderStatusLookup, resolveSourceTxHash, resolveSwapReportRecordId, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, shouldPollSwapOrderStatus, toApiAssetAddress, toApiChain };
+export { ApiClient, type ApiClientConfig, type ApiRequestOptions, AssetRef, BaseUnitAmount, type BuildMcaWithdrawRelayerRequestInput, type BuildNearMcaWithdrawTransactionsInput, type BuildSwapInput, ChainExecutor, ChainRef, DEFAULT_MCA_SIGNER_PRIORITY, ExecuteSwapInput, ExecutorRegistry, type ExtractMcaWithdrawDepositAddressInput, type HistoryRequest, type HistoryStatus, type McaDepositCollateral, type McaDepositQuote, type McaDepositQuoteRequest, type McaFlow, type McaQuote, type McaQuoteRequest, type McaSignerChain, type McaSignerIdentity, type McaSwapInput, type McaSwapResult, type McaWalletDescriptor, type McaWalletKey, type McaWithdrawCollateral, type McaWithdrawNearQuote, type McaWithdrawQuoteRequest, type McaWithdrawRelayerQuote, NearTransaction, OrderPollingOptions, OrderReference, type OrderStatusLookup, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaRequiredCollateralDecreaseInput, type ResolveMcaWithdrawPolicyInput, type SdkLogEntry, type SdkLogLevel, type SdkLogger, SwapBuild, SwapBuildDataRaw, SwapBuildRequestRaw, SwapClient, type SwapClientConfig, SwapCrossChainToTokensDataRaw, type SwapErrorCode, type SwapErrorStage, SwapExecutionResult, SwapFromTokensDataRaw, SwapHistoryAuthChallengeRaw, SwapHistoryAuthChallengeRequestRaw, SwapHistoryAuthProofRaw, SwapHistoryAuthTokenRaw, SwapHistoryAuthVerifyRequestRaw, SwapHistoryDataRaw, type SwapHistoryItem, type SwapHistoryPage, SwapHistoryParamsRaw, SwapHistoryRecordRaw, SwapInput, SwapLifecycleEvent, SwapMcaPayloadRaw, SwapMcaRelayerRequestRaw, SwapOrderStatusDataRaw, SwapOrderStatusParamsRaw, SwapOrderSubmitDataRaw, SwapOrderSubmitRequestRaw, SwapQuoteDataRaw, SwapQuoteRequestRaw, SwapReportDataRaw, SwapReportRequestRaw, SwapSdkError, type SwapSdkErrorOptions, type SwapTokenListItem, type TokenListRequest, WaitForOrderInput, WaitMode, asSwapSdkError, assertOrderStatusParams, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, buildOrderStatusQuery, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, isSdkCatchLoggingEnabled, logSdkCaughtError, normalizeBuild, normalizeCrossChainToTokenList, normalizeFromTokenList, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, orderStatusParamsFromHistoryItem, parseUnits, resolveMcaDecreaseCollateral, resolveMcaRequiredCollateralDecrease, resolveMcaWithdrawPolicy, resolveOrderStatusLookup, resolveSourceTxHash, resolveSwapReportRecordId, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, setSdkCatchLogging, shouldPollSwapOrderStatus, toApiAssetAddress, toApiChain };