mirror of
https://github.com/bitcoin-s/bitcoin-s.git
synced 2025-03-17 21:11:12 +01:00
104 lines
No EOL
17 KiB
HTML
104 lines
No EOL
17 KiB
HTML
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Sports Betting Example · bitcoin-s</title><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Requirements for example"/><meta name="docsearch:version" content="1.9.3"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="Sports Betting Example · bitcoin-s"/><meta property="og:type" content="website"/><meta property="og:url" content="https://bitcoin-s.org/"/><meta property="og:description" content="## Requirements for example"/><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"/><script>
|
|
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
|
|
|
|
ga('create', 'UA-61958686-2', 'auto');
|
|
ga('send', 'pageview');
|
|
</script><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>1.9.3</h3></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class=""><a href="/docs/core/core-intro" target="_self">Docs</a></li><li class=""><a href="/download" target="_self">Download</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="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/oracle/oracle-sports-betting-example.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">Sports Betting Example</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="requirements-for-example"></a><a href="#requirements-for-example" 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>Requirements for example</h2>
|
|
<p>You need to have a fully built oracle server. You can follow <a href="/docs/oracle/build-oracle-server">this guide</a> to do this.</p>
|
|
<p>You will also need a the <code>bitcoin-s-cli</code> command line tool to interact with the server.
|
|
You can find how to build this <a href="/docs/applications/cli">here</a></p>
|
|
<p>After building the oracle server, you will need to start it with</p>
|
|
<pre><code class="hljs">.<span class="hljs-meta-keyword">/app/</span>oracle-server<span class="hljs-meta-keyword">/target/</span>universal<span class="hljs-meta-keyword">/stage/</span>bin/bitcoin-s-oracle-server
|
|
</code></pre>
|
|
<h2><a class="anchor" aria-hidden="true" id="rocky-vs-drago-2022-boxing-championship"></a><a href="#rocky-vs-drago-2022-boxing-championship" 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>Rocky V.S. Drago 2022 Boxing Championship</h2>
|
|
<p>In 2022, Rocky and Drago compete in the final round of the boxing championship.
|
|
People want to do a DLC based on the outcome, so you decide to be
|
|
their oracle and attest to the winner of the match.</p>
|
|
<ol>
|
|
<li>Setting up an oracle that can attest to the outcome of the match</li>
|
|
<li>Complete the announcement by attesting to the winner of the match</li>
|
|
</ol>
|
|
<h3><a class="anchor" aria-hidden="true" id="setting-up-the-boxing-bet"></a><a href="#setting-up-the-boxing-bet" 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>Setting up the boxing bet</h3>
|
|
<p>The boxing match bet can be represented by an enumerated announcement. What we mean by this is the outcomes for this announcement can be simply enumerated in a list. There were three possible outcomes for the match</p>
|
|
<ol>
|
|
<li>"Drago_win"</li>
|
|
<li>"Rocky_win"</li>
|
|
<li>"other"</li>
|
|
</ol>
|
|
<p>The next step is to create an oracle announcement that can be shared with others. This announcement
|
|
contains cryptographic information that is used by people that want to enter into DLCs to setup
|
|
their bitcoin transactions.</p>
|
|
<p>To do this, we need to use the <code>createenumannouncement</code> rpc. This RPC takes 3 parameters</p>
|
|
<ol>
|
|
<li>The label for the announcement
|
|
we will use <code>2022-championship-boxing</code></li>
|
|
<li>the maturation time for the announcement in ISO 8061 format
|
|
For our example we will use <code>"2022-06-16T00:00:00Z"</code></li>
|
|
<li>The outcomes, which we listed above "Drago_win,Rocky_win,other"</li>
|
|
</ol>
|
|
<p>with all of this information, we can create the announcement with <code>bitcoin-s-cli</code>!</p>
|
|
<p>./bitcoin-s-cli createenumannouncement 2022-championship-boxing "2022-06-16T00:00:00Z" "Rocky_win,Drago_win,other"
|
|
fdd824c358412e9c9dc12942a9e1ed030c7bf4ff10f80b0228f9674245ae15d8a956bae6fa0186994d7e12a3b0793b67ebad83d735e9232d9e15eda5c2948d4b8a042a5eb923f087791a31409523431b28dc20af6871f515715ab0e6219c971ee4cb75cbfdd8225f00010a9e74e8c52ae90846cedbb2af3d2e0edc2234a8b4ef240c4fcfbe4f31c693be62aa7280fdd8061c000309526f636b795f77696e09447261676f5f77696e056f7468657218323032322d6368616d70696f6e736869702d626f78696e67</p>
|
|
<p>Yay! The hex string returned is an oracle announcement.
|
|
You can submit this on a tool like the <a href="https://oracle.suredbits.com">Suredbits oracle explorer</a>
|
|
so others can find your oracle.</p>
|
|
<p>If you are building infrastructure to automatically sign announcements, it is important to store two things</p>
|
|
<ol>
|
|
<li>The oracle announcement above (<code>fdd824c...</code>)</li>
|
|
<li>The timestamp that the announcement matures at (<code>"2022-06-16T00:00:00Z"</code>)</li>
|
|
</ol>
|
|
<p>Now you can schedule jobs to sign the announcement when the maturation time passes.</p>
|
|
<h3><a class="anchor" aria-hidden="true" id="signing-the-outcome-for-the-boxing-bet"></a><a href="#signing-the-outcome-for-the-boxing-bet" 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>Signing the outcome for the boxing bet</h3>
|
|
<p>In the real world, you would want to wait for the maturation time to pass for your announcement.
|
|
For the purposes of the demo, we can skip this wait. The winner of the 2022 boxing championship is Rocky.</p>
|
|
<p>Let's sign the announcement.</p>
|
|
<pre><code class="hljs"> ./bitcoin-s-cli signenum <span class="hljs-number">2022</span>-championship-boxing Rocky_win
|
|
fdd<span class="hljs-number">8688518323032322</span>d<span class="hljs-number">6368616</span>d<span class="hljs-number">70696</span>f<span class="hljs-number">6e736869702</span>d<span class="hljs-number">626</span>f<span class="hljs-number">78696e67</span>b<span class="hljs-number">923</span>f<span class="hljs-number">087791</span>a<span class="hljs-number">31409523431</span>b<span class="hljs-number">28</span>dc<span class="hljs-number">20</span>af<span class="hljs-number">6871</span>f<span class="hljs-number">515715</span>ab<span class="hljs-number">0e6219</span><span class="hljs-keyword">c</span><span class="hljs-number">971</span>ee<span class="hljs-number">4</span>cb<span class="hljs-number">75</span>cb<span class="hljs-number">00010</span>a<span class="hljs-number">9e74</span>e<span class="hljs-number">8</span><span class="hljs-keyword">c</span><span class="hljs-number">52</span>ae<span class="hljs-number">90846</span>cedbb<span class="hljs-number">2</span>af<span class="hljs-number">3</span>d<span class="hljs-number">2e0</span>edc<span class="hljs-number">2234</span>a<span class="hljs-number">8</span>b<span class="hljs-number">4</span>ef<span class="hljs-number">240</span><span class="hljs-keyword">c</span><span class="hljs-number">4</span>fcfbe<span class="hljs-number">4</span>f<span class="hljs-number">31</span><span class="hljs-keyword">c</span><span class="hljs-number">693</span>be<span class="hljs-number">7</span><span class="hljs-keyword">c</span><span class="hljs-number">83</span><span class="hljs-keyword">c</span><span class="hljs-number">64</span>f<span class="hljs-number">33</span>bacceb<span class="hljs-number">800</span>f<span class="hljs-number">463</span>a<span class="hljs-number">3</span>a<span class="hljs-number">98</span>ca<span class="hljs-number">56</span>a<span class="hljs-number">40</span>bad<span class="hljs-number">7</span><span class="hljs-keyword">c</span><span class="hljs-number">5e7</span>a<span class="hljs-number">417e3</span>f<span class="hljs-number">4e012</span>f<span class="hljs-number">0</span>f<span class="hljs-number">332</span>d<span class="hljs-number">4</span><span class="hljs-keyword">c</span><span class="hljs-number">09526</span>f<span class="hljs-number">636</span>b<span class="hljs-number">795</span>f<span class="hljs-number">77696</span>e
|
|
</code></pre>
|
|
<p>Yay! Now bitcoin-s gives us an attestation that is represented by the hex string <code>fdd868...</code></p>
|
|
<p>If you submitted your announcement to the <a href="https://oracle.suredbits.com">suredbits oracle explorer</a> above
|
|
you will also want to submit the attestation for your announcement so others can find it and settle their DLCs.</p>
|
|
<p>If you use the <code>getannouncement</code> rpc along the oracle announcement, you can see the announcement is now completed!</p>
|
|
<pre><code class="hljs">./<span class="hljs-keyword">bitcoin-s-cli </span>getannouncement <span class="hljs-number">2022</span>-championship-<span class="hljs-keyword">boxing
|
|
</span>{
|
|
<span class="hljs-string">"nonces"</span>: [
|
|
<span class="hljs-string">"0a9e74e8c52ae90846cedbb2af3d2e0edc2234a8b4ef240c4fcfbe4f31c693be"</span>
|
|
],
|
|
<span class="hljs-string">"eventName"</span>: <span class="hljs-string">"2022-championship-boxing"</span>,
|
|
<span class="hljs-string">"signingVersion"</span>: <span class="hljs-string">"DLCOracleV0SigningVersion"</span>,
|
|
<span class="hljs-string">"maturationTime"</span>: <span class="hljs-string">"2022-06-16T00:00:00Z"</span>,
|
|
<span class="hljs-string">"maturationTimeEpoch"</span>: <span class="hljs-number">1655337600</span>,
|
|
<span class="hljs-string">"announcementSignature"</span>: <span class="hljs-string">"58412e9c9dc12942a9e1ed030c7bf4ff10f80b0228f9674245ae15d8a956bae6fa0186994d7e12a3b0793b67ebad83d735e9232d9e15eda5c2948d4b8a042a5e"</span>,
|
|
<span class="hljs-string">"eventDescriptorTLV"</span>: <span class="hljs-string">"fdd8061c000309526f636b795f77696e09447261676f5f77696e056f74686572"</span>,
|
|
<span class="hljs-string">"eventTLV"</span>: <span class="hljs-string">"fdd8225f00010a9e74e8c52ae90846cedbb2af3d2e0edc2234a8b4ef240c4fcfbe4f31c693be62aa7280fdd8061c000309526f636b795f77696e09447261676f5f77696e056f7468657218323032322d6368616d70696f6e736869702d626f78696e67"</span>,
|
|
<span class="hljs-string">"announcementTLV"</span>: <span class="hljs-string">"fdd824c358412e9c9dc12942a9e1ed030c7bf4ff10f80b0228f9674245ae15d8a956bae6fa0186994d7e12a3b0793b67ebad83d735e9232d9e15eda5c2948d4b8a042a5eb923f087791a31409523431b28dc20af6871f515715ab0e6219c971ee4cb75cbfdd8225f00010a9e74e8c52ae90846cedbb2af3d2e0edc2234a8b4ef240c4fcfbe4f31c693be62aa7280fdd8061c000309526f636b795f77696e09447261676f5f77696e056f7468657218323032322d6368616d70696f6e736869702d626f78696e67"</span>,
|
|
<span class="hljs-string">"attestations"</span>: <span class="hljs-string">"fdd8688518323032322d6368616d70696f6e736869702d626f78696e67b923f087791a31409523431b28dc20af6871f515715ab0e6219c971ee4cb75cb00010a9e74e8c52ae90846cedbb2af3d2e0edc2234a8b4ef240c4fcfbe4f31c693be7c83c64f33bacceb800f463a3a98ca56a40bad7c5e7a417e3f4e012f0f332d4c09526f636b795f77696e"</span>,
|
|
<span class="hljs-string">"outcomes"</span>: [
|
|
<span class="hljs-string">"Rocky_win"</span>,
|
|
<span class="hljs-string">"Drago_win"</span>,
|
|
<span class="hljs-string">"other"</span>
|
|
],
|
|
<span class="hljs-string">"signedOutcome"</span>: <span class="hljs-string">"Rocky_win"</span>,
|
|
</code></pre>
|
|
</span></div></article></div><div class="docLastUpdate"><em>Last updated on 6/16/2022 by GreyMcCarthy</em></div><div class="docs-prevnext"></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#requirements-for-example">Requirements for example</a></li><li><a href="#rocky-vs-drago-2022-boxing-championship">Rocky V.S. Drago 2022 Boxing Championship</a><ul class="toc-headings"><li><a href="#setting-up-the-boxing-bet">Setting up the boxing bet</a></li><li><a href="#signing-the-outcome-for-the-boxing-bet">Signing the outcome for the boxing bet</a></li></ul></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/zt-eavycu0x-WQL7XOakzQo8tAy7jHHZUw" 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 © 2022 Suredbits & the bitcoin-s developers</section></footer></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script><script>
|
|
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> |