Skip to content

Commit 086f2df

Browse files
committed
rebuild docs
1 parent ff57e65 commit 086f2df

20 files changed

+83
-27
lines changed
945 Bytes
Binary file not shown.
5 Bytes
Binary file not shown.
-5 Bytes
Binary file not shown.
-376 Bytes
Binary file not shown.
2.87 KB
Binary file not shown.
489 Bytes
Binary file not shown.
163 Bytes
Binary file not shown.

docs/_build/doctrees/web3.doctree

1.38 KB
Binary file not shown.

docs/_build/html/_sources/web3-eth-accounts.txt

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,10 @@ To use this package standalone use:
1515
.. code-block:: javascript
1616

1717
var Accounts = require('web3-eth-accounts');
18-
var Eth = require('web3-eth');
19-
var eth = new Eth('ws://localhost:8546');
2018

2119
// Passing in the eth or web3 package is necessary to allow retrieving chainId, gasPrice and nonce automatically
2220
// for accounts.signTransaction().
23-
var accounts = new Accounts(eth);
24-
25-
// If nonce, chainId and gasPrice will be always given you don't need to pass in the Eth, or web3 package.
26-
var accounts = new Accounts();
21+
var accounts = new Accounts('ws://localhost:8546');
2722

2823

2924

@@ -612,7 +607,7 @@ Adds an account using a private key or account object to the wallet.
612607
Parameters
613608
----------
614609

615-
1. ``account`` - ``String|Object``: A private key or account object created with :ref:`web3.eth.accounts.new() <accounts-create>`.
610+
1. ``account`` - ``String|Object``: A private key or account object created with :ref:`web3.eth.accounts.create() <accounts-create>`.
616611

617612

618613
-------

docs/_build/html/_sources/web3-eth-contract.txt

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,21 @@ and web3 will auto convert all calls into low level ABI calls over RPC for you.
1212

1313
This allows you to interact with smart contracts as if they were JavaScript objects.
1414

15+
To use it standalone:
16+
17+
.. code-block:: javascript
18+
var Contract = require('web3-eth-contract');
19+
20+
// set provider for all later instances to use
21+
Contract.setProvider('ws://localhost:8546');
22+
23+
var contract = new Contract(jsonInterface, address);
24+
25+
contract.methods.somFunc().send({from: ....})
26+
.on('receipt', function(){
27+
...
28+
});
29+
1530

1631
------------------------------------------------------------------------------
1732

@@ -581,6 +596,7 @@ Example
581596
topics: ['0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7', '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385']
582597
},
583598
event: 'MyEvent',
599+
signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
584600
logIndex: 0,
585601
transactionIndex: 0,
586602
transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
@@ -744,6 +760,7 @@ Example
744760
topics: ['0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7', '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385']
745761
},
746762
event: 'MyEvent',
763+
signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
747764
logIndex: 0,
748765
transactionIndex: 0,
749766
transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
@@ -792,6 +809,7 @@ Returns
792809
The structure of the returned event ``Object`` looks as follows:
793810

794811
- ``event`` - ``String``: The event name.
812+
- ``signature`` - ``String|Null``: The event signature, ``null`` if its an anonymous event.
795813
- ``address`` - ``String``: From which this event originated from.
796814
- ``returnValues`` - ``Object``: The return values coming from the event, e.g. ``{myVar: 1, myVar2: '0x234...'}``.
797815
- ``logIndex`` - ``Number``: Integer of the event index position in the block.
@@ -832,6 +850,7 @@ Example
832850
topics: ['0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7', '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385']
833851
},
834852
event: 'MyEvent',
853+
signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
835854
logIndex: 0,
836855
transactionIndex: 0,
837856
transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
@@ -913,6 +932,7 @@ Example
913932
topics: ['0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7', '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385']
914933
},
915934
event: 'MyEvent',
935+
signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
916936
logIndex: 0,
917937
transactionIndex: 0,
918938
transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',

docs/_build/html/_sources/web3-eth-personal.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,8 @@ Parameters
9393

9494
1. ``String`` - Data to sign. If String it will be converted using :ref:`web3.utils.utf8ToHex <utils-utf8tohex>`.
9595
2. ``String`` - Address to sign data with.
96-
3. ``Function`` - (optional) Optional callback, returns an error object as first parameter and the result as second.
96+
3. ``String`` - The password of the account to sign data with.
97+
4. ``Function`` - (optional) Optional callback, returns an error object as first parameter and the result as second.
9798

9899

99100
-------

docs/_build/html/_sources/web3-utils.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,7 @@ sha3
217217

218218
Will calculate the sha3 of the input.
219219

220-
.. note:: To mimick the sha3 behaviour of solidity use :ref:`soliditySah3 <utils-soliditysha3>`
220+
.. note:: To mimic the sha3 behaviour of solidity use :ref:`soliditySah3 <utils-soliditysha3>`
221221

222222
----------
223223
Parameters
@@ -265,6 +265,7 @@ soliditySha3
265265
web3.utils.soliditySha3(param1 [, param2, ...])
266266

267267
Will calculate the sha3 of given input parameters in the same way solidity would.
268+
This means arguments will be ABI converted and tightly packed before being hashed.
268269

269270
----------
270271
Parameters

docs/_build/html/_sources/web3.txt

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,18 @@ The web3.js object is a umbrella package to house all ethereum related modules.
1111

1212
var Web3 = require('web3');
1313

14+
> Web3.utils
15+
> Web3.version
16+
> Web3.modules
17+
1418
// "Web3.providers.givenProvider" will be set if in an Ethereum supported browser.
1519
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');
1620

1721
> web3.eth
1822
> web3.shh
1923
> web3.bzz
2024
> web3.utils
25+
> web3.version
2126

2227

2328

@@ -29,6 +34,7 @@ version
2934

3035
.. code-block:: javascript
3136

37+
Web3.version
3238
web3.version
3339

3440
Contains the version of the ``web3`` container object.
@@ -49,11 +55,6 @@ Example
4955
> "1.0.0"
5056

5157

52-
------------------------------------------------------------------------------
53-
54-
55-
.. include:: package-core.rst
56-
5758

5859
------------------------------------------------------------------------------
5960

@@ -63,6 +64,7 @@ modules
6364

6465
.. code-block:: javascript
6566

67+
Web3.modules
6668
web3.modules
6769

6870
Will return an object with the classes of all major sub modules, to be able to instantiate them manually.
@@ -98,6 +100,22 @@ Example
98100
------------------------------------------------------------------------------
99101

100102

103+
utils
104+
=====================
105+
106+
.. code-block:: javascript
107+
108+
Web3.utils
109+
web3.utils
110+
111+
Utility functions are also exposes on the ``Web3`` class object directly.
112+
113+
See :ref:`web3.utils <utils>` for more.
114+
115+
116+
------------------------------------------------------------------------------
117+
118+
101119
.. include:: include_package-core.rst
102120

103121

docs/_build/html/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ <h1>web3.js - Ethereum JavaScript API<a class="headerlink" href="#web3-js-ethere
7979
<li class="toctree-l1"><a class="reference internal" href="web3.html">web3</a><ul>
8080
<li class="toctree-l2"><a class="reference internal" href="web3.html#version">version</a></li>
8181
<li class="toctree-l2"><a class="reference internal" href="web3.html#modules">modules</a></li>
82+
<li class="toctree-l2"><a class="reference internal" href="web3.html#utils">utils</a></li>
8283
<li class="toctree-l2"><a class="reference internal" href="web3.html#setprovider">setProvider</a></li>
8384
<li class="toctree-l2"><a class="reference internal" href="web3.html#providers">providers</a></li>
8485
<li class="toctree-l2"><a class="reference internal" href="web3.html#givenprovider">givenProvider</a></li>

docs/_build/html/searchindex.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/_build/html/web3-eth-accounts.html

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -60,15 +60,10 @@ <h1>web3.eth.accounts<a class="headerlink" href="#web3-eth-accounts" title="Perm
6060
<p>The <code class="docutils literal"><span class="pre">web3.eth.accounts</span></code> contains functions to generate Ethereum accounts and sign transactions and data.</p>
6161
<p>To use this package standalone use:</p>
6262
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="kd">var</span> <span class="nx">Accounts</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s1">&#39;web3-eth-accounts&#39;</span><span class="p">);</span>
63-
<span class="kd">var</span> <span class="nx">Eth</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s1">&#39;web3-eth&#39;</span><span class="p">);</span>
64-
<span class="kd">var</span> <span class="nx">eth</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Eth</span><span class="p">(</span><span class="s1">&#39;ws://localhost:8546&#39;</span><span class="p">);</span>
6563

6664
<span class="c1">// Passing in the eth or web3 package is necessary to allow retrieving chainId, gasPrice and nonce automatically</span>
6765
<span class="c1">// for accounts.signTransaction().</span>
68-
<span class="kd">var</span> <span class="nx">accounts</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Accounts</span><span class="p">(</span><span class="nx">eth</span><span class="p">);</span>
69-
70-
<span class="c1">// If nonce, chainId and gasPrice will be always given you don&#39;t need to pass in the Eth, or web3 package.</span>
71-
<span class="kd">var</span> <span class="nx">accounts</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Accounts</span><span class="p">();</span>
66+
<span class="kd">var</span> <span class="nx">accounts</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Accounts</span><span class="p">(</span><span class="s1">&#39;ws://localhost:8546&#39;</span><span class="p">);</span>
7267
</pre></div>
7368
</div>
7469
<hr class="docutils" />
@@ -563,7 +558,7 @@ <h2>wallet.add<a class="headerlink" href="#wallet-add" title="Permalink to this
563558
<div class="section" id="id29">
564559
<h3>Parameters<a class="headerlink" href="#id29" title="Permalink to this headline"></a></h3>
565560
<ol class="arabic simple">
566-
<li><code class="docutils literal"><span class="pre">account</span></code> - <code class="docutils literal"><span class="pre">String|Object</span></code>: A private key or account object created with <a class="reference internal" href="#accounts-create"><span class="std std-ref">web3.eth.accounts.new()</span></a>.</li>
561+
<li><code class="docutils literal"><span class="pre">account</span></code> - <code class="docutils literal"><span class="pre">String|Object</span></code>: A private key or account object created with <a class="reference internal" href="#accounts-create"><span class="std std-ref">web3.eth.accounts.create()</span></a>.</li>
567562
</ol>
568563
</div>
569564
<div class="section" id="id30">

docs/_build/html/web3-eth-contract.html

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ <h1>web3.eth.Contract<a class="headerlink" href="#web3-eth-contract" title="Perm
6161
When you create a new contract object you give it the json interface of the respective smart contract
6262
and web3 will auto convert all calls into low level ABI calls over RPC for you.</p>
6363
<p>This allows you to interact with smart contracts as if they were JavaScript objects.</p>
64+
<p>To use it standalone:</p>
6465
<hr class="docutils" />
6566
<div class="section" id="new-contract">
6667
<h2>new contract<a class="headerlink" href="#new-contract" title="Permalink to this headline"></a></h2>
@@ -547,6 +548,7 @@ <h3>Example<a class="headerlink" href="#id21" title="Permalink to this headline"
547548
<span class="nx">topics</span><span class="o">:</span> <span class="p">[</span><span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">]</span>
548549
<span class="p">},</span>
549550
<span class="nx">event</span><span class="o">:</span> <span class="s1">&#39;MyEvent&#39;</span><span class="p">,</span>
551+
<span class="nx">signature</span><span class="o">:</span> <span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span>
550552
<span class="nx">logIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
551553
<span class="nx">transactionIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
552554
<span class="nx">transactionHash</span><span class="o">:</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">,</span>
@@ -688,6 +690,7 @@ <h3>Example<a class="headerlink" href="#id30" title="Permalink to this headline"
688690
<span class="nx">topics</span><span class="o">:</span> <span class="p">[</span><span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">]</span>
689691
<span class="p">},</span>
690692
<span class="nx">event</span><span class="o">:</span> <span class="s1">&#39;MyEvent&#39;</span><span class="p">,</span>
693+
<span class="nx">signature</span><span class="o">:</span> <span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span>
691694
<span class="nx">logIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
692695
<span class="nx">transactionIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
693696
<span class="nx">transactionHash</span><span class="o">:</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">,</span>
@@ -734,6 +737,7 @@ <h3>Parameters<a class="headerlink" href="#id32" title="Permalink to this headli
734737
<p>The structure of the returned event <code class="docutils literal"><span class="pre">Object</span></code> looks as follows:</p>
735738
<ul class="simple">
736739
<li><code class="docutils literal"><span class="pre">event</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: The event name.</li>
740+
<li><code class="docutils literal"><span class="pre">signature</span></code> - <code class="docutils literal"><span class="pre">String|Null</span></code>: The event signature, <code class="docutils literal"><span class="pre">null</span></code> if its an anonymous event.</li>
737741
<li><code class="docutils literal"><span class="pre">address</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: From which this event originated from.</li>
738742
<li><code class="docutils literal"><span class="pre">returnValues</span></code> - <code class="docutils literal"><span class="pre">Object</span></code>: The return values coming from the event, e.g. <code class="docutils literal"><span class="pre">{myVar:</span> <span class="pre">1,</span> <span class="pre">myVar2:</span> <span class="pre">'0x234...'}</span></code>.</li>
739743
<li><code class="docutils literal"><span class="pre">logIndex</span></code> - <code class="docutils literal"><span class="pre">Number</span></code>: Integer of the event index position in the block.</li>
@@ -771,6 +775,7 @@ <h3>Example<a class="headerlink" href="#id34" title="Permalink to this headline"
771775
<span class="nx">topics</span><span class="o">:</span> <span class="p">[</span><span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">]</span>
772776
<span class="p">},</span>
773777
<span class="nx">event</span><span class="o">:</span> <span class="s1">&#39;MyEvent&#39;</span><span class="p">,</span>
778+
<span class="nx">signature</span><span class="o">:</span> <span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span>
774779
<span class="nx">logIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
775780
<span class="nx">transactionIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
776781
<span class="nx">transactionHash</span><span class="o">:</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">,</span>
@@ -845,6 +850,7 @@ <h3>Example<a class="headerlink" href="#id37" title="Permalink to this headline"
845850
<span class="nx">topics</span><span class="o">:</span> <span class="p">[</span><span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">]</span>
846851
<span class="p">},</span>
847852
<span class="nx">event</span><span class="o">:</span> <span class="s1">&#39;MyEvent&#39;</span><span class="p">,</span>
853+
<span class="nx">signature</span><span class="o">:</span> <span class="s1">&#39;0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7&#39;</span><span class="p">,</span>
848854
<span class="nx">logIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
849855
<span class="nx">transactionIndex</span><span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
850856
<span class="nx">transactionHash</span><span class="o">:</span> <span class="s1">&#39;0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385&#39;</span><span class="p">,</span>

docs/_build/html/web3-eth-personal.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -373,6 +373,7 @@ <h3>Parameters<a class="headerlink" href="#id15" title="Permalink to this headli
373373
<ol class="arabic simple">
374374
<li><code class="docutils literal"><span class="pre">String</span></code> - Data to sign. If String it will be converted using <a class="reference internal" href="web3-utils.html#utils-utf8tohex"><span class="std std-ref">web3.utils.utf8ToHex</span></a>.</li>
375375
<li><code class="docutils literal"><span class="pre">String</span></code> - Address to sign data with.</li>
376+
<li><code class="docutils literal"><span class="pre">String</span></code> - The password of the account to sign data with.</li>
376377
<li><code class="docutils literal"><span class="pre">Function</span></code> - (optional) Optional callback, returns an error object as first parameter and the result as second.</li>
377378
</ol>
378379
</div>

docs/_build/html/web3-utils.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ <h2>sha3<a class="headerlink" href="#sha3" title="Permalink to this headline">¶
215215
<p>Will calculate the sha3 of the input.</p>
216216
<div class="admonition note">
217217
<p class="first admonition-title">Note</p>
218-
<p class="last">To mimick the sha3 behaviour of solidity use <a class="reference internal" href="#utils-soliditysha3"><span class="std std-ref">soliditySah3</span></a></p>
218+
<p class="last">To mimic the sha3 behaviour of solidity use <a class="reference internal" href="#utils-soliditysha3"><span class="std std-ref">soliditySah3</span></a></p>
219219
</div>
220220
<div class="section" id="id12">
221221
<h3>Parameters<a class="headerlink" href="#id12" title="Permalink to this headline"></a></h3>
@@ -253,7 +253,8 @@ <h3>Example<a class="headerlink" href="#id14" title="Permalink to this headline"
253253
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">soliditySha3</span><span class="p">(</span><span class="nx">param1</span> <span class="p">[,</span> <span class="nx">param2</span><span class="p">,</span> <span class="p">...])</span>
254254
</pre></div>
255255
</div>
256-
<p>Will calculate the sha3 of given input parameters in the same way solidity would.</p>
256+
<p>Will calculate the sha3 of given input parameters in the same way solidity would.
257+
This means arguments will be ABI converted and tightly packed before being hashed.</p>
257258
<div class="section" id="id15">
258259
<h3>Parameters<a class="headerlink" href="#id15" title="Permalink to this headline"></a></h3>
259260
<ol class="arabic">

0 commit comments

Comments
 (0)