mirrors/bitcoin-s
1
0
Fork 0
mirror of https://github.com/bitcoin-s/bitcoin-s.git synced 2025-03-15 20:30:17 +01:00
Code Issues Projects Releases Packages Wiki Activity
bitcoin-s/docs/next/applications/chain.html

142 lines
15 KiB
HTML
Raw Normal View History

Deploy website Deploy website version based on 190f49aad707116ca24577fd2e801f6cec3ed0bd
2020-03-11 16:28:43 +00:00
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Blockchain Verification · bitcoin-s</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Bitcoin-S comes bundled with a rudimentary blockchain verification"/><meta name="docsearch:version" content="next"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="Blockchain Verification · bitcoin-s"/><meta property="og:type" content="website"/><meta property="og:url" content="https://bitcoin-s.org/"/><meta property="og:description" content="Bitcoin-S comes bundled with a rudimentary blockchain verification"/><meta property="og:image" content="https://bitcoin-s.org/img/undraw_online.svg"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://bitcoin-s.org/img/undraw_tweetstorm.svg"/><link rel="shortcut icon" href="/img/favicon.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css"/><link rel="stylesheet" href="/css/code-block-buttons.css"/><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js"></script><script type="text/javascript" src="https://fonts.googleapis.com/css?family=Montserrat:500"></script><script type="text/javascript" src="https://www.googletagmanager.com/gtag/js?id=UA-61958686-2"></script><script type="text/javascript" src="/js/code-block-buttons.js"></script><script src="/js/scrollSpy.js"></script><link rel="stylesheet" href="/css/main.css"/><script src="/js/codetabs.js"></script></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/"><img class="logo" src="/img/favicon.ico" alt="bitcoin-s"/><h2 class="headerTitleWithLogo">bitcoin-s</h2></a><a href="/versions"><h3>next</h3></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class="siteNavGroupActive"><a href="/docs/next/core/core-intro" target="_self">Docs</a></li><li class=""><a href="/api/org/bitcoins" target="_self">API</a></li><li class=""><a href="/help" target="_self">Help</a></li><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"><div class="hamburger-menu"><div class="line1"></div><div class="line2"></div><div class="line3"></div></div></div><h2><i>›</i><span>Applications</span></h2><div class="tocToggler" id="tocToggler"><i class="icon-toc"></i></div></div><div class="navGroups"><div class="navGroup"><h3 class="navGroupCategoryTitle">Getting started</h3><ul class=""><li class="navListItem"><a class="navItem" href="/docs/next/getting-started">Add Bitcoin-S to your project</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Getting setup</h3><ul class=""><li class="navListItem"><a class="navItem" href="/docs/next/getting-setup">Getting Bitcoin-S installed on your machine</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle">Core module</h3><ul class=""><li class="navListItem"><a class="navItem" href="/docs/next/core/core-intro">Core module</a></li><li class="navListItem"><a class="navItem" href="/docs/next/core/addresses">Generating addresses</a></li><li class="navListItem"><a class="navItem" href="/docs/next/core/hd-keys">HD key generation</a></li><li class="navListItem"><a class="navItem" href="/docs/next/core/adding-spks">Adding New Script T
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
var coll = document.getElementsByClassName('collapsible');
var checkActiveCategory = true;
for (var i = 0; i < coll.length; i++) {
var links = coll[i].nextElementSibling.getElementsByTagName('*');
if (checkActiveCategory){
for (var j = 0; j < links.length; j++) {
if (links[j].classList.contains('navListItemActive')){
coll[i].nextElementSibling.classList.toggle('hide');
coll[i].childNodes[1].classList.toggle('rotate');
checkActiveCategory = false;
break;
}
}
}
coll[i].addEventListener('click', function() {
var arrow = this.childNodes[1];
arrow.classList.toggle('rotate');
var content = this.nextElementSibling;
content.classList.toggle('hide');
});
}
document.addEventListener('DOMContentLoaded', function() {
createToggler('#navToggler', '#docsNav', 'docsSliderActive');
createToggler('#tocToggler', 'body', 'tocActive');
Deploy website Deploy website version based on 52351447964a0b2a54c3c9c4c0602565f40a6585
2019-12-13 15:35:21 -06:00
var headings = document.querySelector('.toc-headings');
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
headings && headings.addEventListener('click', function(event) {
Deploy website Deploy website version based on 52351447964a0b2a54c3c9c4c0602565f40a6585
2019-12-13 15:35:21 -06:00
var el = event.target;
while(el !== headings){
if (el.tagName === 'A') {
document.body.classList.remove('tocActive');
break;
} else{
el = el.parentNode;
}
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
}
}, false);
function createToggler(togglerSelector, targetSelector, className) {
var toggler = document.querySelector(togglerSelector);
var target = document.querySelector(targetSelector);
if (!toggler) {
return;
}
toggler.onclick = function(event) {
event.preventDefault();
target.classList.toggle(className);
};
}
});
Deploy website Deploy website version based on d78bcaaae3733b222badc243f5d4f51d8c70cc6d
2019-12-18 20:27:16 +00:00
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://github.com/bitcoin-s/bitcoin-s/blob/master/docs/applications/chain.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">Blockchain Verification</h1></header><article><div><span><p>Bitcoin-S comes bundled with a rudimentary blockchain verification
Deploy website Deploy website version based on 69d9c3a3f29bc2098cc6460fcca19eb1af909ede
2019-09-02 13:23:46 +00:00
module. This module is currently only released as a library, and not as a binary.
This is because it (nor the documentation) is not deemed production
ready. Use at your own risk, and without too much money depending on it.</p>
<h2><a class="anchor" aria-hidden="true" id="syncing-and-verifying-block-headers"></a><a href="#syncing-and-verifying-block-headers" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Syncing and verifying block headers</h2>
<p>Using the <code>chain</code> module of Bitcoin-S it's possible to
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
sync and verify block headers from the Bitcoin blockchain. In this document
we demonstrate how to do this, while persisting it to disk. We should be
able to read this chain on subsequent runs, assuming we are connected
to the same <code>bitcoind</code> instance.</p>
Deploy website Deploy website version based on 89f1db6ca75baad3ad9a58fd6542bf026b6fa91b
2020-03-10 19:06:52 +00:00
<pre><code class="hljs css language-scala">implicit val ec = ExecutionContext.global
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
// We are assuming that a `bitcoind` regtest node is running the background.
// You can see our `bitcoind` guides to see how to connect
// to a local or remote `bitcoind` node.
val bitcoindInstance = BitcoindInstance.fromDatadir()
Deploy website Deploy website version based on 5d6a71a490f42dd7a58a70971a20e356f886da78
2019-08-30 20:18:52 +00:00
val rpcCli = BitcoindRpcClient(bitcoindInstance)
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
// Next, we need to create a way to monitor the chain:
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
val getBestBlockHash = SyncUtil.getBestBlockHashFunc(rpcCli)
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
val getBlockHeader = SyncUtil.getBlockHeaderFunc(rpcCli)
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
// set a data directory
val datadir = Files.createTempDirectory("bitcoin-s-test")
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
// set the current network to regtest
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
import com.typesafe.config.ConfigFactory
val config = ConfigFactory.parseString {
"""
| bitcoin-s {
| network = regtest
| }
|""".stripMargin
}
implicit val chainConfig = ChainAppConfig(datadir, config)
// Initialize the needed database tables if they don't exist:
val chainProjectInitF = chainConfig.initialize()
val blockHeaderDAO = BlockHeaderDAO()
Deploy website Deploy website version based on 933f0fcfd0c8233114b3d8cb004e26d8237246ae
2019-09-25 18:26:03 +00:00
val compactFilterHeaderDAO = CompactFilterHeaderDAO()
val compactFilterDAO = CompactFilterDAO()
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
//initialize the chain handler from the database
Deploy website Deploy website version based on 933f0fcfd0c8233114b3d8cb004e26d8237246ae
2019-09-25 18:26:03 +00:00
val chainHandlerF = ChainHandler.fromDatabase(blockHeaderDAO, compactFilterHeaderDAO, compactFilterDAO)
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
// Now, do the actual syncing:
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
val syncedChainApiF = for {
_ &lt;- chainProjectInitF
handler &lt;- chainHandlerF
synced &lt;- ChainSync.sync(handler, getBlockHeader, getBestBlockHash)
} yield synced
val syncResultF = syncedChainApiF.flatMap { chainApi =&gt;
chainApi.getBlockCount.map(count =&gt; println(s"chain api blockcount=${count}"))
rpcCli.getBlockCount.map(count =&gt; println(s"bitcoind blockcount=${count}"))
}
syncResultF.onComplete { case result =&gt;
println(s"Sync result=${result}")
}
</code></pre>
Deploy website Deploy website version based on 6d6b1023c5177f1130699d96aa7a6bcd0f5b88d9
2020-03-10 23:10:01 +00:00
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/next/rpc/rpc-bitcoind"><span class="arrow-prev">← </span><span>bitcoind/Bitcoin Core</span></a><a class="docs-next button" href="/docs/next/applications/filter-sync"><span>Syncing Blockfilters</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#syncing-and-verifying-block-headers">Syncing and verifying block headers</a></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/favicon.ico" alt="bitcoin-s" width="66" height="58"/></a><div><h5>Docs</h5><a href="/docs/en/getting-started">Getting Started</a><a href="/docs/en/core/core-intro">Guides</a><a href="/api/org/bitcoins">API Reference</a></div><div><h5>Community</h5><a href="/en/users.html">User Showcase</a><a href="https://join.slack.com/t/suredbits/shared_invite/enQtNDEyMjY3MTg1MTg3LTYyYjkwOGUzMDQ4NDAwZjE1M2I3MmQyNWNlZjNlYjg4OGRjYTRjNWUwNjRjNjg4Y2NjZjAxYjU1N2JjMTU1YWM" target="_blank" rel="noreferrer noopener">Slack</a><a href="https://gitter.im/bitcoin-s-core/">Gitter chat</a></div><div><h5>More</h5><a href="https://github.com/bitcoin-s/bitcoin-s">GitHub</a><a class="github-button" href="https://github.com/bitcoin-s/bitcoin-s" data-icon="octicon-star" data-count-href="/bitcoin-s/bitcoin-s-core/stargazers" data-show-count="true" data-count-aria-label="# stargazers on GitHub" aria-label="Star this project on GitHub">Star</a></div></section><section class="copyright">Copyright © 2020 Suredbits &amp; the bitcoin-s developers</section></footer></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script><script>
Deploy website Deploy website version based on c5fc1331617b24b3525cfda06aeaad5abaeecf45
2019-08-26 12:25:44 +00:00
document.addEventListener('keyup', function(e) {
if (e.target !== document.body) {
return;
}
// keyCode for '/' (slash)
if (e.keyCode === 191) {
const search = document.getElementById('search_input_react');
search && search.focus();
}
});
</script><script>
var search = docsearch({
apiKey: '0a510688bf8448e19aeb380377d328d3',
indexName: 'bitcoin-s',
inputSelector: '#search_input_react'
});
</script></body></html>
Reference in a new issue Copy permalink