diff --git a/peer/README b/peer/README
new file mode 100644
index 000000000..51b7e2582
--- /dev/null
+++ b/peer/README
@@ -0,0 +1,35 @@
+////////////////////////////
+// All client impl internal messages
+// No filter
+** Channel ""
+
+* NewFilterMsg
+* ...?
+
+
+////////////////////////////
+// All blocks
+// Requires a custom simple filter
+** Channel "block"
+
+* BlockMsg
+* HeaderMsg
+
+
+////////////////////////////
+// New transactions that haven't been committed
+// e.g. the mempool
+// n:10k, p:0.02 -> k:6, m:10KB
+** Channel "newtx"
+
+* NewTxMsg
+
+
+////////////////////////////
+// All about the consensus
+// No filter
+** Channel "consensus"
+
+* ProposalMsg
+* VoteMsg
+* NewBlockMsg