ensure transport subsystem is fully documented in specification

[kiniry]

In particular, make sure all JSON and endpoint specifications reflect the actual implementation and the protocol specification is up-to-date.