add return types, and more exception handling
correct docs and bump client 0.4.2