@rhea-finance/cross-chain-aggregation-dex 2.0.4 → 2.0.6

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  | \"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":["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"]}

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":"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","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  | \"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":["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"]}

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-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, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-D0_DbMT2.mjs';
-export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-D0_DbMT2.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 OrderStatusResult, F as WaitForOrderInput, G as SwapHistoryAuthProofRaw, N as NearTransaction, H as SwapMcaRelayerRequestRaw } from './shared-COkGiqaz.mjs';
+export { ac as BuildContext, Z as ChainExecutionResult, a8 as DepositInfo, a4 as EvmApproval, a5 as EvmSigningRequest, a3 as EvmTx, _ as ExecutionContext, a0 as ExecutorIdentityProvider, a1 as ExecutorMessageSigner, $ as MessageSignOptions, a7 as OrderReference, X as OrderStatus, ab as RouteSummary, V as SignRequestPreview, a6 as SolanaMetadata, I as SwapApiResponse, J as SwapApiTokenMetaRaw, P as SwapBuildApproveRaw, aa as SwapExecution, R as SwapHistoryWalletChainFamilyRaw, L as SwapMcaSignerPayloadRaw, a9 as SwapReportContext, M as SwapSigningRequestRaw, K as SwapTokenListRowRaw, U as SwapWarning, T as TransactionConfirmation, a2 as assertBaseUnitAmount, Y as normalizeOrderStatus } from './shared-COkGiqaz.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" | "history";
+type SwapErrorStage = "quote" | "build" | "approve" | "sign" | "broadcast" | "submit" | "report" | "status" | "tokens" | "history";
 interface SwapSdkErrorOptions {
     retryable?: boolean;
     cause?: unknown;
@@ -66,6 +66,10 @@ declare class ApiClient {
     getOrderStatus(params: SwapOrderStatusParamsRaw, options?: ApiRequestOptions): Promise<SwapOrderStatusDataRaw>;
     report(body: SwapReportRequestRaw, options?: ApiRequestOptions): Promise<SwapReportDataRaw>;
     getHistory(params: SwapHistoryParamsRaw, options?: ApiRequestOptions): Promise<SwapHistoryDataRaw>;
+    createHistoryAuthChallenge(body: SwapHistoryAuthChallengeRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthChallengeRaw>;
+    verifyHistoryAuthChallenge(body: SwapHistoryAuthVerifyRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
+    getFromTokenRows(chainId: number, options?: ApiRequestOptions): Promise<SwapFromTokensDataRaw>;
+    getCrossChainToTokenRows(chainId: number, options?: ApiRequestOptions): Promise<SwapCrossChainToTokensDataRaw>;
     private request;
     private requestOnce;
     private buildUrl;
@@ -89,7 +93,14 @@ interface McaDepositCollateral {
     useAsCollateral: boolean;
 }
 interface McaWithdrawCollateral {
-    needDecrease: boolean;
+    /**
+     * @deprecated The SDK derives this value from decreaseAmountBurrow.
+     *
+     * Compatibility hint. The SDK derives the API's needDecreaseCollateral
+     * from decreaseAmountBurrow so contradictory values cannot be sent.
+     */
+    needDecrease?: boolean;
+    /** Required collateral decrease: max(amountBurrow - suppliedBalance, 0). */
     decreaseAmountBurrow: string;
     withdrawAll?: boolean;
 }
@@ -159,6 +170,10 @@ interface HistoryRequest {
     page?: number;
     pageSize?: number;
     status?: HistoryStatus[];
+    /** Queries wallet-authorized confidential history. */
+    mode?: "confidential";
+    /** Token returned by the confidential history auth verify endpoint. */
+    walletToken?: string;
 }
 interface SwapHistoryPage {
     items: SwapHistoryItem[];
@@ -191,12 +206,38 @@ interface SwapHistoryItem {
     raw: SwapHistoryRecordRaw;
 }
 
+interface TokenListRequest {
+    /** Numeric ID accepted by the token-list endpoints. */
+    chainId: number;
+}
+interface SwapTokenListItem extends AssetRef {
+    chain: ChainRef;
+    /** Token identifier accepted by the unified quote API. */
+    address: string;
+    symbol: string;
+    decimals: number;
+    isNative: boolean;
+    tokenListChainId: number;
+    blockchain: string;
+    assetId: string;
+    contractAddress: string | null;
+    coinType: string | null;
+    name: string | null;
+    logoURI: string | null;
+    price: string | number | null;
+    priceUpdatedAt: number | null;
+    sources: string[];
+    raw: Record<string, unknown>;
+}
+
 interface SwapClientConfig extends ApiClientConfig {
     maxQuoteAgeMs?: number | null;
     reportMode?: "auto" | "manual" | "disabled";
     executors?: readonly ChainExecutor[];
     onEvent?: (event: SwapLifecycleEvent) => void;
     now?: () => number;
+    /** Token-list cache lifetime in milliseconds. Defaults to 10 minutes; use 0 to disable. */
+    tokenListCacheTtlMs?: number;
 }
 interface BuildSwapInput {
     quote: Quote;
@@ -212,12 +253,17 @@ declare class SwapClient {
     private readonly now;
     private readonly inFlight;
     private readonly reportRequests;
+    private readonly tokenListCache;
+    private readonly tokenListInflight;
     constructor(config: SwapClientConfig);
     quoteRaw(request: SwapQuoteRequestRaw, options?: ApiRequestOptions): Promise<SwapQuoteDataRaw>;
     quote(request: McaQuoteRequest, options?: ApiRequestOptions): Promise<McaQuote>;
     quote(request: QuoteRequest, options?: ApiRequestOptions): Promise<Quote>;
     private quoteStandard;
     buildRaw(request: SwapBuildRequestRaw, options?: ApiRequestOptions): Promise<SwapBuildDataRaw>;
+    getFromTokens(request: TokenListRequest, options?: ApiRequestOptions): Promise<SwapTokenListItem[]>;
+    getCrossChainToTokens(request: TokenListRequest, options?: ApiRequestOptions): Promise<SwapTokenListItem[]>;
+    private loadTokenList;
     buildSwap(input: BuildSwapInput): Promise<SwapBuild>;
     private buildStandardSwap;
     executeSwap(input: ExecuteSwapInput): Promise<SwapExecutionResult>;
@@ -236,6 +282,9 @@ declare class SwapClient {
     report(result: SwapExecutionResult): Promise<SwapReportDataRaw>;
     retryReport(result: SwapExecutionResult): Promise<SwapReportDataRaw>;
     getHistoryRaw(params: SwapHistoryParamsRaw, options?: ApiRequestOptions): Promise<SwapHistoryDataRaw>;
+    createHistoryAuthChallenge(request: SwapHistoryAuthChallengeRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthChallengeRaw>;
+    verifyHistoryAuthChallenge(request: SwapHistoryAuthVerifyRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
+    authorizeConfidentialHistory(request: SwapHistoryAuthChallengeRequestRaw, signChallenge: (challenge: SwapHistoryAuthChallengeRaw) => SwapHistoryAuthProofRaw | Promise<SwapHistoryAuthProofRaw>, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
     getHistory(request: HistoryRequest, options?: ApiRequestOptions): Promise<SwapHistoryPage>;
     protected emit(event: SwapLifecycleEvent): void;
     private assertQuoteFresh;
@@ -255,15 +304,42 @@ declare function normalizeHistoryStatus(status: unknown): HistoryStatus;
 declare function serializeQuoteRequest(request: QuoteRequest): SwapQuoteRequestRaw;
 declare function normalizeQuote(request: QuoteRequest, raw: SwapQuoteDataRaw, receivedAt?: number): Quote;
 
+declare function normalizeFromTokenList(raw: SwapFromTokensDataRaw, chainId: number): SwapTokenListItem[];
+declare function normalizeCrossChainToTokenList(raw: SwapCrossChainToTokensDataRaw, chainId: number): SwapTokenListItem[];
+
 interface ResolveMcaWithdrawPolicyInput {
-    collateralBalance: string;
+    /** Requested withdraw amount in Burrow internal decimals. */
+    amountBurrow: string;
+    /** Current supplied balance for the token in Burrow internal decimals. */
+    suppliedBalance: string;
     availableBalance: string;
+    /** Human/display withdraw amount, in the same precision as availableBalance. */
     amountIn: string;
     isMax: boolean;
 }
 declare function resolveMcaWithdrawPolicy(input: ResolveMcaWithdrawPolicyInput): McaWithdrawCollateral & {
+    needDecrease: boolean;
     withdrawAll: boolean;
 };
+interface ResolveMcaRequiredCollateralDecreaseInput {
+    amountBurrow: string;
+    suppliedBalance: string;
+}
+/**
+ * Matches Lending Withdraw and multi-chain-lending's 2026-08-20 hotfix:
+ * only the part of the requested withdraw that exceeds supplied balance must
+ * be removed from collateral.
+ */
+declare function resolveMcaRequiredCollateralDecrease(input: ResolveMcaRequiredCollateralDecreaseInput): Pick<McaWithdrawCollateral, "needDecrease" | "decreaseAmountBurrow"> & {
+    needDecrease: boolean;
+};
+/**
+ * Derive needDecreaseCollateral from an already-computed required decrease and
+ * serialize it in canonical, non-exponential decimal form.
+ */
+declare function resolveMcaDecreaseCollateral(decreaseAmountBurrow: string, field?: string): Pick<McaWithdrawCollateral, "needDecrease" | "decreaseAmountBurrow"> & {
+    needDecrease: boolean;
+};
 
 declare function serializeMcaQuoteRequest(request: McaQuoteRequest, signer: McaSignerIdentity): SwapQuoteRequestRaw;
 declare function normalizeMcaQuote(request: McaQuoteRequest, signer: McaSignerIdentity, quote: Quote): McaQuote;
@@ -304,4 +380,4 @@ declare function buildMcaWithdrawRelayerRequest(input: BuildMcaWithdrawRelayerRe
 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, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaWithdrawPolicyInput, type RetryConfig, type SdkLogEntry, type SdkLogLevel, type SdkLogger, SwapBuild, SwapBuildDataRaw, SwapBuildRequestRaw, SwapClient, type SwapClientConfig, type SwapErrorCode, type SwapErrorStage, SwapExecutionResult, SwapHistoryDataRaw, type SwapHistoryItem, type SwapHistoryPage, SwapHistoryParamsRaw, SwapHistoryRecordRaw, SwapInput, SwapLifecycleEvent, SwapMcaPayloadRaw, SwapMcaRelayerRequestRaw, SwapOrderStatusDataRaw, SwapOrderStatusParamsRaw, SwapOrderSubmitDataRaw, SwapOrderSubmitRequestRaw, SwapQuoteDataRaw, SwapQuoteRequestRaw, SwapReportDataRaw, SwapReportRequestRaw, SwapSdkError, type SwapSdkErrorOptions, WaitForOrderInput, WaitMode, asSwapSdkError, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, normalizeBuild, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, parseUnits, resolveMcaWithdrawPolicy, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, 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, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaRequiredCollateralDecreaseInput, type ResolveMcaWithdrawPolicyInput, type RetryConfig, 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, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, normalizeBuild, normalizeCrossChainToTokenList, normalizeFromTokenList, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, parseUnits, resolveMcaDecreaseCollateral, resolveMcaRequiredCollateralDecrease, resolveMcaWithdrawPolicy, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, toApiAssetAddress, toApiChain };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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, Q as QuoteRequest, l as Quote, m as SwapMcaPayloadRaw, W as WaitMode, O as OrderPollingOptions, n as SwapLifecycleEvent, o as SwapExecutionResult, C as ChainRef, A as AssetRef, B as BaseUnitAmount, p as SwapHistoryRecordRaw, q as ChainExecutor, E as ExecutorRegistry, r as SwapBuild, s as ExecuteSwapInput, t as SwapInput, u as OrderStatusResult, v as WaitForOrderInput, N as NearTransaction, w as SwapMcaRelayerRequestRaw } from './shared-D0_DbMT2.js';
-export { a3 as BuildContext, K as ChainExecutionResult, $ as DepositInfo, X as EvmApproval, Y as EvmSigningRequest, V as EvmTx, L as ExecutionContext, P as ExecutorIdentityProvider, R as ExecutorMessageSigner, M as MessageSignOptions, _ as OrderReference, I as OrderStatus, a2 as RouteSummary, H as SignRequestPreview, Z as SolanaMetadata, x as SwapApiResponse, y as SwapApiTokenMetaRaw, F as SwapBuildApproveRaw, a1 as SwapExecution, z as SwapMcaSignerPayloadRaw, a0 as SwapReportContext, D as SwapSigningRequestRaw, G as SwapWarning, T as TransactionConfirmation, U as assertBaseUnitAmount, J as normalizeOrderStatus } from './shared-D0_DbMT2.js';
+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 OrderStatusResult, F as WaitForOrderInput, G as SwapHistoryAuthProofRaw, N as NearTransaction, H as SwapMcaRelayerRequestRaw } from './shared-COkGiqaz.js';
+export { ac as BuildContext, Z as ChainExecutionResult, a8 as DepositInfo, a4 as EvmApproval, a5 as EvmSigningRequest, a3 as EvmTx, _ as ExecutionContext, a0 as ExecutorIdentityProvider, a1 as ExecutorMessageSigner, $ as MessageSignOptions, a7 as OrderReference, X as OrderStatus, ab as RouteSummary, V as SignRequestPreview, a6 as SolanaMetadata, I as SwapApiResponse, J as SwapApiTokenMetaRaw, P as SwapBuildApproveRaw, aa as SwapExecution, R as SwapHistoryWalletChainFamilyRaw, L as SwapMcaSignerPayloadRaw, a9 as SwapReportContext, M as SwapSigningRequestRaw, K as SwapTokenListRowRaw, U as SwapWarning, T as TransactionConfirmation, a2 as assertBaseUnitAmount, Y as normalizeOrderStatus } from './shared-COkGiqaz.js';
 
 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" | "history";
+type SwapErrorStage = "quote" | "build" | "approve" | "sign" | "broadcast" | "submit" | "report" | "status" | "tokens" | "history";
 interface SwapSdkErrorOptions {
     retryable?: boolean;
     cause?: unknown;
@@ -66,6 +66,10 @@ declare class ApiClient {
     getOrderStatus(params: SwapOrderStatusParamsRaw, options?: ApiRequestOptions): Promise<SwapOrderStatusDataRaw>;
     report(body: SwapReportRequestRaw, options?: ApiRequestOptions): Promise<SwapReportDataRaw>;
     getHistory(params: SwapHistoryParamsRaw, options?: ApiRequestOptions): Promise<SwapHistoryDataRaw>;
+    createHistoryAuthChallenge(body: SwapHistoryAuthChallengeRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthChallengeRaw>;
+    verifyHistoryAuthChallenge(body: SwapHistoryAuthVerifyRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
+    getFromTokenRows(chainId: number, options?: ApiRequestOptions): Promise<SwapFromTokensDataRaw>;
+    getCrossChainToTokenRows(chainId: number, options?: ApiRequestOptions): Promise<SwapCrossChainToTokensDataRaw>;
     private request;
     private requestOnce;
     private buildUrl;
@@ -89,7 +93,14 @@ interface McaDepositCollateral {
     useAsCollateral: boolean;
 }
 interface McaWithdrawCollateral {
-    needDecrease: boolean;
+    /**
+     * @deprecated The SDK derives this value from decreaseAmountBurrow.
+     *
+     * Compatibility hint. The SDK derives the API's needDecreaseCollateral
+     * from decreaseAmountBurrow so contradictory values cannot be sent.
+     */
+    needDecrease?: boolean;
+    /** Required collateral decrease: max(amountBurrow - suppliedBalance, 0). */
     decreaseAmountBurrow: string;
     withdrawAll?: boolean;
 }
@@ -159,6 +170,10 @@ interface HistoryRequest {
     page?: number;
     pageSize?: number;
     status?: HistoryStatus[];
+    /** Queries wallet-authorized confidential history. */
+    mode?: "confidential";
+    /** Token returned by the confidential history auth verify endpoint. */
+    walletToken?: string;
 }
 interface SwapHistoryPage {
     items: SwapHistoryItem[];
@@ -191,12 +206,38 @@ interface SwapHistoryItem {
     raw: SwapHistoryRecordRaw;
 }
 
+interface TokenListRequest {
+    /** Numeric ID accepted by the token-list endpoints. */
+    chainId: number;
+}
+interface SwapTokenListItem extends AssetRef {
+    chain: ChainRef;
+    /** Token identifier accepted by the unified quote API. */
+    address: string;
+    symbol: string;
+    decimals: number;
+    isNative: boolean;
+    tokenListChainId: number;
+    blockchain: string;
+    assetId: string;
+    contractAddress: string | null;
+    coinType: string | null;
+    name: string | null;
+    logoURI: string | null;
+    price: string | number | null;
+    priceUpdatedAt: number | null;
+    sources: string[];
+    raw: Record<string, unknown>;
+}
+
 interface SwapClientConfig extends ApiClientConfig {
     maxQuoteAgeMs?: number | null;
     reportMode?: "auto" | "manual" | "disabled";
     executors?: readonly ChainExecutor[];
     onEvent?: (event: SwapLifecycleEvent) => void;
     now?: () => number;
+    /** Token-list cache lifetime in milliseconds. Defaults to 10 minutes; use 0 to disable. */
+    tokenListCacheTtlMs?: number;
 }
 interface BuildSwapInput {
     quote: Quote;
@@ -212,12 +253,17 @@ declare class SwapClient {
     private readonly now;
     private readonly inFlight;
     private readonly reportRequests;
+    private readonly tokenListCache;
+    private readonly tokenListInflight;
     constructor(config: SwapClientConfig);
     quoteRaw(request: SwapQuoteRequestRaw, options?: ApiRequestOptions): Promise<SwapQuoteDataRaw>;
     quote(request: McaQuoteRequest, options?: ApiRequestOptions): Promise<McaQuote>;
     quote(request: QuoteRequest, options?: ApiRequestOptions): Promise<Quote>;
     private quoteStandard;
     buildRaw(request: SwapBuildRequestRaw, options?: ApiRequestOptions): Promise<SwapBuildDataRaw>;
+    getFromTokens(request: TokenListRequest, options?: ApiRequestOptions): Promise<SwapTokenListItem[]>;
+    getCrossChainToTokens(request: TokenListRequest, options?: ApiRequestOptions): Promise<SwapTokenListItem[]>;
+    private loadTokenList;
     buildSwap(input: BuildSwapInput): Promise<SwapBuild>;
     private buildStandardSwap;
     executeSwap(input: ExecuteSwapInput): Promise<SwapExecutionResult>;
@@ -236,6 +282,9 @@ declare class SwapClient {
     report(result: SwapExecutionResult): Promise<SwapReportDataRaw>;
     retryReport(result: SwapExecutionResult): Promise<SwapReportDataRaw>;
     getHistoryRaw(params: SwapHistoryParamsRaw, options?: ApiRequestOptions): Promise<SwapHistoryDataRaw>;
+    createHistoryAuthChallenge(request: SwapHistoryAuthChallengeRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthChallengeRaw>;
+    verifyHistoryAuthChallenge(request: SwapHistoryAuthVerifyRequestRaw, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
+    authorizeConfidentialHistory(request: SwapHistoryAuthChallengeRequestRaw, signChallenge: (challenge: SwapHistoryAuthChallengeRaw) => SwapHistoryAuthProofRaw | Promise<SwapHistoryAuthProofRaw>, options?: ApiRequestOptions): Promise<SwapHistoryAuthTokenRaw>;
     getHistory(request: HistoryRequest, options?: ApiRequestOptions): Promise<SwapHistoryPage>;
     protected emit(event: SwapLifecycleEvent): void;
     private assertQuoteFresh;
@@ -255,15 +304,42 @@ declare function normalizeHistoryStatus(status: unknown): HistoryStatus;
 declare function serializeQuoteRequest(request: QuoteRequest): SwapQuoteRequestRaw;
 declare function normalizeQuote(request: QuoteRequest, raw: SwapQuoteDataRaw, receivedAt?: number): Quote;
 
+declare function normalizeFromTokenList(raw: SwapFromTokensDataRaw, chainId: number): SwapTokenListItem[];
+declare function normalizeCrossChainToTokenList(raw: SwapCrossChainToTokensDataRaw, chainId: number): SwapTokenListItem[];
+
 interface ResolveMcaWithdrawPolicyInput {
-    collateralBalance: string;
+    /** Requested withdraw amount in Burrow internal decimals. */
+    amountBurrow: string;
+    /** Current supplied balance for the token in Burrow internal decimals. */
+    suppliedBalance: string;
     availableBalance: string;
+    /** Human/display withdraw amount, in the same precision as availableBalance. */
     amountIn: string;
     isMax: boolean;
 }
 declare function resolveMcaWithdrawPolicy(input: ResolveMcaWithdrawPolicyInput): McaWithdrawCollateral & {
+    needDecrease: boolean;
     withdrawAll: boolean;
 };
+interface ResolveMcaRequiredCollateralDecreaseInput {
+    amountBurrow: string;
+    suppliedBalance: string;
+}
+/**
+ * Matches Lending Withdraw and multi-chain-lending's 2026-08-20 hotfix:
+ * only the part of the requested withdraw that exceeds supplied balance must
+ * be removed from collateral.
+ */
+declare function resolveMcaRequiredCollateralDecrease(input: ResolveMcaRequiredCollateralDecreaseInput): Pick<McaWithdrawCollateral, "needDecrease" | "decreaseAmountBurrow"> & {
+    needDecrease: boolean;
+};
+/**
+ * Derive needDecreaseCollateral from an already-computed required decrease and
+ * serialize it in canonical, non-exponential decimal form.
+ */
+declare function resolveMcaDecreaseCollateral(decreaseAmountBurrow: string, field?: string): Pick<McaWithdrawCollateral, "needDecrease" | "decreaseAmountBurrow"> & {
+    needDecrease: boolean;
+};
 
 declare function serializeMcaQuoteRequest(request: McaQuoteRequest, signer: McaSignerIdentity): SwapQuoteRequestRaw;
 declare function normalizeMcaQuote(request: McaQuoteRequest, signer: McaSignerIdentity, quote: Quote): McaQuote;
@@ -304,4 +380,4 @@ declare function buildMcaWithdrawRelayerRequest(input: BuildMcaWithdrawRelayerRe
 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, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaWithdrawPolicyInput, type RetryConfig, type SdkLogEntry, type SdkLogLevel, type SdkLogger, SwapBuild, SwapBuildDataRaw, SwapBuildRequestRaw, SwapClient, type SwapClientConfig, type SwapErrorCode, type SwapErrorStage, SwapExecutionResult, SwapHistoryDataRaw, type SwapHistoryItem, type SwapHistoryPage, SwapHistoryParamsRaw, SwapHistoryRecordRaw, SwapInput, SwapLifecycleEvent, SwapMcaPayloadRaw, SwapMcaRelayerRequestRaw, SwapOrderStatusDataRaw, SwapOrderStatusParamsRaw, SwapOrderSubmitDataRaw, SwapOrderSubmitRequestRaw, SwapQuoteDataRaw, SwapQuoteRequestRaw, SwapReportDataRaw, SwapReportRequestRaw, SwapSdkError, type SwapSdkErrorOptions, WaitForOrderInput, WaitMode, asSwapSdkError, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, normalizeBuild, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, parseUnits, resolveMcaWithdrawPolicy, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, 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, OrderStatusResult, Quote, QuoteRequest, type ResolveMcaRequiredCollateralDecreaseInput, type ResolveMcaWithdrawPolicyInput, type RetryConfig, 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, buildMcaWithdrawRelayerRequest, buildNearMcaWithdrawTransactions, createExecutionId, extractMcaWithdrawBusiness, extractMcaWithdrawDepositAddress, extractMcaWithdrawSignerWallet, formatMcaWallet, formatUnits, fromApiChain, isSameMcaSignerIdentity, normalizeBuild, normalizeCrossChainToTokenList, normalizeFromTokenList, normalizeHistory, normalizeHistoryStatus, normalizeMcaQuote, normalizeQuote, parseUnits, resolveMcaDecreaseCollateral, resolveMcaRequiredCollateralDecrease, resolveMcaWithdrawPolicy, selectMcaSigner, serializeMcaQuoteRequest, serializeQuoteRequest, toApiAssetAddress, toApiChain };