2017-04-05 01:48:34 +03:00
<!DOCTYPE html>
<!-- [if IE 8]><html class="no - js lt - ie9" lang="en" > <![endif] -->
<!-- [if gt IE 8]><! --> < html class = "no-js" lang = "en" > <!-- <![endif] -->
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
2017-05-22 03:37:29 +03:00
< title > Cookbook — ethers.js 2.1.0 documentation< / title >
2017-04-05 01:48:34 +03:00
< link rel = "stylesheet" href = "_static/css/theme.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/css/ethers.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/css/ethers.css" type = "text/css" / >
2017-05-22 03:37:29 +03:00
< link rel = "top" title = "ethers.js 2.1.0 documentation" href = "index.html" / >
2017-04-05 01:48:34 +03:00
< link rel = "next" title = "Notes" href = "notes.html" / >
< link rel = "prev" title = "Low-Level API" href = "api-advanced.html" / >
< script src = "_static/js/modernizr.min.js" > < / script >
< / head >
< body class = "wy-body-for-nav" role = "document" >
< div class = "wy-grid-for-nav" >
< nav data-toggle = "wy-nav-shift" class = "wy-nav-side" >
< div class = "wy-side-scroll" >
< div class = "wy-side-nav-search" >
< a href = "index.html" class = "icon icon-home" > ethers.js
< / a >
< div class = "version" >
2017-05-22 03:37:29 +03:00
2.1.0
2017-04-05 01:48:34 +03:00
< / div >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< input type = "text" name = "q" placeholder = "Search docs" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div >
< div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "main navigation" >
< p class = "caption" > < span class = "caption-text" > Developer Documentation< / span > < / p >
< ul class = "current" >
< li class = "toctree-l1" > < a class = "reference internal" href = "getting-started.html" > Getting Started< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "api.html" > Application Programming Interface (API)< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "api-advanced.html" > Low-Level API< / a > < / li >
< li class = "toctree-l1 current" > < a class = "current reference internal" href = "#" > Cookbook< / a > < ul >
2017-04-06 00:06:11 +03:00
< li class = "toctree-l2" > < a class = "reference internal" href = "#dump-all-json-wallet-balances-in-current-directory" > Dump All JSON Wallet Balances (in current directory)< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#source-code" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#empty-one-account-into-another" > Empty One Account into Another< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#id1" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#transactions-confirm-ui-with-a-custom-signer" > Transactions Confirm UI (with a Custom Signer)< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#id2" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#coalesce-jaxx-wallets" > Coalesce Jaxx Wallets< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#id3" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#access-funds-in-a-mnemonic-phrase-wallet" > Access Funds in a Mnemonic Phrase Wallet< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#id4" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#custom-provider" > Custom Provider< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#id5" > < em > Source Code< / em > < / a > < / li >
< / ul >
< / li >
2017-04-05 01:48:34 +03:00
< / ul >
< / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "notes.html" > Notes< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "testing.html" > Testing< / a > < / li >
< / ul >
< / div >
< / div >
< / nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" >
< nav class = "wy-nav-top" role = "navigation" aria-label = "top navigation" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" > < / i >
< a href = "index.html" > ethers.js< / a >
< / nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "breadcrumbs navigation" >
< ul class = "wy-breadcrumbs" >
< li > < a href = "index.html" > Docs< / a > » < / li >
< li > Cookbook< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "_sources/cookbook.txt" rel = "nofollow" > View page source< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< div class = "section" id = "cookbook" >
< h1 > Cookbook< a class = "headerlink" href = "#cookbook" title = "Permalink to this headline" > ¶< / a > < / h1 >
2017-04-06 00:06:11 +03:00
< p > This is a small (but growing) collection of simple recipes to perform common tasks
with the Ethereum blockchain and Ethereum accounts.< / p >
2017-04-05 01:48:34 +03:00
< p > Some of these recipes are stubs that will be filled in shortly.< / p >
2017-04-06 00:06:11 +03:00
< p > If there is a simple recipe you would like added, please send suggestions to < a class = "reference external" href = "mailto:support%40ethers.io" > support< span > @ < / span > ethers< span > . < / span > io< / a > .< / p >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "dump-all-json-wallet-balances-in-current-directory" >
< h2 > Dump All JSON Wallet Balances (in current directory)< a class = "headerlink" href = "#dump-all-json-wallet-balances-in-current-directory" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > The directory your JSON wallets are located in will depend on the Ethereum
node you are using.< / p >
2017-04-05 01:48:34 +03:00
< dl class = "docutils" >
< dt > Geth< / dt >
< dd > ~/.ethereum/keystore< / dd >
< dt > Parity< / dt >
2017-04-06 00:06:11 +03:00
< dd > ~/.parity/keys/< em > chainDirectory< / em > /keys< / dd >
2017-04-05 01:48:34 +03:00
< / dl >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "source-code" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#source-code" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > fs< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' fs' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > provider< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > providers< / span > < span class = "o" > .< / span > < span class = "n" > defaultProvider< / span > < span class = "p" > ();< / span >
< span class = "n" > var< / span > < span class = "n" > filenames< / span > < span class = "o" > =< / span > < span class = "n" > fs< / span > < span class = "o" > .< / span > < span class = "n" > readDirSync< / span > < span class = "p" > (< / span > < span class = "s1" > ' .' < / span > < span class = "p" > );< / span >
< span class = "n" > filenames< / span > < span class = "o" > .< / span > < span class = "n" > forEach< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > filename< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > fs< / span > < span class = "o" > .< / span > < span class = "n" > readFile< / span > < span class = "p" > (< / span > < span class = "n" > filename< / span > < span class = "p" > ,< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > error< / span > < span class = "p" > ,< / span > < span class = "n" > data< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "k" > if< / span > < span class = "p" > (< / span > < span class = "n" > error< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > console< / span > < span class = "o" > .< / span > < span class = "n" > log< / span > < span class = "p" > (< / span > < span class = "s1" > ' Error reading file: ' < / span > < span class = "o" > +< / span > < span class = "n" > error< / span > < span class = "o" > .< / span > < span class = "n" > message< / span > < span class = "p" > );< / span >
< span class = "k" > return< / span > < span class = "p" > ;< / span >
< span class = "p" > }< / span >
< span class = "n" > var< / span > < span class = "n" > address< / span > < span class = "o" > =< / span > < span class = "n" > JSON< / span > < span class = "o" > .< / span > < span class = "n" > parse< / span > < span class = "p" > (< / span > < span class = "n" > data< / span > < span class = "o" > .< / span > < span class = "n" > toString< / span > < span class = "p" > ())< / span > < span class = "o" > .< / span > < span class = "n" > address< / span > < span class = "p" > ;< / span >
< span class = "n" > provider< / span > < span class = "o" > .< / span > < span class = "n" > getBalance< / span > < span class = "p" > (< / span > < span class = "n" > address< / span > < span class = "p" > )< / span > < span class = "o" > .< / span > < span class = "n" > then< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > balance< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > console< / span > < span class = "o" > .< / span > < span class = "n" > log< / span > < span class = "p" > (< / span > < span class = "n" > address< / span > < span class = "o" > +< / span > < span class = "s1" > ' :' < / span > < span class = "o" > +< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > formatEther< / span > < span class = "p" > (< / span > < span class = "n" > balance< / span > < span class = "p" > ));< / span >
< span class = "p" > });< / span >
< span class = "p" > });< / span >
< span class = "p" > });< / span >
< / pre > < / div >
< / div >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
< div class = "section" id = "empty-one-account-into-another" >
< h2 > Empty One Account into Another< a class = "headerlink" href = "#empty-one-account-into-another" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Include example links to etherscan showing the transactions< / p >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "id1" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#id1" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > provider< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > providers< / span > < span class = "o" > .< / span > < span class = "n" > getDefaultProvider< / span > < span class = "p" > ();< / span >
< span class = "n" > var< / span > < span class = "n" > newAddress< / span > < span class = "o" > =< / span > < span class = "s1" > ' ' < / span > < span class = "p" > ;< / span >
< span class = "n" > var< / span > < span class = "n" > privateKey< / span > < span class = "o" > =< / span > < span class = "s1" > ' ' < / span > < span class = "p" > ;< / span >
< span class = "n" > var< / span > < span class = "n" > wallet< / span > < span class = "o" > =< / span > < span class = "n" > new< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > Wallet< / span > < span class = "p" > (< / span > < span class = "n" > privateKey< / span > < span class = "p" > ,< / span > < span class = "n" > provider< / span > < span class = "p" > );< / span >
< span class = "n" > Promise< / span > < span class = "o" > .< / span > < span class = "n" > all< / span > < span class = "p" > ([< / span >
< span class = "n" > wallet< / span > < span class = "o" > .< / span > < span class = "n" > getBalance< / span > < span class = "p" > (),< / span >
< span class = "n" > provider< / span > < span class = "o" > .< / span > < span class = "n" > getGasPrice< / span > < span class = "p" > (),< / span >
< span class = "n" > provider< / span > < span class = "o" > .< / span > < span class = "n" > getCode< / span > < span class = "p" > (< / span > < span class = "n" > newAddress< / span > < span class = "p" > )< / span >
< span class = "p" > ])< / span > < span class = "o" > .< / span > < span class = "n" > then< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > results< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > var< / span > < span class = "n" > balance< / span > < span class = "o" > =< / span > < span class = "n" > results< / span > < span class = "p" > [< / span > < span class = "mi" > 0< / span > < span class = "p" > ];< / span >
< span class = "n" > var< / span > < span class = "n" > gasPrice< / span > < span class = "o" > =< / span > < span class = "n" > results< / span > < span class = "p" > [< / span > < span class = "mi" > 1< / span > < span class = "p" > ];< / span >
< span class = "n" > var< / span > < span class = "n" > code< / span > < span class = "o" > =< / span > < span class = "n" > results< / span > < span class = "p" > [< / span > < span class = "mi" > 2< / span > < span class = "p" > ];< / span >
< span class = "k" > if< / span > < span class = "p" > (< / span > < span class = "n" > code< / span > < span class = "o" > !==< / span > < span class = "s1" > ' 0x' < / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > throw< / span > < span class = "n" > new< / span > < span class = "n" > Error< / span > < span class = "p" > (< / span > < span class = "s1" > ' this tool should not send to a contract' < / span > < span class = "p" > );< / span >
< span class = "p" > }< / span >
< span class = "o" > //< / span > < span class = "n" > The< / span > < span class = "n" > exact< / span > < span class = "n" > cost< / span > < span class = "p" > (< / span > < span class = "ow" > in< / span > < span class = "n" > gas< / span > < span class = "p" > )< / span > < span class = "n" > to< / span > < span class = "n" > send< / span > < span class = "n" > to< / span > < span class = "n" > an< / span > < span class = "n" > Externally< / span > < span class = "n" > Owned< / span > < span class = "n" > Account< / span > < span class = "p" > (< / span > < span class = "n" > EOA< / span > < span class = "p" > )< / span >
< span class = "n" > var< / span > < span class = "n" > gasLimit< / span > < span class = "o" > =< / span > < span class = "mi" > 21000< / span > < span class = "p" > ;< / span >
< span class = "o" > //< / span > < span class = "n" > The< / span > < span class = "n" > balance< / span > < span class = "n" > less< / span > < span class = "n" > exactly< / span > < span class = "n" > the< / span > < span class = "n" > txfee< / span > < span class = "ow" > in< / span > < span class = "n" > wei< / span >
< span class = "n" > var< / span > < span class = "n" > value< / span > < span class = "o" > =< / span > < span class = "n" > balance< / span > < span class = "o" > .< / span > < span class = "n" > sub< / span > < span class = "p" > (< / span > < span class = "n" > gasPrice< / span > < span class = "o" > .< / span > < span class = "n" > mul< / span > < span class = "p" > (< / span > < span class = "n" > gasLimit< / span > < span class = "p" > ))< / span >
< span class = "n" > wallet< / span > < span class = "o" > .< / span > < span class = "n" > send< / span > < span class = "p" > (< / span > < span class = "n" > newAddress< / span > < span class = "p" > ,< / span > < span class = "n" > value< / span > < span class = "p" > ,< / span > < span class = "p" > {< / span > < span class = "n" > gasLimit< / span > < span class = "p" > :< / span > < span class = "n" > gasLimit< / span > < span class = "p" > })< / span > < span class = "o" > .< / span > < span class = "n" > then< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > console< / span > < span class = "o" > .< / span > < span class = "n" > log< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "p" > );< / span >
< span class = "p" > });< / span >
< span class = "p" > });< / span >
< / pre > < / div >
< / div >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
< div class = "section" id = "transactions-confirm-ui-with-a-custom-signer" >
< h2 > Transactions Confirm UI (with a Custom Signer)< a class = "headerlink" href = "#transactions-confirm-ui-with-a-custom-signer" title = "Permalink to this headline" > ¶< / a > < / h2 >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "id2" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#id2" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > function< / span > < span class = "n" > CustomSigner< / span > < span class = "p" > (< / span > < span class = "n" > privateKey< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > this< / span > < span class = "o" > .< / span > < span class = "n" > provider< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > getDefaultProvider< / span > < span class = "p" > ();< / span >
< span class = "n" > var< / span > < span class = "n" > wallet< / span > < span class = "o" > =< / span > < span class = "n" > new< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > Wallet< / span > < span class = "p" > (< / span > < span class = "n" > privateKey< / span > < span class = "p" > );< / span >
< span class = "n" > this< / span > < span class = "o" > .< / span > < span class = "n" > address< / span > < span class = "o" > =< / span > < span class = "n" > wallet< / span > < span class = "o" > .< / span > < span class = "n" > address< / span > < span class = "p" > ;< / span >
< span class = "n" > this< / span > < span class = "o" > .< / span > < span class = "n" > sign< / span > < span class = "o" > =< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "k" > return< / span > < span class = "n" > new< / span > < span class = "n" > Promise< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > resolve< / span > < span class = "p" > ,< / span > < span class = "n" > reject< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > var< / span > < span class = "n" > allow< / span > < span class = "o" > =< / span > < span class = "n" > confirm< / span > < span class = "p" > (< / span > < span class = "s1" > ' Sign Transaction? To: ' < / span > < span class = "o" > +< / span > < span class = "n" > transaction< / span > < span class = "o" > .< / span > < span class = "n" > to< / span > < span class = "o" > +< / span >
< span class = "s2" > " , Amount: " < / span > < span class = "o" > +< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > formatEther< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "o" > .< / span > < span class = "n" > value< / span > < span class = "p" > ));< / span >
< span class = "n" > var< / span > < span class = "n" > etherString< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > formatEther< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "o" > .< / span > < span class = "n" > value< / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > modal< / span > < span class = "o" > =< / span > < span class = "n" > document< / span > < span class = "o" > .< / span > < span class = "n" > createElement< / span > < span class = "p" > (< / span > < span class = "s1" > ' pre' < / span > < span class = "p" > );< / span >
< span class = "n" > document< / span > < span class = "o" > .< / span > < span class = "n" > body< / span > < span class = "o" > .< / span > < span class = "n" > appendChild< / span > < span class = "p" > (< / span > < span class = "n" > modal< / span > < span class = "p" > );< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > className< / span > < span class = "o" > =< / span > < span class = "s2" > " modal" < / span > < span class = "p" > ;< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > textContent< / span > < span class = "o" > +=< / span > < span class = "s1" > ' Sign Transaction?< / span > < span class = "se" > \n< / span > < span class = "s1" > ' < / span > < span class = "p" > ;< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > textContent< / span > < span class = "o" > +=< / span > < span class = "s1" > ' To: ' < / span > < span class = "o" > +< / span > < span class = "n" > transaction< / span > < span class = "o" > .< / span > < span class = "n" > address< / span > < span class = "o" > +< / span > < span class = "s1" > ' < / span > < span class = "se" > \n< / span > < span class = "s1" > ' < / span > < span class = "p" > ;< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > textContent< / span > < span class = "o" > +=< / span > < span class = "s1" > ' Amount: ' < / span > < span class = "o" > +< / span > < span class = "n" > etherString< / span > < span class = "o" > +< / span > < span class = "s1" > ' < / span > < span class = "se" > \n< / span > < span class = "s1" > ' < / span > < span class = "p" > ;< / span >
< span class = "n" > var< / span > < span class = "n" > confirmButton< / span > < span class = "o" > =< / span > < span class = "n" > document< / span > < span class = "o" > .< / span > < span class = "n" > createElement< / span > < span class = "p" > (< / span > < span class = "s1" > ' div' < / span > < span class = "p" > );< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > appendChild< / span > < span class = "p" > (< / span > < span class = "n" > confirmButton< / span > < span class = "p" > );< / span >
< span class = "n" > confirmButton< / span > < span class = "o" > .< / span > < span class = "n" > textContent< / span > < span class = "o" > =< / span > < span class = "s2" > " " < / span > < span class = "n" > confirm< / span > < span class = "s2" > " ;< / span >
< span class = "n" > confirmButton< / span > < span class = "o" > .< / span > < span class = "n" > onclick< / span > < span class = "o" > =< / span > < span class = "n" > function< / span > < span class = "p" > ()< / span > < span class = "p" > {< / span >
< span class = "n" > resolve< / span > < span class = "p" > (< / span > < span class = "n" > wallet< / span > < span class = "o" > .< / span > < span class = "n" > sign< / span > < span class = "p" > (< / span > < span class = "n" > transaction< / span > < span class = "p" > ));< / span >
< span class = "p" > }< / span >
< span class = "n" > var< / span > < span class = "n" > rejectButton< / span > < span class = "o" > =< / span > < span class = "n" > document< / span > < span class = "o" > .< / span > < span class = "n" > createElement< / span > < span class = "p" > (< / span > < span class = "s1" > ' div' < / span > < span class = "p" > );< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > appendChild< / span > < span class = "p" > (< / span > < span class = "n" > rejectButton< / span > < span class = "p" > );< / span >
< span class = "n" > rejectButton< / span > < span class = "o" > .< / span > < span class = "n" > textContent< / span > < span class = "o" > =< / span > < span class = "s2" > " " < / span > < span class = "n" > confirm< / span > < span class = "s2" > " ;< / span >
< span class = "n" > rejectButton< / span > < span class = "o" > .< / span > < span class = "n" > onclick< / span > < span class = "o" > =< / span > < span class = "n" > function< / span > < span class = "p" > ()< / span > < span class = "p" > {< / span >
< span class = "n" > modal< / span > < span class = "o" > .< / span > < span class = "n" > remove< / span > < span class = "p" > ();< / span >
< span class = "n" > reject< / span > < span class = "p" > (< / span > < span class = "n" > new< / span > < span class = "n" > Error< / span > < span class = "p" > (< / span > < span class = "s1" > ' cancelled transaction' < / span > < span class = "p" > ));< / span >
< span class = "p" > }< / span >
< span class = "p" > }< / span >
< span class = "p" > }< / span >
< / pre > < / div >
< / div >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
< div class = "section" id = "coalesce-jaxx-wallets" >
< h2 > Coalesce Jaxx Wallets< a class = "headerlink" href = "#coalesce-jaxx-wallets" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > The Jaxx Wallet (for iOS, Android, desktop, et cetera) uses HD wallets on Ethereum the
same way as Bitcoin, which results in each transaction being received by a separate
address. As a result, funds get spread across many accounts, making several operations
in Ethereum impossible.< / p >
< p > This short recipe will coalesce all these accounts into a single one, by sending the funds
from each account into a single one.< / p >
< p > This also results in paying multiple transaction fees (1 fee per account to merge).< / p >
< p > @ TODO: This is incomplete!!< / p >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "id3" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#id3" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > provider< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > providers< / span > < span class = "o" > .< / span > < span class = "n" > getDefaultProvider< / span > < span class = "p" > ();< / span >
< span class = "n" > var< / span > < span class = "n" > hdnode< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > HDNode< / span > < span class = "o" > .< / span > < span class = "n" > fromMnemonic< / span > < span class = "p" > ();< / span >
< span class = "n" > hdnode< / span > < span class = "o" > =< / span > < span class = "n" > hdnode< / span > < span class = "o" > .< / span > < span class = "n" > derivePath< / span > < span class = "p" > (< / span > < span class = "s2" > " m/44' /60' /0' /0" < / span > < span class = "p" > );< / span >
< span class = "nd" > @TODO< / span > < span class = "p" > :< / span >
< / pre > < / div >
< / div >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
< div class = "section" id = "access-funds-in-a-mnemonic-phrase-wallet" >
< h2 > Access Funds in a Mnemonic Phrase Wallet< a class = "headerlink" href = "#access-funds-in-a-mnemonic-phrase-wallet" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > @ TODO: This is incomplete< / p >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "id4" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#id4" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > walletPath< / span > < span class = "o" > =< / span > < span class = "p" > {< / span >
< span class = "s2" > " standard" < / span > < span class = "p" > :< / span > < span class = "s2" > " m/44' /60' /0' /0/0" < / span > < span class = "p" > ,< / span >
< span class = "o" > //< / span > < span class = "nd" > @TODO< / span > < span class = "p" > :< / span > < span class = "n" > Include< / span > < span class = "n" > some< / span > < span class = "n" > non< / span > < span class = "o" > -< / span > < span class = "n" > standard< / span > < span class = "n" > wallet< / span > < span class = "n" > paths< / span >
< span class = "p" > };< / span >
< span class = "n" > var< / span > < span class = "n" > mnemonic< / span > < span class = "o" > =< / span > < span class = "s2" > " " < / span > < span class = "p" > ;< / span >
< span class = "n" > var< / span > < span class = "n" > hdnode< / span > < span class = "o" > =< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > HDNode< / span > < span class = "o" > .< / span > < span class = "n" > fromMnemonic< / span > < span class = "p" > (< / span > < span class = "n" > mnemonic< / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > node< / span > < span class = "o" > =< / span > < span class = "n" > hdnode< / span > < span class = "o" > .< / span > < span class = "n" > derivePath< / span > < span class = "p" > (< / span > < span class = "n" > walletPath< / span > < span class = "o" > .< / span > < span class = "n" > standard< / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > wallet< / span > < span class = "o" > =< / span > < span class = "n" > new< / span > < span class = "n" > Wallet< / span > < span class = "p" > (< / span > < span class = "n" > node< / span > < span class = "o" > .< / span > < span class = "n" > privateKey< / span > < span class = "p" > );< / span >
< span class = "n" > console< / span > < span class = "o" > .< / span > < span class = "n" > log< / span > < span class = "p" > (< / span > < span class = "n" > wallet< / span > < span class = "o" > .< / span > < span class = "n" > address< / span > < span class = "p" > );< / span >
< span class = "nd" > @TODO< / span > < span class = "p" > :< / span >
< / pre > < / div >
< / div >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< hr class = "docutils" / >
< div class = "section" id = "custom-provider" >
< h2 > Custom Provider< a class = "headerlink" href = "#custom-provider" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > This is a much more advanced topic, and most people should not need to work this
low level. But it is provided for those rare instances where you need some custom
connection logic.< / p >
< p > A provider must only implement the method < strong > perform(method, params)< / strong > . All data passed
into a provider is sanitized by the Provider subclass, and all results are normalized
before returning them to the user.< / p >
< p > For this example, we will build a DebugProvider, which will simple proxy all commands
through to INFURA, but dump all data going back and forth.< / p >
2017-04-06 00:06:11 +03:00
< div class = "section" id = "id5" >
< h3 > < em > Source Code< / em > < a class = "headerlink" href = "#id5" title = "Permalink to this headline" > ¶< / a > < / h3 >
2017-04-05 01:48:34 +03:00
< div class = "highlight-default" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > var< / span > < span class = "n" > inherits< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' inherits' < / span > < span class = "p" > );< / span >
< span class = "n" > var< / span > < span class = "n" > ethers< / span > < span class = "o" > =< / span > < span class = "n" > require< / span > < span class = "p" > (< / span > < span class = "s1" > ' ethers' < / span > < span class = "p" > );< / span >
< span class = "n" > function< / span > < span class = "n" > DebugProvider< / span > < span class = "p" > (< / span > < span class = "n" > testnet< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > Provider< / span > < span class = "o" > .< / span > < span class = "n" > call< / span > < span class = "p" > (< / span > < span class = "n" > this< / span > < span class = "p" > ,< / span > < span class = "n" > testnet< / span > < span class = "p" > );< / span >
< span class = "n" > this< / span > < span class = "o" > .< / span > < span class = "n" > subprovider< / span > < span class = "o" > =< / span > < span class = "n" > new< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > providers< / span > < span class = "o" > .< / span > < span class = "n" > InfuraProvider< / span > < span class = "p" > (< / span > < span class = "n" > testnet< / span > < span class = "p" > );< / span >
< span class = "p" > }< / span >
< span class = "n" > inherits< / span > < span class = "p" > (< / span > < span class = "n" > DebugProvider< / span > < span class = "p" > ,< / span > < span class = "n" > ethers< / span > < span class = "o" > .< / span > < span class = "n" > providers< / span > < span class = "o" > .< / span > < span class = "n" > Provider< / span > < span class = "p" > );< / span >
< span class = "o" > //< / span > < span class = "n" > This< / span > < span class = "n" > should< / span > < span class = "k" > return< / span > < span class = "n" > a< / span > < span class = "n" > Promise< / span > < span class = "p" > (< / span > < span class = "ow" > and< / span > < span class = "n" > may< / span > < span class = "n" > throw< / span > < span class = "n" > erros< / span > < span class = "p" > )< / span >
< span class = "o" > //< / span > < span class = "n" > method< / span > < span class = "ow" > is< / span > < span class = "n" > the< / span > < span class = "n" > method< / span > < span class = "n" > name< / span > < span class = "p" > (< / span > < span class = "n" > e< / span > < span class = "o" > .< / span > < span class = "n" > g< / span > < span class = "o" > .< / span > < span class = "n" > getBalance< / span > < span class = "p" > )< / span > < span class = "ow" > and< / span > < span class = "n" > params< / span > < span class = "ow" > is< / span > < span class = "n" > an< / span >
< span class = "o" > //< / span > < span class = "nb" > object< / span > < span class = "k" > with< / span > < span class = "n" > normalized< / span > < span class = "n" > values< / span > < span class = "n" > passed< / span > < span class = "ow" > in< / span > < span class = "p" > ,< / span > < span class = "n" > depending< / span > < span class = "n" > on< / span > < span class = "n" > the< / span > < span class = "n" > method< / span >
< span class = "n" > DebugProvier< / span > < span class = "o" > .< / span > < span class = "n" > prototype< / span > < span class = "o" > .< / span > < span class = "n" > perform< / span > < span class = "o" > =< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > method< / span > < span class = "p" > ,< / span > < span class = "n" > params< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > this< / span > < span class = "o" > .< / span > < span class = "n" > subprovider< / span > < span class = "o" > .< / span > < span class = "n" > perform< / span > < span class = "p" > (< / span > < span class = "n" > method< / span > < span class = "p" > ,< / span > < span class = "n" > params< / span > < span class = "p" > )< / span > < span class = "o" > .< / span > < span class = "n" > then< / span > < span class = "p" > (< / span > < span class = "n" > function< / span > < span class = "p" > (< / span > < span class = "n" > result< / span > < span class = "p" > )< / span > < span class = "p" > {< / span >
< span class = "n" > console< / span > < span class = "o" > .< / span > < span class = "n" > log< / span > < span class = "p" > (< / span > < span class = "s1" > ' DEBUG' < / span > < span class = "p" > ,< / span > < span class = "n" > method< / span > < span class = "p" > ,< / span > < span class = "n" > params< / span > < span class = "p" > ,< / span > < span class = "s1" > ' => ' < / span > < span class = "p" > ,< / span > < span class = "n" > result< / span > < span class = "p" > );< / span >
< span class = "p" > });< / span >
< span class = "p" > }< / span >
< / pre > < / div >
< / div >
< hr class = "docutils" / >
< / div >
2017-04-06 00:06:11 +03:00
< / div >
2017-04-05 01:48:34 +03:00
< / div >
< / div >
< / div >
< footer >
< div class = "rst-footer-buttons" role = "navigation" aria-label = "footer navigation" >
< a href = "notes.html" class = "btn btn-neutral float-right" title = "Notes" accesskey = "n" > Next < span class = "fa fa-arrow-circle-right" > < / span > < / a >
< a href = "api-advanced.html" class = "btn btn-neutral" title = "Low-Level API" accesskey = "p" > < span class = "fa fa-arrow-circle-left" > < / span > Previous< / a >
< / div >
< hr / >
< div role = "contentinfo" >
< p >
© Copyright 2016, Richard Moore < me@ricmoo.com> .
< / p >
< / div >
Built with < a href = "http://sphinx-doc.org/" > Sphinx< / a > using a < a href = "https://github.com/snide/sphinx_rtd_theme" > theme< / a > provided by < a href = "https://readthedocs.org" > Read the Docs< / a > .
< / footer >
< / div >
< / div >
< / section >
< / div >
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
2017-05-22 03:37:29 +03:00
VERSION:'2.1.0',
2017-04-05 01:48:34 +03:00
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 >
< script type = "text/javascript" src = "_static/js/theme.js" > < / script >
< script type = "text/javascript" >
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
< / script >
< / body >
< / html >
