@ledgerhq/live-common 34.54.0-nightly.20251209023841 → 34.54.0-nightly.20251209144712

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ledgerhq/live-common",
   "description": "Common ground for the Ledger Live apps",
-  "version": "34.54.0-nightly.20251209023841",
+  "version": "34.54.0-nightly.20251209144712",
   "repository": {
     "type": "git",
     "url": "https://github.com/LedgerHQ/ledger-live.git"
@@ -176,78 +176,78 @@
     "xstate": "^5.19.2",
     "yargs": "^17.0.0",
     "zod": "^3.22.4",
-    "@ledgerhq/coin-algorand": "^0.14.0-nightly.20251209023841",
-    "@ledgerhq/coin-aptos": "^3.7.0-nightly.20251209023841",
-    "@ledgerhq/coin-bitcoin": "^0.26.0-nightly.20251209023841",
-    "@ledgerhq/coin-canton": "^0.11.0-nightly.20251209023841",
-    "@ledgerhq/coin-cardano": "^0.16.0-nightly.20251209023841",
-    "@ledgerhq/coin-casper": "^2.5.0-nightly.20251209023841",
-    "@ledgerhq/coin-celo": "^1.8.0-nightly.20251209023841",
-    "@ledgerhq/coin-cosmos": "^0.21.0-nightly.20251209023841",
-    "@ledgerhq/coin-evm": "^2.36.0-nightly.20251209023841",
-    "@ledgerhq/coin-filecoin": "^1.15.0-nightly.20251209023841",
-    "@ledgerhq/coin-framework": "^6.10.0-nightly.20251209023841",
-    "@ledgerhq/coin-hedera": "^1.15.0-nightly.20251209023841",
-    "@ledgerhq/coin-icon": "^0.16.0-nightly.20251209023841",
-    "@ledgerhq/coin-internet_computer": "^1.12.0-nightly.20251209023841",
-    "@ledgerhq/coin-kaspa": "^1.5.0-nightly.20251209023841",
-    "@ledgerhq/coin-mina": "^1.5.0-nightly.20251209023841",
-    "@ledgerhq/coin-multiversx": "^0.9.0-nightly.20251209023841",
-    "@ledgerhq/coin-near": "^0.17.0-nightly.20251209023841",
-    "@ledgerhq/coin-polkadot": "^6.14.0-nightly.20251209023841",
-    "@ledgerhq/coin-solana": "^0.38.0-nightly.20251209023841",
-    "@ledgerhq/coin-stacks": "^0.13.0-nightly.20251209023841",
-    "@ledgerhq/coin-stellar": "^6.8.0-nightly.20251209023841",
-    "@ledgerhq/coin-sui": "^0.19.0-nightly.20251209023841",
-    "@ledgerhq/coin-tezos": "^6.10.0-nightly.20251209023841",
-    "@ledgerhq/coin-ton": "^0.18.0-nightly.20251209023841",
-    "@ledgerhq/coin-tron": "^5.8.0-nightly.20251209023841",
-    "@ledgerhq/coin-vechain": "^2.13.0-nightly.20251209023841",
-    "@ledgerhq/coin-xrp": "^7.9.0-nightly.20251209023841",
-    "@ledgerhq/cryptoassets": "^13.34.0-nightly.20251209023841",
-    "@ledgerhq/device-core": "^0.6.9-nightly.20251209023841",
-    "@ledgerhq/devices": "8.8.0-nightly.20251209023841",
-    "@ledgerhq/errors": "^6.28.0-nightly.20251209023841",
-    "@ledgerhq/hw-app-algorand": "^6.31.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-aptos": "^6.34.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-btc": "^10.13.0-nightly.20251209023841",
-    "@ledgerhq/hw-app-celo": "^6.35.4-nightly.20251209023841",
-    "@ledgerhq/hw-app-cosmos": "^6.32.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-eth": "^7.0.0-nightly.20251209023841",
-    "@ledgerhq/hw-app-exchange": "^0.18.0-nightly.20251209023841",
-    "@ledgerhq/hw-app-hedera": "^1.2.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-icon": "^1.3.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-kaspa": "^1.3.3-nightly.20251209023841",
-    "@ledgerhq/hw-app-multiversx": "^6.26.1-nightly.20251209023841",
-    "@ledgerhq/hw-app-near": "^6.31.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-polkadot": "^6.34.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-str": "^7.2.10-nightly.20251209023841",
+    "@ledgerhq/coin-algorand": "^0.14.0-nightly.20251209144712",
+    "@ledgerhq/coin-aptos": "^3.7.0-nightly.20251209144712",
+    "@ledgerhq/coin-bitcoin": "^0.26.0-nightly.20251209144712",
+    "@ledgerhq/coin-canton": "^0.11.0-nightly.20251209144712",
+    "@ledgerhq/coin-cardano": "^0.16.0-nightly.20251209144712",
+    "@ledgerhq/coin-casper": "^2.5.0-nightly.20251209144712",
+    "@ledgerhq/coin-celo": "^1.8.0-nightly.20251209144712",
+    "@ledgerhq/coin-cosmos": "^0.21.0-nightly.20251209144712",
+    "@ledgerhq/coin-evm": "^2.36.0-nightly.20251209144712",
+    "@ledgerhq/coin-filecoin": "^1.15.0-nightly.20251209144712",
+    "@ledgerhq/coin-framework": "^6.10.0-nightly.20251209144712",
+    "@ledgerhq/coin-hedera": "^1.15.0-nightly.20251209144712",
+    "@ledgerhq/coin-icon": "^0.16.0-nightly.20251209144712",
+    "@ledgerhq/coin-internet_computer": "^1.12.0-nightly.20251209144712",
+    "@ledgerhq/coin-kaspa": "^1.5.0-nightly.20251209144712",
+    "@ledgerhq/coin-mina": "^1.5.0-nightly.20251209144712",
+    "@ledgerhq/coin-multiversx": "^0.9.0-nightly.20251209144712",
+    "@ledgerhq/coin-near": "^0.17.0-nightly.20251209144712",
+    "@ledgerhq/coin-polkadot": "^6.14.0-nightly.20251209144712",
+    "@ledgerhq/coin-solana": "^0.38.0-nightly.20251209144712",
+    "@ledgerhq/coin-stacks": "^0.13.0-nightly.20251209144712",
+    "@ledgerhq/coin-stellar": "^6.8.0-nightly.20251209144712",
+    "@ledgerhq/coin-sui": "^0.19.0-nightly.20251209144712",
+    "@ledgerhq/coin-tezos": "^6.10.0-nightly.20251209144712",
+    "@ledgerhq/coin-ton": "^0.18.0-nightly.20251209144712",
+    "@ledgerhq/coin-tron": "^5.8.0-nightly.20251209144712",
+    "@ledgerhq/coin-vechain": "^2.13.0-nightly.20251209144712",
+    "@ledgerhq/device-core": "^0.6.9-nightly.20251209144712",
+    "@ledgerhq/coin-xrp": "^7.9.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-algorand": "^6.31.10-nightly.20251209144712",
+    "@ledgerhq/devices": "8.8.0-nightly.20251209144712",
+    "@ledgerhq/cryptoassets": "^13.34.0-nightly.20251209144712",
+    "@ledgerhq/errors": "^6.28.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-aptos": "^6.34.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-btc": "^10.13.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-celo": "^6.35.4-nightly.20251209144712",
+    "@ledgerhq/hw-app-cosmos": "^6.32.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-eth": "^7.0.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-exchange": "^0.18.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-hedera": "^1.2.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-icon": "^1.3.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-kaspa": "^1.3.3-nightly.20251209144712",
+    "@ledgerhq/hw-app-multiversx": "^6.26.1-nightly.20251209144712",
+    "@ledgerhq/hw-app-polkadot": "^6.34.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-str": "^7.2.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-near": "^6.31.10-nightly.20251209144712",
     "@ledgerhq/hw-app-sui": "^1.4.0",
-    "@ledgerhq/hw-app-tezos": "^6.31.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-trx": "^6.31.10-nightly.20251209023841",
-    "@ledgerhq/hw-app-vet": "^0.8.0-nightly.20251209023841",
-    "@ledgerhq/hw-app-xrp": "^6.32.8-nightly.20251209023841",
-    "@ledgerhq/hw-bolos": "^6.32.10-nightly.20251209023841",
-    "@ledgerhq/hw-transport": "6.31.14-nightly.20251209023841",
-    "@ledgerhq/hw-transport-mocker": "^6.30.0-nightly.20251209023841",
-    "@ledgerhq/ledger-cal-service": "^1.9.1-nightly.20251209023841",
-    "@ledgerhq/ledger-trust-service": "^0.4.3-nightly.20251209023841",
-    "@ledgerhq/live-config": "^3.3.0-nightly.20251209023841",
-    "@ledgerhq/live-countervalues": "^0.10.1-nightly.20251209023841",
-    "@ledgerhq/live-countervalues-react": "^0.7.3-nightly.20251209023841",
-    "@ledgerhq/live-dmk-shared": "^0.16.0-nightly.20251209023841",
-    "@ledgerhq/live-env": "^2.22.0-nightly.20251209023841",
-    "@ledgerhq/live-hooks": "0.3.0-nightly.20251209023841",
-    "@ledgerhq/live-network": "^2.1.2-nightly.20251209023841",
+    "@ledgerhq/hw-app-tezos": "^6.31.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-trx": "^6.31.10-nightly.20251209144712",
+    "@ledgerhq/hw-app-vet": "^0.8.0-nightly.20251209144712",
+    "@ledgerhq/hw-app-xrp": "^6.32.8-nightly.20251209144712",
+    "@ledgerhq/hw-bolos": "^6.32.10-nightly.20251209144712",
+    "@ledgerhq/hw-transport": "6.31.14-nightly.20251209144712",
+    "@ledgerhq/hw-transport-mocker": "^6.30.0-nightly.20251209144712",
+    "@ledgerhq/ledger-cal-service": "^1.9.1-nightly.20251209144712",
+    "@ledgerhq/ledger-trust-service": "^0.4.3-nightly.20251209144712",
+    "@ledgerhq/live-config": "^3.3.0-nightly.20251209144712",
+    "@ledgerhq/live-countervalues": "^0.10.1-nightly.20251209144712",
+    "@ledgerhq/live-countervalues-react": "^0.7.3-nightly.20251209144712",
+    "@ledgerhq/live-dmk-shared": "^0.16.0-nightly.20251209144712",
+    "@ledgerhq/live-env": "^2.22.0-nightly.20251209144712",
+    "@ledgerhq/live-hooks": "0.3.0-nightly.20251209144712",
+    "@ledgerhq/live-network": "^2.1.2-nightly.20251209144712",
     "@ledgerhq/live-promise": "^0.1.1",
-    "@ledgerhq/live-signer-canton": "^0.5.2-nightly.20251209023841",
-    "@ledgerhq/live-signer-evm": "^0.11.0-nightly.20251209023841",
-    "@ledgerhq/live-signer-solana": "^0.7.0-nightly.20251209023841",
-    "@ledgerhq/live-wallet": "^0.17.0-nightly.20251209023841",
+    "@ledgerhq/live-signer-evm": "^0.11.0-nightly.20251209144712",
+    "@ledgerhq/live-signer-canton": "^0.5.2-nightly.20251209144712",
+    "@ledgerhq/live-signer-solana": "^0.7.0-nightly.20251209144712",
+    "@ledgerhq/live-wallet": "^0.17.0-nightly.20251209144712",
     "@ledgerhq/logs": "^6.13.0",
-    "@ledgerhq/speculos-transport": "^0.3.0-nightly.20251209023841",
-    "@ledgerhq/wallet-api-acre-module": "^0.10.0-nightly.20251209023841",
-    "@ledgerhq/wallet-api-exchange-module": "^0.19.0-nightly.20251209023841"
+    "@ledgerhq/speculos-transport": "^0.3.0-nightly.20251209144712",
+    "@ledgerhq/wallet-api-acre-module": "^0.10.0-nightly.20251209144712",
+    "@ledgerhq/wallet-api-exchange-module": "^0.19.0-nightly.20251209144712"
   },
   "devDependencies": {
     "@solana/web3.js": "1.95.4",
@@ -294,10 +294,10 @@
     "undici": "6.19.2",
     "uuid": "^8.3.2",
     "ws": "8.18.3",
-    "@ledgerhq/device-react": "^0.3.3-nightly.20251209023841",
-    "@ledgerhq/types-cryptoassets": "^7.31.0-nightly.20251209023841",
+    "@ledgerhq/device-react": "^0.3.3-nightly.20251209144712",
+    "@ledgerhq/types-cryptoassets": "^7.31.0-nightly.20251209144712",
     "@ledgerhq/types-devices": "^6.27.0",
-    "@ledgerhq/types-live": "^6.90.0-nightly.20251209023841"
+    "@ledgerhq/types-live": "^6.90.0-nightly.20251209144712"
   },
   "scripts": {
     "build": "zx ./scripts/build-ts.mjs",

package/src/__tests__/test-helpers/environment.ts

@@ -128,6 +128,8 @@ setSupportedCurrencies([
   "monad_testnet",
   "somnia",
   "zero_gravity",
+  "concordium",
+  "concordium_testnet",
 ]);
 LiveConfig.setConfig(liveConfig);
 

package/src/bridge/generic-alpaca/getAccountShape.ts

@@ -102,10 +102,12 @@ export function genericGetAccountShape(network: string, kind: string): GetAccoun
           internalOperations,
         });
       });
-    // Try to refresh known pending operations (if not already updated)
+    // Try to refresh known pending and broadcasted operations (if not already updated)
     // Useful for integrations without explorers
     const operationsToRefresh = initialAccount?.pendingOperations.filter(
-      pendingOp => !newOpsWithSubs.some(newOp => pendingOp.hash === newOp.hash),
+      pendingOp =>
+        pendingOp.hash && // operation has been broadcasted
+        !newOpsWithSubs.some(newOp => pendingOp.hash === newOp.hash), // operation is not confirmed yet
     );
     const confirmedOperations =
       alpacaApi.refreshOperations && operationsToRefresh?.length

package/src/bridge/generic-alpaca/prepareTransaction.ts

@@ -71,10 +71,15 @@ export function genericPrepareTransaction(
     }
 
     // Pass any parameters that help estimating fees
+    // This includes `assetOwner` and `assetReference` that are not used by some apps that only rely on `subAccountId`
+    // TODO Remove `assetOwner` and `assetReference` in order to maintain one unique way of identifying the type of asset
+    // https://ledgerhq.atlassian.net/browse/LIVE-24044
     const intent = transactionToIntent(
       account,
       {
         ...transaction,
+        assetOwner,
+        assetReference,
         amount,
       },
       computeIntentType,
@@ -125,6 +130,8 @@ export function genericPrepareTransaction(
             account,
             {
               ...transaction,
+              assetOwner,
+              assetReference,
             },
             computeIntentType,
           ),

package/src/bridge/generic-alpaca/tests/prepareTransaction.test.ts

@@ -3,6 +3,8 @@ import { getAlpacaApi } from "../alpaca";
 import { transactionToIntent } from "../utils";
 import BigNumber from "bignumber.js";
 import { GenericTransaction } from "../types";
+import { setupMockCryptoAssetsStore } from "@ledgerhq/cryptoassets/cal-client/test-helpers";
+import { TokenCurrency } from "@ledgerhq/types-cryptoassets";
 
 jest.mock("../alpaca", () => ({
   getAlpacaApi: jest.fn(),
@@ -154,4 +156,44 @@ describe("genericPrepareTransaction", () => {
 
     expect(estimateFees).toHaveBeenCalledWith(expect.objectContaining({ amount: 100n }), {});
   });
+
+  it("fills 'assetOwner' and 'assetReference' from 'subAccountId' for retro compatibility", async () => {
+    setupMockCryptoAssetsStore({
+      findTokenById: tokenId =>
+        Promise.resolve(tokenId === "usdc" ? ({ id: tokenId } as TokenCurrency) : undefined),
+    });
+    (getAlpacaApi as jest.Mock).mockReturnValue({
+      estimateFees: () => Promise.resolve({ value: 0n }),
+      getAssetFromToken: (token, owner) =>
+        token.id === "usdc" ? { assetOwner: owner, assetReference: token.id } : undefined,
+    });
+    const prepareTransaction = genericPrepareTransaction(network, kind);
+
+    await prepareTransaction(
+      {
+        ...account,
+        freshAddress: "test-account-address",
+        subAccounts: [{ id: "test-sub-account+usdc" }],
+      },
+      {
+        subAccountId: "test-sub-account+usdc",
+        amount: new BigNumber(10),
+      } as GenericTransaction,
+    );
+
+    expect(transactionToIntent).toHaveBeenCalledWith(
+      {
+        ...account,
+        freshAddress: "test-account-address",
+        subAccounts: [{ id: "test-sub-account+usdc" }],
+      },
+      {
+        subAccountId: "test-sub-account+usdc",
+        amount: new BigNumber(10),
+        assetOwner: "test-account-address",
+        assetReference: "usdc",
+      },
+      undefined,
+    );
+  });
 });

package/src/exchange/swap/getIncompatibleCurrencyKeys.ts

@@ -83,6 +83,10 @@ const INCOMPATIBLE_NANO_S_CURRENCY_KEYS: Keys = {
     title: "swap.incompatibility.celo_title",
     description: "swap.incompatibility.celo_description",
   },
+  monad: {
+    title: "swap.incompatibility.monad_title",
+    description: "swap.incompatibility.monad_description",
+  },
 };
 
 export const getIncompatibleCurrencyKeys = (exchange: ExchangeSwap) => {

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/featureFlags/defaultFeatures.ts

@@ -110,6 +110,8 @@ export const CURRENCY_DEFAULT_FEATURES = {
   currencyMonadTestnet: DEFAULT_FEATURE,
   currencySomnia: DEFAULT_FEATURE,
   currencyZeroGravity: DEFAULT_FEATURE,
+  currencyConcordium: DEFAULT_FEATURE,
+  currencyConcordiumTestnet: DEFAULT_FEATURE,
 };
 
 /**

package/src/modularDrawer/hooks/useCurrenciesUnderFeatureFlag.ts

@@ -83,6 +83,8 @@ export function useCurrenciesUnderFeatureFlag() {
   const monadTestnet = useFeature("currencyMonadTestnet");
   const somnia = useFeature("currencySomnia");
   const zeroGravity = useFeature("currencyZeroGravity");
+  const concordium = useFeature("currencyConcordium");
+  const concordiumTestnet = useFeature("currencyConcordiumTestnet");
 
   const featureFlaggedCurrencies = useMemo(
     (): Partial<Record<CryptoCurrencyId, Feature<unknown> | null>> => ({
@@ -162,6 +164,8 @@ export function useCurrenciesUnderFeatureFlag() {
       monad_testnet: monadTestnet,
       somnia,
       zero_gravity: zeroGravity,
+      concordium,
+      concordium_testnet: concordiumTestnet,
     }),
     [
       aptos,
@@ -240,6 +244,8 @@ export function useCurrenciesUnderFeatureFlag() {
       monadTestnet,
       somnia,
       zeroGravity,
+      concordium,
+      concordiumTestnet,
     ],
   );
 

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;
+  }
+}