/ docs / blockchain_configuration.html
blockchain_configuration.html
   1  <!DOCTYPE html>
   2  <html lang="en" dir="ltr">
   3    <head prefix="og: http://ogp.me/ns#">
   4    <meta charset="utf-8">
   5    <title>Blockchain client configuration | Embark</title>
   6    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
   7    <meta name="viewport" content="width=device-width, initial-scale=1">
   8    <!-- Canonical links -->
   9    <link rel="canonical" href="https://framework.embarklabs.io/docs/blockchain_configuration.html">
  10    <!-- Alternative links -->
  11    
  12  
  13    <!-- Icon -->
  14    <meta name="msapplication-TileColor" content="#080E1A">
  15    <link rel="icon" type="image/png" href="/assets/images/favicon-16.png" sizes="16x16" />
  16    <link rel="icon" type="image/png" href="/assets/images/favicon-32.png" sizes="32x32" />
  17  
  18    <link rel="apple-touch-icon" sizes="76x76" href="/assets/images/apple-touch-icon-60x60-precomposed.png">
  19    <link rel="apple-touch-icon" sizes="76x76" href="/assets/images/apple-touch-icon-76x76-precomposed.png">
  20    <link rel="apple-touch-icon" sizes="120x120" href="/assets/images/apple-touch-icon-120x120-precomposed.png">
  21    <link rel="apple-touch-icon" sizes="152x152" href="/assets/images/apple-touch-icon-152x152-precomposed.png">
  22    <link rel="apple-touch-icon" sizes="180x180" href="/assets/images/apple-touch-icon-precomposed.png">
  23    <link rel="apple-touch-icon" href="/assets/images/apple-touch-icon-precomposed.png">
  24    <!-- CSS -->
  25    
  26  <link rel="stylesheet" href="/css/embark.css">
  27  
  28    <!-- endbuild -->
  29  
  30    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
  31    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
  32  
  33    <!-- RSS -->
  34    <link rel="alternate" href="/atom.xml" title="Embark">
  35    <meta property="og:image" content="/img/share.png?v=0.0.5" />
  36    <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.4/styles/dracula.min.css">
  37  
  38    <script async defer src="https://buttons.github.io/buttons.js"></script>
  39  
  40  
  41  <script>
  42    !function(root, factory) {
  43      "function" == typeof define && define.amd ? // AMD. Register as an anonymous module unless amdModuleId is set
  44      define([], function() {
  45          return root.svg4everybody = factory();
  46      }) : "object" == typeof module && module.exports ? // Node. Does not work with strict CommonJS, but
  47      // only CommonJS-like environments that support module.exports,
  48      // like Node.
  49      module.exports = factory() : root.svg4everybody = factory();
  50  }(this, function() {
  51      /*! svg4everybody v2.1.9 | github.com/jonathantneal/svg4everybody */
  52      function embed(parent, svg, target) {
  53          // if the target exists
  54          if (target) {
  55              // create a document fragment to hold the contents of the target
  56              var fragment = document.createDocumentFragment(), viewBox = !svg.hasAttribute("viewBox") && target.getAttribute("viewBox");
  57              // conditionally set the viewBox on the svg
  58              viewBox && svg.setAttribute("viewBox", viewBox);
  59              // copy the contents of the clone into the fragment
  60              for (// clone the target
  61              var clone = target.cloneNode(!0); clone.childNodes.length; ) {
  62                  fragment.appendChild(clone.firstChild);
  63              }
  64              // append the fragment into the svg
  65              parent.appendChild(fragment);
  66          }
  67      }
  68      function loadreadystatechange(xhr) {
  69          // listen to changes in the request
  70          xhr.onreadystatechange = function() {
  71              // if the request is ready
  72              if (4 === xhr.readyState) {
  73                  // get the cached html document
  74                  var cachedDocument = xhr._cachedDocument;
  75                  // ensure the cached html document based on the xhr response
  76                  cachedDocument || (cachedDocument = xhr._cachedDocument = document.implementation.createHTMLDocument(""),
  77                  cachedDocument.body.innerHTML = xhr.responseText, xhr._cachedTarget = {}), // clear the xhr embeds list and embed each item
  78                  xhr._embeds.splice(0).map(function(item) {
  79                      // get the cached target
  80                      var target = xhr._cachedTarget[item.id];
  81                      // ensure the cached target
  82                      target || (target = xhr._cachedTarget[item.id] = cachedDocument.getElementById(item.id)),
  83                      // embed the target into the svg
  84                      embed(item.parent, item.svg, target);
  85                  });
  86              }
  87          }, // test the ready state change immediately
  88          xhr.onreadystatechange();
  89      }
  90      function svg4everybody(rawopts) {
  91          function oninterval() {
  92              // while the index exists in the live <use> collection
  93              for (// get the cached <use> index
  94              var index = 0; index < uses.length; ) {
  95                  // get the current <use>
  96                  var use = uses[index], parent = use.parentNode, svg = getSVGAncestor(parent), src = use.getAttribute("xlink:href") || use.getAttribute("href");
  97                  if (!src && opts.attributeName && (src = use.getAttribute(opts.attributeName)),
  98                  svg && src) {
  99                      if (polyfill) {
 100                          if (!opts.validate || opts.validate(src, svg, use)) {
 101                              // remove the <use> element
 102                              parent.removeChild(use);
 103                              // parse the src and get the url and id
 104                              var srcSplit = src.split("#"), url = srcSplit.shift(), id = srcSplit.join("#");
 105                              // if the link is external
 106                              if (url.length) {
 107                                  // get the cached xhr request
 108                                  var xhr = requests[url];
 109                                  // ensure the xhr request exists
 110                                  xhr || (xhr = requests[url] = new XMLHttpRequest(), xhr.open("GET", url), xhr.send(),
 111                                  xhr._embeds = []), // add the svg and id as an item to the xhr embeds list
 112                                  xhr._embeds.push({
 113                                      parent: parent,
 114                                      svg: svg,
 115                                      id: id
 116                                  }), // prepare the xhr ready state change event
 117                                  loadreadystatechange(xhr);
 118                              } else {
 119                                  // embed the local id into the svg
 120                                  embed(parent, svg, document.getElementById(id));
 121                              }
 122                          } else {
 123                              // increase the index when the previous value was not "valid"
 124                              ++index, ++numberOfSvgUseElementsToBypass;
 125                          }
 126                      }
 127                  } else {
 128                      // increase the index when the previous value was not "valid"
 129                      ++index;
 130                  }
 131              }
 132              // continue the interval
 133              (!uses.length || uses.length - numberOfSvgUseElementsToBypass > 0) && requestAnimationFrame(oninterval, 67);
 134          }
 135          var polyfill, opts = Object(rawopts), newerIEUA = /\bTrident\/[567]\b|\bMSIE (?:9|10)\.0\b/, webkitUA = /\bAppleWebKit\/(\d+)\b/, olderEdgeUA = /\bEdge\/12\.(\d+)\b/, edgeUA = /\bEdge\/.(\d+)\b/, inIframe = window.top !== window.self;
 136          polyfill = "polyfill" in opts ? opts.polyfill : newerIEUA.test(navigator.userAgent) || (navigator.userAgent.match(olderEdgeUA) || [])[1] < 10547 || (navigator.userAgent.match(webkitUA) || [])[1] < 537 || edgeUA.test(navigator.userAgent) && inIframe;
 137          // create xhr requests object
 138          var requests = {}, requestAnimationFrame = window.requestAnimationFrame || setTimeout, uses = document.getElementsByTagName("use"), numberOfSvgUseElementsToBypass = 0;
 139          // conditionally start the interval if the polyfill is active
 140          polyfill && oninterval();
 141      }
 142      function getSVGAncestor(node) {
 143          for (var svg = node; "svg" !== svg.nodeName.toLowerCase() && (svg = svg.parentNode); ) {}
 144          return svg;
 145      }
 146      return svg4everybody;
 147  });
 148  
 149  svg4everybody();
 150  </script>
 151  </head>
 152  
 153    <body>
 154      <header role="banner" class="c-header c-header--compact">
 155    <span class="c-header__background"></span>
 156    <div class="o-container c-header__content">
 157      <div class="c-header__top">
 158        <a href="/" title="Embark" class="c-logo c-logo--negative">Embark</a>
 159        <nav role="navigation" class="c-navigation">
 160          <div class="c-navigation__header">
 161            <a href="/" title="Embark" class="c-logo">Embark</a>
 162            <button class="c-navigation__close u-text-light" title="Close menu">
 163              <svg class="c-icon c-icon--xs"><use xlink:href="/../assets/icons/symbols.svg#icon-close"></use></svg>
 164            </button>
 165          </div>
 166          <div class="c-navigation__body">
 167            <ul class="c-navigation__list">
 168              <li class="c-navigation__item">
 169                <a href="/docs/quick_start.html" class="c-navigation__anchor " title="Quick Start">Quick Start</a>
 170              </li>
 171              <li class="c-navigation__item">
 172                <a href="/docs" class="c-navigation__anchor is-active" title="Learn">Learn</a>
 173              </li>
 174              <li class="c-navigation__item">
 175                <a href="/plugins" class="c-navigation__anchor " title="Plugins">Plugins</a>
 176              </li>
 177              <li class="c-navigation__item">
 178                <a href="/community" class="c-navigation__anchor " title="Community">Community</a>
 179              </li>
 180              <li class="c-navigation__item">
 181                <a href="https://blog.embarklabs.io" target="_blank" rel="noopener" class="c-navigation__anchor " title="Blog">Blog</a>
 182              </li>
 183            </ul>
 184          </div>
 185        </nav>
 186        <div class="o-flex o-flex-center">
 187          <form action="" class="o-flex__item u-hidden-until-large">
 188            <input type="search" placeholder="Search" id="search-input">
 189          </form>
 190          <div class="o-flex__item">
 191            <ul class="o-flex o-flex-center">
 192              <li class="o-flex__item">
 193                <a href="https://github.com/embarklabs/embark" title="Github" target="_blank" class="u-link-ghost">
 194                  <svg class="c-icon"><use xlink:href="/../assets/icons/symbols.svg#icon-github"></use></svg>
 195                </a>
 196              </li>
 197              <li class="o-flex__item">
 198                <a href="https://twitter.com/EmbarkProject" title="Twitter" target="_blank">
 199                  <svg class="c-icon"><use xlink:href="/../assets/icons/symbols.svg#icon-twitter"></use></svg>
 200                </a>
 201              </li>
 202              <li class="o-flex__item u-hidden-large-up">
 203                <button type="button"class="c-navigation__trigger u-link-ghost" title="Open menu">
 204                  <svg class="c-icon"><use xlink:href="/../assets/icons/symbols.svg#icon-navigation-menu"></use></svg>
 205                </button>
 206              </li>
 207            </ul>
 208          </div>
 209        </div>
 210      </div>
 211      <div class="c-quick-search o-distance-m u-hidden-large-up">
 212        <input type="search" id="inp-search" placeholder="Search">
 213      </div>
 214      <div class="c-header__body">
 215        <h1 class="c-title u-text-ghost">Documentation</h1>
 216  
 217        
 218  
 219        
 220        
 221      </div>
 222    </div>
 223  </header>
 224  
 225  
 226  <main role="main">
 227    <section class="o-guided-content o-distance">
 228      <div class="o-guided-content__wrapper">
 229        <button title="Open docs menu" id="guides-trigger" class="c-button c-button--minion u-hidden-large-up">
 230          <svg class="c-icon c-icon--xs"><use xlink:href="/../../assets/icons/symbols.svg#icon-navigation-menu"></use></svg>
 231          <span>Guides</span>
 232        </button>
 233        <div class="c-guide o-guided-content__guide"  id="guide-navigation">
 234          <div class="c-guide__header u-hidden-large-up">
 235            <a href="" title="Guides">
 236              Guides
 237            </a>
 238            <button type="button" title="Close menu" id="guides-close">
 239              <svg class="c-icon c-icon--xs"><use xlink:href="/../../assets/icons/symbols.svg#icon-close"></use></svg>
 240            </button>
 241          </div>
 242          <div class="c-guide__body">
 243            <nav role="navigation">
 244              
 245                <div class="">
 246                  <h3 class="c-category-title">Getting Started</h3>
 247                  <ul class="o-list-bare">
 248                    
 249                    <li class="o-list-bare__item">
 250                      <a href="/docs/overview.html" title="Overview" class="u-link-uniform ">Overview</a>
 251                      <!-- <div class="o-distance-m">
 252                        <ul class="o-list-bare c-navigation__subnav">
 253                          <li class="o-list-bare__item">
 254                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 255                          </li>
 256                        </ul>
 257                      </div> -->
 258                    </li>
 259                    
 260                    <li class="o-list-bare__item">
 261                      <a href="/docs/installation.html" title="Installation" class="u-link-uniform ">Installation</a>
 262                      <!-- <div class="o-distance-m">
 263                        <ul class="o-list-bare c-navigation__subnav">
 264                          <li class="o-list-bare__item">
 265                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 266                          </li>
 267                        </ul>
 268                      </div> -->
 269                    </li>
 270                    
 271                    <li class="o-list-bare__item">
 272                      <a href="/docs/faq.html" title="FAQ" class="u-link-uniform ">FAQ</a>
 273                      <!-- <div class="o-distance-m">
 274                        <ul class="o-list-bare c-navigation__subnav">
 275                          <li class="o-list-bare__item">
 276                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 277                          </li>
 278                        </ul>
 279                      </div> -->
 280                    </li>
 281                    
 282                  </ul>
 283                
 284              
 285                <div class="o-distance-xl">
 286                  <h3 class="c-category-title">General Usage</h3>
 287                  <ul class="o-list-bare">
 288                    
 289                    <li class="o-list-bare__item">
 290                      <a href="/docs/create_project.html" title="Creating apps" class="u-link-uniform ">Creating apps</a>
 291                      <!-- <div class="o-distance-m">
 292                        <ul class="o-list-bare c-navigation__subnav">
 293                          <li class="o-list-bare__item">
 294                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 295                          </li>
 296                        </ul>
 297                      </div> -->
 298                    </li>
 299                    
 300                    <li class="o-list-bare__item">
 301                      <a href="/docs/structure.html" title="App structure" class="u-link-uniform ">App structure</a>
 302                      <!-- <div class="o-distance-m">
 303                        <ul class="o-list-bare c-navigation__subnav">
 304                          <li class="o-list-bare__item">
 305                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 306                          </li>
 307                        </ul>
 308                      </div> -->
 309                    </li>
 310                    
 311                    <li class="o-list-bare__item">
 312                      <a href="/docs/running_apps.html" title="Running apps" class="u-link-uniform ">Running apps</a>
 313                      <!-- <div class="o-distance-m">
 314                        <ul class="o-list-bare c-navigation__subnav">
 315                          <li class="o-list-bare__item">
 316                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 317                          </li>
 318                        </ul>
 319                      </div> -->
 320                    </li>
 321                    
 322                    <li class="o-list-bare__item">
 323                      <a href="/docs/dashboard.html" title="Using the dashboard" class="u-link-uniform ">Using the dashboard</a>
 324                      <!-- <div class="o-distance-m">
 325                        <ul class="o-list-bare c-navigation__subnav">
 326                          <li class="o-list-bare__item">
 327                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 328                          </li>
 329                        </ul>
 330                      </div> -->
 331                    </li>
 332                    
 333                    <li class="o-list-bare__item">
 334                      <a href="/docs/using_the_console.html" title="Using the console" class="u-link-uniform ">Using the console</a>
 335                      <!-- <div class="o-distance-m">
 336                        <ul class="o-list-bare c-navigation__subnav">
 337                          <li class="o-list-bare__item">
 338                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 339                          </li>
 340                        </ul>
 341                      </div> -->
 342                    </li>
 343                    
 344                    <li class="o-list-bare__item">
 345                      <a href="/docs/environments.html" title="Environments" class="u-link-uniform ">Environments</a>
 346                      <!-- <div class="o-distance-m">
 347                        <ul class="o-list-bare c-navigation__subnav">
 348                          <li class="o-list-bare__item">
 349                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 350                          </li>
 351                        </ul>
 352                      </div> -->
 353                    </li>
 354                    
 355                    <li class="o-list-bare__item">
 356                      <a href="/docs/configuration.html" title="Configuration" class="u-link-uniform ">Configuration</a>
 357                      <!-- <div class="o-distance-m">
 358                        <ul class="o-list-bare c-navigation__subnav">
 359                          <li class="o-list-bare__item">
 360                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 361                          </li>
 362                        </ul>
 363                      </div> -->
 364                    </li>
 365                    
 366                    <li class="o-list-bare__item">
 367                      <a href="/docs/pipeline_and_webpack.html" title="Building & Compiling" class="u-link-uniform ">Building & Compiling</a>
 368                      <!-- <div class="o-distance-m">
 369                        <ul class="o-list-bare c-navigation__subnav">
 370                          <li class="o-list-bare__item">
 371                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 372                          </li>
 373                        </ul>
 374                      </div> -->
 375                    </li>
 376                    
 377                    <li class="o-list-bare__item">
 378                      <a href="/docs/executing_scripts.html" title="Executing Scripts" class="u-link-uniform ">Executing Scripts</a>
 379                      <!-- <div class="o-distance-m">
 380                        <ul class="o-list-bare c-navigation__subnav">
 381                          <li class="o-list-bare__item">
 382                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 383                          </li>
 384                        </ul>
 385                      </div> -->
 386                    </li>
 387                    
 388                    <li class="o-list-bare__item">
 389                      <a href="/docs/javascript_usage.html" title="Using EmbarkJS" class="u-link-uniform ">Using EmbarkJS</a>
 390                      <!-- <div class="o-distance-m">
 391                        <ul class="o-list-bare c-navigation__subnav">
 392                          <li class="o-list-bare__item">
 393                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 394                          </li>
 395                        </ul>
 396                      </div> -->
 397                    </li>
 398                    
 399                  </ul>
 400                </div>
 401              
 402                <div class="o-distance-xl">
 403                  <h3 class="c-category-title">Smart Contract Development</h3>
 404                  <ul class="o-list-bare">
 405                    
 406                    <li class="o-list-bare__item">
 407                      <a href="/docs/contracts_configuration.html" title="Configuration" class="u-link-uniform ">Configuration</a>
 408                      <!-- <div class="o-distance-m">
 409                        <ul class="o-list-bare c-navigation__subnav">
 410                          <li class="o-list-bare__item">
 411                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 412                          </li>
 413                        </ul>
 414                      </div> -->
 415                    </li>
 416                    
 417                    <li class="o-list-bare__item">
 418                      <a href="/docs/contracts_deployment.html" title="Accounts & Deployment" class="u-link-uniform ">Accounts & Deployment</a>
 419                      <!-- <div class="o-distance-m">
 420                        <ul class="o-list-bare c-navigation__subnav">
 421                          <li class="o-list-bare__item">
 422                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 423                          </li>
 424                        </ul>
 425                      </div> -->
 426                    </li>
 427                    
 428                    <li class="o-list-bare__item">
 429                      <a href="/docs/contracts_imports.html" title="Special Imports" class="u-link-uniform ">Special Imports</a>
 430                      <!-- <div class="o-distance-m">
 431                        <ul class="o-list-bare c-navigation__subnav">
 432                          <li class="o-list-bare__item">
 433                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 434                          </li>
 435                        </ul>
 436                      </div> -->
 437                    </li>
 438                    
 439                    <li class="o-list-bare__item">
 440                      <a href="/docs/contracts_testing.html" title="Testing" class="u-link-uniform ">Testing</a>
 441                      <!-- <div class="o-distance-m">
 442                        <ul class="o-list-bare c-navigation__subnav">
 443                          <li class="o-list-bare__item">
 444                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 445                          </li>
 446                        </ul>
 447                      </div> -->
 448                    </li>
 449                    
 450                    <li class="o-list-bare__item">
 451                      <a href="/docs/contracts_javascript.html" title="Smart Contracts in JavaScript" class="u-link-uniform ">Smart Contracts in JavaScript</a>
 452                      <!-- <div class="o-distance-m">
 453                        <ul class="o-list-bare c-navigation__subnav">
 454                          <li class="o-list-bare__item">
 455                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 456                          </li>
 457                        </ul>
 458                      </div> -->
 459                    </li>
 460                    
 461                  </ul>
 462                </div>
 463              
 464                <div class="o-distance-xl">
 465                  <h3 class="c-category-title">Blockchain Client</h3>
 466                  <ul class="o-list-bare">
 467                    
 468                    <li class="o-list-bare__item">
 469                      <a href="/docs/blockchain_configuration.html" title="Configuration" class="u-link-uniform is-active">Configuration</a>
 470                      <!-- <div class="o-distance-m">
 471                        <ul class="o-list-bare c-navigation__subnav">
 472                          <li class="o-list-bare__item">
 473                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 474                          </li>
 475                        </ul>
 476                      </div> -->
 477                    </li>
 478                    
 479                    <li class="o-list-bare__item">
 480                      <a href="/docs/blockchain_accounts_configuration.html" title="Managing Accounts" class="u-link-uniform ">Managing Accounts</a>
 481                      <!-- <div class="o-distance-m">
 482                        <ul class="o-list-bare c-navigation__subnav">
 483                          <li class="o-list-bare__item">
 484                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 485                          </li>
 486                        </ul>
 487                      </div> -->
 488                    </li>
 489                    
 490                  </ul>
 491                </div>
 492              
 493                <div class="o-distance-xl">
 494                  <h3 class="c-category-title">Storage (IPFS/Swarm)</h3>
 495                  <ul class="o-list-bare">
 496                    
 497                    <li class="o-list-bare__item">
 498                      <a href="/docs/storage_configuration.html" title="Configuration" class="u-link-uniform ">Configuration</a>
 499                      <!-- <div class="o-distance-m">
 500                        <ul class="o-list-bare c-navigation__subnav">
 501                          <li class="o-list-bare__item">
 502                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 503                          </li>
 504                        </ul>
 505                      </div> -->
 506                    </li>
 507                    
 508                    <li class="o-list-bare__item">
 509                      <a href="/docs/storage_deployment.html" title="Deploying apps" class="u-link-uniform ">Deploying apps</a>
 510                      <!-- <div class="o-distance-m">
 511                        <ul class="o-list-bare c-navigation__subnav">
 512                          <li class="o-list-bare__item">
 513                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 514                          </li>
 515                        </ul>
 516                      </div> -->
 517                    </li>
 518                    
 519                    <li class="o-list-bare__item">
 520                      <a href="/docs/storage_javascript.html" title="Storage APIs in JavaScript" class="u-link-uniform ">Storage APIs in JavaScript</a>
 521                      <!-- <div class="o-distance-m">
 522                        <ul class="o-list-bare c-navigation__subnav">
 523                          <li class="o-list-bare__item">
 524                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 525                          </li>
 526                        </ul>
 527                      </div> -->
 528                    </li>
 529                    
 530                  </ul>
 531                </div>
 532              
 533                <div class="o-distance-xl">
 534                  <h3 class="c-category-title">Messages (Whisper)</h3>
 535                  <ul class="o-list-bare">
 536                    
 537                    <li class="o-list-bare__item">
 538                      <a href="/docs/messages_configuration.html" title="Configuration" class="u-link-uniform ">Configuration</a>
 539                      <!-- <div class="o-distance-m">
 540                        <ul class="o-list-bare c-navigation__subnav">
 541                          <li class="o-list-bare__item">
 542                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 543                          </li>
 544                        </ul>
 545                      </div> -->
 546                    </li>
 547                    
 548                    <li class="o-list-bare__item">
 549                      <a href="/docs/messages_javascript.html" title="Messages in JavaScript" class="u-link-uniform ">Messages in JavaScript</a>
 550                      <!-- <div class="o-distance-m">
 551                        <ul class="o-list-bare c-navigation__subnav">
 552                          <li class="o-list-bare__item">
 553                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 554                          </li>
 555                        </ul>
 556                      </div> -->
 557                    </li>
 558                    
 559                  </ul>
 560                </div>
 561              
 562                <div class="o-distance-xl">
 563                  <h3 class="c-category-title">Naming Systems (ENS)</h3>
 564                  <ul class="o-list-bare">
 565                    
 566                    <li class="o-list-bare__item">
 567                      <a href="/docs/naming_configuration.html" title="Configuration" class="u-link-uniform ">Configuration</a>
 568                      <!-- <div class="o-distance-m">
 569                        <ul class="o-list-bare c-navigation__subnav">
 570                          <li class="o-list-bare__item">
 571                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 572                          </li>
 573                        </ul>
 574                      </div> -->
 575                    </li>
 576                    
 577                    <li class="o-list-bare__item">
 578                      <a href="/docs/naming_javascript.html" title="Naming Systems in JavaScript" class="u-link-uniform ">Naming Systems in JavaScript</a>
 579                      <!-- <div class="o-distance-m">
 580                        <ul class="o-list-bare c-navigation__subnav">
 581                          <li class="o-list-bare__item">
 582                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 583                          </li>
 584                        </ul>
 585                      </div> -->
 586                    </li>
 587                    
 588                  </ul>
 589                </div>
 590              
 591                <div class="o-distance-xl">
 592                  <h3 class="c-category-title">Plugins</h3>
 593                  <ul class="o-list-bare">
 594                    
 595                    <li class="o-list-bare__item">
 596                      <a href="/docs/installing_plugins.html" title="Installing plugins" class="u-link-uniform ">Installing plugins</a>
 597                      <!-- <div class="o-distance-m">
 598                        <ul class="o-list-bare c-navigation__subnav">
 599                          <li class="o-list-bare__item">
 600                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 601                          </li>
 602                        </ul>
 603                      </div> -->
 604                    </li>
 605                    
 606                    <li class="o-list-bare__item">
 607                      <a href="/docs/creating_plugins.html" title="Creating plugins" class="u-link-uniform ">Creating plugins</a>
 608                      <!-- <div class="o-distance-m">
 609                        <ul class="o-list-bare c-navigation__subnav">
 610                          <li class="o-list-bare__item">
 611                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 612                          </li>
 613                        </ul>
 614                      </div> -->
 615                    </li>
 616                    
 617                    <li class="o-list-bare__item">
 618                      <a href="/docs/plugin_reference.html" title="Plugin APIs" class="u-link-uniform ">Plugin APIs</a>
 619                      <!-- <div class="o-distance-m">
 620                        <ul class="o-list-bare c-navigation__subnav">
 621                          <li class="o-list-bare__item">
 622                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 623                          </li>
 624                        </ul>
 625                      </div> -->
 626                    </li>
 627                    
 628                  </ul>
 629                </div>
 630              
 631                <div class="o-distance-xl">
 632                  <h3 class="c-category-title">Cockpit Guides</h3>
 633                  <ul class="o-list-bare">
 634                    
 635                    <li class="o-list-bare__item">
 636                      <a href="/docs/cockpit_introduction.html" title="Introduction" class="u-link-uniform ">Introduction</a>
 637                      <!-- <div class="o-distance-m">
 638                        <ul class="o-list-bare c-navigation__subnav">
 639                          <li class="o-list-bare__item">
 640                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 641                          </li>
 642                        </ul>
 643                      </div> -->
 644                    </li>
 645                    
 646                    <li class="o-list-bare__item">
 647                      <a href="/docs/cockpit_dashboard.html" title="Using the Dashboard" class="u-link-uniform ">Using the Dashboard</a>
 648                      <!-- <div class="o-distance-m">
 649                        <ul class="o-list-bare c-navigation__subnav">
 650                          <li class="o-list-bare__item">
 651                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 652                          </li>
 653                        </ul>
 654                      </div> -->
 655                    </li>
 656                    
 657                    <li class="o-list-bare__item">
 658                      <a href="/docs/cockpit_deployment.html" title="Deployment" class="u-link-uniform ">Deployment</a>
 659                      <!-- <div class="o-distance-m">
 660                        <ul class="o-list-bare c-navigation__subnav">
 661                          <li class="o-list-bare__item">
 662                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 663                          </li>
 664                        </ul>
 665                      </div> -->
 666                    </li>
 667                    
 668                    <li class="o-list-bare__item">
 669                      <a href="/docs/cockpit_explorer.html" title="Explorer View" class="u-link-uniform ">Explorer View</a>
 670                      <!-- <div class="o-distance-m">
 671                        <ul class="o-list-bare c-navigation__subnav">
 672                          <li class="o-list-bare__item">
 673                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 674                          </li>
 675                        </ul>
 676                      </div> -->
 677                    </li>
 678                    
 679                    <li class="o-list-bare__item">
 680                      <a href="/docs/cockpit_editor.html" title="Code Editor" class="u-link-uniform ">Code Editor</a>
 681                      <!-- <div class="o-distance-m">
 682                        <ul class="o-list-bare c-navigation__subnav">
 683                          <li class="o-list-bare__item">
 684                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 685                          </li>
 686                        </ul>
 687                      </div> -->
 688                    </li>
 689                    
 690                    <li class="o-list-bare__item">
 691                      <a href="/docs/cockpit_debugger.html" title="Using the Debugger" class="u-link-uniform ">Using the Debugger</a>
 692                      <!-- <div class="o-distance-m">
 693                        <ul class="o-list-bare c-navigation__subnav">
 694                          <li class="o-list-bare__item">
 695                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 696                          </li>
 697                        </ul>
 698                      </div> -->
 699                    </li>
 700                    
 701                  </ul>
 702                </div>
 703              
 704                <div class="o-distance-xl">
 705                  <h3 class="c-category-title">Reference</h3>
 706                  <ul class="o-list-bare">
 707                    
 708                    <li class="o-list-bare__item">
 709                      <a href="/docs/embark_commands.html" title="CLI Commands" class="u-link-uniform ">CLI Commands</a>
 710                      <!-- <div class="o-distance-m">
 711                        <ul class="o-list-bare c-navigation__subnav">
 712                          <li class="o-list-bare__item">
 713                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 714                          </li>
 715                        </ul>
 716                      </div> -->
 717                    </li>
 718                    
 719                  </ul>
 720                </div>
 721              
 722                <div class="o-distance-xl">
 723                  <h3 class="c-category-title">Miscellaneous</h3>
 724                  <ul class="o-list-bare">
 725                    
 726                    <li class="o-list-bare__item">
 727                      <a href="/docs/migrating_from_3.x.html" title="Migrating from Embark 3.x" class="u-link-uniform ">Migrating from Embark 3.x</a>
 728                      <!-- <div class="o-distance-m">
 729                        <ul class="o-list-bare c-navigation__subnav">
 730                          <li class="o-list-bare__item">
 731                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 732                          </li>
 733                        </ul>
 734                      </div> -->
 735                    </li>
 736                    
 737                    <li class="o-list-bare__item">
 738                      <a href="/docs/troubleshooting.html" title="Troubleshooting" class="u-link-uniform ">Troubleshooting</a>
 739                      <!-- <div class="o-distance-m">
 740                        <ul class="o-list-bare c-navigation__subnav">
 741                          <li class="o-list-bare__item">
 742                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 743                          </li>
 744                        </ul>
 745                      </div> -->
 746                    </li>
 747                    
 748                    <li class="o-list-bare__item">
 749                      <a href="/docs/contributing.html" title="Contributing" class="u-link-uniform ">Contributing</a>
 750                      <!-- <div class="o-distance-m">
 751                        <ul class="o-list-bare c-navigation__subnav">
 752                          <li class="o-list-bare__item">
 753                            <a href="#" title="What is Embark?" class="u-link-uniform">What is Embark?</a>
 754                          </li>
 755                        </ul>
 756                      </div> -->
 757                    </li>
 758                    
 759                  </ul>
 760                </div>
 761              
 762            </nav>
 763          </div>
 764        </div>
 765        <div class="o-guided-content__content">
 766          <p class="c-meta">Last updated: January 29th 2020
 767            (<a href="https://github.com/embarklabs/embark/edit/master/site/source/docs/blockchain_configuration.md" target="_blank">
 768              Improve this guide <svg class="c-icon c-icon--xs"><use xlink:href="/../../assets/icons/symbols.svg#icon-pen-write-paper"></use></svg>
 769            </a>)
 770          </p>
 771          <div class="o-standard-page">
 772            <h1>Blockchain client configuration</h1>
 773            <p>When in developing, to interact with a blockchain, it is necessary to use a local Ethereum node, either using a simulator or a client like Geth or Parity. In this guide we’ll explore how to configure a blockchain client we want Embark to connect to. Embark uses the <code>blockchain.js</code> file inside the <code>./config</code> folder by default for blockchain related configurations. This <a href="/docs/configuration.html#config">can be configured</a> to different locations if we want to.</p>
 774  <p>Embark offers a lot of configuration options and most of them already come with a decent default so we can start right away.</p>
 775  <h2 id="Common-Parameters"><a href="#Common-Parameters" class="headerlink" title="Common Parameters"></a>Common Parameters</h2><p>Here are the common parameters. You will often need only a few of them to make your Embark node work.</p>
 776  <p>If you want more configuration options, you can find them <a href="/docs/blockchain_configuration.html#Advanced-parameters">here</a></p>
 777  <figure class="highlight plain"><table><tr><td class="code"><pre><span class="line">module.exports &#x3D; &#123;</span><br><span class="line">  default: &#123;</span><br><span class="line">    enabled: true,</span><br><span class="line">    client: &quot;geth&quot;</span><br><span class="line">  &#125;,</span><br><span class="line">  development: &#123;  </span><br><span class="line">    clientConfig: &#123;</span><br><span class="line">      miningMode: &#39;dev&#39;</span><br><span class="line">    &#125;</span><br><span class="line">  &#125;,</span><br><span class="line">  testnet: &#123;</span><br><span class="line">    endpoint: &quot;https:&#x2F;&#x2F;external-node.com&quot;,</span><br><span class="line">    accounts: [</span><br><span class="line">      &#123;</span><br><span class="line">        mnemonic: &quot;12 word mnemonic&quot;</span><br><span class="line">      &#125;</span><br><span class="line">    ]</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
 778  
 779  <p>Similar to <a href="/docs/contracts_configuration.html">configuring Smart Contracts</a>, this config contains environments that help configuring certain parameters differently depending of the environment. You can read more about <a href="https://framework.embarklabs.io/docs/environments.html">environments here</a>.</p>
 780  <h3 id="Parameter-descriptions"><a href="#Parameter-descriptions" class="headerlink" title="Parameter descriptions"></a>Parameter descriptions</h3><p>Most of the options are self-explanatory, still, here are some brief descriptions:</p>
 781  <table>
 782  <thead>
 783  <tr>
 784  <th>Option</th>
 785  <th>Type: <code>default</code></th>
 786  <th>Value</th>
 787  </tr>
 788  </thead>
 789  <tbody><tr>
 790  <td><code>enabled</code></td>
 791  <td>boolean: <code>true</code></td>
 792  <td>Whether or not to spawn an Ethereum node</td>
 793  </tr>
 794  <tr>
 795  <td><code>client</code></td>
 796  <td>string: <code>geth</code></td>
 797  <td>Client to use for the Ethereum node. Currently supported: <code>geth</code> and <code>parity</code></td>
 798  </tr>
 799  <tr>
 800  <td><code>miningMode</code></td>
 801  <td>string: <code>dev</code></td>
 802  <td>The mining mode to use for the node.<br/><code>dev</code>: This is a special mode where the node uses a development account as defaultAccount. This account is already funded and transactions are faster.<br/><code>auto</code>: Uses a mining script to mine only when needed.<br/><code>always</code>: Miner is always on.<br/><code>off</code>: Turns off the miner</td>
 803  </tr>
 804  <tr>
 805  <td><code>endpoint</code></td>
 806  <td>string</td>
 807  <td>Endpoint to connect to. Works for external endpoints (like Infura) and local ones too (only for nodes started by <code>embark run</code>)</td>
 808  </tr>
 809  <tr>
 810  <td><code>accounts</code></td>
 811  <td>array</td>
 812  <td>Accounts array for the node and to deploy. When no account is given, defaults to one node account. For more details, go <a href="/docs/blockchain_accounts_configuration.html">here</a></td>
 813  </tr>
 814  </tbody></table>
 815  <h2 id="Advanced-parameters"><a href="#Advanced-parameters" class="headerlink" title="Advanced parameters"></a>Advanced parameters</h2><p>Here are all the parameters you can use to customize your node. Note that they all come with defaults that make it that you don’t need to specify those.</p>
 816  <p>We recommend putting those inside the <code>clientConfig</code> object a better structure.</p>
 817  <table>
 818  <thead>
 819  <tr>
 820  <th>Option</th>
 821  <th>Type: <code>default</code></th>
 822  <th>Value</th>
 823  </tr>
 824  </thead>
 825  <tbody><tr>
 826  <td><code>rpcHost</code></td>
 827  <td>string: <code>localhost</code></td>
 828  <td>Host the RPC server listens to</td>
 829  </tr>
 830  <tr>
 831  <td><code>rpcPort</code></td>
 832  <td>number: <code>8545</code></td>
 833  <td>Port the RPC server listens to</td>
 834  </tr>
 835  <tr>
 836  <td><code>rpcCorsDomain</code></td>
 837  <td>object</td>
 838  <td>The CORS domains the node accepts</td>
 839  </tr>
 840  <tr>
 841  <td><code>rpcCorsDomain.auto</code></td>
 842  <td></td>
 843  <td>When set to true, Embark checks your other configurations to set the CORS domains. This only adds the required domains.</td>
 844  </tr>
 845  <tr>
 846  <td><code>rpcCorsDomain.additionalCors</code></td>
 847  <td></td>
 848  <td>Manual list of CORS domains to accept. If <code>auto</code> is set to <code>true</code>, any URLs specified here will be applied <em>in addition to</em> those automatically added with <code>auto</code>.</td>
 849  </tr>
 850  <tr>
 851  <td><code>wsRPC</code></td>
 852  <td>boolean: <code>true</code></td>
 853  <td>Whether or not to enable the Websocket server</td>
 854  </tr>
 855  <tr>
 856  <td><code>wsOrigins</code></td>
 857  <td>object</td>
 858  <td>Same as <code>rpcCorsDomain</code>, but for the Websocket server</td>
 859  </tr>
 860  <tr>
 861  <td><code>wsHost</code></td>
 862  <td>string: <code>localhost</code></td>
 863  <td>Same as <code>rpcHost</code>, but for the Websocket server</td>
 864  </tr>
 865  <tr>
 866  <td><code>wsPort</code></td>
 867  <td>number: <code>8546</code></td>
 868  <td>Same as <code>rpcPort</code>, but for the Websocket server</td>
 869  </tr>
 870  <tr>
 871  <td><code>ethereumClientBin</code></td>
 872  <td>string: <code>geth</code></td>
 873  <td>Path to the client binary. By default, Embark uses the client name as an executable (if it is in the PATH)</td>
 874  </tr>
 875  <tr>
 876  <td><code>datadir</code></td>
 877  <td>string</td>
 878  <td>Directory where to put the Node’s data (eg: keystores)</td>
 879  </tr>
 880  <tr>
 881  <td><code>networkType</code></td>
 882  <td>string: <code>custom</code></td>
 883  <td>Can be: <code>testnet</code>, <code>rinkeby</code>, <code>kovan</code> or custom, in which case, it will use the specified <code>networkId</code></td>
 884  </tr>
 885  <tr>
 886  <td><code>networkId</code></td>
 887  <td>number: <code>1337</code></td>
 888  <td>Used when <code>networkType</code> is set as <code>custom</code>. <a href="https://github.com/ethereumbook/ethereumbook/blob/3e8cf74eb935d4be495f4306b73de027af95fd97/contrib/devp2p-protocol.asciidoc#known-current-network-ids" target="_blank" rel="noopener">List of known network ids</a></td>
 889  </tr>
 890  <tr>
 891  <td><code>nodiscover</code></td>
 892  <td>boolean: <code>true</code></td>
 893  <td>Disables the peer discovery mechanism when set to <code>true</code></td>
 894  </tr>
 895  <tr>
 896  <td><code>maxpeers</code></td>
 897  <td>number: <code>0</code></td>
 898  <td>Maximum number of network peers</td>
 899  </tr>
 900  <tr>
 901  <td><code>proxy</code></td>
 902  <td>boolean: <code>true</code></td>
 903  <td>Whether or not Embark should use a proxy to add functionalities. This proxy is used by Embark to see the different transactions that go through, for example, and shows them to you.</td>
 904  </tr>
 905  <tr>
 906  <td><code>targetGasLimit</code></td>
 907  <td>number</td>
 908  <td>Artificial target gas floor for the blocks to mine</td>
 909  </tr>
 910  <tr>
 911  <td><code>genesisBlock</code></td>
 912  <td>string</td>
 913  <td>The genesis file to use to create the network. This file is used when creating the network. It tells the client the parameters to initiate the node with. You can read more on <a href="https://arvanaghi.com/blog/explaining-the-genesis-block-in-ethereum/" target="_blank" rel="noopener">genesis blocks here</a></td>
 914  </tr>
 915  </tbody></table>
 916  <div class="c-notification c-notification--info">
 917    <p><strong>Using Parity and Metamask</strong></p>
 918    <p><p>Parity has very strict CORS policies. In order to use it with Metamask (or any other browser extension), you need to add the extension’s URL in the CORS.</p>
 919  <p>You can do so by opening Metamask in its own tab. Then, copy the URL. It will look something like <code>chrome-extension://nkbihfbeogaeaoehlefnkodbefgpgknn</code>.</p>
 920  <p>Afterwards, in your blockchain config, add it to <code>additionalCors</code> of <code>rpcCorsDomain</code> and <code>wsOrigins</code>.</p>
 921  </p>
 922  </div> 
 923  
 924  
 925  
 926  <h2 id="Privatenet-configuration"><a href="#Privatenet-configuration" class="headerlink" title="Privatenet configuration"></a>Privatenet configuration</h2><p>A private network is really similar to using the development mode of a client. The biggest differences is that it does not come with a default pre-funded account and it will not use POA (proof of authority), meaning that blocks will need to be mined.</p>
 927  <p>Luckily, Embark has settings to limit the mining to a minimum so that everything can run smoothly while testing in a more realistic environment before going to a test network.</p>
 928  <h3 id="Privatenet-parameters"><a href="#Privatenet-parameters" class="headerlink" title="Privatenet parameters"></a>Privatenet parameters</h3><p>Here are common parameters for private net configurations:</p>
 929  <figure class="highlight plain"><table><tr><td class="code"><pre><span class="line">privatenet: &#123;</span><br><span class="line">  clientConfig: &#123;</span><br><span class="line">    miningMode: &#39;auto&#39;,</span><br><span class="line">    genesisBlock: &quot;config&#x2F;privatenet&#x2F;genesis.json&quot;</span><br><span class="line">  &#125;</span><br><span class="line">  accounts: [</span><br><span class="line">    &#123;</span><br><span class="line">      nodeAccounts: true,</span><br><span class="line">      password: &quot;config&#x2F;privatenet&#x2F;password&quot;</span><br><span class="line">    &#125;</span><br><span class="line">  ]</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
 930  
 931  <p>Note that we can always use the parameters we saw in the <a href="#Common-Parameters">Common parameters section</a> to override the <code>default</code> parameters.</p>
 932  <h3 id="Parameter-descriptions-1"><a href="#Parameter-descriptions-1" class="headerlink" title="Parameter descriptions"></a>Parameter descriptions</h3><table>
 933  <thead>
 934  <tr>
 935  <th>Option</th>
 936  <th>Type: <code>value</code></th>
 937  <th>Description</th>
 938  </tr>
 939  </thead>
 940  <tbody><tr>
 941  <td><code>miningMode</code></td>
 942  <td>string: <code>auto</code></td>
 943  <td>You need to set <code>miningMode</code> to <code>auto</code> or <code>always</code> so you don’t use the development mode</td>
 944  </tr>
 945  <tr>
 946  <td><code>genesisBlock</code></td>
 947  <td>string</td>
 948  <td>File to start the chain in a clean state for your private network</td>
 949  </tr>
 950  <tr>
 951  <td><code>accounts</code></td>
 952  <td>array</td>
 953  <td>Array of accounts to connect to. Go to the <a href="/docs/blockchain_accounts_configuration.html">Accounts configuration</a> page to learn more on accounts</td>
 954  </tr>
 955  </tbody></table>
 956  <h2 id="Testnet-configuration"><a href="#Testnet-configuration" class="headerlink" title="Testnet configuration"></a>Testnet configuration</h2><p>Test networks are networks that are public. Knowing that, if we want to connect to a node that we control, we will first need to synchronize it. This can take hours, as we need to download the blocks that we are missing from the other peers.</p>
 957  <p>The big advantage of using a local synced node is that we have control over it and it preserves our privacy, as we aren’t using a third party node. However, as mentioned, it takes a lot of time to synchronize a node and also requires a lot of computer resources, so keep it in mind if you want to go down that route.</p>
 958  <h3 id="Testnet-parameters"><a href="#Testnet-parameters" class="headerlink" title="Testnet parameters"></a>Testnet parameters</h3><figure class="highlight plain"><table><tr><td class="code"><pre><span class="line">testnet: &#123;</span><br><span class="line">  networkType: &quot;testnet&quot;,</span><br><span class="line">  syncMode: &quot;light&quot;,</span><br><span class="line">  accounts: [</span><br><span class="line">    &#123;</span><br><span class="line">      nodeAccounts: true,</span><br><span class="line">      password: &quot;config&#x2F;testnet&#x2F;password&quot;</span><br><span class="line">    &#125;</span><br><span class="line">  ]</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
 959  
 960  <p>Here are the necessary parameters. Again, we can add more to override as you see fit.</p>
 961  <h3 id="Parameter-descriptions-2"><a href="#Parameter-descriptions-2" class="headerlink" title="Parameter descriptions"></a>Parameter descriptions</h3><table>
 962  <thead>
 963  <tr>
 964  <th>Option</th>
 965  <th>Type: <code>default</code></th>
 966  <th>Value</th>
 967  </tr>
 968  </thead>
 969  <tbody><tr>
 970  <td><code>networkType</code></td>
 971  <td>string: <code>testnet</code></td>
 972  <td>Again, used to specify the network. <code>testnet</code> here represents Ropsten. You can change the network by using a <code>networkId</code> by changing <code>networkType</code> to <code>custom</code></td>
 973  </tr>
 974  <tr>
 975  <td><code>syncMode</code></td>
 976  <td>string</td>
 977  <td>Blockchain sync mode</td>
 978  </tr>
 979  <tr>
 980  <td><code>syncMode = &#39;light&#39;</code></td>
 981  <td></td>
 982  <td>Light clients synchronize a bare minimum of data and fetch necessary data on-demand from the network. Much lower in storage, potentially higher in bandwidth</td>
 983  </tr>
 984  <tr>
 985  <td><code>syncMode = &#39;fast&#39;</code></td>
 986  <td></td>
 987  <td>Faster, but higher store</td>
 988  </tr>
 989  <tr>
 990  <td><code>syncMode = &#39;full&#39;</code></td>
 991  <td></td>
 992  <td>Normal sync</td>
 993  </tr>
 994  <tr>
 995  <td><code>accounts</code></td>
 996  <td>array</td>
 997  <td>Array of accounts to connect to.  Go to the <a href="/docs/blockchain_accounts_configuration.html">Accounts configuration</a> page to learn more on accounts</td>
 998  </tr>
 999  </tbody></table>
1000  <h2 id="Mainnet-configuration"><a href="#Mainnet-configuration" class="headerlink" title="Mainnet configuration"></a>Mainnet configuration</h2><p>Finally, the main network, a.k.a. mainnet. It may come as no surprise, but to sync to the mainnet, the step and configurations are actually the same as for a <a href="#Testnet-configuration">test network</a>. The only major difference is that the <code>networkType</code> needs to be <code>custom</code> with the <code>networkId</code> set to <code>1</code>.</p>
1001  <figure class="highlight plain"><table><tr><td class="code"><pre><span class="line">mainnet: &#123;</span><br><span class="line">  networkType: &quot;custom&quot;,</span><br><span class="line">  networkId: 1,</span><br><span class="line">  syncMode: &quot;light&quot;,</span><br><span class="line">  accounts: [</span><br><span class="line">    &#123;</span><br><span class="line">      nodeAccounts: true,</span><br><span class="line">      password: &quot;config&#x2F;mainnet&#x2F;password&quot;</span><br><span class="line">    &#125;</span><br><span class="line">  ]</span><br><span class="line">&#125;</span><br></pre></td></tr></table></figure>
1002  
1003          </div>
1004          <div class="o-container-medium o-distance-l">
1005            <div class="o-flex o-flex-space-between">
1006    
1007    <div class="o-flex__item">
1008      <a href="/docs/contracts_javascript.html" class="c-button c-button--quite" title="Previous article">Previous</a>
1009    </div>
1010    
1011    
1012    <div class="o-flex__item">
1013      <a href="/docs/blockchain_accounts_configuration.html" class="c-button c-button--quite" title="Next article">Next</a>
1014    </div>
1015    
1016  </div>
1017  
1018  
1019          </div>
1020        </div>
1021        <div class="o-guided-content__addition">
1022          <h3 class="c-category-title">Contents</h3>
1023          <ol class="o-list-bare"><li class="o-list-bare__item o-list-bare-level-2 o-ellipsis"><a href="#Common-Parameters" class="u-link-uniform">Common Parameters</a><ol class="o-list-bare__child"><li class="o-list-bare__item o-list-bare-level-3 o-ellipsis"><a href="#Parameter-descriptions" class="u-link-uniform">Parameter descriptions</a></li></ol></li><li class="o-list-bare__item o-list-bare-level-2 o-ellipsis"><a href="#Advanced-parameters" class="u-link-uniform">Advanced parameters</a></li><li class="o-list-bare__item o-list-bare-level-2 o-ellipsis"><a href="#Privatenet-configuration" class="u-link-uniform">Privatenet configuration</a><ol class="o-list-bare__child"><li class="o-list-bare__item o-list-bare-level-3 o-ellipsis"><a href="#Privatenet-parameters" class="u-link-uniform">Privatenet parameters</a></li><li class="o-list-bare__item o-list-bare-level-3 o-ellipsis"><a href="#Parameter-descriptions-1" class="u-link-uniform">Parameter descriptions</a></li></ol></li><li class="o-list-bare__item o-list-bare-level-2 o-ellipsis"><a href="#Testnet-configuration" class="u-link-uniform">Testnet configuration</a><ol class="o-list-bare__child"><li class="o-list-bare__item o-list-bare-level-3 o-ellipsis"><a href="#Testnet-parameters" class="u-link-uniform">Testnet parameters</a></li><li class="o-list-bare__item o-list-bare-level-3 o-ellipsis"><a href="#Parameter-descriptions-2" class="u-link-uniform">Parameter descriptions</a></li></ol></li><li class="o-list-bare__item o-list-bare-level-2 o-ellipsis"><a href="#Mainnet-configuration" class="u-link-uniform">Mainnet configuration</a></li></ol>
1024        </div>
1025      </div>
1026    </section>
1027  </main>
1028  
1029  <script src="/js/linkjuice/dist/linkjuice.min.js"></script>
1030  
1031      <footer role="contentinfo" class="c-footer o-distance-xxl">
1032    <div class="o-container">
1033      <div class="c-footer__top">
1034        <p class="c-category-title c-footer__top__title u-text-light">
1035          <a href="/" class="c-logo c-logo--negative" title="Embark">Embark</a>
1036        </p>
1037      </div>
1038      <div class="c-footer__body">
1039        <div class="o-grid">
1040          <div class="o-grid__column--1-1 o-grid__column--medium-1-2 o-grid__column--large-1-5">
1041            <p class="c-category-title u-text-light">Resources</p>
1042            <ul class="o-list-bare">
1043              <li class="o-list-bare__item">
1044                <a href="/docs/quick_start.html" class="u-link-ghost" title="Quick Start">Quick Start</a>
1045              </li>
1046              <li class="o-list-bare__item">
1047                <a href="/docs" class="u-link-ghost" title="Documentation">Documentation</a>
1048              </li>
1049              <li class="o-list-bare__item">
1050                <a href="https://blog.embarklabs.io" target="_blank" rel="noopener" class="u-link-ghost" title="Blog">Blog</a>
1051              </li>
1052              <li class="o-list-bare__item">
1053                <a href="/docs/faq.html" class="u-link-ghost" title="FAQ">FAQ</a>
1054              </li>
1055              <li class="o-list-bare__item">
1056                <a href="/docs/troubleshooting.html" class="u-link-ghost" title="Troubleshooting">Troubleshooting</a>
1057              </li>
1058            </ul>
1059          </div>
1060          <div class="o-grid__column--1-1 o-grid__column--medium-1-2 o-grid__column--large-1-5">
1061            <p class="c-category-title u-text-light">Help</p>
1062            <ul class="o-list-bare">
1063              <li class="o-list-bare__item">
1064                <a href="https://stackoverflow.com/questions/tagged/embark" target="_blank" rel="noopener" class="u-link-ghost" title="Embark Questions">Stack Overflow</a>
1065              </li>
1066              <li class="o-list-bare__item">
1067                <a href="https://gitter.im/embark-framework/Lobby" target="_blank" rel="noopener" class="u-link-ghost" title="Gitter">Gitter</a>
1068              </li>
1069              <li class="o-list-bare__item">
1070                <a href="https://github.com/embarklabs/embark/issues" target="_blank" rel="noopener" class="u-link-ghost" title="Report issues">Report issues</a>
1071              </li>
1072              <li class="o-list-bare__item">
1073                <a href="https://github.com/embarklabs/embark/blob/master/CODE_OF_CONDUCT.md" target="_blank" rel="noopener" class="u-link-ghost" title="Code of Conduct">Code of Conduct</a>
1074              </li>
1075            </ul>
1076          </div>
1077          <div class="o-grid__column--1-1 o-grid__column--medium-1-2 o-grid__column--large-1-5">
1078            <p class="c-category-title u-text-light">Community</p>
1079            <ul class="o-list-bare">
1080              <li class="o-list-bare__item">
1081                <a href="https://github.com/embarklabs" target="_blank" rel="noopener" class="u-link-ghost" title="Github">Github</a>
1082              </li>
1083              <li class="o-list-bare__item">
1084                <a href="https://twitter.com/EmbarkProject" target="_blank" rel="noopener" class="u-link-ghost" title="Twitter">Twitter</a>
1085              </li>
1086              <li class="o-list-bare__item">
1087                <a href="/docs/contributing.html" class="u-link-ghost" title="Contribute">Contribute</a>
1088              </li>
1089              <li class="o-list-bare__item">
1090                <a href="/community/#team" class="u-link-ghost" title="Team">Team</a>
1091              </li>
1092            </ul>
1093          </div>
1094  
1095          <div class="o-grid__column--1-1 o-grid__column--medium-1-2 o-grid__column--large-1-4">
1096            <p class="c-category-title u-text-light">The Status Network</p>
1097            <ul class="o-list-bare two-columns">
1098              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://status.im/" target="_blank">Status</a></li>
1099              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://keycard.tech/" target="_blank">Keycard</a></li>
1100              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://dap.ps/" target="_blank">dap.ps</a></li>
1101              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://teller.exchange/" target="_blank">Teller</a></li>
1102              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://assemble.fund/" target="_blank">Assemble</a></li>
1103              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://subspace.embarklabs.io/" target="_blank">Subspace</a></li>
1104              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://vac.dev/" target="_blank">Vac</a></li>
1105              <li class="o-list-bare__item"><a class="u-link-ghost" href="https://nimbus.team/" target="_blank">Nimbus</a></li>
1106            </ul>
1107          </div>
1108        </div>
1109      </div>
1110      <div class="c-footer__bottom">
1111        <p class="u-text-light">
1112          <a href="https://status.im/privacy-policy.html" title="Privacy Policy" target="_blank" class="u-text-light">Privacy Policy</a>
1113          / © 2019-2020 Embark
1114        </p>
1115      </div>
1116    </div>
1117  </footer>
1118  
1119  
1120  
1121  
1122      <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.4/highlight.min.js"></script>
1123      <script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js"></script>
1124      <script>
1125        const EMBARK_DOC_VERSIONS = {
1126          'latest': 'https://framework.embarklabs.io/docs','3.2': 'https://5ca4e0fdb29712000adde37f--embark-site-versions.netlify.com/docs/'
1127        };
1128      </script>
1129  
1130      
1131      <!-- Fathom - simple website analytics - https://github.com/usefathom/fathom -->
1132      <script>
1133      (function(f, a, t, h, o, m){
1134          a[h]=a[h]||function(){(a[h].q=a[h].q||[]).push(arguments)};
1135          o=f.createElement('script'),
1136          m=f.getElementsByTagName('script')[0];
1137          o.async=1; o.src=t; o.id='fathom-script';
1138          m.parentNode.insertBefore(o,m)
1139      })(document, window, '//fathom.status.im/tracker.js', 'fathom');
1140      fathom('set', 'siteId', 'YDUQQ');
1141      fathom('trackPageview');
1142      </script>
1143      <!-- / Fathom -->
1144      
1145  
1146      <script src="/js/index.js"></script>
1147  
1148      
1149      <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
1150      <script type="text/javascript">
1151        docsearch({
1152          apiKey: '439d8dc2add18007a2f31be4a9c0ed70',
1153          indexName: 'embark',
1154          inputSelector: '#search-input'
1155        });
1156      </script>
1157      
1158    </body>
1159  </html>
1160