From 0d36f839c3f7f6f2dbd2b8a09948dd6b242db877 Mon Sep 17 00:00:00 2001
From: ricmoo <me@ricmoo.com>
Date: Sun, 21 May 2017 20:37:29 -0400
Subject: [PATCH] Updated documents to include ENS.

---
 docs/build/html/.buildinfo           |   2 +-
 docs/build/html/api-advanced.html    |  12 ++--
 docs/build/html/api-contract.html    |  24 ++++----
 docs/build/html/api-providers.html   |  89 ++++++++++++++++-----------
 docs/build/html/api-utils.html       |   8 +--
 docs/build/html/api-wallet.html      |  12 ++--
 docs/build/html/api.html             |   8 +--
 docs/build/html/cookbook.html        |   8 +--
 docs/build/html/genindex.html        |   8 +--
 docs/build/html/getting-started.html |   8 +--
 docs/build/html/index.html           |   8 +--
 docs/build/html/notes.html           |   9 +--
 docs/build/html/objects.inv          | Bin 774 -> 774 bytes
 docs/build/html/search.html          |   8 +--
 docs/build/html/searchindex.js       |   2 +-
 docs/build/html/testing.html         |   8 +--
 docs/source/api-contract.rst         |   6 +-
 docs/source/api-providers.rst        |  53 ++++++++++------
 docs/source/api-wallet.rst           |   4 +-
 docs/source/conf.py                  |   4 +-
 20 files changed, 158 insertions(+), 123 deletions(-)

diff --git a/docs/build/html/.buildinfo b/docs/build/html/.buildinfo
index 2eff349a9..475df3778 100644
--- a/docs/build/html/.buildinfo
+++ b/docs/build/html/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 6a62ca43dcc6af574ac04a9f0b9d6b4e
+config: 37414eb22e627195a5e1926fb6f4cd20
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/build/html/api-advanced.html b/docs/build/html/api-advanced.html
index 1c4ec4eb2..3da89271a 100644
--- a/docs/build/html/api-advanced.html
+++ b/docs/build/html/api-advanced.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Low-Level API &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Low-Level API &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="next" title="Cookbook" href="cookbook.html"/>
         <link rel="prev" title="Utilities" href="api-utils.html"/> 
 
@@ -64,7 +64,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -420,7 +420,7 @@ is designed for developers that are sub-classing Provider.</p>
 <dt><sup>prototype</sup> . perform ( method , params )</dt>
 <dd>The only method needed to override in a subclass. All values are sanitized
 and defaults populated in params and the result is sanitized before returning.
-Returns a <span class="xref std std-ref">Promise</span>, see the example below for overview of
+Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a>, see the example below for overview of
 <em>method</em> and <em>params</em>.</dd>
 </dl>
 </div>
@@ -431,7 +431,7 @@ Returns a <span class="xref std std-ref">Promise</span>, see the example below f
 <dd>Set up <em>childProvider</em> as an provider, inheriting the parent prototype and
 set up a prototype.inherits on the <em>childProvider</em>.</dd>
 <dt><sup>Provider</sup> . fetchJSON ( url , body , processFunc )</dt>
-<dd>Convenience method for returning a <span class="xref std std-ref">Promise</span> with the result of fetching JSON
+<dd>Convenience method for returning a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the result of fetching JSON
 from a <em>url</em> with an optional <em>body</em>. The optional <em>processFunc</em> is called on
 the parsed JSON before being passed to the Promise&#8217;s resolve. (throwing an error
 in the <em>processFunc</em> will cause the Promise to reject)</dd>
@@ -728,7 +728,7 @@ invalid RLP-coded data)</dd>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/api-contract.html b/docs/build/html/api-contract.html
index 790edaa20..a2a13edf0 100644
--- a/docs/build/html/api-contract.html
+++ b/docs/build/html/api-contract.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Contracts &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Contracts &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="up" title="Application Programming Interface (API)" href="api.html"/>
         <link rel="next" title="Utilities" href="api-utils.html"/>
         <link rel="prev" title="Providers API" href="api-providers.html"/> 
@@ -65,7 +65,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -184,8 +184,8 @@ which is usually generated by a compiler, such as Solidity.</p>
 <div class="section" id="connecting-to-a-contract">
 <h2>Connecting to a Contract<a class="headerlink" href="#connecting-to-a-contract" title="Permalink to this headline">¶</a></h2>
 <dl class="docutils">
-<dt>new <sup>ethers</sup> . Contract ( address , interface , providerOrSigner )</dt>
-<dd><p class="first">Connects to the contract at <em>address</em> defined by <em>interface</em>, which
+<dt>new <sup>ethers</sup> . Contract ( addressOrName , interface , providerOrSigner )</dt>
+<dd><p class="first">Connects to the contract at <em>addressOrName</em> defined by <em>interface</em>, which
 may be a JSON string or the parsed object.</p>
 <p>The <em>providerOrSigner</em> may be any instance of the following:</p>
 <dl class="last docutils">
@@ -207,10 +207,10 @@ transaction occurs and to defer address behaviour.</dd>
 <h2>Prototype<a class="headerlink" href="#prototype" title="Permalink to this headline">¶</a></h2>
 <p>The prototype will contain all the methods and events defined in the
 <strong>interface</strong>.</p>
-<p>The result of all contant methods are a <span class="xref std std-ref">Promise</span> which
+<p>The result of all contant methods are a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> which
 resolve to the result as a tuple, optionally with the parameters
 accessible by name, if named in the ABI.</p>
-<p>The result of all non-constant methods are a <span class="xref std std-ref">Promise</span>
+<p>The result of all non-constant methods are a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a>
 which resolve to the <a class="reference internal" href="api-providers.html#transactionrequest"><span class="std std-ref">transaction</span></a> that
 was sent to the network.</p>
 <p>Name collisions with the built-in properties (below) will not be overwritten.
@@ -222,7 +222,7 @@ function with a given name will be available. (In the future this will
 be addressed by adding parameter explicit calls).</p>
 <dl class="docutils">
 <dt><sup>prototype</sup> . address</dt>
-<dd>The address of the contract.</dd>
+<dd>The address (or ENS name) of the contract.</dd>
 <dt><sup>prototype</sup> . interface</dt>
 <dd>The <a class="reference internal" href="api-advanced.html#api-interface"><span class="std std-ref">Interface</span></a> meta-class of the parsed
 ABI. Generally, this should not need to be accessed directly.</dd>
@@ -477,7 +477,7 @@ deferring the address, signing and sending transactions.</p>
 <dl class="docutils">
 <dt><sup>object</sup> . getAddress()</dt>
 <dd><p class="first"><em>Required.</em></p>
-<p class="last">Which must return a valid address or a <span class="xref std std-ref">Promise</span> which will resolve to a valid
+<p class="last">Which must return a valid address or a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> which will resolve to a valid
 address or reject an error.</p>
 </dd>
 <dt><sup>object</sup> . provider</dt>
@@ -489,14 +489,14 @@ calls, listen for events and possibly send transaction.</p>
 <dd><p class="first"><em>Optional.</em></p>
 <p>If this is not defined, the provider is queries directly, after populating
 the address using <em>getAddress()</em>.</p>
-<p class="last">The result must be a <span class="xref std std-ref">Promise</span> which resolves to the
+<p class="last">The result must be a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> which resolves to the
 <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a> estimated gas cost.</p>
 </dd>
 <dt><sup>object</sup> . sendTransaction ( transaction )</dt>
 <dd><p class="first"><em>Optional.</em></p>
 <p>If this is defined, it is called instead of sign and is expected to
 populate <em>nonce</em>, <em>gasLimit</em> and <em>gasPrice</em>.</p>
-<p class="last">The result must be a <span class="xref std std-ref">Promise</span> which resolves to the sent transaction, or
+<p class="last">The result must be a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> which resolves to the sent transaction, or
 rejects on failure.</p>
 </dd>
 <dt><sup>object</sup> . sign ( transaction )</dt>
@@ -591,7 +591,7 @@ provider to send it to the network.</p>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/api-providers.html b/docs/build/html/api-providers.html
index 8232665eb..eb441cd23 100644
--- a/docs/build/html/api-providers.html
+++ b/docs/build/html/api-providers.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Providers API &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Providers API &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="up" title="Application Programming Interface (API)" href="api.html"/>
         <link rel="next" title="Contracts" href="api-contract.html"/>
         <link rel="prev" title="Wallets" href="api-wallet.html"/> 
@@ -65,7 +65,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -286,7 +286,7 @@ the providers attached)</dd>
 <dd>The JSON-RPC URL the provider is connected to</dd>
 <dt><sup>prototype</sup> . send ( method , params )</dt>
 <dd>Send the JSON-RPC <em>method</em> with <em>params</em>. This is useful for calling
-non-standard or less common JSON-RPC methods. A <span class="xref std std-ref">Promise</span> is
+non-standard or less common JSON-RPC methods. A <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> is
 returned which will resolve to the parsed JSON result.</dd>
 </dl>
 </div>
@@ -309,17 +309,20 @@ returned which will resolve to the parsed JSON result.</dd>
 <div class="section" id="account-actions">
 <h2>Account Actions<a class="headerlink" href="#account-actions" title="Permalink to this headline">¶</a></h2>
 <dl class="docutils">
-<dt><sup>prototype</sup> . getBalance ( address [ , blockTag ] )</dt>
-<dd><p class="first">Returns a <span class="xref std std-ref">Promise</span> with the balance (as a <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a>) of
-<em>address</em> at <em>blockTag</em>. (See: <a class="reference external" href="blocktag">Block Tags</a>)</p>
+<dt><sup>prototype</sup> . getBalance ( addressOrName [ , blockTag ] )</dt>
+<dd><p class="first">Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the balance (as a <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a>) of
+<em>addressOrName</em> at <em>blockTag</em>. (See: <a class="reference external" href="blocktag">Block Tags</a>)</p>
 <p class="last"><strong>default:</strong> <em>blockTag</em>=&#8221;latest&#8221;</p>
 </dd>
-<dt><sup>prototype</sup> . getTransactionCount ( address [ , blockTag ] )</dt>
-<dd><p class="first">Returns a <span class="xref std std-ref">Promise</span> with the number of sent transactions (as a Number) from
-<em>address</em> at <em>blockTag</em>. This is also the nonce required to send a new
+<dt><sup>prototype</sup> . getTransactionCount ( addressOrName [ , blockTag ] )</dt>
+<dd><p class="first">Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the number of sent transactions (as a Number) from
+<em>addressOrName</em> at <em>blockTag</em>. This is also the nonce required to send a new
 transaction. (See: <a class="reference external" href="blocktag">Block Tags</a>)</p>
 <p class="last"><strong>default:</strong> <em>blockTag</em>=&#8221;latest&#8221;</p>
 </dd>
+<dt><sup>prototype</sup> . resolveName ( ensName )</dt>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the address (or null) of that the <em>ensName</em> resolves
+to.</dd>
 </dl>
 <div class="section" id="id3">
 <h3><em>Examples</em><a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
@@ -338,6 +341,10 @@ transaction. (See: <a class="reference external" href="blocktag">Block Tags</a>)
 <span class="n">provider</span><span class="o">.</span><span class="n">getTransactionCount</span><span class="p">(</span><span class="n">address</span><span class="p">)</span><span class="o">.</span><span class="n">then</span><span class="p">(</span><span class="n">function</span><span class="p">(</span><span class="n">transactionCount</span><span class="p">)</span> <span class="p">{</span>
     <span class="n">console</span><span class="o">.</span><span class="n">log</span><span class="p">(</span><span class="s2">&quot;Total Transactions Ever Send: &quot;</span> <span class="o">+</span> <span class="n">transactionCount</span><span class="p">);</span>
 <span class="p">});</span>
+
+<span class="n">provider</span><span class="o">.</span><span class="n">resolveName</span><span class="p">(</span><span class="s2">&quot;test.ricmoose.eth&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">then</span><span class="p">(</span><span class="n">function</span><span class="p">(</span><span class="n">address</span><span class="p">)</span> <span class="p">{</span>
+    <span class="n">console</span><span class="o">.</span><span class="n">log</span><span class="p">(</span><span class="s2">&quot;Address: &quot;</span> <span class="o">+</span> <span class="n">address</span><span class="p">);</span>
+<span class="p">});</span>
 </pre></div>
 </div>
 </div>
@@ -347,15 +354,15 @@ transaction. (See: <a class="reference external" href="blocktag">Block Tags</a>)
 <h2>Blockchain Status<a class="headerlink" href="#blockchain-status" title="Permalink to this headline">¶</a></h2>
 <dl class="docutils">
 <dt><sup>prototype</sup> . getBlockNumber ( )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the latest block number (as a Number).</dd>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the latest block number (as a Number).</dd>
 <dt><sup>prototype</sup> . getGasPrice ( )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the current gas price (as a <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a>).</dd>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the current gas price (as a <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a>).</dd>
 <dt><sup>prototype</sup> . getBlock ( blockHashOrBlockNumber )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the block at <em>blockHashorBlockNumber</em>. (See: <a class="reference external" href="blockresponse">Block Responses</a>)</dd>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the block at <em>blockHashorBlockNumber</em>. (See: <a class="reference external" href="blockresponse">Block Responses</a>)</dd>
 <dt><sup>prototype</sup> . getTransaction ( transactionHash )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the transaction with <em>transactionHash</em>. (See: <a class="reference external" href="transactionresult">Transaction Results</a>)</dd>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the transaction with <em>transactionHash</em>. (See: <a class="reference external" href="transactionresult">Transaction Results</a>)</dd>
 <dt><sup>prototype</sup> . getTransactionReceipt ( transactionHash )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the transaction receipt with <em>transactionHash</em>.
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the transaction receipt with <em>transactionHash</em>.
 (See: <a class="reference external" href="transactionReceipts">Transaction Receipts</a>)</dd>
 </dl>
 <div class="section" id="id4">
@@ -414,19 +421,19 @@ usually be used instead.</p>
 <dl class="docutils">
 <dt><sup>prototype</sup> . call ( transaction )</dt>
 <dd><p class="first">Send the <strong>read-only</strong> (constant) <em>transaction</em> to a single Ethereum node and
-return a <span class="xref std std-ref">Promise</span> with the result (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>) of executing it.
+return a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the result (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>) of executing it.
 (See <a class="reference external" href="transactionrequest">Transaction Requests</a>)</p>
 <p class="last">This is free, since it does not change any state on the blockchain.</p>
 </dd>
 <dt><sup>prototype</sup> . estimateGas ( transaction )</dt>
-<dd><p class="first">Send a <em>transaction</em> to a single Ethereum node and return a <span class="xref std std-ref">Promise</span> with the
+<dd><p class="first">Send a <em>transaction</em> to a single Ethereum node and return a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the
 estimated amount of gas required (as a <a class="reference internal" href="api-utils.html#bignumber"><span class="std std-ref">BigNumber</span></a>) to send it.
 (See <a class="reference external" href="transactionrequest">Transaction Requests</a>)</p>
 <p class="last">This is free, but only an estimate. Providing too little gas will result in a
 transaction being rejected (while still consuming all provided gas).</p>
 </dd>
 <dt><sup>prototype</sup> . sendTransaction ( signedTransaction )</dt>
-<dd><p class="first">Send the <em>signedTransaction</em> to the <strong>entire</strong> Ethereum network and returns a <span class="xref std std-ref">Promise</span>
+<dd><p class="first">Send the <em>signedTransaction</em> to the <strong>entire</strong> Ethereum network and returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a>
 with the transaction hash.</p>
 <p class="last"><strong>This will consume gas</strong> from the account that signed the transaction.</p>
 </dd>
@@ -442,15 +449,16 @@ with the transaction hash.</p>
 <div class="section" id="contract-state">
 <h2>Contract State<a class="headerlink" href="#contract-state" title="Permalink to this headline">¶</a></h2>
 <dl class="docutils">
-<dt><sup>prototype</sup> . getCode ( address )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the bytecode (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>) at  <em>address</em>.</dd>
-<dt><sup>prototype</sup> . getStorageAt ( address, position [ , blockTag ] )</dt>
-<dd><p class="first">Returns a <span class="xref std std-ref">Promise</span> with the value (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>) at <em>address</em> in
-<em>position</em> at <em>blockTag</em>. (See <a class="reference external" href="blocktag">Block Tags</a>)</p>
+<dt><sup>prototype</sup> . getCode ( addressOrName )</dt>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the bytecode (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>)
+at  <em>addressOrName</em>.</dd>
+<dt><sup>prototype</sup> . getStorageAt ( addressOrName, position [ , blockTag ] )</dt>
+<dd><p class="first">Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the value (as a <a class="reference internal" href="api-utils.html#hexstring"><span class="std std-ref">hex string</span></a>) at
+<em>addressOrName</em> in <em>position</em> at <em>blockTag</em>. (See <a class="reference external" href="blocktag">Block Tags</a>)</p>
 <p class="last">default: <em>blockTag</em>= &#8220;latest&#8221;</p>
 </dd>
 <dt><sup>prototype</sup> . getLogs ( filter )</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with an array (possibly empty) of the logs that
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with an array (possibly empty) of the logs that
 match the <em>filter</em>. (See <a class="reference external" href="filter">Filters</a>)</dd>
 </dl>
 <div class="section" id="id8">
@@ -486,6 +494,11 @@ total number of callbacks registered</dd>
 <dd><p class="first">Whenever a new block is mined</p>
 <p class="last"><code class="docutils literal"><span class="pre">callback(</span> <span class="pre">blockNumber</span> <span class="pre">)</span></code></p>
 </dd>
+<dt>any address</dt>
+<dd><p class="first">When the balance of the coresposding address changes.</p>
+<blockquote class="last">
+<div><code class="docutils literal"><span class="pre">callback(</span> <span class="pre">balance</span> <span class="pre">)</span></code></div></blockquote>
+</dd>
 <dt>any transaction hash</dt>
 <dd><p class="first">When the coresponding transaction is mined; also see
 <a class="reference external" href="waitForTransaction">Waiting for Transactions</a></p>
@@ -502,7 +515,7 @@ total number of callbacks registered</dd>
 <span id="id9"></span><h3>Waiting for Transactions<a class="headerlink" href="#waitfortransaction" title="Permalink to this headline">¶</a></h3>
 <dl class="docutils">
 <dt><sup>prototype</sup> . waitForTransaction ( transachtionHash [ , timeout ] )</dt>
-<dd>Return a <span class="xref std std-ref">Promise</span> which returns the transaction once <em>transactionHash</em> is
+<dd>Return a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> which returns the transaction once <em>transactionHash</em> is
 mined, with an optional <em>timeout</em> (in milliseconds)</dd>
 </dl>
 </div>
@@ -513,6 +526,10 @@ mined, with an optional <em>timeout</em> (in milliseconds)</dd>
     <span class="n">console</span><span class="o">.</span><span class="n">log</span><span class="p">(</span><span class="s1">&#39;New Block: &#39;</span> <span class="o">+</span> <span class="n">blockNumber</span><span class="p">);</span>
 <span class="p">});</span>
 
+<span class="o">//</span> <span class="n">Get</span> <span class="n">notified</span> <span class="n">on</span> <span class="n">account</span> <span class="n">balance</span> <span class="n">change</span>
+<span class="n">provider</span><span class="o">.</span><span class="n">on</span><span class="p">(</span><span class="s1">&#39;0x46Fa84b9355dB0708b6A57cd6ac222950478Be1d&#39;</span><span class="p">,</span> <span class="n">function</span><span class="p">(</span><span class="n">blockNumber</span><span class="p">)</span> <span class="p">{</span>
+    <span class="n">console</span><span class="o">.</span><span class="n">log</span><span class="p">(</span><span class="s1">&#39;New Block: &#39;</span> <span class="o">+</span> <span class="n">blockNumber</span><span class="p">);</span>
+<span class="p">});</span>
 
 <span class="o">//</span> <span class="n">Get</span> <span class="n">notified</span> <span class="n">when</span> <span class="n">a</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="n">mined</span>
 <span class="n">provider</span><span class="o">.</span><span class="n">once</span><span class="p">(</span><span class="n">transactionHash</span><span class="p">,</span> <span class="n">function</span><span class="p">(</span><span class="n">transction</span><span class="p">)</span> <span class="p">{</span>
@@ -585,17 +602,17 @@ or <a class="reference internal" href="api-utils.html#hexstring"><span class="st
 <div class="highlight-default"><div class="highlight"><pre><span></span><span class="o">//</span> <span class="n">Example</span><span class="p">:</span>
 <span class="p">{</span>
     <span class="o">//</span> <span class="n">Required</span> <span class="n">unless</span> <span class="n">deploying</span> <span class="n">a</span> <span class="n">contract</span> <span class="p">(</span><span class="ow">in</span> <span class="n">which</span> <span class="n">case</span> <span class="n">omit</span><span class="p">)</span>
-    <span class="n">to</span><span class="p">:</span> <span class="n">address</span><span class="p">,</span>      <span class="o">//</span> <span class="n">the</span> <span class="n">target</span> <span class="n">address</span>
+    <span class="n">to</span><span class="p">:</span> <span class="n">addressOrName</span><span class="p">,</span>  <span class="o">//</span> <span class="n">the</span> <span class="n">target</span> <span class="n">address</span> <span class="ow">or</span> <span class="n">ENS</span> <span class="n">name</span>
 
     <span class="o">//</span> <span class="n">These</span> <span class="n">are</span> <span class="n">optional</span><span class="o">/</span><span class="n">meaningless</span> <span class="k">for</span> <span class="n">call</span> <span class="ow">and</span> <span class="n">estimateGas</span>
-    <span class="n">nonce</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>         <span class="o">//</span> <span class="n">the</span> <span class="n">transaction</span> <span class="n">nonce</span>
-    <span class="n">gasLimit</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>      <span class="o">//</span> <span class="n">the</span> <span class="n">maximum</span> <span class="n">gas</span> <span class="n">this</span> <span class="n">transaction</span> <span class="n">may</span> <span class="n">spend</span>
-    <span class="n">gasPrice</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>      <span class="o">//</span> <span class="n">the</span> <span class="n">price</span> <span class="p">(</span><span class="ow">in</span> <span class="n">wei</span><span class="p">)</span> <span class="n">per</span> <span class="n">unit</span> <span class="n">of</span> <span class="n">gas</span>
+    <span class="n">nonce</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>           <span class="o">//</span> <span class="n">the</span> <span class="n">transaction</span> <span class="n">nonce</span>
+    <span class="n">gasLimit</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>        <span class="o">//</span> <span class="n">the</span> <span class="n">maximum</span> <span class="n">gas</span> <span class="n">this</span> <span class="n">transaction</span> <span class="n">may</span> <span class="n">spend</span>
+    <span class="n">gasPrice</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>        <span class="o">//</span> <span class="n">the</span> <span class="n">price</span> <span class="p">(</span><span class="ow">in</span> <span class="n">wei</span><span class="p">)</span> <span class="n">per</span> <span class="n">unit</span> <span class="n">of</span> <span class="n">gas</span>
 
     <span class="o">//</span> <span class="n">These</span> <span class="n">are</span> <span class="n">always</span> <span class="n">optional</span> <span class="p">(</span><span class="n">but</span> <span class="k">for</span> <span class="n">call</span><span class="p">,</span> <span class="n">data</span> <span class="ow">is</span> <span class="n">usually</span> <span class="n">specified</span><span class="p">)</span>
-    <span class="n">data</span><span class="p">:</span> <span class="s2">&quot;0x&quot;</span><span class="p">,</span>       <span class="o">//</span> <span class="n">extra</span> <span class="n">data</span> <span class="k">for</span> <span class="n">the</span> <span class="n">transaction</span><span class="p">,</span> <span class="ow">or</span> <span class="nb">input</span> <span class="k">for</span> <span class="n">call</span>
-    <span class="n">value</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>         <span class="o">//</span> <span class="n">the</span> <span class="n">amount</span> <span class="p">(</span><span class="ow">in</span> <span class="n">wei</span><span class="p">)</span> <span class="n">this</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="n">sending</span>
-    <span class="n">chainId</span><span class="p">:</span> <span class="mi">3</span>        <span class="o">//</span> <span class="n">the</span> <span class="n">network</span> <span class="n">ID</span><span class="p">;</span> <span class="n">usually</span> <span class="n">added</span> <span class="n">by</span> <span class="n">a</span> <span class="n">signer</span>
+    <span class="n">data</span><span class="p">:</span> <span class="s2">&quot;0x&quot;</span><span class="p">,</span>         <span class="o">//</span> <span class="n">extra</span> <span class="n">data</span> <span class="k">for</span> <span class="n">the</span> <span class="n">transaction</span><span class="p">,</span> <span class="ow">or</span> <span class="nb">input</span> <span class="k">for</span> <span class="n">call</span>
+    <span class="n">value</span><span class="p">:</span> <span class="mi">0</span><span class="p">,</span>           <span class="o">//</span> <span class="n">the</span> <span class="n">amount</span> <span class="p">(</span><span class="ow">in</span> <span class="n">wei</span><span class="p">)</span> <span class="n">this</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="n">sending</span>
+    <span class="n">chainId</span><span class="p">:</span> <span class="mi">3</span>          <span class="o">//</span> <span class="n">the</span> <span class="n">network</span> <span class="n">ID</span><span class="p">;</span> <span class="n">usually</span> <span class="n">added</span> <span class="n">by</span> <span class="n">a</span> <span class="n">signer</span>
 <span class="p">}</span>
 </pre></div>
 </div>
@@ -683,8 +700,8 @@ for the vast majority of filters, a single topic is usually sufficient (see the
     <span class="n">fromBlock</span><span class="p">:</span> <span class="s2">&quot;latest&quot;</span><span class="p">,</span>
     <span class="n">toBlock</span><span class="p">:</span> <span class="s2">&quot;latest&quot;</span><span class="p">,</span>
 
-    <span class="o">//</span> <span class="n">Optional</span><span class="p">;</span> <span class="n">An</span> <span class="n">address</span> <span class="n">to</span> <span class="nb">filter</span> <span class="n">by</span>
-    <span class="n">address</span><span class="p">:</span> <span class="n">address</span><span class="p">,</span>
+    <span class="o">//</span> <span class="n">Optional</span><span class="p">;</span> <span class="n">An</span> <span class="n">address</span> <span class="p">(</span><span class="ow">or</span> <span class="n">ENS</span> <span class="n">name</span><span class="p">)</span> <span class="n">to</span> <span class="nb">filter</span> <span class="n">by</span>
+    <span class="n">address</span><span class="p">:</span> <span class="n">addressOrName</span><span class="p">,</span>
 
     <span class="o">//</span> <span class="n">Optional</span><span class="p">;</span> <span class="n">A</span> <span class="p">(</span><span class="n">possibly</span> <span class="n">nested</span><span class="p">)</span> <span class="nb">list</span> <span class="n">of</span> <span class="n">topics</span>
     <span class="n">topics</span><span class="p">:</span> <span class="p">[</span> <span class="n">topic1</span> <span class="p">]</span>
@@ -698,7 +715,7 @@ for the vast majority of filters, a single topic is usually sufficient (see the
 <h2>Provider Specific Extra API Calls<a class="headerlink" href="#provider-specific-extra-api-calls" title="Permalink to this headline">¶</a></h2>
 <dl class="docutils">
 <dt><sup>EtherscanProvider</sup> . getEtherPrice()</dt>
-<dd>Returns a <span class="xref std std-ref">Promise</span> with the price of ether in USD.</dd>
+<dd>Returns a <a class="reference internal" href="notes.html#promise"><span class="std std-ref">Promise</span></a> with the price of ether in USD.</dd>
 </dl>
 <div class="section" id="id16">
 <h3><em>Examples</em><a class="headerlink" href="#id16" title="Permalink to this headline">¶</a></h3>
@@ -753,7 +770,7 @@ for the vast majority of filters, a single topic is usually sufficient (see the
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/api-utils.html b/docs/build/html/api-utils.html
index b4f17b7c0..c41c0c645 100644
--- a/docs/build/html/api-utils.html
+++ b/docs/build/html/api-utils.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Utilities &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Utilities &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="up" title="Application Programming Interface (API)" href="api.html"/>
         <link rel="next" title="Low-Level API" href="api-advanced.html"/>
         <link rel="prev" title="Contracts" href="api-contract.html"/> 
@@ -65,7 +65,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -518,7 +518,7 @@ defined)</dd>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/api-wallet.html b/docs/build/html/api-wallet.html
index 12067cf73..121838528 100644
--- a/docs/build/html/api-wallet.html
+++ b/docs/build/html/api-wallet.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Wallets &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Wallets &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="up" title="Application Programming Interface (API)" href="api.html"/>
         <link rel="next" title="Providers API" href="api-providers.html"/>
         <link rel="prev" title="Application Programming Interface (API)" href="api.html"/> 
@@ -65,7 +65,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -354,8 +354,8 @@ in <strong>wei</strong>) at the <a class="reference internal" href="api-provider
 <dd>Sends the <em>transaction</em> to the network and returns a Promise with the transaction
 details. It is highly recommended to omit <em>transaction.chainId</em>, it will be
 filled in by <em>provider</em>.</dd>
-<dt><sup>prototype</sup> . send ( address, amountWei [ , options ] )</dt>
-<dd>Sends <em>amountWei</em> to <em>address</em> on the network and returns a Promise with the
+<dt><sup>prototype</sup> . send ( addressOrName, amountWei [ , options ] )</dt>
+<dd>Sends <em>amountWei</em> to <em>addressOrName</em> on the network and returns a Promise with the
 transaction details.</dd>
 </dl>
 <div class="section" id="id2">
@@ -539,7 +539,7 @@ transaction details.</dd>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/api.html b/docs/build/html/api.html
index 7aa0d0e58..9f062028e 100644
--- a/docs/build/html/api.html
+++ b/docs/build/html/api.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Application Programming Interface (API) &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Application Programming Interface (API) &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="next" title="Wallets" href="api-wallet.html"/>
         <link rel="prev" title="Getting Started" href="getting-started.html"/> 
 
@@ -64,7 +64,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -231,7 +231,7 @@
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/cookbook.html b/docs/build/html/cookbook.html
index aaaacad99..517c49201 100644
--- a/docs/build/html/cookbook.html
+++ b/docs/build/html/cookbook.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Cookbook &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Cookbook &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="next" title="Notes" href="notes.html"/>
         <link rel="prev" title="Low-Level API" href="api-advanced.html"/> 
 
@@ -64,7 +64,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -426,7 +426,7 @@ through to INFURA, but dump all data going back and forth.</p>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html
index 79029c42b..9abdf50a3 100644
--- a/docs/build/html/genindex.html
+++ b/docs/build/html/genindex.html
@@ -9,7 +9,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Index &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Index &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -35,7 +35,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/> 
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/> 
 
   
   <script src="_static/js/modernizr.min.js"></script>
@@ -63,7 +63,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -173,7 +173,7 @@
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/getting-started.html b/docs/build/html/getting-started.html
index d81c09af8..43570e4c0 100644
--- a/docs/build/html/getting-started.html
+++ b/docs/build/html/getting-started.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Getting Started &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Getting Started &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="next" title="Application Programming Interface (API)" href="api.html"/>
         <link rel="prev" title="What is ethers.js" href="index.html"/> 
 
@@ -64,7 +64,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -212,7 +212,7 @@ distribution network) should suffice:</p>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/index.html b/docs/build/html/index.html
index a0adfff9a..6d03e4cf9 100644
--- a/docs/build/html/index.html
+++ b/docs/build/html/index.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>What is ethers.js &mdash; ethers.js 2.0.0 documentation</title>
+  <title>What is ethers.js &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="#"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="#"/>
         <link rel="next" title="Getting Started" href="getting-started.html"/> 
 
   
@@ -63,7 +63,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -307,7 +307,7 @@ the owners machine at all times.</p>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/notes.html b/docs/build/html/notes.html
index 8b73f66d9..29547634c 100644
--- a/docs/build/html/notes.html
+++ b/docs/build/html/notes.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Notes &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Notes &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="next" title="Testing" href="testing.html"/>
         <link rel="prev" title="Cookbook" href="cookbook.html"/> 
 
@@ -64,7 +64,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -177,6 +177,7 @@ which can have mathematical operations handeled safely.</p>
 <span id="promise"></span><h2>Promises<a class="headerlink" href="#promises" title="Permalink to this headline">¶</a></h2>
 <p>A <a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise in JavaScript</a> is an object which simplifies many aspects of dealing with
 asynchronous functions.</p>
+<p>It allows a pending result to be treated in many ways as if it has already been resolved.</p>
 <p>The most useful operations you will need are:</p>
 <dl class="docutils">
 <dt><sup>Promise</sup> . all ( promises )</dt>
@@ -342,7 +343,7 @@ alphanumeric characters (instead of the standard 30).</p>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
index 024d8c8f7431f2fb594079539165012f38842469..e9453b4d4ad706745e60725fb955ebdaae3dabd5 100644
GIT binary patch
delta 12
TcmZo;Yh#;W&uF;O;TRJD7)}Gz

delta 12
TcmZo;Yh#;W&uFmG;TRJD7)b-t

diff --git a/docs/build/html/search.html b/docs/build/html/search.html
index e4d6ed73e..38d4068cb 100644
--- a/docs/build/html/search.html
+++ b/docs/build/html/search.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Search &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Search &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/> 
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/> 
 
   
   <script src="_static/js/modernizr.min.js"></script>
@@ -62,7 +62,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -176,7 +176,7 @@
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js
index 80f83790d..15b8bd8b4 100644
--- a/docs/build/html/searchindex.js
+++ b/docs/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({envversion:49,filenames:["cookbook","getting-started","index","notes","testing"],objects:{},objnames:{},objtypes:{},terms:{"0x00":3,"0x0123456789012345678901234567890123456789012345678901234567890123":3,"0x02f024e0882b310c6734703ab9066edd3a10c6e0":3,"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826":3,"0xdc2a3d9f938e13cd947ec05abc7fe734df8dd826":3,"byte":3,"case":[3,4],"class":2,"float":3,"function":[0,2,3],"new":[0,3,4],"return":[0,3],"short":0,"static":2,"throw":[0,3],"var":[0,1,3],"while":3,about:3,abov:3,access:[],account:3,across:[0,3],action:2,add:4,address:[],advanc:0,after:3,again:3,all:3,allow:[0,3],allpromis:3,alphabet:3,alphanumer:3,also:0,amount:[0,3],android:0,anoth:3,another:[],api:2,appendchild:0,applic:1,applicat:[],around:3,arrayish:2,aspect:3,asynchron:3,attack:3,back:0,backward:[3,4],balanc:3,balancepromis:3,base:2,becaus:3,been:3,befor:[0,3],begin:3,best:1,between:3,big:[2,3],binari:3,bitcoin:0,block:3,blockchain:[0,2],blocknumb:3,bodi:0,broken:3,build:0,call:[0,2,3],can:[],cancel:0,capit:3,cdn:1,cent:3,cetera:0,chain:3,chaindirectori:0,chainid:3,charact:3,check:4,checksum:[],classnam:0,clean:3,client:2,coalesc:[],code:3,collect:0,command:0,common:[0,3],compact:1,compat:[3,4],complet:[1,4],concept:3,confirm:[],confirmbutton:0,connect:[0,2],consol:[0,3],content:1,contract:[0,2],convert:3,cookbook:[],copi:1,correct:4,cosid:3,cost:0,countri:3,creat:[2,4],createel:0,cryptograph:2,currenc:3,current:[],custom:[],customsign:0,data:0,deal:3,debug:0,debugprovi:0,debugprovid:0,defaultprovid:0,definit:3,demonstr:3,depend:0,deploi:2,derivepath:0,design:2,desktop:0,develop:2,differ:3,digit:3,director:[],directori:1,displai:3,distribut:1,div:0,document:[0,2],dollar:3,doubl:3,down:3,dump:[],each:0,easier:2,empty:[],encod:3,encode:2,encount:3,ensur:4,enter:3,eoa:[0,3],erro:0,error:[0,3],ethereum:[0,1,2,3],etherscan:0,etherstr:[0,3],event:2,everi:3,exact:[0,3],exactli:0,exampl:[],execut:[2,3],explain:4,expos:1,extend:3,extern:3,external:0,extra:2,fals:3,featur:4,fee:[0,3],few:3,file:[0,1],filenam:0,fill:0,first:3,follow:3,foreach:0,format:3,formateth:[0,3],forth:0,from:[0,1,3],frommnemon:0,fulfil:3,fund:[],gaslimit:0,gaspric:[0,3],gaspricepromis:3,gener:4,get:[],getaddress:3,getbal:[0,3],getcod:[0,3],getdefaultprovid:0,getgaspric:[0,3],geth:[],github:4,global:1,granulairti:3,grow:0,handel:3,hash:3,have:3,hdnode:[0,2],help:4,here:4,hex:2,hexidecim:3,hole:3,hour:4,how:[3,4],howev:3,http:1,iban:3,icap:[],ieee:3,implement:0,imposs:0,include:[],incomplet:0,inform:3,infura:0,infuraprovid:0,inherit:0,insert:3,instal:1,install:[],instanc:[0,2],instead:3,integ:3,interact:3,interest:3,interfac:2,invalid:3,ios:0,ipfs:4,issu:3,javascript:[1,2,3],jaxx:[],json:[],just:[],keep:[2,3],kei:[0,2],keystor:0,larg:[3,4],length:2,less:[0,3],level:[0,2],librari:[1,2,4],like:0,link:[0,4],littl:3,locat:0,log:[0,3],logic:0,low:[0,2],machin:2,made:2,mai:[0,3],make:[0,2,3],mani:[0,3,4],manipul:3,mathemat:3,max_safe_integer:3,maximum:3,merg:0,messag:0,method:[0,2,3],min:1,mind:3,mine:3,minedpromis:3,minu:3,mix:3,mnemon:[],modal:0,more:[0,4],most:[0,3],much:0,mul:[0,3],multipl:0,must:0,name:0,need:[0,3],network:[1,3],newaddress:0,node:[],non:[0,3],nonc:3,normal:0,note:[],npm:1,number:[],numer:3,object:[0,2,3],obviou:3,occur:3,onc:3,onclick:0,one:[],onli:[0,3],only:3,onreject:3,onresolv:3,oper:[0,3],operat:2,order:3,origin:3,our:3,out:3,own:3,owned:0,owner:2,pai:0,param:0,pariti:0,pars:[0,2],parseeth:3,pass:[0,4],path:0,peopl:0,per:0,perform:0,phrase:[],place:1,pleas:0,point:3,possibl:4,post:4,pre:0,precis:3,prefix:2,prevent:3,privat:2,privatekei:[0,3],problem:3,problemat:3,procedur:4,program:2,project:1,promis:[],promsi:3,prototyp:[0,1,2,3],provid:3,proxi:0,purpos:1,quick:[1,3],rare:0,read:0,readdirsync:0,readfil:0,receiv:0,recip:0,recurs:2,regress:4,reject:[0,3],rejectbutton:0,relev:1,remain:3,remedi:3,remov:0,replai:3,repres:3,represent:3,requir:[0,1,3],resolv:[0,3],result:[0,2,3],ricmoo:1,rlp:2,run:4,safe:3,same:[0,3],sanit:0,save:1,script:1,secur:1,see:3,send:[0,3],sendpromis:3,sendtransact:3,sent:3,separ:0,server:1,set:3,sever:0,shortli:0,should:[0,1],show:0,side:2,sign:[0,2,3],signedtransact:3,signer:[],simpl:0,simplifi:3,sinc:3,singl:[0,3],small:0,some:[0,3],sourc:[],sourcecod:[],specif:2,spread:0,src:1,standard:[0,3],start:[],state:2,statu:2,store:3,string:[2,3],stub:0,sub:[0,2,3],subclass:0,subprovid:0,suffic:1,suggest:0,suit:4,sup:[],support:0,take:4,targetaddress:3,task:0,teh:3,test:[],testcas:4,testnet:0,text:1,textcont:0,them:0,thi:[0,1,2,3],those:0,through:0,time:[2,3],todo:[0,4],too:4,tool:0,topic:0,tostr:0,transact:3,transactioncount:3,transactioncountpromis:3,trueli:3,txfee:0,txfeeinwei:3,type:[1,2],user:[0,1,3],usual:1,utf:2,utiliti:2,valid:3,valu:[0,3],variabl:1,veri:3,wai:0,waitfortransact:3,wallet:3,walletpath:0,web:[],wei:[0,2,3],when:3,where:0,which:[0,2,3],why:[],work:0,would:0,write:2,you:[0,3],your:[0,1,3]},titles:["Cookbook","Getting Started","What is ethers.js","Notes","Testing"],titleterms:{access:0,account:0,address:3,all:0,another:0,applicat:1,balanc:0,can:3,checksum:3,coalesc:0,code:0,confirm:0,cookbook:0,current:0,custom:0,director:[],directori:0,dump:0,empty:0,ether:2,exampl:3,fund:0,get:1,geth:[],icap:3,include:1,install:1,jaxx:0,json:0,just:3,mnemon:0,node:1,note:3,number:3,one:0,phrase:0,promis:3,provid:0,signer:0,sourc:0,start:1,test:4,transact:0,wallet:0,web:1,what:2,why:3}})
\ No newline at end of file
+Search.setIndex({envversion:49,filenames:["api","api-advanced","api-contract","api-providers","api-utils","api-wallet","cookbook","getting-started","index","notes","testing"],objects:{},objnames:{},objtypes:{},terms:{"000000000000000000000000000000000000000000000000000000000000000b":1,"0000000000000000000000000b48656c6c6f20576f726c640000000000000000":2,"00b557825182559160200191906001019061009a565b5b5090506100c3919061":2,"00c7565b5090565b6100e991905b808211156100e55760008160009055506001":2,"011785556100b6565b828001600101855582156100b6579182015b8281111561":2,"016100cd565b5090565b90565b6033806100fa6000396000f30060606040525b":2,"070cc9e2c92f3df79ad46d5b3226d7f3d1e8a0535236e497c59e3fba93b78e1":3,"0cc9e2c92f":5,"0x00":[3,9],"0x0000000000000000000000000000000000000000000000000000000000000020":1,"0x0123456789012345678901234567890123456789012345678901234567890123":[1,2,5,9],"0x026655feed4d214c261e0a6b554395596f1f1476a77d999560e5a8df9b8a1a3515":1,"0x02f024e0882b310c6734703ab9066edd3a10c6e0":[3,9],"0x046655feed4d214c261e0a6b554395596f1f1476a77d999560e5a8df9b8a1a35":1,"0x0cccc7507aedf9feaf8c8d731421746e16b4d39d":4,"0x1234":1,"0x125d2b846de85c4c74eafb6f1b49fdb2326e22400ae223d96a8a0b26ccb2a513":3,"0x14791697260e4c9a71f18484c9f997b308e59325":[1,5],"0x17060cb000d2c714":3,"0x1a9d05433883bdc7e6d882740f4ea7921ef458a61b2cfe6197c2bb1bc47236fd":1,"0x1f675bff07515f5df96737194ea945c36c41e7b4fcef307b7cd4d0e602a69111":4,"0x20965255":1,"0x2a":[3,4],"0x3d8182d27303d92a2c9efd294a36dac878e1a9f7cb0964fa0f789fa96b5d0667":3,"0x42":[1,4],"0x46fa84b9355db0708b6a57cd6ac222950478be1d":3,"0x48656c6c6f20576f726c64":4,"0x535236e497c59e3fba93b78e124305c7c9b20db0f8531b015066725e4bb31de6":[3,5],"0x592fa743889fc7f92ac2a37bb1f5ba1daf2a5c84741ca0e0061d243a2e6707ba":[1,4],"0x5b13ef45ce3faf69d1f40f9d15b0070cc9e2c92f3df79ad46d5b3226d7f3d1e8":[3,5],"0x5bdfd14fcc917abc2f02a30721d152a6f147f09e8cbaad4e0d5405d646c5c3e1":4,"0x6060604052341561000c57fe5b60405161012d38038061012d83398101604052":2,"0x65746865726d696e65202d20555331":3,"0x68ad6719a0070b3bb2f866fa0d46c8123b18cefe9b387ddb4feb6647ca418435":1,"0x79f56f3422dc67f57b2aeeb0b20295a99ec90420b203177f83d419c98beda7f":1,"0x7a1d0b010393c8d850200d0ec1e27c0c8a295366247b1bd6124d496cf59182ad":3,"0x7baea23e7d77bff455d94f0c81916f938c398252fb62fce2cdb43643134ce4":3,"0x7dec07531aae8178e9d0b0abbd317ac3bb6e8e0fd37c2733b4e0d382ba34c5d2":3,"0x7ee9ae2a2eaf3f0df8d323d555479be562ac4905":5,"0x7f20ef60e9f91896b7ebb0962a18b8defb5e9074e62e1b6cde992648fe78794b":3,"0x88a5c2d9919e46f883eb62f7b8dd9d0cc45bc290":5,"0x8a27e1f7d3e92ae1a01db5cce3e4718e04954a34e9b17c1942011a5f3a942bf4":3,"0x93a09352":1,"0x948d6e8f6f8a4d30c0bd527becbe24d15b1aba796f9a9a09a758b622145fd963":3,"0x954de93d9f1cd1e2e3ae5964f614cdcc821fac64":1,"0xa591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146":4,"0xac39b311dceb2a4b2f5d8461c1cdaf756f4f7ae9":5,"0xbd141969b164ed70388f95d780864210e045e7db83e71f171ab851b2fba6b730":3,"0xc149be1bcdfa69a94384b46a1f91350e5f81c1ab":[3,5],"0xc6af6e1a78a6752c7f8cd63877eb789a2adb776c":4,"0xc8c142821234c2c0c0":1,"0xca1d4d9c4ac0b903a64cf3ae3be55cc31f25f81bf29933dd23c13e51c3711840":3,"0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826":9,"0xd115bffabbdd893a6f7cea402e7338643ced44a6":4,"0xdc2a3d9f938e13cd947ec05abc7fe734df8dd826":9,"0xdf7e70e5021544f4834bbee64a9e3789febc4be81470df629cad6ddb03320a5c":4,"0xea674fdde714fd979de3edf0f56aa9716b898ec8":[3,5],"0xf517872f3c466c2e1520e35ad943d833fdca5a6739cfea9e686c4c1b3ab1022":3,"0xf86c808504a817c8008252089488a5c2d9919e46f883eb62f7b8dd9d0cc45bc2":5,"0xf87083154262850500cf6e0083015f9094c149be1bcdfa69a94384b46a1f913":[3,5],"10adcc8bcaf49474c6710460e0dc974331f71ee4c7baa7314b4a23d25fd6c406":5,"15217e88dd05e938efdd71b2cce322bf01da96cd42087b236e8f5043157a9c068":1,"1cf53b5ae8d75f8c037b453e7c3c61b010225d916768a6b145adf5cf9cb3a703":5,"1dcdf13e49cea706994ed38804f6d171":5,"1e18":5,"24305c7c9b20db0f8531b015066725e4bb31de6":3,"24c57b3be967e2074220fca13e79":5,"2fa":2,"466f6f6261722100000000000000000000000000000000000000000000000000":1,"48656c6c6f20576f726c64000000000000000000000000000000000000000000":1,"4e40":5,"505b506100ec565b828054600181600116156101000203166002900490600052":2,"50e5f81c1ab880de6c75de74c236c8025a05b13ef45ce3faf69d1f40f9d15b0":3,"50e5f81c1ab880de6c75de74c236c8025a05b13ef45ce3faf69d1f40f9d15b007":5,"602060002090601f016020900481019282601f1061008857805160ff19168380":2,"7026b1be504a":5,"8080518201919050505b806000908051906020019061003f929190610047565b":2,"88a5c2d9919e46f883eb62f7b8dd9d0cc45bc290":5,"90880de0b6b3a7640000801ca0d7b10eee694f7fd9acaa0baf51e91da5c3d324":5,"abstract":[1,3],"break":1,"byte":1,"case":[1,2,3,4,5,9,10],"class":[],"default":[1,3,5],"float":[4,9],"function":[0,1,2,3],"import":4,"int":2,"new":[1,2,3,4,5,6,9,10],"null":3,"public":[1,5],"return":[1,2,3,4,5,6,9],"short":6,"static":[],"switch":1,"throw":[1,4,6,9],"true":[1,2,3,4],"var":[1,2,3,4,5,6,7,9],"while":[3,9],_author:2,_signingkei:1,_valu:2,abi:[1,2],abl:4,about:[1,9],abov:[2,3,9],absent:1,accept:[1,2,3],access:[],account:[],accur:4,across:[3,6,9],action:0,add:[4,10],addit:2,address:[],addressornam:[2,3,5],advanc:[1,6],affect:3,after:[2,9],again:9,alias:2,align:2,all:[],allow:[2,3,4,5,6,9],allpromis:9,alphabet:9,alphanumer:9,alreadi:9,also:[1,2,3,5,6],alter:1,alwai:[1,3,4],amd:2,amount:[3,4,5,6,9],amountwei:5,android:6,ani:[1,2,3,4],anonym:[1,2],anoth:[2,5,9],another:[],any:[2,3],anyth:4,api:[],apiaccesstoken:3,apitoken:3,aposit:1,apostroph:1,appendchild:6,applic:[2,4,7],applicat:[],appropri:5,argument:2,around:[1,9],arrai:1,arrayifi:[2,4],arrayish:[0,1,2],arrayofhexstringsandarrayish:4,aspect:[1,9],assum:1,asynchron:[2,9],attach:[3,5],attack:[3,9],attempt:3,author:2,authot:2,automat:3,avaiabl:2,avail:[1,2,3,4],back:[3,6],backward:[9,10],balanc:[],balancepromis:[5,9],base:[3,8],bbfa53547e3e3bfcc9786a2cbef8504a5031d82734ecef02153e29daeed658fd:5,becaus:9,been:9,befor:[1,2,6,9],begin:9,behaviour:2,below:[1,2,3],best:7,better:2,between:[2,4,9],big:0,bignuberifi:3,bignumb:[2,3,4,5],bignumberifi:[3,4,5],binari:[1,2,4,9],bip32:5,bip39:[1,5],bip:1,bit:[1,2,4],bitcoin:6,block:[],blockchain:[0,2],blockhash:[1,3],blockhashorblocknumb:3,blocknumb:[3,9],blocktag:[1,3,5],blur:[1,5],bodi:[1,6],both:[2,4],brain:5,broken:9,build:6,built:2,bytecod:[1,2,3],cabbag:[1,5],call:[0,1,2],callback:[2,3,5],callpromis:2,can:[],cancel:6,cannot:[2,5],capit:9,care:2,carri:4,caus:1,cdn:7,cent:9,certain:3,cetera:6,chain:[1,3,9],chaincod:1,chaindid:5,chaindirectori:6,chainid:[3,5,9],chang:3,charact:[4,9],check:[2,10],checksum:[],chef:[1,5],child:3,childprovid:1,cipher:5,cipherparam:5,ciphertext:5,classnam:6,clean:9,client:8,coalesc:[],code:[],collect:6,collis:[1,2],colliss:1,com:1,come:2,command:6,commifi:4,common:[1,3,6,9],compact:7,compat:[3,9,10],compil:[1,2],compit:1,complet:[5,7,10],complex:5,complic:3,compon:1,compress:1,compressedpublickei:1,comput:[1,4],concat:4,concaten:4,concept:9,confirm:[],confirmbutton:6,connect:0,consist:4,consol:[1,2,3,4,5,6,9],constant:[1,2,3],constructor:[1,2],consum:3,contain:[1,2],contant:2,content:7,contract:[0,1],contractaddress:3,control:2,conveni:[1,5],convers:2,convert:[1,2,3,4,5,9],cookbook:[],copi:[1,3,7],corespond:3,coresposd:3,correct:10,correspond:1,cosid:9,cost:[2,4,5,6],countri:9,creat:0,createel:6,createrandom:5,creator:4,credit:2,crypto:5,cryptograph:0,cryptographi:1,ctr:5,cumulativegasus:3,currenc:9,current:[],curv:1,custom:[],customsign:[2,6],d646:5,d8e037c72cd7d0aa671e2f002900000000000000000000000000000000000000:2,d8e037c72cd7d0aa671e2f0029:2,data:[1,2,3,4,5,6],databas:2,deal:[1,9],debug:6,debugprovi:6,debugprovid:6,decim:[3,4],declin:2,decod:1,decodeparam:1,decrypt:5,defaultprovid:6,defer:2,defin:[2,4],defineproperti:1,definit:9,delimit:1,demonstr:[2,9],demoprovid:1,depend:6,deploi:[0,1],deployfunct:1,deploytransact:2,depth:1,deriv:[1,5],derivepath:[1,6],descend:1,design:[1,8],desktop:6,detail:5,determin:[1,2],determinist:1,develop:[1,8],differ:[5,9],difficulti:3,digest:1,digit:[4,9],directli:2,director:[],directori:[],displai:9,distribut:7,div:[4,6],divid:4,dklen:5,document:[1,6,8],doe:[1,3],dollar:9,doubl:9,down:[3,9],drop:1,due:2,dump:[],dynam:2,each:[1,2,3,4,6],easier:8,either:[1,2],ellipt:1,embark:[1,5],emphasi:1,empti:3,empty:[],encod:[1,4,9],encode:[],encodeparam:1,encount:[3,9],encrypt:5,encryptpromis:5,endian:4,enforc:1,engin:[1,5],ens:[2,3],ensnam:3,ensur:[5,10],enter:9,entir:3,entri:2,entropi:1,entropytomnemon:1,eoa:[6,9],equal:4,equival:3,erro:6,error:[1,2,3,4,6,9],estim:[2,3,5],estimat:[2,5],estimatega:[1,2,3,5],estimategaspromis:5,estimatepromis:2,eth:3,ethereum:[0,1,2],etherscan:[3,6],etherstr:[3,4,6,9],ethersymbol:4,even:[2,4],event:[0,1,2],eventemitt:3,eventnam:2,eventtop:3,eventtyp:3,ever:[3,5],everi:[3,4,5,9],exact:[6,9],exactli:[1,3,6],exampl:[],exclud:4,execut:0,expect:2,explain:[3,10],explicit:2,expos:[4,7],extend:9,extern:9,external:6,extra:0,extradata:3,extraentropi:5,f67ad827fbe4410a32967cbc32a06ffb0b4ac0855f146ff82bef010f6f2729b4:5,failur:2,fall:3,fallback:3,fals:[1,2,3,9],far:4,fb1280c0:5,fe00a165627a7a72305820041f440021b887310055b6f4e647c2844f4e1c8cf1:2,featur:[1,10],fee:[6,9],fetch:1,fetchjson:1,few:9,fiction:[1,5],file:[6,7],filenam:6,fill:[5,6],fine:2,first:[1,2,3,9],fix:[1,2,5],follow:[1,2,9],foo:5,foobar:1,foreach:6,format:[3,4,9],formateth:[3,4,6,9],forth:6,free:3,from:[1,2],fromblock:[1,3],frombrainwallet:5,fromencryptedwallet:5,frommnemon:[1,5,6],fromse:1,fulfil:9,functionnam:2,fund:[],futur:[1,2,3],gascost:2,gasestim:5,gaslimit:[1,2,3,4,5,6],gaspric:[1,2,3,5,6,9],gaspricepromis:9,gaspricestr:3,gaspricewei:4,gasus:3,gener:[1,2,4,5,10],generateicap:4,get:[],getaddress:[2,4,5,9],getbal:[1,3,5,6,9],getblock:[1,3],getblocknumb:[1,3],getcod:[1,3,6,9],getcontractaddress:4,getdataresult:1,getdefaultprovid:[2,3,5,6],getdeploytransact:2,getetherpric:3,getgaspric:[1,3,6,9],geth:[],getlog:[1,3],getpublickei:1,getstorageat:[1,3],gettransact:[1,3],gettransactioncount:[1,3,5],gettransactionreceipt:[1,3],getvalu:[1,2],getvalueinfo:1,github:[1,10],given:[1,2],global:7,grace:2,grain:2,granulairti:9,greater:4,greek:4,grow:6,gte:4,handel:9,handl:[2,3,4],harden:1,hash:[3,4,5,9],have:[1,2,4,5,9],hdnode:[],hello:[1,2,4],help:10,here:[1,2,10],hex:[0,1,2,3],hexidecim:[4,9],hexlifi:4,hexstr:[1,4],hexstringorarrayish:[1,4,5],hierarch:1,hierarchi:1,highli:5,hole:9,homestead:[3,5],host:3,hour:10,how:[2,4,9,10],howev:[2,3,9],http:[1,3,7],iban:9,icap:[],icapaddress:4,ident:2,identifi:3,ieee:[4,9],ifac:1,immut:[3,4],implement:[1,6],imposs:6,improve:3,includ:[1,4,5],include:[],incomplet:6,incorrectli:4,index:[1,2,3,4],indic:[1,3],indirectli:3,infact:1,inform:9,infua:3,infura:[3,6],infuraprovid:[],inherit:1,initi:1,input:[1,2,3],insensit:4,insert:9,instal:7,install:[],instanc:0,instanti:2,instead:[2,3,9],int256:2,int8:2,integ:[1,4,9],interact:9,interest:9,interfac:[],intern:1,invalid:[1,9],ios:6,ipfs:10,isarrayish:4,issu:[2,3,9],isvalidmnemon:1,iszero:4,item:1,javascript:[1,2,4,7,8,9],jaxx:[],joi:[1,5],json:[],just:[],kdf:5,kdfparam:5,keccak256:[1,4],keep:[5,8,9],kei:[],keystor:6,keyword:1,larg:[1,3,4,9,10],larger:[4,5],latest:[3,5],lead:4,learn:1,least:4,length:[],less:[2,3,4,6,9],letter:4,level:[],librari:[1,7,8,10],lightli:1,like:6,limit:[3,5],link:[6,10],list:3,listen:[1,2],listenercount:3,littl:[3,9],live:4,local:3,localhost:3,locat:6,log:[1,2,3,4,5,6,9],logic:6,logsbloom:3,lost:5,low:[],lower:[2,4],lte:4,mac:5,machin:8,made:8,mai:[1,2,3,4,5,6,9],mainnet:[3,5],major:3,make:[5,6,8,9],manag:[3,5],mani:[2,4,6,9,10],manipul:9,map:2,master:[1,5],masternod:1,match:3,math:4,mathemat:[2,9],max:4,max_safe_integer:9,maxcostwei:4,maximum:[3,9],meaningless:3,memori:4,merg:6,messag:[1,6],messagebyt:1,messagedigest:1,meta:[1,2],method:[],millisecond:3,min:7,mind:[3,9],mine:[2,3,9],minedpromis:9,miner:3,minu:[4,9],mix:9,mnemon:[],mnemonictoentropi:1,mnemonictose:1,mod:4,modal:6,modifi:[1,3],modulo:4,more:[1,2,3,6,10],most:[1,3,6,9],msg:2,much:[2,6],mul:[4,6,9],multipl:[2,6],must:[2,4,5,6],name:[1,2,3,6],nearest:2,necessari:1,necessarili:2,need:[1,2,6,9],neg:4,nest:[1,3],network:[1,2,3,4,5,7,9],networkid:3,newaddress:6,newvalu:1,next:3,node:[],non:[1,2,3,4,6,9],nonc:[1,2,3,4,5,9],normal:[4,6],note:[],notic:2,notifi:3,now:5,npm:7,number:[],numberorbignumberorhexstringorarrayish:4,numer:[2,9],object:[0,1,2],obviou:9,occasion:2,occur:[2,9],odd:4,often:4,oldvalu:1,omit:[3,5],ommit:3,onc:[3,9],onclick:6,one:[],onli:[1,2,3,4,6,9],only:[3,9],onreject:9,onresolv:9,onto:3,onvaluechang:2,oper:[2,4,5,6,9],operat:0,option:[1,2,3,4,5],optional:[2,3,5],order:9,origin:9,other:[1,2],othervalu:4,otherwis:4,our:9,out:[4,9],output:[1,2,4],outsid:4,over:2,overload:2,overrid:[1,5],overview:1,overwritten:2,own:9,owned:6,owner:8,ownership:5,packag:4,pad:4,padzero:4,pai:6,pair:[1,5],param:[1,3,6],paramet:[1,2,3,5],parent:1,parenthash:3,pariti:[3,6],pars:[0,1,2,3,4],parseeth:[3,4,5,9],parseint:5,parsetransact:5,pass:[1,2,4,5,6,10],password123:5,password:5,path:[1,5,6],payabl:2,pend:[3,9],peopl:[1,6],per:[3,6],percent:5,perform:[1,2,6],phrase:[],place:[4,7],pleas:6,plu:4,point:[1,4,9],popul:[1,2,3,5],posit:[1,2,3],possibl:[1,2,3,10],post:10,pre:6,precis:9,prefix:[],prepend:4,present:3,prevent:[3,9],price:3,privat:[1,5,8],privatekei:[1,2,5,6,9],problem:9,problemat:9,procedur:10,processfunc:1,program:[],progresscallback:5,project:7,promis:[],promisesend:5,prompt:2,promsi:9,properti:[1,2,3,4,5],protocol:2,prototyp:0,prove:5,provid:[],providerorsign:2,providersinfuraprovid:3,proxi:6,publickei:1,publickeytoaddress:1,publicorprivatekei:1,purpos:7,queri:[2,3,5],quick:[7,9],radar:[1,5],random:[4,5],randombyt:4,rang:[2,3,4],rare:6,raw:[3,5],read:[3,6],readdirsync:6,readfil:6,receiv:6,recent:3,recip:6,recommend:[3,5],recov:[1,5],recoveryparam:1,recurs:[],refer:4,reflect:3,regard:2,regist:[2,3],registr:2,registri:2,regress:10,reject:[1,2,3,6,9],rejectbutton:6,rel:3,releas:[1,5],relev:7,reliabl:[1,3,4],remain:9,remedi:9,remov:[3,6],removealllisten:3,removelisten:3,replai:[3,5,9],repres:[1,4,9],represend:1,represent:[4,9],reproduc:1,request:[1,2],requir:[2,3,4,5,6,7,9],requri:1,reserv:1,resolv:[1,2,3,6,9],resolvenam:3,respect:2,result:[0,1],ricmoo:7,ricmoos:3,rlp:[],root:3,ropsten:[3,4],rpc:3,run:[4,10],safe:[2,4,5,9],salt:5,same:[1,2,3,6,9],sanit:[1,6],save:7,scheme:[1,5],script:7,scrypt:5,scypt:5,second:2,secp256k1:1,secret:5,secur:[4,7],see:[1,2,3,5,9],seed:1,send:[1,2,3,5,6,9],sender:2,sendpromis:[2,5,9],sendtransact:[1,2,3,5,9],sendtransactionpromis:5,sent:[2,3,5,9],separ:6,server:7,servic:3,set:[1,9],setvalu:[1,2],setvalueinfo:1,sever:[1,3,4,6],sha256:4,sha2:4,sha3:4,shortli:6,should:[1,2,3,6,7],show:6,side:8,sign:[],signatur:[1,2,3],signdigest:1,signedtransact:[1,2,3,5,9],signer:[],signingkei:1,simpl:[1,5,6],simplest:2,simplestor:2,simpli:2,simplifi:[2,9],sinc:[2,3,4,9],singl:[3,6,9],slash:1,small:6,sms:2,solid:[1,2],some:[1,2,6,9],somegaslimit:1,somegaspric:1,somethingels:1,somewhat:3,somewher:5,sourc:[],sourcecod:[],special:2,specif:[0,1],specifi:[1,2,3,5],spend:3,spread:6,src:7,standard:[3,6,9],standardethereum:1,start:[],state:0,statu:0,still:3,sting:3,stir:5,storag:5,store:[5,9],string:[0,1],stringifi:5,stripe:4,stripzero:4,stub:6,sub:[],subclass:[1,6],subprovid:6,subsequ:1,suffic:7,suffici:3,suggest:6,suit:10,sup:[],support:[3,4,5,6],sure:5,symbol:4,system:2,take:[2,10],target:3,targetaddress:9,task:6,teh:9,test:[],testcas:10,testnet:[1,3,6],text:[4,7],textcont:6,than:[3,4],thei:[1,2,3],them:[2,4,6],thi:[1,2,3,4,5,6,7,8,9],think:4,those:6,through:[2,4,6],thrown:4,time:[4,5,8,9],timeout:3,timestamp:3,toblock:[1,3],todo:[3,6,10],tohexstr:4,token:3,tonumb:4,too:[3,4,10],tool:6,topic1:3,topic:[1,3,6],tostr:[2,3,4,6],total:3,toutf8byt:[1,2,4],toutf8str:[2,4],transachtionhash:3,transact:[],transactioncount:[3,5,9],transactioncountpromis:[5,9],transactionhash:[1,3,5],transactionindex:3,transactionreceipt:3,transction:3,transfer:5,treat:[4,9],tree:1,trigger:[2,3],trueli:9,tupl:2,turn:3,txfee:6,txfeeinwei:9,type:[0,1],typeduint8arrai:4,uint256:2,uint8arrai:[1,4],uint:2,umbrella:4,uncompress:1,uncompressedpublickei:1,understand:4,uniqu:3,unit:3,unless:[3,5],unregist:3,unsign:2,until:2,url:[1,3],usag:1,usd:3,user:[2,6,7,9],usernam:5,usual:[2,3,7],utf8byt:4,utf:0,util:[1,2,3,4,5],utiliti:0,valid:[1,2,4,9],valu:[1,2,3,4,5,6,9],valuechang:[1,2],valuechangedinfo:1,variabl:[2,3,7],variant:2,vast:3,veri:9,version:5,vulner:3,wai:[1,2,3,5,6,9],wait:2,waitfortransact:[3,9],wallet:[],walletpath:6,web:[],wei:[0,3],well:2,when:[2,3,9],whenev:3,where:6,whether:3,which:[1,2,3,4,5,6,8,9],whole:4,why:[],wiki:1,witch:4,within:[1,2,4],without:2,work:[2,4,6],world:[1,2,4],worri:1,would:[1,4,6],write:8,xe93of8sr0owi6f4fo88kwo4unngg1febhi:4,you:[1,2,4,6,9],your:[6,7,9],yourtransactioncountforyouraddress:1,zero:4},titles:["Application Programming Interface (API)","Low-Level API","Contracts","Providers API","Utilities","Wallets","Cookbook","Getting Started","What is ethers.js","Notes","Testing"],titleterms:{"byte":2,"class":1,"function":4,"static":1,access:6,account:[3,6],action:3,address:[4,9],all:6,another:6,api:[0,1,3],applicat:[0,7],arrai:2,arrayish:4,balanc:6,big:4,block:3,blockchain:[3,5],call:3,can:9,checksum:9,coalesc:6,code:6,confirm:6,connect:[2,3],contract:[2,3,4],cookbook:6,creat:[1,4,5],cryptograph:4,current:6,custom:[2,6],deploi:2,director:[],directori:6,dump:6,empty:6,encode:1,ether:[4,8],ethereum:3,etherscanprovid:3,event:3,exampl:[1,2,3,4,5,9],execut:3,extra:3,fallbackprovid:3,filter:3,from:3,fund:6,get:7,geth:[],hdnode:1,hex:4,icap:9,include:7,infuraprovid:3,inherit:3,install:7,instanc:[1,4,5],integer:2,interfac:[0,1],jaxx:6,json:6,jsonrpcprovid:3,just:9,kei:1,length:1,level:1,low:1,method:1,mnemon:6,node:7,note:9,number:[4,9],object:3,one:6,operat:5,pars:5,phrase:6,prefix:1,program:0,promis:9,prototyp:[1,2,3,5],provid:[1,3,6],receipt:3,recurs:1,request:3,respons:3,result:[2,3],rlp:1,sign:1,signer:[2,6],sourc:6,specif:3,start:7,state:3,statu:3,string:[2,4],sub:1,tag:3,test:10,transact:[3,5,6],type:[2,3],utf:4,utiliti:4,wait:3,wallet:[5,6],web:7,wei:4,what:8,why:9}})
\ No newline at end of file
diff --git a/docs/build/html/testing.html b/docs/build/html/testing.html
index 3ce934370..cba1e4809 100644
--- a/docs/build/html/testing.html
+++ b/docs/build/html/testing.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Testing &mdash; ethers.js 2.0.0 documentation</title>
+  <title>Testing &mdash; ethers.js 2.1.0 documentation</title>
   
 
   
@@ -34,7 +34,7 @@
   
 
   
-    <link rel="top" title="ethers.js 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="ethers.js 2.1.0 documentation" href="index.html"/>
         <link rel="prev" title="Notes" href="notes.html"/> 
 
   
@@ -63,7 +63,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.1.0
               </div>
             
           
@@ -191,7 +191,7 @@ generate and are too large to check into GitHub)</dd>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.1.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/source/api-contract.rst b/docs/source/api-contract.rst
index bbfebe3c5..0aa498935 100644
--- a/docs/source/api-contract.rst
+++ b/docs/source/api-contract.rst
@@ -22,8 +22,8 @@ To better see this demonstrated, see the `example`_ below.
 Connecting to a Contract
 ========================
 
-new :sup:`ethers` . Contract ( address , interface , providerOrSigner )
-    Connects to the contract at *address* defined by *interface*, which
+new :sup:`ethers` . Contract ( addressOrName , interface , providerOrSigner )
+    Connects to the contract at *addressOrName* defined by *interface*, which
     may be a JSON string or the parsed object.
 
     The *providerOrSigner* may be any instance of the following:
@@ -66,7 +66,7 @@ function with a given name will be available. (In the future this will
 be addressed by adding parameter explicit calls).
 
 :sup:`prototype` . address
-    The address of the contract.
+    The address (or ENS name) of the contract.
 
 :sup:`prototype` . interface
     The :ref:`Interface <api-interface>` meta-class of the parsed
diff --git a/docs/source/api-providers.rst b/docs/source/api-providers.rst
index 321efe991..f9dc92e1e 100644
--- a/docs/source/api-providers.rst
+++ b/docs/source/api-providers.rst
@@ -126,19 +126,22 @@ InfuraProvider :sup:`( inherits from JsonRpcProvider )`
 Account Actions
 ===============
 
-:sup:`prototype` . getBalance ( address [ , blockTag ] )
+:sup:`prototype` . getBalance ( addressOrName [ , blockTag ] )
     Returns a :ref:`Promise <promise>` with the balance (as a :ref:`BigNumber <bignumber>`) of
-    *address* at *blockTag*. (See: `Block Tags <blocktag>`_)
+    *addressOrName* at *blockTag*. (See: `Block Tags <blocktag>`_)
 
     **default:** *blockTag*\ ="latest"
 
-:sup:`prototype` . getTransactionCount ( address [ , blockTag ] )
+:sup:`prototype` . getTransactionCount ( addressOrName [ , blockTag ] )
     Returns a :ref:`Promise <promise>` with the number of sent transactions (as a Number) from
-    *address* at *blockTag*. This is also the nonce required to send a new
+    *addressOrName* at *blockTag*. This is also the nonce required to send a new
     transaction. (See: `Block Tags <blocktag>`_)
 
     **default:** *blockTag*\ ="latest"
 
+:sup:`prototype` . resolveName ( ensName )
+    Returns a :ref:`Promise <promise>` with the address (or null) of that the *ensName* resolves
+    to.
 
 *Examples*
 ----------
@@ -161,6 +164,10 @@ Account Actions
         console.log("Total Transactions Ever Send: " + transactionCount);
     });
 
+    provider.resolveName("test.ricmoose.eth").then(function(address) {
+        console.log("Address: " + address);
+    });
+
 -----
 
 Blockchain Status
@@ -271,12 +278,13 @@ usually be used instead.
 Contract State
 ==============
 
-:sup:`prototype` . getCode ( address )
-    Returns a :ref:`Promise <promise>` with the bytecode (as a :ref:`hex string <hexstring>`) at  *address*.
+:sup:`prototype` . getCode ( addressOrName )
+    Returns a :ref:`Promise <promise>` with the bytecode (as a :ref:`hex string <hexstring>`)
+    at  *addressOrName*.
 
-:sup:`prototype` . getStorageAt ( address, position [ , blockTag ] )
-    Returns a :ref:`Promise <promise>` with the value (as a :ref:`hex string <hexstring>`) at *address* in
-    *position* at *blockTag*. (See `Block Tags <blocktag>`_)
+:sup:`prototype` . getStorageAt ( addressOrName, position [ , blockTag ] )
+    Returns a :ref:`Promise <promise>` with the value (as a :ref:`hex string <hexstring>`) at
+    *addressOrName* in *position* at *blockTag*. (See `Block Tags <blocktag>`_)
 
     default: *blockTag*\ = "latest"
 
@@ -324,6 +332,11 @@ Event Types
 
     ``callback( blockNumber )``
 
+any address
+   When the balance of the coresposding address changes.
+
+    ``callback( balance )``
+
 any transaction hash
     When the coresponding transaction is mined; also see
     `Waiting for Transactions <waitForTransaction>`_
@@ -355,6 +368,10 @@ Waiting for Transactions
         console.log('New Block: ' + blockNumber);
     });
 
+    // Get notified on account balance change
+    provider.on('0x46Fa84b9355dB0708b6A57cd6ac222950478Be1d', function(blockNumber) {
+        console.log('New Block: ' + blockNumber);
+    });
 
     // Get notified when a transaction is mined
     provider.once(transactionHash, function(transction) {
@@ -439,17 +456,17 @@ or :ref:`hex string <hexstring>`.
     // Example:
     {
         // Required unless deploying a contract (in which case omit)
-        to: address,      // the target address
+        to: addressOrName,  // the target address or ENS name
 
         // These are optional/meaningless for call and estimateGas
-        nonce: 0,         // the transaction nonce
-        gasLimit: 0,      // the maximum gas this transaction may spend
-        gasPrice: 0,      // the price (in wei) per unit of gas
+        nonce: 0,           // the transaction nonce
+        gasLimit: 0,        // the maximum gas this transaction may spend
+        gasPrice: 0,        // the price (in wei) per unit of gas
 
         // These are always optional (but for call, data is usually specified)
-        data: "0x",       // extra data for the transaction, or input for call
-        value: 0,         // the amount (in wei) this transaction is sending
-        chainId: 3        // the network ID; usually added by a signer
+        data: "0x",         // extra data for the transaction, or input for call
+        value: 0,           // the amount (in wei) this transaction is sending
+        chainId: 3          // the network ID; usually added by a signer
     }
 
 
@@ -549,8 +566,8 @@ The *EtherscanProvider* only supports a single topic.
         fromBlock: "latest",
         toBlock: "latest",
 
-        // Optional; An address to filter by
-        address: address,
+        // Optional; An address (or ENS name) to filter by
+        address: addressOrName,
 
         // Optional; A (possibly nested) list of topics
         topics: [ topic1 ]
diff --git a/docs/source/api-wallet.rst b/docs/source/api-wallet.rst
index b0e6a9b03..8683b3581 100644
--- a/docs/source/api-wallet.rst
+++ b/docs/source/api-wallet.rst
@@ -216,8 +216,8 @@ These operations require the wallet have a provider attached to it.
     details. It is highly recommended to omit *transaction.chainId*, it will be
     filled in by *provider*.
 
-:sup:`prototype` . send ( address, amountWei [ , options ] )
-    Sends *amountWei* to *address* on the network and returns a Promise with the
+:sup:`prototype` . send ( addressOrName, amountWei [ , options ] )
+    Sends *amountWei* to *addressOrName* on the network and returns a Promise with the
     transaction details.
 
 *Examples*
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 2bb09dd09..afdc6013d 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -59,9 +59,9 @@ author = u'Richard Moore <me@ricmoo.com>'
 # built documents.
 #
 # The short X.Y version.
-version = u'2.0.0'
+version = u'2.1.0'
 # The full version, including alpha/beta/rc tags.
-release = u'2.0.0'
+release = u'2.1.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.