Skip to content

Commit

Permalink
deploy: 905b89a
Browse files Browse the repository at this point in the history
  • Loading branch information
zzzckck committed Jul 25, 2024
1 parent 3bfa81c commit 30179af
Show file tree
Hide file tree
Showing 13 changed files with 159 additions and 203 deletions.
24 changes: 13 additions & 11 deletions bnb-smart-chain/developers/node_operators/archive_node/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1220,11 +1220,11 @@


<li class="md-nav__item">
<a href="../docker/" class="md-nav__link">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Docker Image
Verify Node
</span>


Expand All @@ -1241,11 +1241,11 @@


<li class="md-nav__item">
<a href="../upgrade_geth/" class="md-nav__link">
<a href="../docker/" class="md-nav__link">


<span class="md-ellipsis">
Upgrade Geth
Docker Image
</span>


Expand All @@ -1262,11 +1262,11 @@


<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">
<a href="../upgrade_geth/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
Upgrade Geth
</span>


Expand Down Expand Up @@ -2284,11 +2284,13 @@ <h2 id="what-is-an-archive-node">What is an archive node?<a class="headerlink" h
<p>Simply speaking, an archive node is a full node running with an additional special option, <code>--gcmode archive</code>. It stores all the historical data of the blockchain starting from the genesis block. As compared to a typical full node that just holds all the state change data for some latest blocks, an archive node always stores them for each block.</p>
<h2 id="why-is-an-archive-node-important">Why is an archive node important?<a class="headerlink" href="#why-is-an-archive-node-important" title="Link to this section"></a></h2>
<p>Developers are limited to querying the limited recent blocks to check the balance of an address and the state of a smart contract with a full node. It is hard to get all what they want as the blockchain is moving forward at the same time, while they can query any block at a specific point in time with an archive node.
Archive nodes are used by various applications on the blockchain for challenging use cases, including but not limited to the followings:
* Automatic trading system needs historical data to optimize trading model
* Verification modules need state data to verify transactions in time
* Analytical tools need full historical data to do data analysis
* Exchange in some wallets depends on archive node for fast and efficient transfers</p>
Archive nodes are used by various applications on the blockchain for challenging use cases, including but not limited to the followings:</p>
<ul>
<li>Automatic trading system needs historical data to optimize trading model</li>
<li>Verification modules need state data to verify transactions in time</li>
<li>Analytical tools need full historical data to do data analysis</li>
<li>Exchange in some wallets depends on archive node for fast and efficient transfers</li>
</ul>
<h2 id="suggested-requirements">Suggested Requirements<a class="headerlink" href="#suggested-requirements" title="Link to this section"></a></h2>
<p>Running an archive node will take a high cost as it includes all the block and state change data. First of all it needs the disk with sufficient capacity; besides this, the CPU and disk performance should be good enough to catch up with the latest block height. You can refer to the <a href="https://github.com/node-real/bsc-erigon?tab=readme-ov-file#system-requirements">suggested hardware requirements</a>.</p>
<h2 id="how-to-run-an-archive-node-for-bsc-mainnet">How to run an archive node for BSC mainnet?<a class="headerlink" href="#how-to-run-an-archive-node-for-bsc-mainnet" title="Link to this section"></a></h2>
Expand Down
12 changes: 6 additions & 6 deletions bnb-smart-chain/developers/node_operators/boot_node/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1216,11 +1216,11 @@


<li class="md-nav__item">
<a href="../docker/" class="md-nav__link">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Docker Image
Verify Node
</span>


Expand All @@ -1237,11 +1237,11 @@


<li class="md-nav__item">
<a href="../upgrade_geth/" class="md-nav__link">
<a href="../docker/" class="md-nav__link">


<span class="md-ellipsis">
Upgrade Geth
Docker Image
</span>


Expand All @@ -1258,11 +1258,11 @@


<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">
<a href="../upgrade_geth/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
Upgrade Geth
</span>


Expand Down
48 changes: 24 additions & 24 deletions bnb-smart-chain/developers/node_operators/docker/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
<link rel="canonical" href="https://docs.bnbchain.org/bnb-smart-chain/developers/node_operators/docker/">


<link rel="prev" href="../separate_node/">
<link rel="prev" href="../verify_node/">


<link rel="next" href="../upgrade_geth/">
Expand Down Expand Up @@ -1126,6 +1126,27 @@





<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
</span>


</a>
</li>











Expand Down Expand Up @@ -1336,27 +1357,6 @@



<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
</span>


</a>
</li>










<li class="md-nav__item">
<a href="../node_maintenance/" class="md-nav__link">

Expand Down Expand Up @@ -2581,7 +2581,7 @@ <h4 id="check-geth-logs">Check Geth Logs<a class="headerlink" href="#check-geth-
<nav class="md-footer__inner md-grid" aria-label="Footer" >


<a href="../separate_node/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Separate Node">
<a href="../verify_node/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Verify Node">
<div class="md-footer__button md-icon">

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
Expand All @@ -2591,7 +2591,7 @@ <h4 id="check-geth-logs">Check Geth Logs<a class="headerlink" href="#check-geth-
Previous
</span>
<div class="md-ellipsis">
Separate Node
Verify Node
</div>
</div>
</a>
Expand Down
12 changes: 6 additions & 6 deletions bnb-smart-chain/developers/node_operators/fast_node/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1247,11 +1247,11 @@


<li class="md-nav__item">
<a href="../docker/" class="md-nav__link">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Docker Image
Verify Node
</span>


Expand All @@ -1268,11 +1268,11 @@


<li class="md-nav__item">
<a href="../upgrade_geth/" class="md-nav__link">
<a href="../docker/" class="md-nav__link">


<span class="md-ellipsis">
Upgrade Geth
Docker Image
</span>


Expand All @@ -1289,11 +1289,11 @@


<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">
<a href="../upgrade_geth/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
Upgrade Geth
</span>


Expand Down
39 changes: 8 additions & 31 deletions bnb-smart-chain/developers/node_operators/full_node/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1271,11 +1271,11 @@


<li class="md-nav__item">
<a href="../docker/" class="md-nav__link">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Docker Image
Verify Node
</span>


Expand All @@ -1292,11 +1292,11 @@


<li class="md-nav__item">
<a href="../upgrade_geth/" class="md-nav__link">
<a href="../docker/" class="md-nav__link">


<span class="md-ellipsis">
Upgrade Geth
Docker Image
</span>


Expand All @@ -1313,11 +1313,11 @@


<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">
<a href="../upgrade_geth/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
Upgrade Geth
</span>


Expand Down Expand Up @@ -2437,8 +2437,7 @@ <h3 id="sync-from-snapshot-recommended">Sync From Snapshot (Recommended)<a class
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Make sure you use the version of geth you downloaded with wget above, and not your local installation of geth, which might be the wrong version.
1. Since <code>v1.3.1</code>, the flags <code>--txlookuplimit</code> has been replaced by <code>--history.transactions</code>. Make sure you no longer use <code>--txlookuplimit</code>, otherwise, node may not start.
2. For all geth nodes, DO NOT use <code>-pipecommit</code> flag</p>
For all geth nodes, DO NOT use <code>-pipecommit</code> flag</p>
</div>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
Expand Down Expand Up @@ -2469,33 +2468,11 @@ <h3 id="sync-from-genesis-block-not-recommended">Sync From Genesis Block (Not Re
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>To sync from genesis block, you would need a more powerful hardware. Server should at least have 40k IOPS and be at least an i3/i3en series server.
If you can not download the chaindata snapshot and want to sync from genesis, then you have to generate the genesis block first, for which you have already downloaded the genesis.json in the Step - 2 above where you have downloaded config files.</p>
<p>To sync from genesis block, you would need a more powerful hardware. Server should at least have 40k IOPS and be at least an i3/i3en series server.</p>
</div>
<ol>
<li>
<p>Write genesis state locally</p>
<div class="highlight"><pre><span></span><code>## It will init genesis with Hash-Base Storage Scheme by default.
./geth --datadir ./node init ./genesis.json
</code></pre></div>
<p>You could see the following output:</p>
<div class="highlight"><pre><span></span><code>INFO [05-19|14:53:17.468] Allocated cache and file handles database=/Users/huangsuyu/Downloads/bsc/node/geth/chaindata cache=16.00MiB handles=16
INFO [05-19|14:53:17.498] Writing custom genesis block
INFO [05-19|14:53:17.501] Persisted trie from memory database nodes=21 size=56.84KiB time=357.915µs gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=-574.00B
INFO [05-19|14:53:17.502] Successfully wrote genesis state database=chaindata hash=7d79cc…fb0d1e
INFO [05-19|14:53:17.503] Allocated cache and file handles database=/Users/huangsuyu/Downloads/bsc/node/geth/lightchaindata cache=16.00MiB handles=16
INFO [05-19|14:53:17.524] Writing custom genesis block
INFO [05-19|14:53:17.525] Persisted trie from memory database nodes=21 size=56.84KiB time=638.396µs gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=-574.00B
INFO [05-19|14:53:17.528] Successfully wrote genesis state database=lightchaindata hash=7d79cc…fb0d1e
</code></pre></div>
</li>
<li>
<p>Start fullnode</p>
<div class="highlight"><pre><span></span><code><span class="c1">## start a full node</span>
./geth<span class="w"> </span>--config<span class="w"> </span>./config.toml<span class="w"> </span>--datadir<span class="w"> </span>./node<span class="w"> </span>--cache<span class="w"> </span><span class="m">8000</span><span class="w"> </span>--rpc.allow-unprotected-txs<span class="w"> </span>--history.transactions<span class="w"> </span><span class="m">0</span>
</code></pre></div>
</li>
</ol>
<h2 id="sync-mode">Sync Mode<a class="headerlink" href="#sync-mode" title="Link to this section"></a></h2>
<p>There are two sync modes for running a full node: <strong>snap</strong> and <strong>full</strong> which can be specified by flag <strong>–syncmode</strong>.</p>
<p>The <strong>snap</strong> sync mode is used for initial sync, which will download the latest states rather than execute the blocks from the genesis. When the initial sync is done, it will switch to full sync automatically.</p>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1418,11 +1418,11 @@


<li class="md-nav__item">
<a href="../docker/" class="md-nav__link">
<a href="../verify_node/" class="md-nav__link">


<span class="md-ellipsis">
Docker Image
Verify Node
</span>


Expand All @@ -1439,11 +1439,11 @@


<li class="md-nav__item">
<a href="../upgrade_geth/" class="md-nav__link">
<a href="../docker/" class="md-nav__link">


<span class="md-ellipsis">
Upgrade Geth
Docker Image
</span>


Expand All @@ -1460,11 +1460,11 @@


<li class="md-nav__item">
<a href="../verify_node/" class="md-nav__link">
<a href="../upgrade_geth/" class="md-nav__link">


<span class="md-ellipsis">
Verify Node
Upgrade Geth
</span>


Expand Down
Loading

0 comments on commit 30179af

Please sign in to comment.