Add JSDoc to all functions

kmoe

and describe side effects: e.g. `Identity.generateKeyPair()` should have the side effect of setting properties on the `Identity` instance.