Improve events (#454)

* Fix typo in docs

* Improve events
Expose `error` event
Add `once`
Allow method chaining for `on` and `once`

packages/rpc-provider/src/types.ts

@@ -37,7 +37,7 @@ export type JsonRpcResponse = JsonRpcObject & JsonRpcResponseBase;
 
 export type ProviderInterface$Callback = (result: any) => void;
 
-export type ProviderInterface$Emitted = 'connected' | 'disconnected';
+export type ProviderInterface$Emitted = 'connected' | 'disconnected' | 'error';
 
 export type ProviderInterface$EmitCb = (value?: any) => any;
 

packages/rpc-provider/src/ws/index.ts

@@ -245,6 +245,7 @@ export default class WsProvider implements WSProviderInterface {
 
   private onSocketError = (error: Event): void => {
     l.debug(() => ['socket error', error]);
+    this.emit('error', error);
   }
 
   private onSocketMessage = (message: MessageEvent): void => {