wagmi 0.0.13 → 0.0.17

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Tom Meagher
+Copyright (c) 2022 Tom Meagher
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -17,7 +17,7 @@
 
 **React Hooks library for Ethereum, built on [ethers.js](https://github.com/ethers-io/ethers.js).**
 
-🚀   Hooks for connecting wallets, signing messages, sending transactions, etc.
+🚀   20+ hooks for working with wallets, ENS, contracts, transactions, signing, etc.
 
 💼   Built-in wallet connectors for MetaMask, WalletConnect, and Coinbase Wallet
 
@@ -60,7 +60,7 @@ const App = () => (
 ```tsx
 import { useAccount } from 'wagmi'
 
-const App = () => {
+const Page = () => {
   const [{ data, error, loading }, disconnect] = useAccount({
     fetchEns: true,
   })

package/dist/declarations/src/hooks/accounts/useBalance.d.ts

@@ -24,8 +24,14 @@ export declare const useBalance: ({ addressOrName, formatUnits, skip, token, wat
     addressOrName: string;
     formatUnits?: Config['formatUnits'];
     token?: Config['token'];
-} | undefined) => Promise<Error | {
-    formatted: string;
-    symbol: string;
-    value: BigNumber;
+} | undefined) => Promise<{
+    data: {
+        formatted: string;
+        symbol: string;
+        value: BigNumber;
+    };
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
 }>];

package/dist/declarations/src/hooks/accounts/useConnect.d.ts

@@ -7,7 +7,10 @@ export declare const useConnect: () => readonly [{
     };
     readonly error: Error | undefined;
     readonly loading: boolean;
-}, (connector: Connector) => Promise<Error | {
-    connector: Connector<any, any>;
+}, (connector: Connector) => Promise<{
     data: import("wagmi-private").Data<any>;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
 } | undefined>];

package/dist/declarations/src/hooks/accounts/useNetwork.d.ts

@@ -21,4 +21,10 @@ export declare const useNetwork: () => readonly [{
     };
     readonly error: Error | undefined;
     readonly loading: boolean | undefined;
-}, ((chainId: number) => Promise<boolean | Error>) | undefined];
+}, ((chainId: number) => Promise<false | {
+    data: boolean;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>) | undefined];

package/dist/declarations/src/hooks/accounts/useSignMessage.d.ts

@@ -9,4 +9,10 @@ export declare const useSignMessage: ({ message }?: Config) => readonly [{
     readonly loading: boolean | undefined;
 }, (config?: {
     message?: Config['message'];
-} | undefined) => Promise<string | Error>];
+} | undefined) => Promise<{
+    data: string;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];

package/dist/declarations/src/hooks/contracts/useContractEvent.d.ts

@@ -1,8 +1,8 @@
 import { ethers } from 'ethers';
 import { Config as UseContractConfig } from './useContract';
 declare type Config = {
-    /** Subscribe to changes */
-    watch?: boolean;
+    /** Receive only a single event */
+    once?: boolean;
 };
-export declare const useContractEvent: <Contract extends ethers.Contract = ethers.Contract>(contractConfig: UseContractConfig, eventName: Parameters<Contract["on"]>[0], listener: Parameters<Contract["on"]>[1], { watch }?: Config) => void;
+export declare const useContractEvent: <Contract extends ethers.Contract = ethers.Contract>(contractConfig: UseContractConfig, eventName: Parameters<Contract["on"]>[0], listener: Parameters<Contract["on"]>[1], { once }?: Config) => void;
 export {};

package/dist/declarations/src/hooks/contracts/useContractRead.d.ts

@@ -12,6 +12,12 @@ export declare const useContractRead: <Contract extends ethers.Contract = ethers
     readonly loading: boolean | undefined;
 }, (config?: {
     args?: Config['args'];
-    overrides: Config['overrides'];
-} | undefined) => Promise<any>];
+    overrides?: Config['overrides'];
+} | undefined) => Promise<{
+    data: ethers.utils.Result;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/contracts/useContractWrite.d.ts

@@ -10,6 +10,12 @@ export declare const useContractWrite: <Contract extends ethers.Contract = ether
     readonly loading: boolean | undefined;
 }, (config?: {
     args?: Config['args'];
-    overrides: Config['overrides'];
-} | undefined) => Promise<any>];
+    overrides?: Config['overrides'];
+} | undefined) => Promise<{
+    data: ethers.providers.TransactionResponse;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/contracts/useToken.d.ts

@@ -25,12 +25,18 @@ export declare const useToken: ({ address, formatUnits, skip, }?: Config) => rea
 }) => Promise<boolean | Error>, (config?: {
     address: string;
     formatUnits?: Config['formatUnits'];
-} | undefined) => Promise<Error | {
-    address: string;
-    decimals: any;
-    symbol: any;
-    totalSupply: {
-        formatted: string;
-        value: any;
+} | undefined) => Promise<{
+    data: {
+        address: string;
+        decimals: any;
+        symbol: any;
+        totalSupply: {
+            formatted: string;
+            value: any;
+        };
     };
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
 }>];

package/dist/declarations/src/hooks/ens/useEnsLookup.d.ts

@@ -10,5 +10,11 @@ export declare const useEnsLookup: ({ address, skip }?: Config) => readonly [{
     readonly error: Error | undefined;
 }, (config?: {
     address: string;
-} | undefined) => Promise<string | Error | null>];
+} | undefined) => Promise<{
+    data: string | null;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/ens/useEnsResolver.d.ts

@@ -11,5 +11,11 @@ export declare const useEnsResolver: ({ name, skip }?: Config) => readonly [{
     readonly error: Error | undefined;
 }, (config?: {
     name: Config['name'];
-} | undefined) => Promise<Error | import("@ethersproject/providers").Resolver | null>];
+} | undefined) => Promise<{
+    data: import("@ethersproject/providers").Resolver | null;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/network-status/useBlockNumber.d.ts

@@ -8,5 +8,11 @@ export declare const useBlockNumber: ({ skip, watch }?: Config) => readonly [{
     readonly data: number | undefined;
     readonly error: Error | undefined;
     readonly loading: boolean | undefined;
-}, () => Promise<number | Error>];
+}, () => Promise<{
+    data: number;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/network-status/useFeeData.d.ts

@@ -21,5 +21,11 @@ export declare const useFeeData: ({ formatUnits, skip, watch, }?: Config) => rea
     } | undefined;
     readonly loading: boolean | undefined;
     readonly error: Error | undefined;
-}, () => Promise<Error | FeeData>];
+}, () => Promise<{
+    data: FeeData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];
 export {};

package/dist/declarations/src/hooks/transactions/useTransaction.d.ts

@@ -9,4 +9,10 @@ export declare const useTransaction: ({ request }?: Config) => readonly [{
     readonly loading: boolean | undefined;
 }, (config?: {
     request: Config['request'];
-} | undefined) => Promise<Error | TransactionResponse>];
+} | undefined) => Promise<{
+    data: TransactionResponse;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];

package/dist/declarations/src/hooks/transactions/useWaitForTransaction.d.ts

@@ -22,4 +22,10 @@ export declare const useWaitForTransaction: ({ confirmations, hash, skip, timeou
     hash?: Config['hash'];
     timeout?: Config['timeout'];
     wait?: Config['wait'];
-} | undefined) => Promise<Error | TransactionReceipt>];
+} | undefined) => Promise<{
+    data: TransactionReceipt;
+    error: undefined;
+} | {
+    data: undefined;
+    error: Error;
+}>];

package/dist/wagmi.cjs.dev.js

@@ -246,14 +246,20 @@ var useEnsLookup = function useEnsLookup() {
           ens,
           loading: false
         }));
-        return ens;
+        return {
+          data: ens,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -310,14 +316,20 @@ var useEnsResolver = function useEnsResolver() {
           loading: false,
           resolver
         }));
-        return resolver;
+        return {
+          data: resolver,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -424,14 +436,20 @@ var useBlockNumber = function useBlockNumber() {
         blockNumber,
         loading: false
       }));
-      return blockNumber;
+      return {
+        data: blockNumber,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]);
   /* eslint-disable react-hooks/exhaustive-deps */
@@ -500,14 +518,20 @@ var useFeeData = function useFeeData() {
         feeData,
         loading: false
       }));
-      return feeData;
+      return {
+        data: feeData,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]); // Fetch feeData on mount or when chain changes
 
@@ -608,14 +632,20 @@ var useBalance = function useBalance() {
           balance,
           loading: false
         }));
-        return balance;
+        return {
+          data: balance,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -695,8 +725,8 @@ var useConnect = () => {
           loading: false
         }));
         return {
-          connector,
-          data
+          data,
+          error: undefined
         };
       } catch (error_) {
         var error = error_;
@@ -705,7 +735,10 @@ var useConnect = () => {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -766,14 +799,20 @@ var useNetwork = () => {
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           loading: false
         }));
-        return true;
+        return {
+          data: true,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -825,7 +864,10 @@ var useSignMessage = function useSignMessage() {
           signature,
           loading: false
         }));
-        return signature;
+        return {
+          data: signature,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -833,7 +875,10 @@ var useSignMessage = function useSignMessage() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -880,10 +925,8 @@ var useContract = _ref2 => {
 
 var useContractEvent = function useContractEvent(contractConfig, eventName, listener) {
   var {
-    watch
-  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
-    watch: true
-  };
+    once
+  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   var provider = useProvider();
   var webSocketProvider = useWebSocketProvider();
   var contract = useContract(_objectSpread2({
@@ -903,7 +946,7 @@ var useContractEvent = function useContractEvent(contractConfig, eventName, list
     };
 
     var contract_ = ethers.ethers.Contract;
-    if (!watch) contract_.once(eventName, handler);else contract_.on(eventName, handler);
+    if (once) contract_.once(eventName, handler);else contract_.on(eventName, handler);
     return () => {
       contract_.off(eventName, handler);
       return;
@@ -949,14 +992,20 @@ var useContractRead = function useContractRead(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1033,7 +1082,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -1041,7 +1093,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1104,14 +1159,20 @@ var useToken = function useToken() {
           token,
           loading: false
         }));
-        return token;
+        return {
+          data: token,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1190,7 +1251,10 @@ var useTransaction = function useTransaction() {
           loading: false,
           transaction
         }));
-        return transaction;
+        return {
+          data: transaction,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -1198,7 +1262,10 @@ var useTransaction = function useTransaction() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1247,14 +1314,20 @@ var useWaitForTransaction = function useWaitForTransaction() {
           loading: false,
           receipt
         }));
-        return receipt;
+        return {
+          data: receipt,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 

package/dist/wagmi.cjs.prod.js

@@ -246,14 +246,20 @@ var useEnsLookup = function useEnsLookup() {
           ens,
           loading: false
         }));
-        return ens;
+        return {
+          data: ens,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -310,14 +316,20 @@ var useEnsResolver = function useEnsResolver() {
           loading: false,
           resolver
         }));
-        return resolver;
+        return {
+          data: resolver,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -424,14 +436,20 @@ var useBlockNumber = function useBlockNumber() {
         blockNumber,
         loading: false
       }));
-      return blockNumber;
+      return {
+        data: blockNumber,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]);
   /* eslint-disable react-hooks/exhaustive-deps */
@@ -500,14 +518,20 @@ var useFeeData = function useFeeData() {
         feeData,
         loading: false
       }));
-      return feeData;
+      return {
+        data: feeData,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]); // Fetch feeData on mount or when chain changes
 
@@ -608,14 +632,20 @@ var useBalance = function useBalance() {
           balance,
           loading: false
         }));
-        return balance;
+        return {
+          data: balance,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -695,8 +725,8 @@ var useConnect = () => {
           loading: false
         }));
         return {
-          connector,
-          data
+          data,
+          error: undefined
         };
       } catch (error_) {
         var error = error_;
@@ -705,7 +735,10 @@ var useConnect = () => {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -766,14 +799,20 @@ var useNetwork = () => {
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           loading: false
         }));
-        return true;
+        return {
+          data: true,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -825,7 +864,10 @@ var useSignMessage = function useSignMessage() {
           signature,
           loading: false
         }));
-        return signature;
+        return {
+          data: signature,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -833,7 +875,10 @@ var useSignMessage = function useSignMessage() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -880,10 +925,8 @@ var useContract = _ref2 => {
 
 var useContractEvent = function useContractEvent(contractConfig, eventName, listener) {
   var {
-    watch
-  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
-    watch: true
-  };
+    once
+  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   var provider = useProvider();
   var webSocketProvider = useWebSocketProvider();
   var contract = useContract(_objectSpread2({
@@ -903,7 +946,7 @@ var useContractEvent = function useContractEvent(contractConfig, eventName, list
     };
 
     var contract_ = ethers.ethers.Contract;
-    if (!watch) contract_.once(eventName, handler);else contract_.on(eventName, handler);
+    if (once) contract_.once(eventName, handler);else contract_.on(eventName, handler);
     return () => {
       contract_.off(eventName, handler);
       return;
@@ -949,14 +992,20 @@ var useContractRead = function useContractRead(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1033,7 +1082,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -1041,7 +1093,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1104,14 +1159,20 @@ var useToken = function useToken() {
           token,
           loading: false
         }));
-        return token;
+        return {
+          data: token,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1190,7 +1251,10 @@ var useTransaction = function useTransaction() {
           loading: false,
           transaction
         }));
-        return transaction;
+        return {
+          data: transaction,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new wagmiPrivate.UserRejectedRequestError();
@@ -1198,7 +1262,10 @@ var useTransaction = function useTransaction() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1247,14 +1314,20 @@ var useWaitForTransaction = function useWaitForTransaction() {
           loading: false,
           receipt
         }));
-        return receipt;
+        return {
+          data: receipt,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 

package/dist/wagmi.esm.js

@@ -223,14 +223,20 @@ var useEnsLookup = function useEnsLookup() {
           ens,
           loading: false
         }));
-        return ens;
+        return {
+          data: ens,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -287,14 +293,20 @@ var useEnsResolver = function useEnsResolver() {
           loading: false,
           resolver
         }));
-        return resolver;
+        return {
+          data: resolver,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -401,14 +413,20 @@ var useBlockNumber = function useBlockNumber() {
         blockNumber,
         loading: false
       }));
-      return blockNumber;
+      return {
+        data: blockNumber,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]);
   /* eslint-disable react-hooks/exhaustive-deps */
@@ -477,14 +495,20 @@ var useFeeData = function useFeeData() {
         feeData,
         loading: false
       }));
-      return feeData;
+      return {
+        data: feeData,
+        error: undefined
+      };
     } catch (error_) {
       var error = error_;
       setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
         error,
         loading: false
       }));
-      return error;
+      return {
+        data: undefined,
+        error
+      };
     }
   }), [provider]); // Fetch feeData on mount or when chain changes
 
@@ -585,14 +609,20 @@ var useBalance = function useBalance() {
           balance,
           loading: false
         }));
-        return balance;
+        return {
+          data: balance,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -672,8 +702,8 @@ var useConnect = () => {
           loading: false
         }));
         return {
-          connector,
-          data
+          data,
+          error: undefined
         };
       } catch (error_) {
         var error = error_;
@@ -682,7 +712,10 @@ var useConnect = () => {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -743,14 +776,20 @@ var useNetwork = () => {
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           loading: false
         }));
-        return true;
+        return {
+          data: true,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -802,7 +841,10 @@ var useSignMessage = function useSignMessage() {
           signature,
           loading: false
         }));
-        return signature;
+        return {
+          data: signature,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new UserRejectedRequestError();
@@ -810,7 +852,10 @@ var useSignMessage = function useSignMessage() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -857,10 +902,8 @@ var useContract = _ref2 => {
 
 var useContractEvent = function useContractEvent(contractConfig, eventName, listener) {
   var {
-    watch
-  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {
-    watch: true
-  };
+    once
+  } = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   var provider = useProvider();
   var webSocketProvider = useWebSocketProvider();
   var contract = useContract(_objectSpread2({
@@ -880,7 +923,7 @@ var useContractEvent = function useContractEvent(contractConfig, eventName, list
     };
 
     var contract_ = ethers.Contract;
-    if (!watch) contract_.once(eventName, handler);else contract_.on(eventName, handler);
+    if (once) contract_.once(eventName, handler);else contract_.on(eventName, handler);
     return () => {
       contract_.off(eventName, handler);
       return;
@@ -926,14 +969,20 @@ var useContractRead = function useContractRead(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1010,7 +1059,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           loading: false,
           response
         }));
-        return response;
+        return {
+          data: response,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new UserRejectedRequestError();
@@ -1018,7 +1070,10 @@ var useContractWrite = function useContractWrite(contractConfig, functionName) {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1081,14 +1136,20 @@ var useToken = function useToken() {
           token,
           loading: false
         }));
-        return token;
+        return {
+          data: token,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1167,7 +1228,10 @@ var useTransaction = function useTransaction() {
           loading: false,
           transaction
         }));
-        return transaction;
+        return {
+          data: transaction,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         if (error_.code === 4001) error = new UserRejectedRequestError();
@@ -1175,7 +1239,10 @@ var useTransaction = function useTransaction() {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 
@@ -1224,14 +1291,20 @@ var useWaitForTransaction = function useWaitForTransaction() {
           loading: false,
           receipt
         }));
-        return receipt;
+        return {
+          data: receipt,
+          error: undefined
+        };
       } catch (error_) {
         var error = error_;
         setState(x => _objectSpread2(_objectSpread2({}, x), {}, {
           error,
           loading: false
         }));
-        return error;
+        return {
+          data: undefined,
+          error
+        };
       }
     });
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "wagmi",
   "description": "React Hooks library for Ethereum",
   "license": "MIT",
-  "version": "0.0.13",
+  "version": "0.0.17",
   "ethereum": "awkweb.eth",
   "repository": "tmm/wagmi",
   "homepage": "https://wagmi-xyz.vercel.app",
@@ -31,7 +31,7 @@
   "dependencies": {
     "@walletconnect/ethereum-provider": "^1.6.6",
     "@ethersproject/providers": "^5.5.1",
-    "wagmi-private": "0.0.13",
+    "wagmi-private": "0.0.17",
     "walletlink": "^2.2.8"
   },
   "devDependencies": {
@@ -41,7 +41,7 @@
     "ethers": "^5.5.1",
     "react": "^17.0.0",
     "walletlink": "^2.2.8",
-    "wagmi-testing": "0.0.13"
+    "wagmi-testing": "0.0.17"
   },
-  "readme": "<p>\n  <a aria-label=\"NPM version\" href=\"https://www.npmjs.com/package/wagmi\">\n    <img\n      alt=\"\"\n      src=\"https://img.shields.io/npm/v/wagmi.svg?style=for-the-badge&labelColor=161c22\"\n    />\n  </a>\n  <a aria-label=\"License\" href=\"/LICENSE\">\n    <img\n      alt=\"\"\n      src=\"https://img.shields.io/npm/l/wagmi.svg?style=for-the-badge&labelColor=161c22\"\n    />\n  </a>\n</p>\n\n# wagmi\n\n**React Hooks library for Ethereum, built on [ethers.js](https://github.com/ethers-io/ethers.js).**\n\n🚀 &nbsp; Hooks for connecting wallets, signing messages, sending transactions, etc.\n\n💼 &nbsp; Built-in wallet connectors for MetaMask, WalletConnect, and Coinbase Wallet\n\n🌀 &nbsp; Auto-refresh data on wallet and network changes\n\n🦄 &nbsp; TypeScript ready\n\n💨 &nbsp; Zero-dependencies (besides ethers.js peer dependency)\n\n🌳 &nbsp; Test suite and documentation\n\n📖 &nbsp; MIT License\n\n## Documentation\n\nVisit https://wagmi-xyz.vercel.app to view the full documentation.\n\n## Usage\n\n1. Install the dependencies.\n\n```bash\npnpm add wagmi ethers\n```\n\n2. Wrap your app with the `Provider` component.\n\n```tsx\nimport { Provider } from 'wagmi'\n\nconst App = () => (\n  <Provider>\n    <YourRoutes />\n  </Provider>\n)\n```\n\n3. Use hooks.\n\n```tsx\nimport { useAccount } from 'wagmi'\n\nconst App = () => {\n  const [{ data, error, loading }, disconnect] = useAccount({\n    fetchEns: true,\n  })\n\n  return ...\n}\n```\n\nEvery component inside the `Provider` is set up with the default `InjectedConnector` for connecting wallets and ethers.js [Default Provider](https://docs.ethers.io/v5/api/providers/#providers-getDefaultProvider) for fetching data.\n\nWant to learn more? Check out the [guides](https://wagmi-xyz.vercel.app/guides/connect-wallet) or browse the [API docs](https://wagmi-xyz.vercel.app/docs/provider).\n\n## Thanks\n\n- [ricmoo.eth](https://twitter.com/ricmoo) for creating and continued work on [ethers.js](https://github.com/ethers-io/ethers.js)\n- [Mirror](https://mirror.xyz) for creating space to do good work\n\n## License\n\nMIT.\n\n<br />\n\nwagmi\n"
+  "readme": "<p>\n  <a aria-label=\"NPM version\" href=\"https://www.npmjs.com/package/wagmi\">\n    <img\n      alt=\"\"\n      src=\"https://img.shields.io/npm/v/wagmi.svg?style=for-the-badge&labelColor=161c22\"\n    />\n  </a>\n  <a aria-label=\"License\" href=\"/LICENSE\">\n    <img\n      alt=\"\"\n      src=\"https://img.shields.io/npm/l/wagmi.svg?style=for-the-badge&labelColor=161c22\"\n    />\n  </a>\n</p>\n\n# wagmi\n\n**React Hooks library for Ethereum, built on [ethers.js](https://github.com/ethers-io/ethers.js).**\n\n🚀 &nbsp; 20+ hooks for working with wallets, ENS, contracts, transactions, signing, etc.\n\n💼 &nbsp; Built-in wallet connectors for MetaMask, WalletConnect, and Coinbase Wallet\n\n🌀 &nbsp; Auto-refresh data on wallet and network changes\n\n🦄 &nbsp; TypeScript ready\n\n💨 &nbsp; Zero-dependencies (besides ethers.js peer dependency)\n\n🌳 &nbsp; Test suite and documentation\n\n📖 &nbsp; MIT License\n\n## Documentation\n\nVisit https://wagmi-xyz.vercel.app to view the full documentation.\n\n## Usage\n\n1. Install the dependencies.\n\n```bash\npnpm add wagmi ethers\n```\n\n2. Wrap your app with the `Provider` component.\n\n```tsx\nimport { Provider } from 'wagmi'\n\nconst App = () => (\n  <Provider>\n    <YourRoutes />\n  </Provider>\n)\n```\n\n3. Use hooks.\n\n```tsx\nimport { useAccount } from 'wagmi'\n\nconst Page = () => {\n  const [{ data, error, loading }, disconnect] = useAccount({\n    fetchEns: true,\n  })\n\n  return ...\n}\n```\n\nEvery component inside the `Provider` is set up with the default `InjectedConnector` for connecting wallets and ethers.js [Default Provider](https://docs.ethers.io/v5/api/providers/#providers-getDefaultProvider) for fetching data.\n\nWant to learn more? Check out the [guides](https://wagmi-xyz.vercel.app/guides/connect-wallet) or browse the [API docs](https://wagmi-xyz.vercel.app/docs/provider).\n\n## Thanks\n\n- [ricmoo.eth](https://twitter.com/ricmoo) for creating and continued work on [ethers.js](https://github.com/ethers-io/ethers.js)\n- [Mirror](https://mirror.xyz) for creating space to do good work\n\n## License\n\nMIT.\n\n<br />\n\nwagmi\n"
 }