almost finalized protocol; added examples