feat: add receipts with the operations summary (#3658)

* feat: add receipts handling to transaction operations

* .

* test: add tests for merging transaction operation receipts

* refactor: expose `mergeOperations` function for transaction operations

* refactor: improve mergeOperations function formatting and readability

* ci: add changeset for incremental Fuels package update

* feat: send receipts with operations summary for account and recipes packages

* test: add tests for adding operations with receipt merging

* refactor: make `mergeOperations` function private

* test: improve formatting of operation receipts test case

* Atualizar o rotten-pillows-scream.md

Co-authored-by: Peter Smith <[email protected]>

---------

Co-authored-by: Peter Smith <[email protected]>

Author: nelitow

.changeset/rotten-pillows-scream.md

@@ -0,0 +1,5 @@
+---
+"@fuel-ts/account": patch
+---
+
+feat: add receipts with the operations summary

packages/account/src/providers/transaction-summary/operations.test.ts

@@ -73,6 +73,7 @@ describe('operations', () => {
             assetId: ZeroBytes32,
           },
         ],
+        receipts: [MOCK_RECEIPT_CALL],
       };
 
       const receipts = [
@@ -266,6 +267,7 @@ describe('operations', () => {
           chain: ChainName.ethereum,
           type: 1,
         },
+        receipts: [MOCK_RECEIPT_MESSAGE_OUT],
       };
 
       const operations = getWithdrawFromFuelOperations({
@@ -324,6 +326,7 @@ describe('operations', () => {
               assetId: '0x0000000000000000000000000000000000000000000000000000000000000000',
             },
           ],
+          receipts: [MOCK_RECEIPT_TRANSFER_OUT],
         },
         {
           name: OperationName.contractCall,
@@ -342,6 +345,7 @@ describe('operations', () => {
               assetId: ZeroBytes32,
             },
           ],
+          receipts: [MOCK_RECEIPT_CALL],
         },
       ];
 
@@ -400,6 +404,7 @@ describe('operations', () => {
       const operationsCallNoAmount: Operation = {
         ...expected,
         assetsSent: undefined,
+        receipts: [{ ...MOCK_RECEIPT_CALL, amount: bn(0) }],
       };
 
       const operations = getOperations({
@@ -822,6 +827,93 @@ describe('operations', () => {
       expect(operationsAddedSameContractCall.length).toEqual(1);
       expect(operationsAddedSameContractCall[0].calls?.length).toEqual(2);
     });
+
+    it('should merge receipts when adding operations', () => {
+      const receipt1: TransactionResultReceipt = {
+        type: ReceiptType.Transfer,
+        to: '0xabc',
+        amount: bn(100),
+        assetId: '0x0',
+        id: '0x123',
+        pc: bn(0),
+        is: bn(0),
+      };
+
+      const receipt2: TransactionResultReceipt = {
+        type: ReceiptType.Transfer,
+        to: '0xdef',
+        amount: bn(200),
+        assetId: '0x0',
+        id: '0x456',
+        pc: bn(0),
+        is: bn(0),
+      };
+
+      const op1: Operation = {
+        name: OperationName.transfer,
+        receipts: [receipt1],
+      };
+
+      const op2: Operation = {
+        name: OperationName.transfer,
+        receipts: [receipt2],
+      };
+
+      const operations = addOperation([op1], op2);
+      expect(operations[0].receipts).toHaveLength(2);
+      expect(operations[0].receipts).toContainEqual(receipt1);
+      expect(operations[0].receipts).toContainEqual(receipt2);
+    });
+
+    it('should not duplicate receipts when adding operations', () => {
+      const receipt: TransactionResultReceipt = {
+        type: ReceiptType.Transfer,
+        to: '0xabc',
+        amount: bn(100),
+        assetId: '0x0',
+        id: '0x123',
+        pc: bn(0),
+        is: bn(0),
+      };
+
+      const op1: Operation = {
+        name: OperationName.transfer,
+        receipts: [receipt],
+      };
+
+      const op2: Operation = {
+        name: OperationName.transfer,
+        receipts: [receipt],
+      };
+
+      const operations = addOperation([op1], op2);
+      expect(operations[0].receipts).toHaveLength(1);
+      expect(operations[0].receipts?.[0]).toEqual(receipt);
+    });
+
+    it('should handle operations without receipts', () => {
+      const op1: Operation = {
+        name: OperationName.transfer,
+      };
+
+      const op2: Operation = {
+        name: OperationName.transfer,
+        receipts: [
+          {
+            type: ReceiptType.Transfer,
+            to: '0xabc',
+            amount: bn(100),
+            assetId: '0x0',
+            id: '0x123',
+            pc: bn(0),
+            is: bn(0),
+          },
+        ],
+      };
+
+      const operations = addOperation([op1], op2);
+      expect(operations[0].receipts).toHaveLength(1);
+    });
   });
 
   describe('isType', () => {

packages/account/src/providers/transaction-summary/operations.ts

@@ -196,6 +196,10 @@ function mergeOperations(existing: Operation, toAdd: Operation): Operation {
     ...existing,
     assetsSent: mergeAssetsSent(existing, toAdd),
     calls: mergeCalls(existing, toAdd),
+    receipts: [
+      ...(existing.receipts || []),
+      ...(toAdd.receipts?.filter((r) => !existing.receipts?.some((er) => er === r)) || []),
+    ],
   };
 }
 
@@ -252,6 +256,7 @@ export function getWithdrawFromFuelOperations({
               assetId: baseAssetId,
             },
           ],
+          receipts: [receipt],
         });
 
         return newWithdrawFromFuelOps;
@@ -332,6 +337,7 @@ function processCallReceipt(
       },
       assetsSent: getAssetsSent(receipt),
       calls,
+      receipts: [receipt],
     },
   ];
 }
@@ -421,6 +427,7 @@ function extractTransferOperationFromReceipt(
         amount,
       },
     ],
+    receipts: [receipt],
   };
 }
 

packages/account/src/providers/transaction-summary/types.ts

@@ -118,6 +118,7 @@ export type Operation = {
   to?: OperationTransactionAddress;
   assetsSent?: Array<OperationCoin>;
   calls?: Array<OperationFunctionCall>;
+  receipts?: TransactionResultReceipt[];
 };
 
 /**