Fix some mistakes in the readme file

This includes a full refresh of the obelisk protocol
from the original source code.