comments for further clarity around encodedData

src/core/dwn-constant.ts

@@ -1,6 +1,7 @@
 export class DwnConstant {
   /**
    * The maximum size in bytes of raw data that will be returned as `encodedData`.
+   * this is also the maximum size that we will store within MessageStore.
    */
   public static readonly maxDataSizeAllowedToBeEncoded = 50_000;
 }

src/handlers/messages-get.ts

@@ -63,7 +63,8 @@ export class MessagesGetHandler implements MethodHandler {
         continue;
       }
 
-      // RecordsWrite specific handling
+      // RecordsWrite specific handling, if MessageStore has embedded `encodedData` return it with the entry.
+      // we store `encodedData` along with the message if the data is below a certain threshold.
       const recordsWrite = message as RecordsWriteMessageWithOptionalEncodedData;
       if (recordsWrite.encodedData !== undefined) {
         entry.encodedData = recordsWrite.encodedData;

src/handlers/records-write.ts

@@ -92,8 +92,9 @@ export class RecordsWriteHandler implements MethodHandler {
       }
 
       try {
+        // if data is below the threshold, we store it within MessageStore
         if (message.descriptor.dataSize <= DwnConstant.maxDataSizeAllowedToBeEncoded) {
-          // processes and sets `encodedData` with appropriate data to be saved in MessageStore.
+          // processes and sets `encodedData` with appropriate data.
           messageWithOptionalEncodedData = await this.processEncodedData(
             message,
             dataStream,

src/store/storage-controller.ts

@@ -79,4 +79,5 @@ export class StorageController {
   }
 }
 
+// records with a data size below a threshold are stored within MessageStore with their data embedded
 export type RecordsWriteMessageWithOptionalEncodedData = RecordsWriteMessage & { encodedData?: string };