Update readme about hg tip requirement
Clean up decoding / encoding code
Buffer reads and writes
Add API instability disclaimer to readme