storage: doc

lib/storage.js

@@ -125,6 +125,7 @@ Piece.prototype._reset = function () {
   self.blocksWritten = 0
 }
 
+// called by writeBlock() once all blocks have been written
 Piece.prototype.verify = function (buffer) {
   var self = this
   buffer = buffer || self.buffer
@@ -155,6 +156,7 @@ Piece.prototype.verify = function (buffer) {
   }
 }
 
+// validates a readBlock()/writeBlock() offset
 Piece.prototype._verifyOffset = function (offset) {
   var self = this
   if (offset % BLOCK_LENGTH === 0) {
@@ -165,6 +167,7 @@ Piece.prototype._verifyOffset = function (offset) {
   }
 }
 
+// validates a writeBlock() buffer length
 Piece.prototype._verifyBlock = function (offset, buffer) {
   var self = this
   if (buffer.length === BLOCK_LENGTH) {