get client method implemented
add doc blocks to the client interface. some refactor is defo in order :]