@wagmi/core 0.4.7 → 0.5.0-prepare-hooks.0

package/dist/wagmi-core.cjs.dev.js

@@ -2,14 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var client = require('./client-71ece661.cjs.dev.js');
-var base = require('./base-90b7f3e4.cjs.dev.js');
+var getProvider = require('./getProvider-ec251513.cjs.dev.js');
 var ethers$1 = require('ethers/lib/ethers');
 var utils = require('ethers/lib/utils');
 var ethers = require('ethers');
 var shallow = require('zustand/shallow');
 var rpcs = require('./rpcs-f1d24f0e.cjs.dev.js');
-var chains = require('./chains-7e6dc59c.cjs.dev.js');
+var chains = require('./chains-ba6218fb.cjs.dev.js');
 require('zustand/vanilla');
 require('zustand/middleware');
 require('eventemitter3');
@@ -21,6 +20,7 @@ var shallow__default = /*#__PURE__*/_interopDefault(shallow);
 function configureChains(defaultChains, providers) {
   let {
     minQuorum = 1,
+    pollingInterval = 4000,
     targetQuorum = 1,
     stallTimeout
   } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
@@ -66,21 +66,27 @@ function configureChains(defaultChains, providers) {
   return {
     chains,
     provider: _ref2 => {
-      var _defaultChains$, _chainProviders$;
+      var _defaultChains$;
 
       let {
         chainId
       } = _ref2;
       const activeChainId = chainId && chains.some(x => x.id === chainId) ? chainId : (_defaultChains$ = defaultChains[0]) === null || _defaultChains$ === void 0 ? void 0 : _defaultChains$.id;
       const chainProviders = providers_[activeChainId];
-      if (!chainProviders) throw new Error("No providers configured for chain \"".concat(activeChainId, "\""));
-      if (chainProviders.length === 1) return Object.assign(((_chainProviders$ = chainProviders[0]) === null || _chainProviders$ === void 0 ? void 0 : _chainProviders$.call(chainProviders)) || {}, {
-        chains
-      });
+      if (!chainProviders || !chainProviders[0]) throw new Error("No providers configured for chain \"".concat(activeChainId, "\""));
+
+      if (chainProviders.length === 1) {
+        return Object.assign(chainProviders[0](), {
+          chains,
+          pollingInterval
+        });
+      }
+
       return Object.assign(fallbackProvider(targetQuorum, minQuorum, chainProviders, {
         stallTimeout
       }), {
-        chains
+        chains,
+        pollingInterval
       });
     },
     webSocketProvider: _ref3 => {
@@ -247,41 +253,44 @@ async function connect(_ref) {
     chainId,
     connector
   } = _ref;
-  const client$1 = client.getClient();
-  const activeConnector = client$1.connector;
-  if (connector.id === (activeConnector === null || activeConnector === void 0 ? void 0 : activeConnector.id)) throw new base.ConnectorAlreadyConnectedError();
+  const client = getProvider.getClient();
+  const activeConnector = client.connector;
+  if (connector.id === (activeConnector === null || activeConnector === void 0 ? void 0 : activeConnector.id)) throw new getProvider.ConnectorAlreadyConnectedError();
 
   try {
-    client$1.setState(x => ({ ...x,
+    client.setState(x => ({ ...x,
       status: 'connecting'
     }));
     const data = await connector.connect({
       chainId
     });
-    client$1.setLastUsedConnector(connector.id);
-    client$1.setState(x => ({ ...x,
+    client.setLastUsedConnector(connector.id);
+    client.setState(x => ({ ...x,
       connector,
       chains: connector === null || connector === void 0 ? void 0 : connector.chains,
       data,
       status: 'connected'
     }));
-    client$1.storage.setItem('connected', true);
+    client.storage.setItem('connected', true);
     return { ...data,
       connector
     };
   } catch (err) {
-    client$1.setState(x => ({ ...x,
-      status: 'disconnected'
-    }));
+    client.setState(x => {
+      return { ...x,
+        // Keep existing connector connected in case of error
+        status: x.connector ? 'connected' : 'disconnected'
+      };
+    });
     throw err;
   }
 }
 
 async function disconnect() {
-  const client$1 = client.getClient();
-  if (client$1.connector) await client$1.connector.disconnect();
-  client$1.clearState();
-  client$1.storage.removeItem('connected');
+  const client = getProvider.getClient();
+  if (client.connector) await client.connector.disconnect();
+  client.clearState();
+  client.storage.removeItem('connected');
 }
 
 function getContract(_ref) {
@@ -293,34 +302,83 @@ function getContract(_ref) {
   return new ethers.Contract(addressOrName, contractInterface, signerOrProvider);
 }
 
-function getProvider() {
+/**
+ * @description Prepares the parameters required for a contract write transaction.
+ *
+ * Returns config to be passed through to `writeContract`.
+ *
+ * @example
+ * import { prepareWriteContract, writeContract } from '@wagmi/core'
+ *
+ * const config = await prepareWriteContract({
+ *  addressOrName: '0x...',
+ *  contractInterface: wagmiAbi,
+ *  functionName: 'mint',
+ * })
+ * const result = await writeContract(config)
+ */
+async function prepareWriteContract(_ref) {
   let {
-    chainId
-  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  const client$1 = client.getClient();
-  if (chainId && typeof client$1.config.provider === 'function') return client$1.config.provider({
-    chainId
+    addressOrName,
+    args,
+    chainId,
+    contractInterface,
+    functionName,
+    overrides,
+    signer: signer_
+  } = _ref;
+  const signer = signer_ !== null && signer_ !== void 0 ? signer_ : await fetchSigner();
+  if (!signer) throw new getProvider.ConnectorNotFoundError();
+  const contract = getContract({
+    addressOrName,
+    contractInterface,
+    signerOrProvider: signer
   });
-  return client$1.provider;
+  const populateTransactionFn = contract.populateTransaction[functionName];
+
+  if (!populateTransactionFn) {
+    throw new getProvider.ContractMethodDoesNotExistError({
+      addressOrName,
+      functionName
+    });
+  }
+
+  const params = [...(Array.isArray(args) ? args : args ? [args] : []), ...(overrides ? [overrides] : [])];
+  const unsignedTransaction = await populateTransactionFn(...params);
+  const gasLimit = unsignedTransaction.gasLimit || (await signer.estimateGas(unsignedTransaction));
+  return {
+    addressOrName,
+    args,
+    ...(chainId ? {
+      chainId
+    } : {}),
+    contractInterface,
+    functionName,
+    overrides,
+    request: { ...unsignedTransaction,
+      gasLimit
+    },
+    mode: 'prepared'
+  };
 }
 
 function getWebSocketProvider() {
   let {
     chainId
   } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  const client$1 = client.getClient();
-  if (chainId && typeof client$1.config.webSocketProvider === 'function') return client$1.config.webSocketProvider({
+  const client = getProvider.getClient();
+  if (chainId && typeof client.config.webSocketProvider === 'function') return client.config.webSocketProvider({
     chainId
   });
-  return client$1.webSocketProvider;
+  return client.webSocketProvider;
 }
 
 function watchProvider(args, callback) {
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
-  const handleChange = async () => callback(getProvider(args));
+  const handleChange = async () => callback(getProvider.getProvider(args));
 
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       provider
     } = _ref;
@@ -330,11 +388,11 @@ function watchProvider(args, callback) {
 }
 
 function watchWebSocketProvider(args, callback) {
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = async () => callback(getWebSocketProvider(args));
 
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       webSocketProvider
     } = _ref;
@@ -352,7 +410,7 @@ async function readContract(_ref) {
     functionName,
     overrides
   } = _ref;
-  const provider = getProvider({
+  const provider = getProvider.getProvider({
     chainId
   });
   const contract = getContract({
@@ -374,16 +432,16 @@ async function multicall(_ref) {
     contracts,
     overrides
   } = _ref;
-  const provider = getProvider({
+  const provider = getProvider.getProvider({
     chainId
   });
-  if (!provider.chains) throw new base.ProviderChainsNotFound();
+  if (!provider.chains) throw new getProvider.ProviderChainsNotFound();
   const chain = provider.chains.find(chain => chain.id === chainId) || provider.chains[0];
-  if (!chain) throw new base.ProviderChainsNotFound();
-  if (!(chain !== null && chain !== void 0 && chain.multicall)) throw new base.ChainDoesNotSupportMulticallError({
+  if (!chain) throw new getProvider.ProviderChainsNotFound();
+  if (!(chain !== null && chain !== void 0 && chain.multicall)) throw new getProvider.ChainDoesNotSupportMulticallError({
     chain
   });
-  if (typeof (overrides === null || overrides === void 0 ? void 0 : overrides.blockTag) === 'number' && (overrides === null || overrides === void 0 ? void 0 : overrides.blockTag) < chain.multicall.blockCreated) throw new base.ChainDoesNotSupportMulticallError({
+  if (typeof (overrides === null || overrides === void 0 ? void 0 : overrides.blockTag) === 'number' && (overrides === null || overrides === void 0 ? void 0 : overrides.blockTag) < chain.multicall.blockCreated) throw new getProvider.ChainDoesNotSupportMulticallError({
     blockNumber: overrides === null || overrides === void 0 ? void 0 : overrides.blockTag,
     chain
   });
@@ -430,11 +488,9 @@ async function multicall(_ref) {
     } = contracts[i];
 
     if (returnData === '0x') {
-      var _chain$blockExplorers;
-
-      const err = new base.ContractMethodNoResultError({
+      const err = new getProvider.ContractMethodNoResultError({
         addressOrName,
-        blockExplorer: (_chain$blockExplorers = chain.blockExplorers) === null || _chain$blockExplorers === void 0 ? void 0 : _chain$blockExplorers.default,
+        chainId: chain.id,
         functionName
       });
       if (!allowFailure) throw err;
@@ -465,7 +521,7 @@ async function readContracts(_ref) {
   } = _ref;
 
   try {
-    const provider = getProvider();
+    const provider = getProvider.getProvider();
     const contractsByChainId = contracts.reduce((contracts, contract) => {
       var _contract$chainId;
 
@@ -488,7 +544,7 @@ async function readContracts(_ref) {
       return (await Promise.allSettled(promises)).map(result => {
         if (result.status === 'fulfilled') return result.value;
 
-        if (result.reason instanceof base.ChainDoesNotSupportMulticallError) {
+        if (result.reason instanceof getProvider.ChainDoesNotSupportMulticallError) {
           console.warn(result.reason.message);
           throw result.reason;
         }
@@ -499,7 +555,7 @@ async function readContracts(_ref) {
 
     return (await Promise.all(promises)).flat();
   } catch (err) {
-    if (err instanceof base.ContractMethodNoResultError) throw err;
+    if (err instanceof getProvider.ContractMethodNoResultError) throw err;
     const promises = contracts.map(contract => readContract({ ...contract,
       overrides
     }));
@@ -533,7 +589,7 @@ eventName, callback) {
     contract = getContract({
       signerOrProvider: getWebSocketProvider({
         chainId
-      }) || getProvider({
+      }) || getProvider.getProvider({
         chainId
       }),
       ...contractArgs
@@ -542,8 +598,8 @@ eventName, callback) {
   };
 
   watchEvent();
-  const client$1 = client.getClient();
-  const unsubscribe = client$1.subscribe(_ref => {
+  const client = getProvider.getClient();
+  const unsubscribe = client.subscribe(_ref => {
     let {
       provider,
       webSocketProvider
@@ -567,7 +623,7 @@ async function fetchBlockNumber() {
   let {
     chainId
   } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  const provider = getProvider({
+  const provider = getProvider.getProvider({
     chainId
   });
   const blockNumber = await provider.getBlockNumber();
@@ -590,10 +646,10 @@ function watchBlockNumber(args, callback) {
     previousProvider = provider;
   };
 
-  const client$1 = client.getClient();
-  const provider_ = (_client$webSocketProv = client$1.webSocketProvider) !== null && _client$webSocketProv !== void 0 ? _client$webSocketProv : client$1.provider;
+  const client = getProvider.getClient();
+  const provider_ = (_client$webSocketProv = client.webSocketProvider) !== null && _client$webSocketProv !== void 0 ? _client$webSocketProv : client.provider;
   if (args.listen) createListener(provider_);
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       provider,
       webSocketProvider
@@ -624,14 +680,14 @@ function watchBlockNumber(args, callback) {
 }
 
 function watchReadContract(config, callback) {
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = async () => callback(await readContract(config));
 
   const unwatch = config.listenToBlock ? watchBlockNumber({
     listen: true
   }, handleChange) : undefined;
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       provider
     } = _ref;
@@ -644,14 +700,14 @@ function watchReadContract(config, callback) {
 }
 
 function watchReadContracts(config, callback) {
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = async () => callback(await readContracts(config));
 
   const unwatch = config.listenToBlock ? watchBlockNumber({
     listen: true
   }, handleChange) : undefined;
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       provider
     } = _ref;
@@ -663,6 +719,221 @@ function watchReadContracts(config, callback) {
   };
 }
 
+async function fetchEnsAddress(_ref) {
+  let {
+    chainId,
+    name
+  } = _ref;
+  const provider = getProvider.getProvider({
+    chainId
+  });
+  const address = await provider.resolveName(name);
+
+  try {
+    return address ? utils.getAddress(address) : null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+async function fetchEnsAvatar(_ref) {
+  let {
+    addressOrName,
+    chainId
+  } = _ref;
+  const provider = getProvider.getProvider({
+    chainId
+  }); // TODO: Update with more advanced logic
+  // https://github.com/ensdomains/ens-avatar
+
+  const avatar = await provider.getAvatar(addressOrName);
+  return avatar;
+}
+
+async function fetchEnsName(_ref) {
+  let {
+    address,
+    chainId
+  } = _ref;
+  const provider = getProvider.getProvider({
+    chainId
+  });
+  return await provider.lookupAddress(address);
+}
+
+async function fetchEnsResolver(_ref) {
+  let {
+    chainId,
+    name
+  } = _ref;
+  const provider = getProvider.getProvider({
+    chainId
+  });
+  const resolver = await provider.getResolver(name);
+  return resolver;
+}
+
+/**
+ * @description Prepares the parameters required for sending a transaction.
+ *
+ * Returns config to be passed through to `sendTransaction`.
+ *
+ * @example
+ * import { prepareSendTransaction, sendTransaction } from '@wagmi/core'
+ *
+ * const config = await prepareSendTransaction({
+ *  request: {
+ *    to: 'moxey.eth',
+ *    value: parseEther('1'),
+ *  }
+ * })
+ * const result = await sendTransaction(config)
+ */
+async function prepareSendTransaction(_ref) {
+  let {
+    chainId,
+    request,
+    signerOrProvider = getProvider.getProvider()
+  } = _ref;
+  const [to, gasLimit] = await Promise.all([utils.isAddress(request.to) ? Promise.resolve(request.to) : fetchEnsAddress({
+    name: request.to
+  }), request.gasLimit ? Promise.resolve(request.gasLimit) : signerOrProvider.estimateGas(request)]);
+  if (!to) throw new Error('Could not resolve ENS name');
+  return { ...(chainId ? {
+      chainId
+    } : {}),
+    request: { ...request,
+      gasLimit,
+      to
+    },
+    mode: 'prepared'
+  };
+}
+
+/**
+ * @description Function to send a transaction.
+ *
+ * It is recommended to pair this with the `prepareSendTransaction` function to avoid
+ * [UX pitfalls](https://wagmi.sh/docs/prepare-hooks/intro#ux-pitfalls-without-prepare-hooks).
+ *
+ * @example
+ * import { prepareSendTransaction, sendTransaction } from '@wagmi/core'
+ *
+ * const config = await prepareSendTransaction({
+ *  to: 'moxey.eth',
+ *  value: parseEther('1'),
+ * })
+ * const result = await sendTransaction(config)
+ */
+async function sendTransaction(_ref) {
+  let {
+    chainId,
+    mode,
+    request
+  } = _ref;
+
+  /********************************************************************/
+
+  /** START: iOS App Link cautious code.                              */
+
+  /** Do not perform any async operations in this block.              */
+
+  /** Ref: wagmi.sh/docs/prepare-hooks/intro#ios-app-link-constraints */
+
+  /********************************************************************/
+  // `fetchSigner` isn't really "asynchronous" as we have already
+  // initialized the provider upon user connection, so it will return
+  // immediately.
+  const signer = await fetchSigner();
+  if (!signer) throw new getProvider.ConnectorNotFoundError();
+
+  if (mode === 'prepared') {
+    if (!request.gasLimit) throw new Error('`gasLimit` is required');
+    if (!request.to) throw new Error('`to` is required');
+  }
+
+  const {
+    chain: activeChain,
+    chains
+  } = getNetwork();
+  const activeChainId = activeChain === null || activeChain === void 0 ? void 0 : activeChain.id;
+
+  if (chainId && chainId !== (activeChain === null || activeChain === void 0 ? void 0 : activeChain.id)) {
+    var _chains$find$name, _chains$find, _chains$find$name2, _chains$find2;
+
+    throw new getProvider.ChainMismatchError({
+      activeChain: (_chains$find$name = (_chains$find = chains.find(x => x.id === activeChainId)) === null || _chains$find === void 0 ? void 0 : _chains$find.name) !== null && _chains$find$name !== void 0 ? _chains$find$name : "Chain ".concat(activeChainId),
+      targetChain: (_chains$find$name2 = (_chains$find2 = chains.find(x => x.id === chainId)) === null || _chains$find2 === void 0 ? void 0 : _chains$find2.name) !== null && _chains$find$name2 !== void 0 ? _chains$find$name2 : "Chain ".concat(chainId)
+    });
+  }
+
+  try {
+    // Why don't we just use `signer.sendTransaction`?
+    // The `signer.sendTransaction` method performs async
+    // heavy operations (such as fetching block number)
+    // which is not really needed for our case.
+    // Having async heavy operations has side effects
+    // when using it in a click handler (iOS deep linking issues,
+    // delay to open wallet, etc).
+    const uncheckedSigner = signer.connectUnchecked();
+    const {
+      hash,
+      wait
+    } = await uncheckedSigner.sendTransaction(request);
+    /********************************************************************/
+
+    /** END: iOS App Link cautious code.                                */
+
+    /** Go nuts!                                                        */
+
+    /********************************************************************/
+
+    return {
+      hash,
+      wait
+    };
+  } catch (error) {
+    if (error.code === 4001) throw new getProvider.UserRejectedRequestError(error);
+    throw error;
+  }
+}
+
+async function waitForTransaction(_ref) {
+  let {
+    chainId,
+    confirmations,
+    hash,
+    timeout,
+    wait: wait_
+  } = _ref;
+  let promise;
+
+  if (hash) {
+    const provider = getProvider.getProvider({
+      chainId
+    });
+    promise = provider.waitForTransaction(hash, confirmations, timeout);
+  } else if (wait_) promise = wait_(confirmations);else throw new Error('hash or wait is required');
+
+  return await promise;
+}
+
+/**
+ * @description Function to call a contract write method.
+ *
+ * It is recommended to pair this with the {@link prepareWriteContract} function
+ * to avoid [UX pitfalls](https://wagmi.sh/docs/prepare-hooks/intro#ux-pitfalls-without-prepare-hooks).
+ *
+ * @example
+ * import { prepareWriteContract, writeContract } from '@wagmi/core'
+ *
+ * const config = await prepareWriteContract({
+ *   addressOrName: '0x...',
+ *   contractInterface: wagmiAbi,
+ *   functionName: 'mint',
+ * })
+ * const result = await writeContract(config)
+ */
 async function writeContract(_ref) {
   let {
     addressOrName,
@@ -670,49 +941,61 @@ async function writeContract(_ref) {
     chainId,
     contractInterface,
     functionName,
+    mode,
     overrides,
-    signerOrProvider
+    request: request_
   } = _ref;
-  const {
-    connector
-  } = client.getClient();
-  if (!connector) throw new base.ConnectorNotFoundError();
-  const params = [...(Array.isArray(args) ? args : args ? [args] : []), ...(overrides ? [overrides] : [])];
 
-  try {
-    var _chain;
+  /********************************************************************/
 
-    let chain;
+  /** START: iOS App Link cautious code.                              */
 
-    if (chainId) {
-      const activeChainId = await connector.getChainId(); // Try to switch chain to provided `chainId`
+  /** Do not perform any async operations in this block.              */
 
-      if (chainId !== activeChainId) {
-        var _connector$chains$fin, _connector$chains$fin2, _connector$chains$fin3, _connector$chains$fin4;
+  /** Ref: wagmi.sh/docs/prepare-hooks/intro#ios-app-link-constraints */
 
-        if (connector.switchChain) chain = await connector.switchChain(chainId);else throw new base.ChainMismatchError({
-          activeChain: (_connector$chains$fin = (_connector$chains$fin2 = connector.chains.find(x => x.id === activeChainId)) === null || _connector$chains$fin2 === void 0 ? void 0 : _connector$chains$fin2.name) !== null && _connector$chains$fin !== void 0 ? _connector$chains$fin : "Chain ".concat(activeChainId),
-          targetChain: (_connector$chains$fin3 = (_connector$chains$fin4 = connector.chains.find(x => x.id === chainId)) === null || _connector$chains$fin4 === void 0 ? void 0 : _connector$chains$fin4.name) !== null && _connector$chains$fin3 !== void 0 ? _connector$chains$fin3 : "Chain ".concat(chainId)
-        });
-      }
-    }
+  /********************************************************************/
+  const signer = await fetchSigner();
+  if (!signer) throw new getProvider.ConnectorNotFoundError();
+  const {
+    chain: activeChain,
+    chains
+  } = getNetwork();
+  const activeChainId = activeChain === null || activeChain === void 0 ? void 0 : activeChain.id;
 
-    const signer = await connector.getSigner({
-      chainId: (_chain = chain) === null || _chain === void 0 ? void 0 : _chain.id
-    });
-    const contract = getContract({
-      addressOrName,
-      contractInterface,
-      signerOrProvider
+  if (chainId && chainId !== activeChainId) {
+    var _chains$find$name, _chains$find, _chains$find$name2, _chains$find2;
+
+    throw new getProvider.ChainMismatchError({
+      activeChain: (_chains$find$name = (_chains$find = chains.find(x => x.id === activeChainId)) === null || _chains$find === void 0 ? void 0 : _chains$find.name) !== null && _chains$find$name !== void 0 ? _chains$find$name : "Chain ".concat(activeChainId),
+      targetChain: (_chains$find$name2 = (_chains$find2 = chains.find(x => x.id === chainId)) === null || _chains$find2 === void 0 ? void 0 : _chains$find2.name) !== null && _chains$find$name2 !== void 0 ? _chains$find$name2 : "Chain ".concat(chainId)
     });
-    const contractWithSigner = contract.connect(signer);
-    const contractFunction = contractWithSigner[functionName];
-    if (!contractFunction) console.warn("\"".concat(functionName, "\" does not exist in interface for contract \"").concat(addressOrName, "\""));
-    return await contractFunction(...params);
-  } catch (error) {
-    if (error.code === 4001) throw new base.UserRejectedRequestError(error);
-    throw error;
   }
+
+  if (mode === 'prepared') {
+    if (!request_) throw new Error('`request` is required');
+  }
+
+  const request = mode === 'dangerouslyUnprepared' ? (await prepareWriteContract({
+    addressOrName,
+    args,
+    contractInterface,
+    functionName,
+    overrides
+  })).request : request_;
+  const transaction = await sendTransaction({
+    request,
+    mode: 'prepared'
+  });
+  /********************************************************************/
+
+  /** END: iOS App Link cautious code.                                */
+
+  /** Go nuts!                                                        */
+
+  /********************************************************************/
+
+  return transaction;
 }
 
 async function fetchBalance(_ref) {
@@ -724,8 +1007,8 @@ async function fetchBalance(_ref) {
     formatUnits: unit = 'ether',
     token
   } = _ref;
-  const client$1 = client.getClient();
-  const provider = getProvider({
+  const client = getProvider.getClient();
+  const provider = getProvider.getProvider({
     chainId
   });
 
@@ -765,7 +1048,7 @@ async function fetchBalance(_ref) {
     };
   }
 
-  const chains = [...(client$1.provider.chains || []), ...((_client$chains = client$1.chains) !== null && _client$chains !== void 0 ? _client$chains : [])];
+  const chains = [...(client.provider.chains || []), ...((_client$chains = client.chains) !== null && _client$chains !== void 0 ? _client$chains : [])];
   const value = await provider.getBalance(addressOrName);
   const chain = chains.find(x => x.id === provider.network.chainId);
   return {
@@ -780,8 +1063,8 @@ async function fetchBalance(_ref) {
 async function fetchSigner() {
   var _client$connector, _client$connector$get;
 
-  const client$1 = client.getClient();
-  const signer = (await ((_client$connector = client$1.connector) === null || _client$connector === void 0 ? void 0 : (_client$connector$get = _client$connector.getSigner) === null || _client$connector$get === void 0 ? void 0 : _client$connector$get.call(_client$connector))) || null;
+  const client = getProvider.getClient();
+  const signer = (await ((_client$connector = client.connector) === null || _client$connector === void 0 ? void 0 : (_client$connector$get = _client$connector.getSigner) === null || _client$connector$get === void 0 ? void 0 : _client$connector$get.call(_client$connector))) || null;
   return signer;
 }
 
@@ -790,7 +1073,7 @@ function getAccount() {
     data,
     connector,
     status
-  } = client.getClient();
+  } = getProvider.getClient();
 
   switch (status) {
     case 'connected':
@@ -842,10 +1125,10 @@ function getAccount() {
 function getNetwork() {
   var _client$data, _client$data$chain, _client$chains, _find, _client$data2;
 
-  const client$1 = client.getClient();
-  const chainId = (_client$data = client$1.data) === null || _client$data === void 0 ? void 0 : (_client$data$chain = _client$data.chain) === null || _client$data$chain === void 0 ? void 0 : _client$data$chain.id;
-  const activeChains = (_client$chains = client$1.chains) !== null && _client$chains !== void 0 ? _client$chains : [];
-  const activeChain = (_find = [...(client$1.provider.chains || []), ...activeChains].find(x => x.id === chainId)) !== null && _find !== void 0 ? _find : {
+  const client = getProvider.getClient();
+  const chainId = (_client$data = client.data) === null || _client$data === void 0 ? void 0 : (_client$data$chain = _client$data.chain) === null || _client$data$chain === void 0 ? void 0 : _client$data$chain.id;
+  const activeChains = (_client$chains = client.chains) !== null && _client$chains !== void 0 ? _client$chains : [];
+  const activeChain = (_find = [...(client.provider.chains || []), ...activeChains].find(x => x.id === chainId)) !== null && _find !== void 0 ? _find : {
     id: chainId,
     name: "Chain ".concat(chainId),
     network: "".concat(chainId),
@@ -855,7 +1138,7 @@ function getNetwork() {
   };
   return {
     chain: chainId ? { ...activeChain,
-      ...((_client$data2 = client$1.data) === null || _client$data2 === void 0 ? void 0 : _client$data2.chain),
+      ...((_client$data2 = client.data) === null || _client$data2 === void 0 ? void 0 : _client$data2.chain),
       id: chainId
     } : undefined,
     chains: activeChains
@@ -865,10 +1148,10 @@ function getNetwork() {
 async function signMessage(args) {
   try {
     const signer = await fetchSigner();
-    if (!signer) throw new base.ConnectorNotFoundError();
+    if (!signer) throw new getProvider.ConnectorNotFoundError();
     return await signer.signMessage(args.message);
   } catch (error) {
-    if (error.code === 4001) throw new base.UserRejectedRequestError(error);
+    if (error.code === 4001) throw new getProvider.UserRejectedRequestError(error);
     throw error;
   }
 }
@@ -879,42 +1162,32 @@ async function signTypedData(_ref) {
     types,
     value
   } = _ref;
+  const signer = await fetchSigner();
+  if (!signer) throw new getProvider.ConnectorNotFoundError();
   const {
-    connector
-  } = client.getClient();
-  if (!connector) throw new base.ConnectorNotFoundError();
-
-  try {
-    var _chain;
-
-    const {
-      chainId
-    } = domain;
-    let chain;
+    chain: activeChain,
+    chains
+  } = getNetwork();
+  const {
+    chainId: chainId_
+  } = domain;
 
-    if (chainId) {
-      const chainId_ = base.normalizeChainId(chainId);
-      const activeChainId = await connector.getChainId(); // Try to switch chain to provided `chainId`
+  if (chainId_) {
+    const chainId = getProvider.normalizeChainId(chainId_);
+    const activeChainId = activeChain === null || activeChain === void 0 ? void 0 : activeChain.id;
 
-      if (chainId !== activeChainId) {
-        var _connector$chains$fin, _connector$chains$fin2, _connector$chains$fin3, _connector$chains$fin4;
+    if (chainId !== (activeChain === null || activeChain === void 0 ? void 0 : activeChain.id)) {
+      var _chains$find$name, _chains$find, _chains$find$name2, _chains$find2;
 
-        if (connector.switchChain) chain = await connector.switchChain(chainId_);else throw new base.ChainMismatchError({
-          activeChain: (_connector$chains$fin = (_connector$chains$fin2 = connector.chains.find(x => x.id === activeChainId)) === null || _connector$chains$fin2 === void 0 ? void 0 : _connector$chains$fin2.name) !== null && _connector$chains$fin !== void 0 ? _connector$chains$fin : "Chain ".concat(activeChainId),
-          targetChain: (_connector$chains$fin3 = (_connector$chains$fin4 = connector.chains.find(x => x.id === chainId_)) === null || _connector$chains$fin4 === void 0 ? void 0 : _connector$chains$fin4.name) !== null && _connector$chains$fin3 !== void 0 ? _connector$chains$fin3 : "Chain ".concat(chainId_)
-        });
-      }
+      throw new getProvider.ChainMismatchError({
+        activeChain: (_chains$find$name = (_chains$find = chains.find(x => x.id === activeChainId)) === null || _chains$find === void 0 ? void 0 : _chains$find.name) !== null && _chains$find$name !== void 0 ? _chains$find$name : "Chain ".concat(activeChainId),
+        targetChain: (_chains$find$name2 = (_chains$find2 = chains.find(x => x.id === chainId)) === null || _chains$find2 === void 0 ? void 0 : _chains$find2.name) !== null && _chains$find$name2 !== void 0 ? _chains$find$name2 : "Chain ".concat(chainId)
+      });
     }
+  } // Method name may be changed in the future, see https://docs.ethers.io/v5/api/signer/#Signer-signTypedData
 
-    const signer = await connector.getSigner({
-      chainId: (_chain = chain) === null || _chain === void 0 ? void 0 : _chain.id
-    }); // Method name may be changed in the future, see https://docs.ethers.io/v5/api/signer/#Signer-signTypedData
 
-    return await signer._signTypedData(domain, types, value);
-  } catch (error) {
-    if (error.code === 4001) throw new base.UserRejectedRequestError(error);
-    throw error;
-  }
+  return await signer._signTypedData(domain, types, value);
 }
 
 async function switchNetwork(_ref) {
@@ -923,9 +1196,9 @@ async function switchNetwork(_ref) {
   } = _ref;
   const {
     connector
-  } = client.getClient();
-  if (!connector) throw new base.ConnectorNotFoundError();
-  if (!connector.switchChain) throw new base.SwitchChainNotSupportedError({
+  } = getProvider.getClient();
+  if (!connector) throw new getProvider.ConnectorNotFoundError();
+  if (!connector.switchChain) throw new getProvider.SwitchChainNotSupportedError({
     connector
   });
   return await connector.switchChain(chainId);
@@ -935,11 +1208,11 @@ function watchAccount(callback) {
   let {
     selector = x => x
   } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = () => callback(getAccount());
 
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     let {
       data,
       connector,
@@ -960,11 +1233,11 @@ function watchNetwork(callback) {
   let {
     selector = x => x
   } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = () => callback(getNetwork());
 
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     var _data$chain;
 
     let {
@@ -982,11 +1255,11 @@ function watchNetwork(callback) {
 }
 
 function watchSigner(callback) {
-  const client$1 = client.getClient();
+  const client = getProvider.getClient();
 
   const handleChange = async () => callback(await fetchSigner());
 
-  const unsubscribe = client$1.subscribe(_ref => {
+  const unsubscribe = client.subscribe(_ref => {
     var _data$chain;
 
     let {
@@ -1004,66 +1277,12 @@ function watchSigner(callback) {
   return unsubscribe;
 }
 
-async function fetchEnsAddress(_ref) {
-  let {
-    chainId,
-    name
-  } = _ref;
-  const provider = getProvider({
-    chainId
-  });
-  const address = await provider.resolveName(name);
-
-  try {
-    return address ? utils.getAddress(address) : null;
-  } catch (_error) {
-    return null;
-  }
-}
-
-async function fetchEnsAvatar(_ref) {
-  let {
-    addressOrName,
-    chainId
-  } = _ref;
-  const provider = getProvider({
-    chainId
-  }); // TODO: Update with more advanced logic
-  // https://github.com/ensdomains/ens-avatar
-
-  const avatar = await provider.getAvatar(addressOrName);
-  return avatar;
-}
-
-async function fetchEnsName(_ref) {
-  let {
-    address,
-    chainId
-  } = _ref;
-  const provider = getProvider({
-    chainId
-  });
-  return await provider.lookupAddress(address);
-}
-
-async function fetchEnsResolver(_ref) {
-  let {
-    chainId,
-    name
-  } = _ref;
-  const provider = getProvider({
-    chainId
-  });
-  const resolver = await provider.getResolver(name);
-  return resolver;
-}
-
 async function fetchFeeData() {
   let {
     chainId,
     formatUnits: units = 'wei'
   } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  const provider = getProvider({
+  const provider = getProvider.getProvider({
     chainId
   });
   const feeData = await provider.getFeeData();
@@ -1083,102 +1302,58 @@ async function fetchToken(_ref) {
     chainId,
     formatUnits: units = 'ether'
   } = _ref;
-  const provider = getProvider({
+  const erc20Config = {
+    addressOrName: address,
+    contractInterface: erc20ABI,
     chainId
+  };
+  const [decimals, name, symbol, totalSupply] = await readContracts({
+    allowFailure: false,
+    contracts: [{ ...erc20Config,
+      functionName: 'decimals'
+    }, { ...erc20Config,
+      functionName: 'name'
+    }, { ...erc20Config,
+      functionName: 'symbol'
+    }, { ...erc20Config,
+      functionName: 'totalSupply'
+    }]
   });
-  const contract = new ethers$1.Contract(address, erc20ABI, provider);
-  const [symbol, decimals, totalSupply] = await Promise.all([contract.symbol(), contract.decimals(), contract.totalSupply()]);
-  const token = {
+  return {
     address,
     decimals,
+    name,
     symbol,
     totalSupply: {
       formatted: utils.formatUnits(totalSupply, units),
       value: totalSupply
     }
   };
-  return token;
-}
-
-async function sendTransaction(_ref) {
-  let {
-    chainId,
-    request
-  } = _ref;
-  const {
-    connector
-  } = client.getClient();
-  if (!connector) throw new base.ConnectorNotFoundError();
-
-  try {
-    var _chain;
-
-    let chain;
-
-    if (chainId) {
-      const activeChainId = await connector.getChainId(); // Try to switch chain to provided `chainId`
-
-      if (chainId !== activeChainId) {
-        var _connector$chains$fin, _connector$chains$fin2, _connector$chains$fin3, _connector$chains$fin4;
-
-        if (connector.switchChain) chain = await connector.switchChain(chainId);else throw new base.ChainMismatchError({
-          activeChain: (_connector$chains$fin = (_connector$chains$fin2 = connector.chains.find(x => x.id === activeChainId)) === null || _connector$chains$fin2 === void 0 ? void 0 : _connector$chains$fin2.name) !== null && _connector$chains$fin !== void 0 ? _connector$chains$fin : "Chain ".concat(activeChainId),
-          targetChain: (_connector$chains$fin3 = (_connector$chains$fin4 = connector.chains.find(x => x.id === chainId)) === null || _connector$chains$fin4 === void 0 ? void 0 : _connector$chains$fin4.name) !== null && _connector$chains$fin3 !== void 0 ? _connector$chains$fin3 : "Chain ".concat(chainId)
-        });
-      }
-    }
-
-    const signer = await connector.getSigner({
-      chainId: (_chain = chain) === null || _chain === void 0 ? void 0 : _chain.id
-    });
-    return await signer.sendTransaction(request);
-  } catch (error) {
-    if (error.code === 4001) throw new base.UserRejectedRequestError(error);
-    throw error;
-  }
-}
-
-async function waitForTransaction(_ref) {
-  let {
-    chainId,
-    confirmations,
-    hash,
-    timeout,
-    wait: wait_
-  } = _ref;
-  let promise;
-
-  if (hash) {
-    const provider = getProvider({
-      chainId
-    });
-    promise = provider.waitForTransaction(hash, confirmations, timeout);
-  } else if (wait_) promise = wait_(confirmations);else throw new Error('hash or wait is required');
-
-  return await promise;
 }
 
-exports.Client = client.Client;
-exports.InjectedConnector = client.InjectedConnector;
-exports.createClient = client.createClient;
-exports.createStorage = client.createStorage;
-exports.noopStorage = client.noopStorage;
-exports.AddChainError = base.AddChainError;
-exports.ChainDoesNotSupportMulticallError = base.ChainDoesNotSupportMulticallError;
-exports.ChainMismatchError = base.ChainMismatchError;
-exports.ChainNotConfiguredError = base.ChainNotConfiguredError;
-exports.Connector = base.Connector;
-exports.ConnectorAlreadyConnectedError = base.ConnectorAlreadyConnectedError;
-exports.ConnectorNotFoundError = base.ConnectorNotFoundError;
-exports.ContractMethodNoResultError = base.ContractMethodNoResultError;
-exports.ProviderChainsNotFound = base.ProviderChainsNotFound;
-exports.ProviderRpcError = base.ProviderRpcError;
-exports.ResourceUnavailableError = base.ResourceUnavailableError;
-exports.RpcError = base.RpcError;
-exports.SwitchChainError = base.SwitchChainError;
-exports.SwitchChainNotSupportedError = base.SwitchChainNotSupportedError;
-exports.UserRejectedRequestError = base.UserRejectedRequestError;
-exports.normalizeChainId = base.normalizeChainId;
+exports.AddChainError = getProvider.AddChainError;
+exports.ChainDoesNotSupportMulticallError = getProvider.ChainDoesNotSupportMulticallError;
+exports.ChainMismatchError = getProvider.ChainMismatchError;
+exports.ChainNotConfiguredError = getProvider.ChainNotConfiguredError;
+exports.Client = getProvider.Client;
+exports.Connector = getProvider.Connector;
+exports.ConnectorAlreadyConnectedError = getProvider.ConnectorAlreadyConnectedError;
+exports.ConnectorNotFoundError = getProvider.ConnectorNotFoundError;
+exports.ContractMethodDoesNotExistError = getProvider.ContractMethodDoesNotExistError;
+exports.ContractMethodNoResultError = getProvider.ContractMethodNoResultError;
+exports.InjectedConnector = getProvider.InjectedConnector;
+exports.ProviderChainsNotFound = getProvider.ProviderChainsNotFound;
+exports.ProviderRpcError = getProvider.ProviderRpcError;
+exports.ResourceUnavailableError = getProvider.ResourceUnavailableError;
+exports.RpcError = getProvider.RpcError;
+exports.SwitchChainError = getProvider.SwitchChainError;
+exports.SwitchChainNotSupportedError = getProvider.SwitchChainNotSupportedError;
+exports.UserRejectedRequestError = getProvider.UserRejectedRequestError;
+exports.createClient = getProvider.createClient;
+exports.createStorage = getProvider.createStorage;
+exports.getProvider = getProvider.getProvider;
+exports.noopStorage = getProvider.noopStorage;
+exports.normalizeChainId = getProvider.normalizeChainId;
 exports.alchemyRpcUrls = rpcs.alchemyRpcUrls;
 exports.infuraRpcUrls = rpcs.infuraRpcUrls;
 exports.publicRpcUrls = rpcs.publicRpcUrls;
@@ -1206,9 +1381,10 @@ exports.fetchToken = fetchToken;
 exports.getAccount = getAccount;
 exports.getContract = getContract;
 exports.getNetwork = getNetwork;
-exports.getProvider = getProvider;
 exports.getWebSocketProvider = getWebSocketProvider;
 exports.parseContractResult = parseContractResult;
+exports.prepareSendTransaction = prepareSendTransaction;
+exports.prepareWriteContract = prepareWriteContract;
 exports.readContract = readContract;
 exports.readContracts = readContracts;
 exports.sendTransaction = sendTransaction;