make verbose details an option

src/headless/integrationtest.ts

@@ -187,7 +187,7 @@ export async function runIntegrationTest(args: IntegrationTestArgs) {
 
   await myWallet.runUntilDone();
 
-  const history = await myWallet.getHistory();
+  const history = await myWallet.getHistory({ verboseDetails: true });
 
   console.log("history after integration test:", JSON.stringify(history, undefined, 2));
 }

src/operations/history.ts

@@ -215,15 +215,16 @@ export async function getHistory(
               cs.push(x);
             }
           });
-          const verboseDetails: VerboseWithdrawDetails = {
+
+          let verboseDetails: VerboseWithdrawDetails | undefined = undefined;
+          if (historyQuery?.verboseDetails) {
+            verboseDetails = {
               coins: cs.map((x) => ({
                 value: Amounts.toString(x.coinValue),
                 denomPub: x.denomPub,
               })),
             };
-          const coins = cs.map((x) => ({
+          }
-            value: x.coinValue
-          }));
           
           history.push({
             type: HistoryEventType.Withdrawn,
@@ -257,6 +258,8 @@ export async function getHistory(
         if (!orderShortInfo) {
           return;
         }
+        let verboseDetails: VerbosePayCoinDetails | undefined = undefined;
+        if (historyQuery?.verboseDetails) {
           const coins: {
             value: string,
             contribution: string;
@@ -279,7 +282,8 @@ export async function getHistory(
               value: Amounts.toString(d.value),
             });
           }
-        const verboseDetails: VerbosePayCoinDetails = { coins };
+          verboseDetails = { coins }; 
+        }
         const amountPaidWithFees = Amounts.sum(
           purchase.payReq.coins.map(x => Amounts.parseOrThrow(x.contribution)),
         ).amount;
@@ -331,6 +335,8 @@ export async function getHistory(
         } else {
           amountRefreshedEffective = Amounts.sum(amountsEffective).amount;
         }
+        let verboseDetails: VerboseRefreshDetails | undefined = undefined;
+        if (historyQuery?.verboseDetails) {
           const outputCoins: {
             value: string;
             denomPub: string,
@@ -353,9 +359,10 @@ export async function getHistory(
               });
             }
           }
-        const verboseDetails: VerboseRefreshDetails = {
+          verboseDetails = {
             outputCoins: outputCoins,
           }
+        }
         history.push({
           type: HistoryEventType.Refreshed,
           refreshGroupId: rg.refreshGroupId,

src/types/history.ts

@@ -509,7 +509,7 @@ export interface HistoryPaymentSent {
    */
   sessionId: string | undefined;
 
-  verboseDetails: VerbosePayCoinDetails;
+  verboseDetails?: VerbosePayCoinDetails;
 }
 
 /**
@@ -590,7 +590,7 @@ export interface HistoryRefreshedEvent {
    */
   refreshGroupId: string;
 
-  verboseDetails: VerboseRefreshDetails;
+  verboseDetails?: VerboseRefreshDetails;
 }
 
 export interface VerboseWithdrawDetails {
@@ -630,7 +630,10 @@ export interface HistoryWithdrawnEvent {
    */
   amountWithdrawnEffective: string;
 
-  verboseDetails: VerboseWithdrawDetails;
+  /**
+   * Verbose details of the operations, only generated when requested.
+   */
+  verboseDetails?: VerboseWithdrawDetails;
 }
 
 /**
@@ -684,5 +687,9 @@ export type HistoryEvent = HistoryEventBase &
   );
 
 export interface HistoryQuery {
-  // TBD
+  /**
+   * Output extra verbose details, intended for debugging
+   * and not for end users.
+   */
+  verboseDetails?: boolean;
 }

src/types/pending.ts

@@ -60,6 +60,9 @@ export type PendingOperationInfo = PendingOperationInfoCommon &
     | PendingWithdrawOperation
   );
 
+/**
+ * The wallet is currently updating information about an exchange.
+ */
 export interface PendingExchangeUpdateOperation {
   type: PendingOperationType.ExchangeUpdate;
   stage: string;
@@ -68,6 +71,11 @@ export interface PendingExchangeUpdateOperation {
   lastError: OperationError | undefined;
 }
 
+/**
+ * Some interal error happened in the wallet.  This pending operation
+ * should *only* be reported for problems in the wallet, not when
+ * a problem with a merchant/exchange/etc. occurs.
+ */
 export interface PendingBugOperation {
   type: PendingOperationType.Bug;
   message: string;