From 6b6f0ec1d0228158a71b34a228bd8bce0b4666ec Mon Sep 17 00:00:00 2001
From: jakobsn <jakob_sn_@hotmail.com>
Date: Wed, 29 Apr 2026 11:23:23 +0000
Subject: [PATCH] TxSummary

---
 packages/core/src/protocols/hdwalletv1.ts | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/core/src/protocols/hdwalletv1.ts b/packages/core/src/protocols/hdwalletv1.ts
index b12b173..dadf335 100644
--- a/packages/core/src/protocols/hdwalletv1.ts
+++ b/packages/core/src/protocols/hdwalletv1.ts
@@ -134,11 +134,27 @@ export interface ErrorMessage extends ProtocolMessage {
   error: string;
 }
 
+export interface TxSummaryTokenChange {
+  categoryId: string; // hex token category ID
+  fungibleAmount: string; // signed bigint as string (negative = spending, positive = receiving)
+  nftCount?: number;
+  symbol?: string;
+  decimals?: number;
+}
+
+export interface TxSummary {
+  netBchSats: string; // signed bigint as string (negative = spending, positive = receiving)
+  tokenChanges: TxSummaryTokenChange[];
+}
+
 export interface SignTransactionRequest extends ProtocolMessage {
   action: RelayMsgAction.SignTransactionRequest;
   transaction: WcSignTransactionRequest;
   sequence: number;
   inputPaths: [number, PathName, number][]; // [inputIndex, pathName, addressIndex]
+  /// Dapp-provided transaction summary. Wallets should use this for display
+  /// when present rather than parsing the raw transaction themselves.
+  txSummary?: TxSummary;
 }
 
 export interface SignTransactionResponse extends ProtocolMessage {