@ledgerhq/live-common 34.54.0 → 34.54.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ledgerhq/live-common",
   "description": "Common ground for the Ledger Live apps",
-  "version": "34.54.0",
+  "version": "34.54.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/LedgerHQ/ledger-live.git"
@@ -120,7 +120,7 @@
   "dependencies": {
     "@blooo/hw-app-acre": "^1.1.1",
     "@cardano-foundation/ledgerjs-hw-app-cardano": "^7.1.2",
-    "@ledgerhq/device-management-kit": "0.11.1",
+    "@ledgerhq/device-management-kit": "0.13.0",
     "@ledgerhq/speculos-device-controller": "0.1.0",
     "@ledgerhq/live-app-sdk": "^0.8.1",
     "@ledgerhq/wallet-api-client": "^1.12.5",
@@ -182,79 +182,79 @@
     "xstate": "^5.19.2",
     "yargs": "^17.0.0",
     "zod": "^3.22.4",
-    "@ledgerhq/coin-algorand": "^0.14.0",
-    "@ledgerhq/coin-aptos": "^3.7.0",
-    "@ledgerhq/coin-bitcoin": "^0.26.0",
-    "@ledgerhq/coin-canton": "^0.11.0",
-    "@ledgerhq/coin-cardano": "^0.15.1",
-    "@ledgerhq/coin-casper": "^2.4.1",
-    "@ledgerhq/coin-celo": "^1.7.2",
-    "@ledgerhq/coin-cosmos": "^0.20.1",
-    "@ledgerhq/coin-evm": "^2.36.0",
-    "@ledgerhq/coin-filecoin": "^1.15.0",
-    "@ledgerhq/coin-framework": "^6.10.0",
-    "@ledgerhq/coin-hedera": "^1.15.0",
-    "@ledgerhq/coin-icon": "^0.15.1",
-    "@ledgerhq/coin-internet_computer": "^1.11.1",
-    "@ledgerhq/coin-kaspa": "^1.5.0",
-    "@ledgerhq/coin-mina": "^1.4.2",
-    "@ledgerhq/coin-multiversx": "^0.8.1",
-    "@ledgerhq/coin-near": "^0.16.1",
-    "@ledgerhq/coin-polkadot": "^6.13.1",
-    "@ledgerhq/coin-solana": "^0.38.0",
-    "@ledgerhq/coin-stacks": "^0.12.1",
-    "@ledgerhq/coin-stellar": "^6.8.0",
-    "@ledgerhq/coin-sui": "^0.18.1",
-    "@ledgerhq/coin-tezos": "^6.10.0",
-    "@ledgerhq/coin-ton": "^0.17.1",
-    "@ledgerhq/coin-tron": "^5.7.1",
-    "@ledgerhq/coin-vechain": "^2.13.0",
-    "@ledgerhq/coin-xrp": "^7.9.0",
+    "@ledgerhq/coin-algorand": "^0.14.1",
+    "@ledgerhq/coin-aptos": "^3.7.1",
+    "@ledgerhq/coin-bitcoin": "^0.26.1",
+    "@ledgerhq/coin-canton": "^0.11.1",
+    "@ledgerhq/coin-cardano": "^0.15.2",
+    "@ledgerhq/coin-casper": "^2.4.2",
+    "@ledgerhq/coin-celo": "^1.7.3",
+    "@ledgerhq/coin-cosmos": "^0.20.2",
+    "@ledgerhq/coin-evm": "^2.36.1",
+    "@ledgerhq/coin-filecoin": "^1.15.1",
+    "@ledgerhq/coin-framework": "^6.10.1",
+    "@ledgerhq/coin-hedera": "^1.15.1",
+    "@ledgerhq/coin-icon": "^0.15.2",
+    "@ledgerhq/coin-internet_computer": "^1.11.2",
+    "@ledgerhq/coin-kaspa": "^1.5.1",
+    "@ledgerhq/coin-mina": "^1.4.3",
+    "@ledgerhq/coin-multiversx": "^0.8.2",
+    "@ledgerhq/coin-near": "^0.16.2",
+    "@ledgerhq/coin-polkadot": "^6.13.2",
+    "@ledgerhq/coin-solana": "^0.38.1",
+    "@ledgerhq/coin-stacks": "^0.12.2",
+    "@ledgerhq/coin-stellar": "^6.8.1",
+    "@ledgerhq/coin-sui": "^0.18.2",
+    "@ledgerhq/coin-tezos": "^6.10.1",
+    "@ledgerhq/coin-ton": "^0.17.2",
+    "@ledgerhq/coin-tron": "^5.7.2",
+    "@ledgerhq/coin-vechain": "^2.13.1",
+    "@ledgerhq/coin-xrp": "^7.9.1",
     "@ledgerhq/crypto-icons-ui": "^1.24.0",
-    "@ledgerhq/cryptoassets": "^13.34.0",
-    "@ledgerhq/device-core": "^0.6.9",
-    "@ledgerhq/devices": "8.7.0",
-    "@ledgerhq/errors": "^6.27.0",
-    "@ledgerhq/hw-app-algorand": "^6.31.9",
-    "@ledgerhq/hw-app-aptos": "^6.34.9",
-    "@ledgerhq/hw-app-btc": "^10.13.0",
-    "@ledgerhq/hw-app-celo": "^6.35.4",
-    "@ledgerhq/hw-app-cosmos": "^6.32.9",
-    "@ledgerhq/hw-app-eth": "^7.0.0",
-    "@ledgerhq/hw-app-exchange": "^0.18.0",
-    "@ledgerhq/hw-app-hedera": "^1.2.9",
-    "@ledgerhq/hw-app-icon": "^1.3.9",
-    "@ledgerhq/hw-app-kaspa": "^1.3.2",
-    "@ledgerhq/hw-app-multiversx": "^6.26.0",
-    "@ledgerhq/hw-app-near": "^6.31.9",
-    "@ledgerhq/hw-app-polkadot": "^6.34.9",
-    "@ledgerhq/hw-app-str": "^7.2.9",
+    "@ledgerhq/cryptoassets": "^13.34.1",
+    "@ledgerhq/device-core": "^0.6.10",
+    "@ledgerhq/devices": "8.7.1",
+    "@ledgerhq/errors": "^6.27.1",
+    "@ledgerhq/hw-app-algorand": "^6.31.10",
+    "@ledgerhq/hw-app-aptos": "^6.34.10",
+    "@ledgerhq/hw-app-btc": "^10.13.1",
+    "@ledgerhq/hw-app-celo": "^6.35.5",
+    "@ledgerhq/hw-app-cosmos": "^6.32.10",
+    "@ledgerhq/hw-app-eth": "^7.0.1",
+    "@ledgerhq/hw-app-exchange": "^0.18.1",
+    "@ledgerhq/hw-app-hedera": "^1.2.10",
+    "@ledgerhq/hw-app-icon": "^1.3.10",
+    "@ledgerhq/hw-app-kaspa": "^1.3.3",
+    "@ledgerhq/hw-app-multiversx": "^6.26.1",
+    "@ledgerhq/hw-app-near": "^6.31.10",
+    "@ledgerhq/hw-app-polkadot": "^6.34.10",
+    "@ledgerhq/hw-app-str": "^7.2.10",
     "@ledgerhq/hw-app-sui": "^1.4.0",
-    "@ledgerhq/hw-app-tezos": "^6.31.9",
-    "@ledgerhq/hw-app-trx": "^6.31.9",
-    "@ledgerhq/hw-app-vet": "^0.8.0",
-    "@ledgerhq/hw-app-xrp": "^6.32.7",
-    "@ledgerhq/hw-bolos": "^6.32.9",
-    "@ledgerhq/hw-transport": "6.31.13",
-    "@ledgerhq/hw-transport-mocker": "^6.29.13",
-    "@ledgerhq/ledger-cal-service": "^1.9.1",
-    "@ledgerhq/ledger-trust-service": "^0.4.3",
+    "@ledgerhq/hw-app-tezos": "^6.31.10",
+    "@ledgerhq/hw-app-trx": "^6.31.10",
+    "@ledgerhq/hw-app-vet": "^0.8.1",
+    "@ledgerhq/hw-app-xrp": "^6.32.8",
+    "@ledgerhq/hw-bolos": "^6.32.10",
+    "@ledgerhq/hw-transport": "6.31.14",
+    "@ledgerhq/hw-transport-mocker": "^6.29.14",
+    "@ledgerhq/ledger-cal-service": "^1.9.2",
+    "@ledgerhq/ledger-trust-service": "^0.4.4",
     "@ledgerhq/live-config": "^3.2.0",
-    "@ledgerhq/live-countervalues": "^0.10.1",
-    "@ledgerhq/live-countervalues-react": "^0.7.3",
-    "@ledgerhq/live-dmk-shared": "^0.15.0",
+    "@ledgerhq/live-countervalues": "^0.10.2",
+    "@ledgerhq/live-countervalues-react": "^0.7.4",
+    "@ledgerhq/live-dmk-shared": "^0.15.1",
     "@ledgerhq/live-env": "^2.22.0",
     "@ledgerhq/live-hooks": "0.2.0",
-    "@ledgerhq/live-network": "^2.1.2",
+    "@ledgerhq/live-network": "^2.1.3",
     "@ledgerhq/live-promise": "^0.1.1",
-    "@ledgerhq/live-signer-canton": "^0.5.2",
-    "@ledgerhq/live-signer-evm": "^0.10.2",
-    "@ledgerhq/live-signer-solana": "^0.7.0",
-    "@ledgerhq/live-wallet": "^0.16.1",
-    "@ledgerhq/speculos-transport": "^0.3.0",
+    "@ledgerhq/live-signer-canton": "^0.5.3",
+    "@ledgerhq/live-signer-evm": "^0.10.3",
+    "@ledgerhq/live-signer-solana": "^0.7.1",
+    "@ledgerhq/live-wallet": "^0.16.2",
     "@ledgerhq/logs": "^6.13.0",
+    "@ledgerhq/speculos-transport": "^0.3.1",
     "@ledgerhq/wallet-api-acre-module": "^0.10.0",
-    "@ledgerhq/wallet-api-exchange-module": "^0.19.0"
+    "@ledgerhq/wallet-api-exchange-module": "^0.19.1"
   },
   "devDependencies": {
     "@solana/web3.js": "1.95.4",
@@ -302,7 +302,7 @@
     "undici": "6.19.2",
     "uuid": "^8.3.2",
     "ws": "7",
-    "@ledgerhq/device-react": "^0.3.3",
+    "@ledgerhq/device-react": "^0.3.4",
     "@ledgerhq/types-cryptoassets": "^7.30.0",
     "@ledgerhq/types-devices": "^6.27.0",
     "@ledgerhq/types-live": "^6.90.0"

package/src/e2e/speculosCI.ts

@@ -7,7 +7,7 @@ import {
 import { SpeculosDevice } from "./speculos";
 import https from "https";
 
-const { SEED, GITHUB_TOKEN, AWS_ROLE, CLUSTER, SPECULOS_IMAGE_TAG } = process.env;
+const { GITHUB_TOKEN, SPECULOS_IMAGE_TAG } = process.env;
 const GIT_API_URL = "https://api.github.com/repos/LedgerHQ/actions/actions/";
 const START_WORKFLOW_ID = "workflows/161487603/dispatches";
 const STOP_WORKFLOW_ID = "workflows/161487604/dispatches";
@@ -152,9 +152,6 @@ function createStartPayload(deviceParams: DeviceParams, runId: string) {
       coin_app_version: appVersion,
       device: reverseModelMap[model],
       device_os_version: firmware,
-      aws_role: AWS_ROLE,
-      cluster: CLUSTER,
-      seed: SEED,
       run_id: runId,
       additional_args,
     },
@@ -192,8 +189,6 @@ export async function releaseSpeculosDeviceCI(runId: string) {
     ref: GITHUB_REF,
     inputs: {
       run_id: runId.toString(),
-      aws_role: AWS_ROLE,
-      cluster: CLUSTER,
     },
   };
   await githubApiRequest({ urlSuffix: STOP_WORKFLOW_ID, data });

package/src/exchange/swap/postSwapState.ts

@@ -106,6 +106,7 @@ export const postSwapCancelled: PostSwapCancelled = async ({
   seedIdTo,
   refundAddress,
   payoutAddress,
+  data,
   ...rest
 }) => {
   if (isIntegrationTestEnv()) return mockPostSwapCancelled({ provider, swapId, ...rest });
@@ -138,7 +139,8 @@ export const postSwapCancelled: PostSwapCancelled = async ({
 
     const shouldIncludeAddresses =
       rest.statusCode === "WrongDeviceForAccountPayout" ||
-      rest.statusCode === "WrongDeviceForAccountRefund";
+      rest.statusCode === "WrongDeviceForAccountRefund" ||
+      rest.statusCode === "FeeNotLoaded";
 
     const requestData = {
       provider,
@@ -147,11 +149,14 @@ export const postSwapCancelled: PostSwapCancelled = async ({
       swapIntentWithoutProvider,
       payloadAddressMatchAccountAddress,
       fromAmount,
-      fromAccountAddress: shouldIncludeAddresses ? fromAccountAddress : undefined,
-      toAccountAddress: shouldIncludeAddresses ? toAccountAddress : undefined,
-      payloadRefundAddress: shouldIncludeAddresses ? refundAddress : undefined,
-      payloadPayoutAddress: shouldIncludeAddresses ? payoutAddress : undefined,
+      ...(shouldIncludeAddresses && {
+        fromAccountAddress,
+        toAccountAddress,
+        payloadRefundAddress: refundAddress,
+        payloadPayoutAddress: payoutAddress,
+      }),
       maybeSeedMatch: seedIdFrom === seedIdTo, // Only true if both accounts are from the same seed and from the same chain type
+      data,
       ...rest,
     };
 

package/src/exchange/swap/transactionStrategies.ts

@@ -2,6 +2,7 @@ import { BigNumber } from "bignumber.js";
 
 import { Transaction } from "../../generated/types";
 import { TransactionCommon } from "@ledgerhq/types-live";
+import { createStepError, StepError, CustomErrorType } from "../../wallet-api/Exchange";
 export type { SwapLiveError } from "@ledgerhq/wallet-api-exchange-module";
 
 export function defaultTransaction({
@@ -85,11 +86,11 @@ export function stellarTransaction({
   customErrorType,
 }: TransactionWithCustomFee): Extract<Transaction, { family: "stellar" }> {
   if (!payinExtraId)
-    throw {
+    throw createStepError({
       error: new Error("Missing payinExtraId"),
-      step: "PayinExtraIdStepError",
+      step: StepError.PAYIN_EXTRA_ID,
       customErrorType,
-    };
+    });
 
   return {
     family: "stellar",
@@ -110,11 +111,11 @@ export function rippleTransaction({
   customErrorType,
 }: TransactionWithCustomFee): Partial<Extract<Transaction, { family: "xrp" }>> {
   if (!payinExtraId)
-    throw {
+    throw createStepError({
       error: new Error("Missing payinExtraId"),
-      step: "PayinExtraIdStepError",
+      step: StepError.PAYIN_EXTRA_ID,
       customErrorType,
-    };
+    });
 
   return {
     family: "xrp",
@@ -257,7 +258,7 @@ export type TransactionWithCustomFee = TransactionCommon & {
     [key: string]: BigNumber;
   };
   payinExtraId?: string;
-  customErrorType?: "swap";
+  customErrorType?: CustomErrorType;
   extraTransactionParameters?: string;
   family: string;
   sponsored?: boolean;

package/src/exchange/swap/types.ts

@@ -214,7 +214,9 @@ export type SwapStateAcceptedRequest = SwapStateRequest & {
   transactionId: string;
 };
 
-export type SwapStateCancelledRequest = SwapStateRequest;
+export type SwapStateCancelledRequest = SwapStateRequest & {
+  data?: string;
+};
 
 export type PostSwapAccepted = (arg0: SwapStateAcceptedRequest) => Promise<null>;
 

package/src/hw/connectAppEventMapper.ts

@@ -11,11 +11,10 @@ import type {
 } from "@ledgerhq/device-management-kit";
 import {
   DeviceActionStatus,
-  DeviceDisconnectedWhileSendingError,
   DeviceSessionStateType,
   UserInteractionRequired,
   OutOfMemoryDAError,
-  UnsupportedFirmwareDAError,
+  DeviceModelId,
 } from "@ledgerhq/device-management-kit";
 import type {
   ConnectAppDAOutput,
@@ -27,12 +26,14 @@ import {
   UserRefusedAllowManager,
   UserRefusedOnDevice,
   LatestFirmwareVersionRequired,
+  UnsupportedFeatureError,
 } from "@ledgerhq/errors";
 
 import type { SkippedAppOp } from "../apps/types";
 import { SkipReason } from "../apps/types";
 import { parseDeviceInfo } from "../deviceSDK/tasks/getDeviceInfo";
 import { ConnectAppEvent } from "./connectApp";
+import { NoSuchAppOnProvider } from "../errors";
 
 export class ConnectAppEventMapper {
   private openAppRequested: boolean = false;
@@ -241,7 +242,8 @@ export class ConnectAppEventMapper {
       });
       this.eventSubject.complete();
     } else if (
-      error instanceof UnsupportedFirmwareDAError &&
+      "_tag" in error &&
+      error._tag === "UnsupportedFirmwareDAError" &&
       deviceState.sessionStateType !== DeviceSessionStateType.Connected
     ) {
       this.eventSubject.error(
@@ -252,12 +254,34 @@ export class ConnectAppEventMapper {
             deviceState.firmwareUpdateContext!.currentFirmware.version,
         }),
       );
+    } else if (
+      "_tag" in error &&
+      error._tag === "UnsupportedApplicationDAError" &&
+      deviceState.sessionStateType !== DeviceSessionStateType.Connected
+    ) {
+      if (deviceState.deviceModelId === DeviceModelId.NANO_S) {
+        // This will show an error modal with upsell link
+        this.eventSubject.error(
+          new NoSuchAppOnProvider(`Ledger Nano S does not support this feature`, {
+            appName: this.appName,
+          }),
+        );
+        return;
+      }
+      // This will show an error modal with contact support link
+      this.eventSubject.error(
+        new UnsupportedFeatureError(`App ${this.appName} not supported on this device`, {
+          appName: this.appName,
+          deviceModelId: deviceState.deviceModelId,
+          deviceVersion: deviceState.firmwareVersion?.os,
+        }),
+      );
     } else if ("_tag" in error && error._tag === "DeviceLockedError") {
       this.eventSubject.next({ type: "lockedDevice" });
       this.eventSubject.complete();
     } else if ("_tag" in error && error._tag === "RefusedByUserDAError") {
       this.eventSubject.error(new UserRefusedAllowManager());
-    } else if (error instanceof DeviceDisconnectedWhileSendingError) {
+    } else if ("_tag" in error && error._tag === "DeviceDisconnectedWhileSendingError") {
       this.eventSubject.next({ type: "disconnected", expected: false });
     } else if ("_tag" in error && error._tag === "WebHidSendReportError") {
       this.eventSubject.next({ type: "disconnected", expected: false });

package/src/hw/getAppAndVersion.ts

@@ -2,12 +2,13 @@ import { GetAppAndVersionUnsupportedFormat } from "../errors";
 import Transport from "@ledgerhq/hw-transport";
 export default async (
   transport: Transport,
+  { abortTimeoutMs }: { abortTimeoutMs?: number } = {},
 ): Promise<{
   name: string;
   version: string;
   flags: number | Buffer;
 }> => {
-  const r = await transport.send(0xb0, 0x01, 0x00, 0x00);
+  const r = await transport.send(0xb0, 0x01, 0x00, 0x00, undefined, undefined, { abortTimeoutMs });
   let i = 0;
   const format = r[i++];
 

package/src/wallet-api/Exchange/SwapError.test.ts

@@ -0,0 +1,126 @@
+/* eslint-env jest */
+import {
+  IgnoredSignatureStepError,
+  ListAccountError,
+  ListCurrencyError,
+  NonceStepError,
+  NotEnoughFunds,
+  PayloadStepError,
+  PayinExtraIdError,
+  SignatureStepError,
+  SwapError,
+  UnknownAccountError,
+} from "./SwapError";
+
+describe("SwapError", () => {
+  it("captures nested error metadata", () => {
+    const nested = new Error("payload failed");
+    Object.assign(nested, { code: "E500" });
+
+    const error = new SwapError("swap999", nested);
+
+    expect(error).toBeInstanceOf(SwapError);
+    expect(error.cause.swapCode).toBe("swap999");
+    expect(error.cause.message).toBe(String(nested));
+    expect(error.cause.code).toBe("E500");
+    expect(error.message).toBe("payload failed");
+  });
+
+  it("defaults to swap000 when no code provided", () => {
+    const error = new SwapError();
+
+    expect(error.cause.swapCode).toBe("swap000");
+    expect(error.message).toBe("undefined");
+  });
+});
+
+type DerivedErrorCase = {
+  label: string;
+  create: (nested?: Error) => SwapError;
+  swapCode: string;
+  name: string;
+  propagatesMessage?: boolean;
+};
+
+const DERIVED_ERROR_CASES: DerivedErrorCase[] = [
+  {
+    label: "NonceStepError",
+    create: nested => new NonceStepError(nested),
+    swapCode: "swap001",
+    name: "NonceStepError",
+    propagatesMessage: true,
+  },
+  {
+    label: "PayloadStepError",
+    create: nested => new PayloadStepError(nested),
+    swapCode: "swap002",
+    name: "PayloadStepError",
+    propagatesMessage: true,
+  },
+  {
+    label: "SignatureStepError",
+    create: nested => new SignatureStepError(nested),
+    swapCode: "swap003",
+    name: "SignatureStepError",
+    propagatesMessage: true,
+  },
+  {
+    label: "IgnoredSignatureStepError",
+    create: nested => new IgnoredSignatureStepError(nested),
+    swapCode: "swap003Ignored",
+    name: "SignatureStepError",
+    propagatesMessage: true,
+  },
+  {
+    label: "NotEnoughFunds",
+    create: () => new NotEnoughFunds(),
+    swapCode: "swap004",
+    name: "NotEnoughFunds",
+  },
+  {
+    label: "ListAccountError",
+    create: nested => new ListAccountError(nested),
+    swapCode: "swap005",
+    name: "ListAccountError",
+    propagatesMessage: true,
+  },
+  {
+    label: "ListCurrencyError",
+    create: nested => new ListCurrencyError(nested),
+    swapCode: "swap006",
+    name: "ListCurrencyError",
+    propagatesMessage: true,
+  },
+  {
+    label: "UnknownAccountError",
+    create: nested => new UnknownAccountError(nested),
+    swapCode: "swap007",
+    name: "UnknownAccountError",
+    propagatesMessage: true,
+  },
+  {
+    label: "PayinExtraIdError",
+    create: nested => new PayinExtraIdError(nested),
+    swapCode: "swap010",
+    name: "PayinExtraIdError",
+    propagatesMessage: true,
+  },
+];
+
+describe.each(DERIVED_ERROR_CASES)(
+  "Derived $label",
+  ({ create, swapCode, name, propagatesMessage }) => {
+    it("inherits SwapError defaults", () => {
+      const nested = new Error("step failure");
+      const error = create(propagatesMessage ? nested : undefined);
+
+      expect(error).toBeInstanceOf(SwapError);
+      expect(error.name).toBe(name);
+      expect(error.cause.swapCode).toBe(swapCode);
+
+      if (propagatesMessage) {
+        expect(error.message).toBe("step failure");
+      }
+    });
+  },
+);

package/src/wallet-api/Exchange/SwapError.ts

@@ -0,0 +1,159 @@
+/**
+ * Simplified Swap Error System
+ * Base error class and specific error types for swap transaction flows
+ */
+
+/**
+ * Base error class for all swap-related errors
+ * Contains error code and nested error information
+ */
+export class SwapError extends Error {
+  cause: {
+    swapCode: string;
+    [key: string]: string | Error | unknown | undefined;
+  };
+  message: string;
+
+  constructor(code = "swap000", nestedError?: Error) {
+    super();
+    this.name = "SwapError";
+
+    // Preserve nested error information
+    this.cause = {
+      swapCode: code,
+      ...(nestedError?.constructor !== Object && nestedError?.constructor !== Array
+        ? { message: `${nestedError}` }
+        : {}),
+      ...nestedError,
+    };
+
+    this.message = nestedError?.message ? nestedError.message : `${nestedError}`;
+  }
+}
+
+/**
+ * Error during nonce/deviceTransactionId generation step
+ * Typically occurs when calling startSwap()
+ */
+export class NonceStepError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap001", nestedError);
+    this.name = "NonceStepError";
+  }
+}
+
+/**
+ * Error during payload retrieval step
+ * Occurs when communicating with backend to get transaction payload
+ */
+export class PayloadStepError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap002", nestedError);
+    this.name = "PayloadStepError";
+  }
+}
+
+/**
+ * Error during transaction signature step
+ * Occurs when user rejects or device fails during completeSwap()
+ */
+export class SignatureStepError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap003", nestedError);
+    this.name = "SignatureStepError";
+  }
+}
+
+/**
+ * Special case: signature error that should be ignored/handled silently
+ * Used for expected user cancellations
+ */
+export class IgnoredSignatureStepError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap003Ignored", nestedError);
+    this.name = "SignatureStepError";
+  }
+}
+
+/**
+ * Error when user doesn't have sufficient funds
+ * Thrown during balance validation
+ */
+export class NotEnoughFunds extends SwapError {
+  constructor() {
+    super("swap004");
+    this.name = "NotEnoughFunds";
+  }
+}
+
+/**
+ * Error when unable to retrieve account list
+ * Occurs during account lookup phase
+ */
+export class ListAccountError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap005", nestedError);
+    this.name = "ListAccountError";
+  }
+}
+
+/**
+ * Error when unable to retrieve currency information
+ * Occurs during currency lookup phase
+ */
+export class ListCurrencyError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap006", nestedError);
+    this.name = "ListCurrencyError";
+  }
+}
+
+/**
+ * Error when specified account ID cannot be found
+ * Thrown when fromAccountId or toAccountId is invalid
+ */
+export class UnknownAccountError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap007", nestedError);
+    this.name = "UnknownAccountError";
+  }
+}
+
+/**
+ * Error when extra identifier is required but missing
+ * Some chains require payinExtraId (e.g., XLM memo, XRP tag)
+ */
+export class PayinExtraIdError extends SwapError {
+  constructor(nestedError?: Error) {
+    super("swap010", nestedError);
+    this.name = "PayinExtraIdError";
+  }
+}
+
+/**
+ * CompleteSwap/CompleteExchange step information
+ * Tracks which hardware wallet step failed
+ */
+export type CompleteExchangeStep =
+  | "INIT"
+  | "SET_PARTNER_KEY"
+  | "CHECK_PARTNER"
+  | "PROCESS_TRANSACTION"
+  | "CHECK_TRANSACTION_SIGNATURE"
+  | "CHECK_PAYOUT_ADDRESS"
+  | "CHECK_REFUND_ADDRESS"
+  | "SIGN_COIN_TRANSACTION";
+
+/**
+ * Error that occurs during completeSwap with step tracking
+ * Useful for debugging hardware wallet interactions
+ */
+export class CompleteExchangeError extends Error {
+  step: CompleteExchangeStep;
+
+  constructor(step: CompleteExchangeStep, message?: string) {
+    super(message);
+    this.name = "CompleteExchangeError";
+    this.step = step;
+  }
+}