docs(interface): improve comments

src/interface.ts

@@ -10,17 +10,34 @@ export interface Entry extends Tuple {
 }
 
 export interface Prefix {
-  readonly average: number; // same for all buckets of the same tree
-  readonly level: number; // changes based on level of the bucket in the tree, leaves are always level 0
-  readonly base: number; // base number for delta encoding of entry seq field
+  /**
+   * Must be the same for all buckets of the same tree.
+   */
+  readonly average: number;
+
+  /**
+   * Changes based on the level of the bucket in the tree.
+   * Leaves are always level 0.
+   */
+  readonly level: number;
+
+  /**
+   * Base number for delta encoding.
+   * Set to boundary seq, 0 if the bucket is empty.
+   */
+  readonly base: number;
 }
 
 export interface Bucket extends Prefix {
   readonly entries: Entry[];
   getBytes(): Uint8Array;
   getCID(): CID;
   getDigest(): Uint8Array;
-  getBoundary(): Entry | null; // null if bucket is empty
+
+  /**
+   * Null if the bucket is empty.
+   */
+  getBoundary(): Entry | null;
   getParentEntry(): Entry | null;
 }