mirror of
https://github.com/embarklabs/web3.js.git
synced 2026-08-31 14:41:17 +00:00
1272 lines
99 KiB
HTML
1272 lines
99 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>web3.utils — web3.js 1.0.0 documentation</title>
|
|
|
|
<link rel="stylesheet" href="_static/classic.css" type="text/css" />
|
|
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: './',
|
|
VERSION: '1.0.0',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="_static/jquery.js"></script>
|
|
<script type="text/javascript" src="_static/underscore.js"></script>
|
|
<script type="text/javascript" src="_static/doctools.js"></script>
|
|
<link rel="index" title="Index" href="genindex.html" />
|
|
<link rel="search" title="Search" href="search.html" />
|
|
<link rel="top" title="web3.js 1.0.0 documentation" href="index.html" />
|
|
<link rel="prev" title="web3.shh" href="web3-shh.html" />
|
|
</head>
|
|
<body role="document">
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
accesskey="I">index</a></li>
|
|
<li class="right" >
|
|
<a href="web3-shh.html" title="web3.shh"
|
|
accesskey="P">previous</a> |</li>
|
|
<li class="nav-item nav-item-0"><a href="index.html">web3.js 1.0.0 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body" role="main">
|
|
|
|
<div class="admonition note" id="utils">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">This documentation is work in progress and web3.js 1.0 is not yet released! You can find the current documentation for web3 0.x.x at <a class="reference external" href="https://github.com/ethereum/wiki/wiki/JavaScript-API">github.com/ethereum/wiki/wiki/JavaScript-API</a>.</p>
|
|
</div>
|
|
<div class="section" id="web3-utils">
|
|
<h1>web3.utils<a class="headerlink" href="#web3-utils" title="Permalink to this headline">¶</a></h1>
|
|
<p>This package provides utility functions for Ethereum dapps and other web3.js packages.</p>
|
|
<hr class="docutils" />
|
|
<div class="section" id="randomhex">
|
|
<h2>randomHex<a class="headerlink" href="#randomhex" title="Permalink to this headline">¶</a></h2>
|
|
<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">randomHex</span><span class="p">(</span><span class="nx">size</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>The <a href="#id78"><span class="problematic" id="id79">`randomHex <https://github.com/frozeman/randomHex`_</span></a> library to generate cryptographically strong pseudo-random HEX strings from a given byte size.</p>
|
|
<div class="section" id="parameters">
|
|
<h3>Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">size</span></code> - <code class="docutils literal"><span class="pre">Number</span></code>: The byte size for the HEX string, e.g. <code class="docutils literal"><span class="pre">32</span></code> will result in a 32 bytes HEX string with 64 characters preficed with “0x”.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="returns">
|
|
<h3>Returns<a class="headerlink" href="#returns" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The generated random HEX string.</p>
|
|
</div>
|
|
<div class="section" id="example">
|
|
<h3>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h3>
|
|
<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">randomHex</span><span class="p">(</span><span class="mi">32</span><span class="p">)</span>
|
|
<span class="o">></span> <span class="s2">"0xa5b9d60f32436310afebcfda832817a68921beb782fabf7915cc0460b443116a"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">randomHex</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
|
|
<span class="o">></span> <span class="s2">"0x6892ffc6"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">randomHex</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
|
|
<span class="o">></span> <span class="s2">"0x99d6"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">randomHex</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
|
|
<span class="o">></span> <span class="s2">"0x9a"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">randomHex</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
|
|
<span class="o">></span> <span class="s2">"0x"</span>
|
|
</pre></div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
</div>
|
|
</div>
|
|
<div class="section" id="id1">
|
|
<h2>_<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
|
<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">_</span><span class="p">()</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>The <a href="#id80"><span class="problematic" id="id81">`underscore <http://underscorejs.org`_</span></a> library for many convenience JavaScript functions.</p>
|
|
<p>See the <a href="#id82"><span class="problematic" id="id83">`underscore API reference <http://underscorejs.org`_</span></a> for details.</p>
|
|
<div class="section" id="id2">
|
|
<h3>Example<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
|
|
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="kd">var</span> <span class="nx">_</span> <span class="o">=</span> <span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">_</span><span class="p">;</span>
|
|
|
|
<span class="nx">_</span><span class="p">.</span><span class="nx">union</span><span class="p">([</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">],[</span><span class="mi">3</span><span class="p">]);</span>
|
|
<span class="o">></span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">]</span>
|
|
|
|
<span class="nx">_</span><span class="p">.</span><span class="nx">each</span><span class="p">({</span><span class="nx">my</span><span class="o">:</span> <span class="s1">'object'</span><span class="p">},</span> <span class="kd">function</span><span class="p">(</span><span class="nx">value</span><span class="p">,</span> <span class="nx">key</span><span class="p">){</span> <span class="p">...</span> <span class="p">})</span>
|
|
|
|
<span class="p">...</span>
|
|
</pre></div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
</div>
|
|
</div>
|
|
<div class="section" id="bn">
|
|
<span id="utils-bn"></span><h2>BN<a class="headerlink" href="#bn" title="Permalink to this headline">¶</a></h2>
|
|
<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">BN</span><span class="p">(</span><span class="nx">mixed</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>The <a href="#id84"><span class="problematic" id="id85">`BN.js <https://github.com/indutny/bn.js/`_</span></a> library for calculating with big numbers in JavaScript.
|
|
See the <cite>BN.js documentation <https://github.com/indutny/bn.js/</cite> for details.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">For safe conversion of many types, incl <a href="#id86"><span class="problematic" id="id87">`BigNumber.js <http://mikemcl.github.io/bignumber.js/`_</span></a> use <a class="reference internal" href="#utils-tobn"><span class="std std-ref">utils.toBN</span></a></p>
|
|
</div>
|
|
<div class="section" id="id3">
|
|
<h3>Parameters<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">mixed</span></code> - <code class="docutils literal"><span class="pre">String|Number</span></code>: A number, number string or HEX string to convert to a BN object.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id4">
|
|
<h3>Returns<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Object</span></code>: The <a href="#id88"><span class="problematic" id="id89">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</p>
|
|
</div>
|
|
<div class="section" id="id5">
|
|
<h3>Example<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
|
|
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="kd">var</span> <span class="nx">BN</span> <span class="o">=</span> <span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">BN</span><span class="p">;</span>
|
|
|
|
<span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="mi">1234</span><span class="p">).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"1234"</span>
|
|
|
|
<span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'1234'</span><span class="p">).</span><span class="nx">add</span><span class="p">(</span><span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'1'</span><span class="p">)).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"1235"</span>
|
|
|
|
<span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'0xea'</span><span class="p">).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"234"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="isbn">
|
|
<h2>isBN<a class="headerlink" href="#isbn" title="Permalink to this headline">¶</a></h2>
|
|
<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">isBN</span><span class="p">(</span><span class="nx">bn</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Checks if a given value is a <a href="#id90"><span class="problematic" id="id91">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</p>
|
|
<div class="section" id="id6">
|
|
<h3>Parameters<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">bn</span></code> - <code class="docutils literal"><span class="pre">Object</span></code>: An <a href="#id92"><span class="problematic" id="id93">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id7">
|
|
<h3>Returns<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Boolean</span></code></p>
|
|
</div>
|
|
<div class="section" id="id8">
|
|
<h3>Example<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h3>
|
|
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="kd">var</span> <span class="nx">number</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="mi">10</span><span class="p">);</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isBN</span><span class="p">(</span><span class="nx">number</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="isbignumber">
|
|
<h2>isBigNumber<a class="headerlink" href="#isbignumber" title="Permalink to this headline">¶</a></h2>
|
|
<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">isBigNumber</span><span class="p">(</span><span class="nx">bignumber</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Checks if a given value is a <a href="#id94"><span class="problematic" id="id95">`BigNumber.js <http://mikemcl.github.io/bignumber.js/`_</span></a> instance.</p>
|
|
<div class="section" id="id9">
|
|
<h3>Parameters<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">bignumber</span></code> - <code class="docutils literal"><span class="pre">Object</span></code>: A <a href="#id96"><span class="problematic" id="id97">`BigNumber.js <http://mikemcl.github.io/bignumber.js/`_</span></a> instance.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id10">
|
|
<h3>Returns<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Boolean</span></code></p>
|
|
</div>
|
|
<div class="section" id="id11">
|
|
<h3>Example<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h3>
|
|
<div class="highlight-javascript"><div class="highlight"><pre><span></span><span class="kd">var</span> <span class="nx">number</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">BigNumber</span><span class="p">(</span><span class="mi">10</span><span class="p">);</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isBigNumber</span><span class="p">(</span><span class="nx">number</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="sha3">
|
|
<h2>sha3<a class="headerlink" href="#sha3" title="Permalink to this headline">¶</a></h2>
|
|
<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">sha3</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">keccak256</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="c1">// ALIAS</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Will calculate the sha3 of the input.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<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>
|
|
</div>
|
|
<div class="section" id="id12">
|
|
<h3>Parameters<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">string</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: A string to hash.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id13">
|
|
<h3>Returns<a class="headerlink" href="#id13" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: the result hash.</p>
|
|
</div>
|
|
<div class="section" id="id14">
|
|
<h3>Example<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h3>
|
|
<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">sha3</span><span class="p">(</span><span class="s1">'234'</span><span class="p">);</span> <span class="c1">// taken as string</span>
|
|
<span class="o">></span> <span class="s2">"0xc1912fee45d61c87cc5ea59dae311904cd86b84fee17cc96966216f811ce6a79"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">sha3</span><span class="p">(</span><span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'234'</span><span class="p">));</span>
|
|
<span class="o">></span> <span class="s2">"0xbc36789e7a1e281436464229828f817d6612f7b477d66591ff96a9e064bcc98a"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">sha3</span><span class="p">(</span><span class="mi">234</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">null</span> <span class="c1">// can't calculate the has of a number</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">sha3</span><span class="p">(</span><span class="mh">0xea</span><span class="p">);</span> <span class="c1">// same as above, just the HEX representation of the number</span>
|
|
<span class="o">></span> <span class="kc">null</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">sha3</span><span class="p">(</span><span class="s1">'0xea'</span><span class="p">);</span> <span class="c1">// will be converted to a byte array first, and then hashed</span>
|
|
<span class="o">></span> <span class="s2">"0x2f20677459120677484f7104c76deb6846a2c071f9b3152c103bb12cd54d1a4a"</span>
|
|
</pre></div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
</div>
|
|
</div>
|
|
<div class="section" id="soliditysha3">
|
|
<span id="utils-soliditysha3"></span><h2>soliditySha3<a class="headerlink" href="#soliditysha3" title="Permalink to this headline">¶</a></h2>
|
|
<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>
|
|
</pre></div>
|
|
</div>
|
|
<p>Will calculate the sha3 of given input parameters in the same way solidity would.</p>
|
|
<div class="section" id="id15">
|
|
<h3>Parameters<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic">
|
|
<li><p class="first"><code class="docutils literal"><span class="pre">paramX</span></code> - <code class="docutils literal"><span class="pre">Mixed</span></code>: Any type, or an object with <code class="docutils literal"><span class="pre">{type:</span> <span class="pre">'uint',</span> <span class="pre">value:</span> <span class="pre">'123456'}</span></code> or <code class="docutils literal"><span class="pre">{t:</span> <span class="pre">'bytes',</span> <span class="pre">v:</span> <span class="pre">'0xfff456'}</span></code>. Basic types are autodetected as follows:</p>
|
|
<blockquote>
|
|
<div><ul class="simple">
|
|
<li><code class="docutils literal"><span class="pre">String</span></code> non numerical UTF-8 string is interpreted as <code class="docutils literal"><span class="pre">string</span></code>.</li>
|
|
<li><code class="docutils literal"><span class="pre">String|Number|BN|HEX</span></code> positive number is interpreted as <code class="docutils literal"><span class="pre">uint256</span></code>.</li>
|
|
<li><code class="docutils literal"><span class="pre">String|Number|BN</span></code> negative number is interpreted as <code class="docutils literal"><span class="pre">int256</span></code>.</li>
|
|
<li><code class="docutils literal"><span class="pre">Boolean</span></code> as <code class="docutils literal"><span class="pre">bool</span></code>.</li>
|
|
<li><code class="docutils literal"><span class="pre">String</span></code> HEX string with leading <code class="docutils literal"><span class="pre">0x</span></code> is interpreted as <code class="docutils literal"><span class="pre">bytes</span></code>.</li>
|
|
<li><code class="docutils literal"><span class="pre">HEX</span></code> HEX number representation is interpreted as <code class="docutils literal"><span class="pre">uint256</span></code>.</li>
|
|
</ul>
|
|
</div></blockquote>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id16">
|
|
<h3>Returns<a class="headerlink" href="#id16" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: the result hash.</p>
|
|
</div>
|
|
<div class="section" id="id17">
|
|
<h3>Example<a class="headerlink" href="#id17" title="Permalink to this headline">¶</a></h3>
|
|
<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="s1">'234564535'</span><span class="p">,</span> <span class="s1">'0xfff23243'</span><span class="p">,</span> <span class="kc">true</span><span class="p">,</span> <span class="o">-</span><span class="mi">10</span><span class="p">);</span>
|
|
<span class="c1">// auto detects: uint256, bytes, bool, int256</span>
|
|
<span class="o">></span> <span class="s2">"0x3e27a893dc40ef8a7f0841d96639de2f58a132be5ae466d40087a2cfa83b7179"</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="s1">'Hello!%'</span><span class="p">);</span> <span class="c1">// auto detects: string</span>
|
|
<span class="o">></span> <span class="s2">"0x661136a4267dba9ccdf6bfddb7c00e714de936674c4bdb065a531cf1cb15c7fc"</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="s1">'234'</span><span class="p">);</span> <span class="c1">// auto detects: uint256</span>
|
|
<span class="o">></span> <span class="s2">"0x61c831beab28d67d1bb40b5ae1a11e2757fa842f031a2d0bc94a7867bc5d26c2"</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="mh">0xea</span><span class="p">);</span> <span class="c1">// same as above</span>
|
|
<span class="o">></span> <span class="s2">"0x61c831beab28d67d1bb40b5ae1a11e2757fa842f031a2d0bc94a7867bc5d26c2"</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="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'234'</span><span class="p">));</span> <span class="c1">// same as above</span>
|
|
<span class="o">></span> <span class="s2">"0x61c831beab28d67d1bb40b5ae1a11e2757fa842f031a2d0bc94a7867bc5d26c2"</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">type</span><span class="o">:</span> <span class="s1">'uint256'</span><span class="p">,</span> <span class="nx">value</span><span class="o">:</span> <span class="s1">'234'</span><span class="p">}));</span> <span class="c1">// same as above</span>
|
|
<span class="o">></span> <span class="s2">"0x61c831beab28d67d1bb40b5ae1a11e2757fa842f031a2d0bc94a7867bc5d26c2"</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">t</span><span class="o">:</span> <span class="s1">'uint'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'234'</span><span class="p">)}));</span> <span class="c1">// same as above</span>
|
|
<span class="o">></span> <span class="s2">"0x61c831beab28d67d1bb40b5ae1a11e2757fa842f031a2d0bc94a7867bc5d26c2"</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="s1">'0x407D73d8a49eeb85D32Cf465507dd71d507100c1'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x4e8ebbefa452077428f93c9520d3edd60594ff452a29ac7d2ccc11d47f3ab95b"</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">t</span><span class="o">:</span> <span class="s1">'bytes'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="s1">'0x407D73d8a49eeb85D32Cf465507dd71d507100c1'</span><span class="p">});</span>
|
|
<span class="o">></span> <span class="s2">"0x4e8ebbefa452077428f93c9520d3edd60594ff452a29ac7d2ccc11d47f3ab95b"</span> <span class="c1">// same result as above</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">t</span><span class="o">:</span> <span class="s1">'address'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="s1">'0x407D73d8a49eeb85D32Cf465507dd71d507100c1'</span><span class="p">});</span>
|
|
<span class="o">></span> <span class="s2">"0x4e8ebbefa452077428f93c9520d3edd60594ff452a29ac7d2ccc11d47f3ab95b"</span> <span class="c1">// same as above, but will do a checksum check, if its multi case</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">t</span><span class="o">:</span> <span class="s1">'bytes32'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="s1">'0x407D73d8a49eeb85D32Cf465507dd71d507100c1'</span><span class="p">});</span>
|
|
<span class="o">></span> <span class="s2">"0x3c69a194aaf415ba5d6afca734660d0a3d45acdc05d54cd1ca89a8988e7625b4"</span> <span class="c1">// different result as above</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">t</span><span class="o">:</span> <span class="s1">'string'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="s1">'Hello!%'</span><span class="p">},</span> <span class="p">{</span><span class="nx">t</span><span class="o">:</span> <span class="s1">'int8'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:-</span><span class="mi">23</span><span class="p">},</span> <span class="p">{</span><span class="nx">t</span><span class="o">:</span> <span class="s1">'address'</span><span class="p">,</span> <span class="nx">v</span><span class="o">:</span> <span class="s1">'0x85F43D8a49eeB85d32Cf465507DD71d507100C1d'</span><span class="p">});</span>
|
|
<span class="o">></span> <span class="s2">"0xa13b31627c1ed7aaded5aecec71baf02fe123797fffd45e662eac8e06fbe4955"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="ishex">
|
|
<h2>isHex<a class="headerlink" href="#ishex" title="Permalink to this headline">¶</a></h2>
|
|
<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">isHex</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Checks if a given string is a HEX string.</p>
|
|
<div class="section" id="id18">
|
|
<h3>Parameters<a class="headerlink" href="#id18" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hex</span></code> - <code class="docutils literal"><span class="pre">String|HEX</span></code>: The given HEX string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id19">
|
|
<h3>Returns<a class="headerlink" href="#id19" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Boolean</span></code></p>
|
|
</div>
|
|
<div class="section" id="id20">
|
|
<h3>Example<a class="headerlink" href="#id20" title="Permalink to this headline">¶</a></h3>
|
|
<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">isHex</span><span class="p">(</span><span class="s1">'0xc1912'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isHex</span><span class="p">(</span><span class="mh">0xc1912</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isHex</span><span class="p">(</span><span class="s1">'c1912'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isHex</span><span class="p">(</span><span class="mi">345</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span> <span class="c1">// this is tricky, as 345 can be a a HEX representation or a number, be careful when not having a 0x in front!</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isHex</span><span class="p">(</span><span class="s1">'0xZ1912'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">false</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isHex</span><span class="p">(</span><span class="s1">'Hello'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">false</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="isaddress">
|
|
<h2>isAddress<a class="headerlink" href="#isaddress" title="Permalink to this headline">¶</a></h2>
|
|
<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">isAddress</span><span class="p">(</span><span class="nx">address</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Checks if a given string is a valid Ethereum address.
|
|
It will also check the checksum, if the address has upper and lowercase letters.</p>
|
|
<div class="section" id="id21">
|
|
<h3>Parameters<a class="headerlink" href="#id21" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">address</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: An address string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id22">
|
|
<h3>Returns<a class="headerlink" href="#id22" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Boolean</span></code></p>
|
|
</div>
|
|
<div class="section" id="id23">
|
|
<h3>Example<a class="headerlink" href="#id23" title="Permalink to this headline">¶</a></h3>
|
|
<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">isAddress</span><span class="p">(</span><span class="s1">'0xc1912fee45d61c87cc5ea59dae31190fffff232d'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isAddress</span><span class="p">(</span><span class="s1">'c1912fee45d61c87cc5ea59dae31190fffff232d'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isAddress</span><span class="p">(</span><span class="s1">'0XC1912FEE45D61C87CC5EA59DAE31190FFFFF232D'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span> <span class="c1">// as all is uppercase, no checksum will be checked</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isAddress</span><span class="p">(</span><span class="s1">'0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">isAddress</span><span class="p">(</span><span class="s1">'0xC1912fEE45d61C87Cc5EA59DaE31190FFFFf232d'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">false</span> <span class="c1">// wrong checksum</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="tochecksumaddress">
|
|
<h2>toChecksumAddress<a class="headerlink" href="#tochecksumaddress" title="Permalink to this headline">¶</a></h2>
|
|
<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">toChecksumAddress</span><span class="p">(</span><span class="nx">address</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Will convert an upper or lowercase Ethereum address to a checksum address.</p>
|
|
<div class="section" id="id24">
|
|
<h3>Parameters<a class="headerlink" href="#id24" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">address</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: An address string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id25">
|
|
<h3>Returns<a class="headerlink" href="#id25" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The checksum address.</p>
|
|
</div>
|
|
<div class="section" id="id26">
|
|
<h3>Example<a class="headerlink" href="#id26" title="Permalink to this headline">¶</a></h3>
|
|
<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">toChecksumAddress</span><span class="p">(</span><span class="s1">'0xc1912fee45d61c87cc5ea59dae31190fffff2323'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toChecksumAddress</span><span class="p">(</span><span class="s1">'0XC1912FEE45D61C87CC5EA59DAE31190FFFFF232D'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d"</span> <span class="c1">// same as above</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="checkaddresschecksum">
|
|
<h2>checkAddressChecksum<a class="headerlink" href="#checkaddresschecksum" title="Permalink to this headline">¶</a></h2>
|
|
<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">checkAddressChecksum</span><span class="p">(</span><span class="nx">address</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Checks the checksum of a given address. Will also return false on non-checksum addresses.</p>
|
|
<div class="section" id="id27">
|
|
<h3>Parameters<a class="headerlink" href="#id27" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">address</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: An address string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id28">
|
|
<h3>Returns<a class="headerlink" href="#id28" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Boolean</span></code>: <code class="docutils literal"><span class="pre">true</span></code> when the checksum of the address is valid, <code class="docutils literal"><span class="pre">false</span></code> if its not a checksum address, or the checksum is invalid.</p>
|
|
</div>
|
|
<div class="section" id="id29">
|
|
<h3>Example<a class="headerlink" href="#id29" title="Permalink to this headline">¶</a></h3>
|
|
<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">checkAddressChecksum</span><span class="p">(</span><span class="s1">'0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="kc">true</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="tohex">
|
|
<h2>toHex<a class="headerlink" href="#tohex" title="Permalink to this headline">¶</a></h2>
|
|
<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">toHex</span><span class="p">(</span><span class="nx">mixed</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Will auto convert any given value to HEX.
|
|
Number strings will interpreted as numbers.
|
|
Text strings will be interpreted as UTF-8 strings.</p>
|
|
<div class="section" id="id30">
|
|
<h3>Parameters<a class="headerlink" href="#id30" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">mixed</span></code> - <code class="docutils literal"><span class="pre">String|Number|BN|BigNumber</span></code>: The input to convert to HEX.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id31">
|
|
<h3>Returns<a class="headerlink" href="#id31" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The resulting HEX string.</p>
|
|
</div>
|
|
<div class="section" id="id32">
|
|
<h3>Example<a class="headerlink" href="#id32" title="Permalink to this headline">¶</a></h3>
|
|
<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">toHex</span><span class="p">(</span><span class="s1">'234'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0xea"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toHex</span><span class="p">(</span><span class="mi">234</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0xea"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toHex</span><span class="p">(</span><span class="k">new</span> <span class="nx">BN</span><span class="p">(</span><span class="s1">'234'</span><span class="p">));</span>
|
|
<span class="o">></span> <span class="s2">"0xea"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toHex</span><span class="p">(</span><span class="k">new</span> <span class="nx">BigNumber</span><span class="p">(</span><span class="s1">'234'</span><span class="p">));</span>
|
|
<span class="o">></span> <span class="s2">"0xea"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toHex</span><span class="p">(</span><span class="s1">'I have 100€'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x49206861766520313030e282ac"</span>
|
|
</pre></div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
</div>
|
|
</div>
|
|
<div class="section" id="tobn">
|
|
<span id="utils-tobn"></span><h2>toBN<a class="headerlink" href="#tobn" title="Permalink to this headline">¶</a></h2>
|
|
<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">toBN</span><span class="p">(</span><span class="nx">number</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Will safly convert any given value (including <a href="#id98"><span class="problematic" id="id99">`BigNumber.js <http://mikemcl.github.io/bignumber.js/`_</span></a> instances) into a <a href="#id100"><span class="problematic" id="id101">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance, for handling big numbers in JavaScript.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">For just the <a href="#id102"><span class="problematic" id="id103">`BN.js <https://github.com/indutny/bn.js/`_</span></a> class use <a class="reference internal" href="#utils-bn"><span class="std std-ref">utils.BN</span></a></p>
|
|
</div>
|
|
<div class="section" id="id33">
|
|
<h3>Parameters<a class="headerlink" href="#id33" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">number</span></code> - <code class="docutils literal"><span class="pre">String|Number|HEX</span></code>: Number to convert to a big number.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id34">
|
|
<h3>Returns<a class="headerlink" href="#id34" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Object</span></code>: The <a href="#id104"><span class="problematic" id="id105">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</p>
|
|
</div>
|
|
<div class="section" id="id35">
|
|
<h3>Example<a class="headerlink" href="#id35" title="Permalink to this headline">¶</a></h3>
|
|
<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">toBN</span><span class="p">(</span><span class="mi">1234</span><span class="p">).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"1234"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toBN</span><span class="p">(</span><span class="s1">'1234'</span><span class="p">).</span><span class="nx">add</span><span class="p">(</span><span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toBN</span><span class="p">(</span><span class="s1">'1'</span><span class="p">)).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"1235"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toBN</span><span class="p">(</span><span class="s1">'0xea'</span><span class="p">).</span><span class="nx">toString</span><span class="p">();</span>
|
|
<span class="o">></span> <span class="s2">"234"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="hextonumberstring">
|
|
<h2>hexToNumberString<a class="headerlink" href="#hextonumberstring" title="Permalink to this headline">¶</a></h2>
|
|
<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">hexToNumberString</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the number representation of a given HEX value as a string.</p>
|
|
<div class="section" id="id36">
|
|
<h3>Parameters<a class="headerlink" href="#id36" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hexString</span></code> - <code class="docutils literal"><span class="pre">String|HEX</span></code>: A string to hash.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id37">
|
|
<h3>Returns<a class="headerlink" href="#id37" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The number as a string.</p>
|
|
</div>
|
|
<div class="section" id="id38">
|
|
<h3>Example<a class="headerlink" href="#id38" title="Permalink to this headline">¶</a></h3>
|
|
<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">hexToNumberString</span><span class="p">(</span><span class="s1">'0xea'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"234"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="hextonumber">
|
|
<h2>hexToNumber<a class="headerlink" href="#hextonumber" title="Permalink to this headline">¶</a></h2>
|
|
<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">hexToNumber</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toDecimal</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the number representation of a given HEX value.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">This is not useful for big numbers, rather use <a class="reference internal" href="#utils-tobn"><span class="std std-ref">utils.toBN</span></a> instead.</p>
|
|
</div>
|
|
<div class="section" id="id39">
|
|
<h3>Parameters<a class="headerlink" href="#id39" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hexString</span></code> - <code class="docutils literal"><span class="pre">String|HEX</span></code>: A string to hash.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id40">
|
|
<h3>Returns<a class="headerlink" href="#id40" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Number</span></code></p>
|
|
</div>
|
|
<div class="section" id="id41">
|
|
<h3>Example<a class="headerlink" href="#id41" title="Permalink to this headline">¶</a></h3>
|
|
<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">hexToNumber</span><span class="p">(</span><span class="s1">'0xea'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="mi">234</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="numbertohex">
|
|
<h2>numberToHex<a class="headerlink" href="#numbertohex" title="Permalink to this headline">¶</a></h2>
|
|
<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">numberToHex</span><span class="p">(</span><span class="nx">number</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromDecimal</span><span class="p">(</span><span class="nx">number</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the HEX representation of a given number value.</p>
|
|
<div class="section" id="id42">
|
|
<h3>Parameters<a class="headerlink" href="#id42" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">number</span></code> - <code class="docutils literal"><span class="pre">String|Number|BN|BigNumber</span></code>: A number as string or number.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id43">
|
|
<h3>Returns<a class="headerlink" href="#id43" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The HEX value of the given number.</p>
|
|
</div>
|
|
<div class="section" id="id44">
|
|
<h3>Example<a class="headerlink" href="#id44" title="Permalink to this headline">¶</a></h3>
|
|
<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">numberToHex</span><span class="p">(</span><span class="s1">'234'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s1">'0xea'</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="hextoutf8">
|
|
<h2>hexToUtf8<a class="headerlink" href="#hextoutf8" title="Permalink to this headline">¶</a></h2>
|
|
<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">hexToUtf8</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">hexToString</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span> <span class="c1">// ALIAS</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toUtf8</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the UTF-8 string representation of a given HEX value.</p>
|
|
<div class="section" id="id45">
|
|
<h3>Parameters<a class="headerlink" href="#id45" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hex</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: A HEX string to convert to a UTF-8 string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id46">
|
|
<h3>Returns<a class="headerlink" href="#id46" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The UTF-8 string.</p>
|
|
</div>
|
|
<div class="section" id="id47">
|
|
<h3>Example<a class="headerlink" href="#id47" title="Permalink to this headline">¶</a></h3>
|
|
<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">hexToUtf8</span><span class="p">(</span><span class="s1">'0x49206861766520313030e282ac'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"I have 100€"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="hextoascii">
|
|
<h2>hexToAscii<a class="headerlink" href="#hextoascii" title="Permalink to this headline">¶</a></h2>
|
|
<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">hexToAscii</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toAscii</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the ASCII string representation of a given HEX value.</p>
|
|
<div class="section" id="id48">
|
|
<h3>Parameters<a class="headerlink" href="#id48" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hex</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: A HEX string to convert to a ASCII string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id49">
|
|
<h3>Returns<a class="headerlink" href="#id49" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The ASCII string.</p>
|
|
</div>
|
|
<div class="section" id="id50">
|
|
<h3>Example<a class="headerlink" href="#id50" title="Permalink to this headline">¶</a></h3>
|
|
<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">hexToAscii</span><span class="p">(</span><span class="s1">'0x4920686176652031303021'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"I have 100!"</span>
|
|
</pre></div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
</div>
|
|
</div>
|
|
<div class="section" id="utf8tohex">
|
|
<span id="utils-utf8tohex"></span><h2>utf8ToHex<a class="headerlink" href="#utf8tohex" title="Permalink to this headline">¶</a></h2>
|
|
<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">utf8ToHex</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">stringToHex</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="c1">// ALIAS</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromUtf8</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the HEX representation of a given UTF-8 string.</p>
|
|
<div class="section" id="id51">
|
|
<h3>Parameters<a class="headerlink" href="#id51" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">string</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: A UTF-8 string to convert to a HEX string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id52">
|
|
<h3>Returns<a class="headerlink" href="#id52" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The HEX string.</p>
|
|
</div>
|
|
<div class="section" id="id53">
|
|
<h3>Example<a class="headerlink" href="#id53" title="Permalink to this headline">¶</a></h3>
|
|
<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">utf8ToHex</span><span class="p">(</span><span class="s1">'I have 100€'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x49206861766520313030e282ac"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="asciitohex">
|
|
<h2>asciiToHex<a class="headerlink" href="#asciitohex" title="Permalink to this headline">¶</a></h2>
|
|
<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">asciiToHex</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromAscii</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="c1">// ALIAS, deprecated</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns the HEX representation of a given ASCII string.</p>
|
|
<div class="section" id="id54">
|
|
<h3>Parameters<a class="headerlink" href="#id54" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">string</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: A ASCII string to convert to a HEX string.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id55">
|
|
<h3>Returns<a class="headerlink" href="#id55" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The HEX string.</p>
|
|
</div>
|
|
<div class="section" id="id56">
|
|
<h3>Example<a class="headerlink" href="#id56" title="Permalink to this headline">¶</a></h3>
|
|
<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">asciiToHex</span><span class="p">(</span><span class="s1">'I have 100!'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x4920686176652031303021"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="hextobytes">
|
|
<h2>hexToBytes<a class="headerlink" href="#hextobytes" title="Permalink to this headline">¶</a></h2>
|
|
<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">hexToBytes</span><span class="p">(</span><span class="nx">hex</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns a byte array from the given HEX string.</p>
|
|
<div class="section" id="id57">
|
|
<h3>Parameters<a class="headerlink" href="#id57" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">hex</span></code> - <code class="docutils literal"><span class="pre">String|HEX</span></code>: A HEX to convert.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id58">
|
|
<h3>Returns<a class="headerlink" href="#id58" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">Array</span></code>: The byte array.</p>
|
|
</div>
|
|
<div class="section" id="id59">
|
|
<h3>Example<a class="headerlink" href="#id59" title="Permalink to this headline">¶</a></h3>
|
|
<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">hexToBytes</span><span class="p">(</span><span class="s1">'0x000000ea'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="p">[</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">234</span> <span class="p">]</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">hexToBytes</span><span class="p">(</span><span class="mh">0x000000ea</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="p">[</span> <span class="mi">234</span> <span class="p">]</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="bytestohex">
|
|
<h2>bytesToHex<a class="headerlink" href="#bytestohex" title="Permalink to this headline">¶</a></h2>
|
|
<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">bytesToHex</span><span class="p">(</span><span class="nx">byteArray</span><span class="p">)</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Returns a HEX string from a byte array.</p>
|
|
<div class="section" id="id60">
|
|
<h3>Parameters<a class="headerlink" href="#id60" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">byteArray</span></code> - <code class="docutils literal"><span class="pre">Array</span></code>: A byte array to convert.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id61">
|
|
<h3>Returns<a class="headerlink" href="#id61" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The HEX string.</p>
|
|
</div>
|
|
<div class="section" id="id62">
|
|
<h3>Example<a class="headerlink" href="#id62" title="Permalink to this headline">¶</a></h3>
|
|
<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">bytesToHex</span><span class="p">([</span> <span class="mi">72</span><span class="p">,</span> <span class="mi">101</span><span class="p">,</span> <span class="mi">108</span><span class="p">,</span> <span class="mi">108</span><span class="p">,</span> <span class="mi">111</span><span class="p">,</span> <span class="mi">33</span><span class="p">,</span> <span class="mi">36</span> <span class="p">]);</span>
|
|
<span class="o">></span> <span class="s2">"0x48656c6c6f2125"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="towei">
|
|
<h2>toWei<a class="headerlink" href="#towei" title="Permalink to this headline">¶</a></h2>
|
|
<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">toWei</span><span class="p">(</span><span class="nx">number</span> <span class="p">[,</span> <span class="nx">unit</span><span class="p">])</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Converts any <a class="reference external" href="http://ethdocs.org/en/latest/ether.html">ether value</a> value into <a href="#id106"><span class="problematic" id="id107">`wei <http://ethereum.stackexchange.com/questions/253/the-ether-denominations-are-called-finney-szabo-and-wei-what-who-are-these-na`_</span></a>.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">“wei” are the smallest ethere unit, and you should always make calculations in wei and convert only for display reasons.</p>
|
|
</div>
|
|
<div class="section" id="id63">
|
|
<h3>Parameters<a class="headerlink" href="#id63" title="Permalink to this headline">¶</a></h3>
|
|
<p>1. <code class="docutils literal"><span class="pre">number</span></code> - <code class="docutils literal"><span class="pre">String|Number|BN</span></code>: The value.
|
|
1. <code class="docutils literal"><span class="pre">unit</span></code> - <code class="docutils literal"><span class="pre">String</span></code> (optional, defaults to <code class="docutils literal"><span class="pre">"ether"</span></code>): The ether to convert from. Possible units are:</p>
|
|
<blockquote>
|
|
<div><ul class="simple">
|
|
<li><code class="docutils literal"><span class="pre">noether</span></code>: ‘0’</li>
|
|
<li><code class="docutils literal"><span class="pre">wei</span></code>: ‘1’</li>
|
|
<li><code class="docutils literal"><span class="pre">kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">babbage</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">femtoether</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">lovelace</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">picoether</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">shannon</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nanoether</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nano</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">szabo</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">microether</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">micro</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">finney</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milliether</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milli</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">ether</span></code>: ‘1000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">kether</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">grand</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mether</span></code>: ‘1000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gether</span></code>: ‘1000000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">tether</span></code>: ‘1000000000000000000000000000000’</li>
|
|
</ul>
|
|
</div></blockquote>
|
|
</div>
|
|
<div class="section" id="id64">
|
|
<h3>Returns<a class="headerlink" href="#id64" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String|BN</span></code>: If a number, or string is given it returns a number string, otherwise a <a href="#id108"><span class="problematic" id="id109">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</p>
|
|
</div>
|
|
<div class="section" id="id65">
|
|
<h3>Example<a class="headerlink" href="#id65" title="Permalink to this headline">¶</a></h3>
|
|
<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">toWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'ether'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"1000000000000000000"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'finney'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"1000000000000000"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'szabo'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"1000000000000"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">toWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'shannon'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"1000000000"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="fromwei">
|
|
<h2>fromWei<a class="headerlink" href="#fromwei" title="Permalink to this headline">¶</a></h2>
|
|
<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">fromWei</span><span class="p">(</span><span class="nx">number</span> <span class="p">[,</span> <span class="nx">unit</span><span class="p">])</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Converts any <a href="#id110"><span class="problematic" id="id111">`wei <http://ethereum.stackexchange.com/questions/253/the-ether-denominations-are-called-finney-szabo-and-wei-what-who-are-these-na`_</span></a> value into a <a class="reference external" href="http://ethdocs.org/en/latest/ether.html">ether value</a>.</p>
|
|
<div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">“wei” are the smallest ethere unit, and you should always make calculations in wei and convert only for display reasons.</p>
|
|
</div>
|
|
<div class="section" id="id67">
|
|
<h3>Parameters<a class="headerlink" href="#id67" title="Permalink to this headline">¶</a></h3>
|
|
<p>1. <code class="docutils literal"><span class="pre">number</span></code> - <code class="docutils literal"><span class="pre">String|Number|BN</span></code>: The value in wei.
|
|
1. <code class="docutils literal"><span class="pre">unit</span></code> - <code class="docutils literal"><span class="pre">String</span></code> (optional, defaults to <code class="docutils literal"><span class="pre">"ether"</span></code>): The ether to convert to. Possible units are:</p>
|
|
<blockquote>
|
|
<div><ul class="simple">
|
|
<li><code class="docutils literal"><span class="pre">noether</span></code>: ‘0’</li>
|
|
<li><code class="docutils literal"><span class="pre">wei</span></code>: ‘1’</li>
|
|
<li><code class="docutils literal"><span class="pre">kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">babbage</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">femtoether</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">lovelace</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">picoether</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">shannon</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nanoether</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nano</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">szabo</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">microether</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">micro</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">finney</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milliether</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milli</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">ether</span></code>: ‘1000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">kether</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">grand</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mether</span></code>: ‘1000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gether</span></code>: ‘1000000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">tether</span></code>: ‘1000000000000000000000000000000’</li>
|
|
</ul>
|
|
</div></blockquote>
|
|
</div>
|
|
<div class="section" id="id68">
|
|
<h3>Returns<a class="headerlink" href="#id68" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String|BN</span></code>: If a number, or string is given it returns a number string, otherwise a <a href="#id112"><span class="problematic" id="id113">`BN.js <https://github.com/indutny/bn.js/`_</span></a> instance.</p>
|
|
</div>
|
|
<div class="section" id="id69">
|
|
<h3>Example<a class="headerlink" href="#id69" title="Permalink to this headline">¶</a></h3>
|
|
<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">fromWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'ether'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0.000000000000000001"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'finney'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0.000000000000001"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'szabo'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0.000000000001"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">fromWei</span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span> <span class="s1">'shannon'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0.000000001"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="unitmap">
|
|
<h2>unitMap<a class="headerlink" href="#unitmap" title="Permalink to this headline">¶</a></h2>
|
|
<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">unitMap</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Shows all possible <a class="reference external" href="http://ethdocs.org/en/latest/ether.html">ether value</a> and their amount in <a href="#id114"><span class="problematic" id="id115">`wei <http://ethereum.stackexchange.com/questions/253/the-ether-denominations-are-called-finney-szabo-and-wei-what-who-are-these-na`_</span></a>.</p>
|
|
<div class="section" id="retrun-value">
|
|
<h3>Retrun value<a class="headerlink" href="#retrun-value" title="Permalink to this headline">¶</a></h3>
|
|
<ul>
|
|
<li><dl class="first docutils">
|
|
<dt><code class="docutils literal"><span class="pre">Object</span></code> with the following properties:</dt>
|
|
<dd><ul class="first last simple">
|
|
<li><code class="docutils literal"><span class="pre">noether</span></code>: ‘0’</li>
|
|
<li><code class="docutils literal"><span class="pre">wei</span></code>: ‘1’</li>
|
|
<li><code class="docutils literal"><span class="pre">kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Kwei</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">babbage</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">femtoether</span></code>: ‘1000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Mwei</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">lovelace</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">picoether</span></code>: ‘1000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">Gwei</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">shannon</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nanoether</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">nano</span></code>: ‘1000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">szabo</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">microether</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">micro</span></code>: ‘1000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">finney</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milliether</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">milli</span></code>: ‘1000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">ether</span></code>: ‘1000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">kether</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">grand</span></code>: ‘1000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">mether</span></code>: ‘1000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">gether</span></code>: ‘1000000000000000000000000000’</li>
|
|
<li><code class="docutils literal"><span class="pre">tether</span></code>: ‘1000000000000000000000000000000’</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="id71">
|
|
<h3>Example<a class="headerlink" href="#id71" title="Permalink to this headline">¶</a></h3>
|
|
<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">unitMap</span>
|
|
<span class="o">></span> <span class="p">{</span>
|
|
<span class="nx">noether</span><span class="o">:</span> <span class="s1">'0'</span><span class="p">,</span>
|
|
<span class="nx">wei</span><span class="o">:</span> <span class="s1">'1'</span><span class="p">,</span>
|
|
<span class="nx">kwei</span><span class="o">:</span> <span class="s1">'1000'</span><span class="p">,</span>
|
|
<span class="nx">Kwei</span><span class="o">:</span> <span class="s1">'1000'</span><span class="p">,</span>
|
|
<span class="nx">babbage</span><span class="o">:</span> <span class="s1">'1000'</span><span class="p">,</span>
|
|
<span class="nx">femtoether</span><span class="o">:</span> <span class="s1">'1000'</span><span class="p">,</span>
|
|
<span class="nx">mwei</span><span class="o">:</span> <span class="s1">'1000000'</span><span class="p">,</span>
|
|
<span class="nx">Mwei</span><span class="o">:</span> <span class="s1">'1000000'</span><span class="p">,</span>
|
|
<span class="nx">lovelace</span><span class="o">:</span> <span class="s1">'1000000'</span><span class="p">,</span>
|
|
<span class="nx">picoether</span><span class="o">:</span> <span class="s1">'1000000'</span><span class="p">,</span>
|
|
<span class="nx">gwei</span><span class="o">:</span> <span class="s1">'1000000000'</span><span class="p">,</span>
|
|
<span class="nx">Gwei</span><span class="o">:</span> <span class="s1">'1000000000'</span><span class="p">,</span>
|
|
<span class="nx">shannon</span><span class="o">:</span> <span class="s1">'1000000000'</span><span class="p">,</span>
|
|
<span class="nx">nanoether</span><span class="o">:</span> <span class="s1">'1000000000'</span><span class="p">,</span>
|
|
<span class="nx">nano</span><span class="o">:</span> <span class="s1">'1000000000'</span><span class="p">,</span>
|
|
<span class="nx">szabo</span><span class="o">:</span> <span class="s1">'1000000000000'</span><span class="p">,</span>
|
|
<span class="nx">microether</span><span class="o">:</span> <span class="s1">'1000000000000'</span><span class="p">,</span>
|
|
<span class="nx">micro</span><span class="o">:</span> <span class="s1">'1000000000000'</span><span class="p">,</span>
|
|
<span class="nx">finney</span><span class="o">:</span> <span class="s1">'1000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">milliether</span><span class="o">:</span> <span class="s1">'1000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">milli</span><span class="o">:</span> <span class="s1">'1000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">ether</span><span class="o">:</span> <span class="s1">'1000000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">kether</span><span class="o">:</span> <span class="s1">'1000000000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">grand</span><span class="o">:</span> <span class="s1">'1000000000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">mether</span><span class="o">:</span> <span class="s1">'1000000000000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">gether</span><span class="o">:</span> <span class="s1">'1000000000000000000000000000'</span><span class="p">,</span>
|
|
<span class="nx">tether</span><span class="o">:</span> <span class="s1">'1000000000000000000000000000000'</span>
|
|
<span class="p">}</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="leftpad">
|
|
<h2>leftPad<a class="headerlink" href="#leftpad" title="Permalink to this headline">¶</a></h2>
|
|
<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">leftPad</span><span class="p">(</span><span class="nx">string</span><span class="p">,</span> <span class="nx">characterAmount</span> <span class="p">[,</span> <span class="nx">sign</span><span class="p">])</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">leftPad</span><span class="p">(</span><span class="nx">string</span><span class="p">,</span> <span class="nx">characterAmount</span> <span class="p">[,</span> <span class="nx">sign</span><span class="p">])</span> <span class="c1">// ALIAS</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Adds a padding on the left of a string, Useful for adding paddings to HEX strings.</p>
|
|
<div class="section" id="id72">
|
|
<h3>Parameters<a class="headerlink" href="#id72" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">string</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: The string to add padding on the left.</li>
|
|
<li><code class="docutils literal"><span class="pre">characterAmount</span></code> - <code class="docutils literal"><span class="pre">Number</span></code>: The number of characters the total string should have.</li>
|
|
<li><code class="docutils literal"><span class="pre">sign</span></code> - <code class="docutils literal"><span class="pre">String</span></code> (optional): The character sign to use, defaults to <code class="docutils literal"><span class="pre">"0"</span></code>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id73">
|
|
<h3>Returns<a class="headerlink" href="#id73" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The padded string.</p>
|
|
</div>
|
|
<div class="section" id="id74">
|
|
<h3>Example<a class="headerlink" href="#id74" title="Permalink to this headline">¶</a></h3>
|
|
<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">leftPad</span><span class="p">(</span><span class="s1">'0x3456ff'</span><span class="p">,</span> <span class="mi">20</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x000000000000003456ff"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">leftPad</span><span class="p">(</span><span class="mh">0x3456ff</span><span class="p">,</span> <span class="mi">20</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x000000000000003456ff"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">leftPad</span><span class="p">(</span><span class="s1">'Hello'</span><span class="p">,</span> <span class="mi">20</span><span class="p">,</span> <span class="s1">'x'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"xxxxxxxxxxxxxxxHello"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<hr class="docutils" />
|
|
<div class="section" id="rightpad">
|
|
<h2>rightPad<a class="headerlink" href="#rightpad" title="Permalink to this headline">¶</a></h2>
|
|
<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">rightPad</span><span class="p">(</span><span class="nx">string</span><span class="p">,</span> <span class="nx">characterAmount</span> <span class="p">[,</span> <span class="nx">sign</span><span class="p">])</span>
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">rightPad</span><span class="p">(</span><span class="nx">string</span><span class="p">,</span> <span class="nx">characterAmount</span> <span class="p">[,</span> <span class="nx">sign</span><span class="p">])</span> <span class="c1">// ALIAS</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>Adds a padding on the right of a string, Useful for adding paddings to HEX strings.</p>
|
|
<div class="section" id="id75">
|
|
<h3>Parameters<a class="headerlink" href="#id75" title="Permalink to this headline">¶</a></h3>
|
|
<ol class="arabic simple">
|
|
<li><code class="docutils literal"><span class="pre">string</span></code> - <code class="docutils literal"><span class="pre">String</span></code>: The string to add padding on the right.</li>
|
|
<li><code class="docutils literal"><span class="pre">characterAmount</span></code> - <code class="docutils literal"><span class="pre">Number</span></code>: The number of characters the total string should have.</li>
|
|
<li><code class="docutils literal"><span class="pre">sign</span></code> - <code class="docutils literal"><span class="pre">String</span></code> (optional): The character sign to use, defaults to <code class="docutils literal"><span class="pre">"0"</span></code>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section" id="id76">
|
|
<h3>Returns<a class="headerlink" href="#id76" title="Permalink to this headline">¶</a></h3>
|
|
<p><code class="docutils literal"><span class="pre">String</span></code>: The padded string.</p>
|
|
</div>
|
|
<div class="section" id="id77">
|
|
<h3>Example<a class="headerlink" href="#id77" title="Permalink to this headline">¶</a></h3>
|
|
<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">rightPad</span><span class="p">(</span><span class="s1">'0x3456ff'</span><span class="p">,</span> <span class="mi">20</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x3456ff00000000000000"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">rightPad</span><span class="p">(</span><span class="mh">0x3456ff</span><span class="p">,</span> <span class="mi">20</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"0x3456ff00000000000000"</span>
|
|
|
|
<span class="nx">web3</span><span class="p">.</span><span class="nx">utils</span><span class="p">.</span><span class="nx">rightPad</span><span class="p">(</span><span class="s1">'Hello'</span><span class="p">,</span> <span class="mi">20</span><span class="p">,</span> <span class="s1">'x'</span><span class="p">);</span>
|
|
<span class="o">></span> <span class="s2">"Helloxxxxxxxxxxxxxxx"</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="index.html">Table Of Contents</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">web3.utils</a><ul>
|
|
<li><a class="reference internal" href="#randomhex">randomHex</a><ul>
|
|
<li><a class="reference internal" href="#parameters">Parameters</a></li>
|
|
<li><a class="reference internal" href="#returns">Returns</a></li>
|
|
<li><a class="reference internal" href="#example">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#id1">_</a><ul>
|
|
<li><a class="reference internal" href="#id2">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#bn">BN</a><ul>
|
|
<li><a class="reference internal" href="#id3">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id4">Returns</a></li>
|
|
<li><a class="reference internal" href="#id5">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#isbn">isBN</a><ul>
|
|
<li><a class="reference internal" href="#id6">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id7">Returns</a></li>
|
|
<li><a class="reference internal" href="#id8">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#isbignumber">isBigNumber</a><ul>
|
|
<li><a class="reference internal" href="#id9">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id10">Returns</a></li>
|
|
<li><a class="reference internal" href="#id11">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#sha3">sha3</a><ul>
|
|
<li><a class="reference internal" href="#id12">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id13">Returns</a></li>
|
|
<li><a class="reference internal" href="#id14">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#soliditysha3">soliditySha3</a><ul>
|
|
<li><a class="reference internal" href="#id15">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id16">Returns</a></li>
|
|
<li><a class="reference internal" href="#id17">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#ishex">isHex</a><ul>
|
|
<li><a class="reference internal" href="#id18">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id19">Returns</a></li>
|
|
<li><a class="reference internal" href="#id20">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#isaddress">isAddress</a><ul>
|
|
<li><a class="reference internal" href="#id21">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id22">Returns</a></li>
|
|
<li><a class="reference internal" href="#id23">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#tochecksumaddress">toChecksumAddress</a><ul>
|
|
<li><a class="reference internal" href="#id24">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id25">Returns</a></li>
|
|
<li><a class="reference internal" href="#id26">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#checkaddresschecksum">checkAddressChecksum</a><ul>
|
|
<li><a class="reference internal" href="#id27">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id28">Returns</a></li>
|
|
<li><a class="reference internal" href="#id29">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#tohex">toHex</a><ul>
|
|
<li><a class="reference internal" href="#id30">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id31">Returns</a></li>
|
|
<li><a class="reference internal" href="#id32">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#tobn">toBN</a><ul>
|
|
<li><a class="reference internal" href="#id33">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id34">Returns</a></li>
|
|
<li><a class="reference internal" href="#id35">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#hextonumberstring">hexToNumberString</a><ul>
|
|
<li><a class="reference internal" href="#id36">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id37">Returns</a></li>
|
|
<li><a class="reference internal" href="#id38">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#hextonumber">hexToNumber</a><ul>
|
|
<li><a class="reference internal" href="#id39">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id40">Returns</a></li>
|
|
<li><a class="reference internal" href="#id41">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#numbertohex">numberToHex</a><ul>
|
|
<li><a class="reference internal" href="#id42">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id43">Returns</a></li>
|
|
<li><a class="reference internal" href="#id44">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#hextoutf8">hexToUtf8</a><ul>
|
|
<li><a class="reference internal" href="#id45">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id46">Returns</a></li>
|
|
<li><a class="reference internal" href="#id47">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#hextoascii">hexToAscii</a><ul>
|
|
<li><a class="reference internal" href="#id48">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id49">Returns</a></li>
|
|
<li><a class="reference internal" href="#id50">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#utf8tohex">utf8ToHex</a><ul>
|
|
<li><a class="reference internal" href="#id51">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id52">Returns</a></li>
|
|
<li><a class="reference internal" href="#id53">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#asciitohex">asciiToHex</a><ul>
|
|
<li><a class="reference internal" href="#id54">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id55">Returns</a></li>
|
|
<li><a class="reference internal" href="#id56">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#hextobytes">hexToBytes</a><ul>
|
|
<li><a class="reference internal" href="#id57">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id58">Returns</a></li>
|
|
<li><a class="reference internal" href="#id59">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#bytestohex">bytesToHex</a><ul>
|
|
<li><a class="reference internal" href="#id60">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id61">Returns</a></li>
|
|
<li><a class="reference internal" href="#id62">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#towei">toWei</a><ul>
|
|
<li><a class="reference internal" href="#id63">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id64">Returns</a></li>
|
|
<li><a class="reference internal" href="#id65">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#fromwei">fromWei</a><ul>
|
|
<li><a class="reference internal" href="#id67">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id68">Returns</a></li>
|
|
<li><a class="reference internal" href="#id69">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#unitmap">unitMap</a><ul>
|
|
<li><a class="reference internal" href="#retrun-value">Retrun value</a></li>
|
|
<li><a class="reference internal" href="#id71">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#leftpad">leftPad</a><ul>
|
|
<li><a class="reference internal" href="#id72">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id73">Returns</a></li>
|
|
<li><a class="reference internal" href="#id74">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#rightpad">rightPad</a><ul>
|
|
<li><a class="reference internal" href="#id75">Parameters</a></li>
|
|
<li><a class="reference internal" href="#id76">Returns</a></li>
|
|
<li><a class="reference internal" href="#id77">Example</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="web3-shh.html"
|
|
title="previous chapter">web3.shh</a></p>
|
|
<div role="note" aria-label="source link">
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="_sources/web3-utils.txt"
|
|
rel="nofollow">Show Source</a></li>
|
|
</ul>
|
|
</div>
|
|
<div id="searchbox" style="display: none" role="search">
|
|
<h3>Quick search</h3>
|
|
<form class="search" action="search.html" method="get">
|
|
<div><input type="text" name="q" /></div>
|
|
<div><input type="submit" value="Go" /></div>
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
<script type="text/javascript">$('#searchbox').show(0);</script>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="genindex.html" title="General Index"
|
|
>index</a></li>
|
|
<li class="right" >
|
|
<a href="web3-shh.html" title="web3.shh"
|
|
>previous</a> |</li>
|
|
<li class="nav-item nav-item-0"><a href="index.html">web3.js 1.0.0 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer" role="contentinfo">
|
|
© Copyright 2016, Ethereum.
|
|
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.8.
|
|
</div>
|
|
</body>
|
|
</html> |