diff --git a/dagger/storageproofs/README.md b/dagger/storageproofs/README.md
index 1ee54b5e..258606b2 100644
--- a/dagger/storageproofs/README.md
+++ b/dagger/storageproofs/README.md
@@ -1 +1,9 @@
 Nim implementation of Proof of Storage related schemes
+
+Implementation of the BLS-based public PoS scheme from
+Shacham H., Waters B., "Compact Proofs of Retrievability"
+using pairing over BLS12-381 ECC.
+
+For a detailed description of the implementation, see `bls.nim`
+
+For a usage example, see `testbls.nim`