@ledgerhq/coin-stellar 6.26.1 → 6.26.2

package/lib-es/network/horizonErrorBody.d.ts

@@ -0,0 +1,29 @@
+/** Horizon RFC 7807 problem+json body (subset used by coin-stellar). */
+export type HorizonErrorBody = {
+    type?: string;
+    title?: string;
+    status?: number;
+    detail?: string;
+    extras?: {
+        envelope_xdr?: string;
+        result_xdr?: string;
+        result_codes?: {
+            transaction?: string;
+            operations?: string[];
+        };
+        invalid_field?: string;
+        reason?: string;
+    };
+};
+export declare function isHorizonErrorBody(data: unknown): data is HorizonErrorBody;
+/**
+ * Horizon failures are usually {@link BadResponseError} with `response` = problem+json body.
+ * Axios rejects first; the SDK forwards it unchanged, so the body lives on `error.response.data`.
+ */
+export declare function getHorizonErrorBody(error: unknown): HorizonErrorBody | null;
+/**
+ * Best-effort human-readable summary for logs (`errorExtras.documentationSummary`).
+ * Prefers operation result codes, then transaction codes, then Horizon `detail` / `extras.reason`.
+ */
+export declare function documentationSummaryFromHorizonBody(body: HorizonErrorBody): string;
+//# sourceMappingURL=horizonErrorBody.d.ts.map

package/lib-es/network/horizonErrorBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizonErrorBody.d.ts","sourceRoot":"","sources":["../../src/network/horizonErrorBody.ts"],"names":[],"mappings":"AAKA,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE;YACb,WAAW,CAAC,EAAE,MAAM,CAAA;YACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;SACtB,CAAA;QACD,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AA2DD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAS1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAW3E;AAiCD;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAkClF"}

package/lib-es/network/horizonErrorBody.js

@@ -0,0 +1,134 @@
+// SPDX-FileCopyrightText: © 2026 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+import { BadResponseError } from '@stellar/stellar-sdk';
+const GENERIC_TRANSACTION_FAILED_DETAIL = /The transaction failed when submitted to the Stellar network/i;
+/** Horizon `extras.result_codes.transaction` → one-line description (Stellar docs). */
+const HORIZON_TRANSACTION_RESULT_CODE_DOCUMENTATION = {
+    tx_success: 'The transaction succeeded.',
+    tx_failed: 'One of the operations failed (none were applied).',
+    tx_too_early: 'The ledger closeTime was before the minTime.',
+    tx_too_late: 'The ledger closeTime was after the maxTime.',
+    tx_missing_operation: 'No operation was specified.',
+    tx_bad_seq: 'Sequence number does not match source account.',
+    tx_bad_auth: 'Too few valid signatures / wrong network.',
+    tx_insufficient_balance: 'Fee would bring account below reserve.',
+    tx_no_source_account: 'Source account not found.',
+    tx_insufficient_fee: 'Fee is too small.',
+    tx_bad_auth_extra: 'Unused signatures attached to transaction.',
+    tx_internal_error: 'An unknown error occurred.',
+    tx_fee_bump_inner_success: 'Fee bump inner transaction succeeded.',
+    tx_fee_bump_inner_failed: 'Fee bump inner transaction failed.',
+    tx_not_supported: 'Transaction type not supported.',
+    tx_bad_sponsorship: 'Sponsorship is invalid.',
+    tx_bad_min_seq_age_or_gap: 'Minimum sequence age or gap precondition failed.',
+    tx_malformed: 'Transaction is malformed.',
+    tx_soroban_invalid: 'Soroban transaction is invalid.',
+};
+/** Horizon `extras.result_codes.operations[]` → one-line description (Stellar docs). */
+const HORIZON_OPERATION_RESULT_CODE_DOCUMENTATION = {
+    op_inner: 'The inner object result is valid and the operation was a success.',
+    op_bad_auth: 'There are too few valid signatures, or the transaction was submitted to the wrong network.',
+    op_no_source_account: 'The source account was not found.',
+    op_no_account: 'The source account was not found.',
+    op_not_supported: 'The operation is not supported at this time.',
+    op_too_many_subentries: 'Max number of subentries (1000) already reached.',
+    op_exceeded_work_limit: 'Operation did too much work.',
+    op_malformed: 'The operation input is invalid.',
+    op_underfunded: 'The source account does not have enough balance to send the payment amount while maintaining its minimum reserve.',
+    op_src_no_trust: 'The source account does not have a trustline for the asset it is trying to send.',
+    op_src_not_authorized: 'The source account is not authorized to send this asset.',
+    op_no_destination: 'The destination account does not exist.',
+    op_no_trust: 'The destination account does not have a trustline for the asset being sent.',
+    op_not_authorized: 'The destination account is not authorized to hold this asset.',
+    op_line_full: 'The destination account does not have sufficient limits to receive the amount and still satisfy its buying liabilities.',
+    op_no_issuer: 'The issuer of the asset does not exist.',
+};
+/** Operation result codes that mark success for a prior op in a multi-op failure list. */
+const HORIZON_OPERATION_SUCCESS_RESULT_CODES = new Set(['op_inner']);
+function failingOperationCode(operations) {
+    return operations?.find((code) => !HORIZON_OPERATION_SUCCESS_RESULT_CODES.has(code));
+}
+export function isHorizonErrorBody(data) {
+    return !!(data &&
+        typeof data === 'object' &&
+        'title' in data &&
+        typeof data.title === 'string' &&
+        'status' in data &&
+        typeof data.status === 'number');
+}
+/**
+ * Horizon failures are usually {@link BadResponseError} with `response` = problem+json body.
+ * Axios rejects first; the SDK forwards it unchanged, so the body lives on `error.response.data`.
+ */
+export function getHorizonErrorBody(error) {
+    if (error instanceof BadResponseError && isHorizonErrorBody(error.response)) {
+        return error.response;
+    }
+    if (error && typeof error === 'object' && 'response' in error) {
+        const data = error.response?.data;
+        if (isHorizonErrorBody(data)) {
+            return data;
+        }
+    }
+    return null;
+}
+function lookupOperationDocumentation(operationCode) {
+    if (!operationCode) {
+        return undefined;
+    }
+    return HORIZON_OPERATION_RESULT_CODE_DOCUMENTATION[operationCode];
+}
+function lookupTransactionDocumentation(transactionCode) {
+    if (!transactionCode) {
+        return undefined;
+    }
+    return HORIZON_TRANSACTION_RESULT_CODE_DOCUMENTATION[transactionCode];
+}
+function detailDocumentation(body) {
+    const detail = body.detail?.trim();
+    if (!detail || GENERIC_TRANSACTION_FAILED_DETAIL.test(detail)) {
+        return undefined;
+    }
+    return detail;
+}
+function extrasReasonDocumentation(body) {
+    const reason = body.extras?.reason?.trim();
+    if (!reason) {
+        return undefined;
+    }
+    const invalidField = body.extras?.invalid_field?.trim();
+    return invalidField ? `${reason} (field: ${invalidField})` : reason;
+}
+/**
+ * Best-effort human-readable summary for logs (`errorExtras.documentationSummary`).
+ * Prefers operation result codes, then transaction codes, then Horizon `detail` / `extras.reason`.
+ */
+export function documentationSummaryFromHorizonBody(body) {
+    const transactionCode = body.extras?.result_codes?.transaction;
+    const operationCode = failingOperationCode(body.extras?.result_codes?.operations);
+    const operationSummary = lookupOperationDocumentation(operationCode);
+    if (operationSummary) {
+        return operationSummary;
+    }
+    const transactionSummary = lookupTransactionDocumentation(transactionCode);
+    if (transactionSummary && transactionCode !== 'tx_failed') {
+        return transactionSummary;
+    }
+    const detail = detailDocumentation(body);
+    if (detail) {
+        return detail;
+    }
+    const extrasReason = extrasReasonDocumentation(body);
+    if (extrasReason) {
+        return extrasReason;
+    }
+    if (transactionSummary) {
+        return transactionSummary;
+    }
+    const title = body.title?.trim();
+    if (title) {
+        return title;
+    }
+    return 'Unknown Horizon error.';
+}
+//# sourceMappingURL=horizonErrorBody.js.map

package/lib-es/network/horizonErrorBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizonErrorBody.js","sourceRoot":"","sources":["../../src/network/horizonErrorBody.ts"],"names":[],"mappings":"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"}

package/lib-es/network/horizonLedgerErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"horizonLedgerErrors.d.ts","sourceRoot":"","sources":["../../src/network/horizonLedgerErrors.ts"],"names":[],"mappings":"AAMA,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAQ5D;AASD,wBAAgB,mCAAmC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAwB9F"}
+{"version":3,"file":"horizonLedgerErrors.d.ts","sourceRoot":"","sources":["../../src/network/horizonLedgerErrors.ts"],"names":[],"mappings":"AAOA,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAY5D;AASD,wBAAgB,mCAAmC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CA2C9F"}

package/lib-es/network/horizonLedgerErrors.js

@@ -2,7 +2,12 @@
 // SPDX-License-Identifier: Apache-2.0
 import { LedgerAPI4xx, LedgerAPI5xx, NetworkDown } from '@ledgerhq/errors';
 import { NetworkError, NotFoundError } from '@stellar/stellar-sdk';
+import { documentationSummaryFromHorizonBody, getHorizonErrorBody } from './horizonErrorBody';
 export function messageFromHorizonUnknown(e) {
+    const body = getHorizonErrorBody(e);
+    if (body) {
+        return documentationSummaryFromHorizonBody(body);
+    }
     if (e instanceof Error) {
         return e.message;
     }
@@ -18,8 +23,25 @@ const HORIZON_STATUS_5XX = /status code 5\d{2}/;
 const HORIZON_NETWORK_DOWN = /ECONNRESET|ECONNREFUSED|ENOTFOUND|EPIPE|ETIMEDOUT/;
 const HORIZON_UNDEFINED_OBJECT = /undefined is not an object/;
 export function throwHorizonLedgerOrOperationsError(e, notFoundMessage) {
+    if (e instanceof NotFoundError) {
+        throw new Error(notFoundMessage);
+    }
+    const body = getHorizonErrorBody(e);
+    const status = body?.status;
+    if (status === 404) {
+        throw new Error(notFoundMessage);
+    }
+    if (status === 429) {
+        throw new LedgerAPI4xx('status code 4xx', { status: 429, url: undefined, method: 'GET' });
+    }
+    if (status !== undefined && status >= 400 && status < 500) {
+        throw new LedgerAPI4xx();
+    }
+    if (status !== undefined && status >= 500 && status < 600) {
+        throw new LedgerAPI5xx();
+    }
     const errorMsg = messageFromHorizonUnknown(e);
-    if (e instanceof NotFoundError || HORIZON_STATUS_404.exec(errorMsg)) {
+    if (HORIZON_STATUS_404.exec(errorMsg)) {
         throw new Error(notFoundMessage);
     }
     if (HORIZON_TOO_MANY_REQUESTS.exec(errorMsg)) {

package/lib-es/network/horizonLedgerErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"horizonLedgerErrors.js","sourceRoot":"","sources":["../../src/network/horizonLedgerErrors.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sCAAsC;AAEtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAElE,MAAM,UAAU,yBAAyB,CAAC,CAAU;IAClD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC,OAAO,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAC5C,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AACtD,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAC/C,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAC/C,MAAM,oBAAoB,GAAG,mDAAmD,CAAA;AAChF,MAAM,wBAAwB,GAAG,4BAA4B,CAAA;AAE7D,MAAM,UAAU,mCAAmC,CAAC,CAAU,EAAE,eAAuB;IACrF,MAAM,QAAQ,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAAA;IAE7C,IAAI,CAAC,YAAY,aAAa,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3F,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,YAAY,EAAE,CAAA;IAC1B,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,YAAY,EAAE,CAAA;IAC1B,CAAC;IACD,IACE,CAAC,YAAY,YAAY;QACzB,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACvC,CAAC;QACD,MAAM,IAAI,WAAW,EAAE,CAAA;IACzB,CAAC;IAED,MAAM,CAAC,CAAA;AACT,CAAC"}
+{"version":3,"file":"horizonLedgerErrors.js","sourceRoot":"","sources":["../../src/network/horizonLedgerErrors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/coin-stellar",
-  "version": "6.26.1",
+  "version": "6.26.2",
   "description": "Ledger Stellar Coin integration",
   "license": "Apache-2.0",
   "keywords": [
@@ -82,7 +82,7 @@
     "@stellar/stellar-sdk": "^14.0.0",
     "bignumber.js": "^9.1.2",
     "@exodus/patch-broken-hermes-typed-arrays": "1.0.0-alpha.1",
-    "@ledgerhq/coin-module-framework": "^3.5.1"
+    "@ledgerhq/coin-module-framework": "^3.6.0"
   },
   "peerDependencies": {
     "@ledgerhq/errors": "^6.33.0",

package/src/api/index.integ.test.ts

@@ -233,7 +233,7 @@ describe('Stellar Api', () => {
 
   /**
    * Signed transaction envelope from BACK-10960 / Jira (mainnet).
-   * Live Horizon may report `tx_failed` + XDR `txFailed` (operation-level failure) while static ticket JSON showed `tx_no_source_account`.
+   * Live Horizon reports `tx_failed` with operation-level `op_underfunded`.
    */
   describe('broadcast', () => {
     let broadcastModule: CoinModuleApi<StellarMemo>
@@ -250,8 +250,10 @@ describe('Stellar Api', () => {
     it('maps Horizon transaction failure to StellarBroadcastFailedError with XDR context', async () => {
       await expect(broadcastModule.broadcast(tx)).rejects.toMatchObject({
         name: 'StellarBroadcastFailedError',
-        documentationSummary: 'One of the operations failed (none were applied).',
+        documentationSummary:
+          'The source account does not have enough balance to send the payment amount while maintaining its minimum reserve.',
         horizonTransactionCode: 'tx_failed',
+        horizonOperationCodes: ['op_underfunded'],
         stellarDocUrl:
           'https://developers.stellar.org/docs/data/apis/horizon/api-reference/errors/result-codes/transactions',
         decodedResultXdr: {

package/src/network/broadcastTransaction.test.ts

@@ -75,6 +75,26 @@ describe('broadcastTransaction', () => {
     })
   })
 
+  it('maps malformed Horizon body without result_codes to StellarBroadcastFailedError', async () => {
+    const body = {
+      type: 'https://stellar.org/horizon-errors/transaction_malformed',
+      title: 'Transaction Malformed',
+      status: 400,
+      detail: 'Horizon could not decode the transaction envelope in this request.',
+      extras: { envelope_xdr: tx },
+    }
+    submitTransactionSpy.mockRejectedValue(
+      new BadResponseError('Transaction submission failed. Server responded: 400 Bad Request', body)
+    )
+
+    await expect(broadcastTransaction(tx)).rejects.toMatchObject({
+      name: 'StellarBroadcastFailedError',
+      documentationSummary: 'Horizon could not decode the transaction envelope in this request.',
+      horizonTransactionCode: '',
+      cause: expect.any(BadResponseError),
+    })
+  })
+
   it('rethrows a plain error with no Horizon payload unchanged (same reference)', async () => {
     const original = new Error('ECONNREFUSED')
     submitTransactionSpy.mockRejectedValue(original)

package/src/network/horizon.ts

@@ -7,7 +7,6 @@ import { LedgerAPI4xx, LedgerAPI5xx, NetworkDown } from '@ledgerhq/errors'
 import { makeLRUCache } from '@ledgerhq/live-network/cache'
 import { log } from '@ledgerhq/logs'
 import {
-  BadResponseError,
   BASE_FEE,
   Horizon,
   MuxedAccount,
@@ -30,6 +29,11 @@ import {
   NetworkCongestionLevel,
 } from '../types'
 import { StellarBroadcastFailedError, type StellarDecodedResultXdr } from '../types/errors'
+import {
+  documentationSummaryFromHorizonBody,
+  getHorizonErrorBody,
+  type HorizonErrorBody,
+} from './horizonErrorBody'
 import { throwHorizonLedgerOrOperationsError } from './horizonLedgerErrors'
 import { getReservedBalance, rawOperationsToOperations } from './serialization'
 
@@ -41,75 +45,6 @@ const FETCH_LIMIT = 100
 const STELLAR_TX_RESULT_CODES_DOC_URL =
   'https://developers.stellar.org/docs/data/apis/horizon/api-reference/errors/result-codes/transactions'
 
-/** Horizon `extras.result_codes.transaction` → one-line description (Stellar docs). */
-const HORIZON_TRANSACTION_RESULT_CODE_DOCUMENTATION: Record<string, string> = {
-  tx_success: 'The transaction succeeded.',
-  tx_failed: 'One of the operations failed (none were applied).',
-  tx_too_early: 'The ledger closeTime was before the minTime.',
-  tx_too_late: 'The ledger closeTime was after the maxTime.',
-  tx_missing_operation: 'No operation was specified.',
-  tx_bad_seq: 'Sequence number does not match source account.',
-  tx_bad_auth: 'Too few valid signatures / wrong network.',
-  tx_insufficient_balance: 'Fee would bring account below reserve.',
-  tx_no_source_account: 'Source account not found.',
-  tx_insufficient_fee: 'Fee is too small.',
-  tx_bad_auth_extra: 'Unused signatures attached to transaction.',
-  tx_internal_error: 'An unknown error occurred.',
-  tx_fee_bump_inner_success: 'Fee bump inner transaction succeeded.',
-  tx_fee_bump_inner_failed: 'Fee bump inner transaction failed.',
-  tx_not_supported: 'Transaction type not supported.',
-  tx_bad_sponsorship: 'Sponsorship is invalid.',
-  tx_bad_min_seq_age_or_gap: 'Minimum sequence age or gap precondition failed.',
-  tx_malformed: 'Transaction is malformed.',
-  tx_soroban_invalid: 'Soroban transaction is invalid.',
-}
-
-type HorizonSubmitErrorBody = {
-  type?: string
-  title?: string
-  status?: number
-  detail?: string
-  extras?: {
-    envelope_xdr?: string
-    result_xdr?: string
-    result_codes?: {
-      transaction?: string
-      operations?: string[]
-    }
-  }
-}
-
-function isHorizonSubmitErrorBody(data: unknown): data is HorizonSubmitErrorBody {
-  return !!(
-    data &&
-    typeof data === 'object' &&
-    'extras' in data &&
-    typeof data.extras === 'object' &&
-    data.extras !== null &&
-    'result_codes' in data.extras &&
-    data.extras.result_codes !== undefined &&
-    typeof data.extras.result_codes === 'object'
-  )
-}
-
-/**
- * Horizon submit failures are usually {@link BadResponseError} with `response` = problem+json body.
- * In practice axios rejects with `AxiosError` first; the SDK's `.catch` forwards it unchanged (see js-stellar-sdk horizon/server.js),
- * so the Horizon body lives on `error.response.data`.
- */
-function getHorizonBodyFromSubmitFailure(error: unknown): HorizonSubmitErrorBody | null {
-  if (error instanceof BadResponseError && isHorizonSubmitErrorBody(error.response)) {
-    return error.response
-  }
-  if (error && typeof error === 'object' && 'response' in error) {
-    const data = (error as { response?: { data?: unknown } }).response?.data
-    if (isHorizonSubmitErrorBody(data)) {
-      return data
-    }
-  }
-  return null
-}
-
 function decodeTransactionResultFields(resultXdrBase64: string | undefined):
   | {
       feeChargedStroops?: string
@@ -136,14 +71,11 @@ function decodeTransactionResultFields(resultXdrBase64: string | undefined):
   }
 }
 
-function makeBroadcastFailedError(body: HorizonSubmitErrorBody, cause: Error): Error {
+function makeBroadcastFailedError(body: HorizonErrorBody, cause: Error): Error {
   const extras = body.extras
   const horizonTransactionCode = extras?.result_codes?.transaction ?? ''
   const horizonOperationCodes = extras?.result_codes?.operations
-  const documentationSummary =
-    (horizonTransactionCode &&
-      HORIZON_TRANSACTION_RESULT_CODE_DOCUMENTATION[horizonTransactionCode]) ||
-    'Unknown transaction result code.'
+  const documentationSummary = documentationSummaryFromHorizonBody(body)
   const decodedResult = decodeTransactionResultFields(extras?.result_xdr)
   const feeChargedStroops = decodedResult?.feeChargedStroops
   const resultXdrSwitchName = decodedResult?.resultXdrSwitchName
@@ -558,7 +490,7 @@ export async function fetchSigners(account: string): Promise<Signer[]> {
 }
 
 function interpretedError(error: unknown): unknown {
-  const body = getHorizonBodyFromSubmitFailure(error)
+  const body = getHorizonErrorBody(error)
   if (body) {
     const cause = error instanceof Error ? error : new Error(String(error))
     return makeBroadcastFailedError(body, cause)

package/src/network/horizon.unit.test.ts

@@ -382,7 +382,7 @@ describe('horizon.ts (unit, spies)', () => {
         .mockRejectedValue(new Error('mock not configured'))
     })
 
-    it('uses Unknown transaction result code when Horizon code is not in the map', async () => {
+    it('uses Horizon detail as documentationSummary when transaction result code is unknown', async () => {
       const body = {
         type: 'https://stellar.org/horizon-errors/transaction_failed',
         title: 'Transaction Failed',
@@ -403,7 +403,7 @@ describe('horizon.ts (unit, spies)', () => {
 
       await expect(broadcastTransaction(signedTxFixture)).rejects.toMatchObject({
         name: 'StellarBroadcastFailedError',
-        documentationSummary: 'Unknown transaction result code.',
+        documentationSummary: 'failed',
       })
     })
 

package/src/network/horizonErrorBody.test.ts

@@ -0,0 +1,133 @@
+// SPDX-FileCopyrightText: © 2026 LEDGER SAS
+// SPDX-License-Identifier: Apache-2.0
+
+import { BadResponseError } from '@stellar/stellar-sdk'
+import {
+  documentationSummaryFromHorizonBody,
+  getHorizonErrorBody,
+  isHorizonErrorBody,
+} from './horizonErrorBody'
+
+describe('isHorizonErrorBody', () => {
+  it('accepts RFC 7807 problem bodies with title and status', () => {
+    expect(
+      isHorizonErrorBody({
+        type: 'https://stellar.org/horizon-errors/transaction_malformed',
+        title: 'Transaction Malformed',
+        status: 400,
+        detail: 'Horizon could not decode the transaction envelope in this request.',
+      })
+    ).toBe(true)
+  })
+
+  it('rejects non-problem payloads', () => {
+    expect(isHorizonErrorBody({ title: 'Missing status' })).toBe(false)
+    expect(isHorizonErrorBody(null)).toBe(false)
+  })
+})
+
+describe('getHorizonErrorBody', () => {
+  const body = {
+    type: 'https://stellar.org/horizon-errors/bad_request',
+    title: 'Bad Request',
+    status: 400,
+    detail: 'Invalid cursor.',
+    extras: { reason: 'cursor is invalid' },
+  }
+
+  it('reads BadResponseError.response', () => {
+    const error = new BadResponseError('bad', body)
+    expect(getHorizonErrorBody(error)).toEqual(body)
+  })
+
+  it('reads axios-like error.response.data', () => {
+    const error = Object.assign(new Error('Request failed with status code 400'), {
+      response: { data: body },
+    })
+    expect(getHorizonErrorBody(error)).toEqual(body)
+  })
+})
+
+describe('documentationSummaryFromHorizonBody', () => {
+  const genericDetail =
+    'The transaction failed when submitted to the Stellar network. The `extras.result_codes` field on this response contains further details.'
+
+  it('prefers operation result code over generic tx_failed', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Transaction Failed',
+        status: 400,
+        detail: genericDetail,
+        extras: {
+          result_codes: {
+            transaction: 'tx_failed',
+            operations: ['op_underfunded'],
+          },
+        },
+      })
+    ).toBe(
+      'The source account does not have enough balance to send the payment amount while maintaining its minimum reserve.'
+    )
+  })
+
+  it('skips op_inner and uses the first failing operation code', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Transaction Failed',
+        status: 400,
+        detail: genericDetail,
+        extras: {
+          result_codes: {
+            transaction: 'tx_failed',
+            operations: ['op_inner', 'op_underfunded'],
+          },
+        },
+      })
+    ).toBe(
+      'The source account does not have enough balance to send the payment amount while maintaining its minimum reserve.'
+    )
+  })
+
+  it('uses transaction code when it is specific', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Transaction Failed',
+        status: 400,
+        detail: genericDetail,
+        extras: {
+          result_codes: { transaction: 'tx_bad_seq' },
+        },
+      })
+    ).toBe('Sequence number does not match source account.')
+  })
+
+  it('uses Horizon detail when no result codes are present', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Transaction Malformed',
+        status: 400,
+        detail: 'Horizon could not decode the transaction envelope in this request.',
+        extras: { envelope_xdr: 'AAAA' },
+      })
+    ).toBe('Horizon could not decode the transaction envelope in this request.')
+  })
+
+  it('uses extras.reason for validation errors', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Bad Request',
+        status: 400,
+        extras: { invalid_field: 'cursor', reason: 'cursor is invalid' },
+      })
+    ).toBe('cursor is invalid (field: cursor)')
+  })
+
+  it('falls back to title when nothing else is available', () => {
+    expect(
+      documentationSummaryFromHorizonBody({
+        title: 'Rate Limited',
+        status: 429,
+      })
+    ).toBe('Rate Limited')
+  })
+})