diff --git a/README.md b/README.md
index 7b1a2b7..c901aaf 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-# silent payments
+# Silent Payments
 
-Trying to implement silent payments in rust using the reference.py as a guide
+This repo is a rust implementation of BIP352: Silent Payments.
+This BIP is still under development, and this repo is by no means ready for real use yet.
+At this point, the repo is no more than a rust rewrite of the `reference.py` python reference implementation.
+
+It currently passes the given send and receive test vectors as of July 23rd 2023.
+However, for ease of reading the data, some slight changes have been made to the formatting:
+
+- Empty labels are given as an empty map `{}` rather than an empty list `[]`
+- The label integer `m` is given in 32-byte big-endian hex format