mirror of
https://github.com/bitcoin-s/bitcoin-s.git
synced 2025-03-19 05:25:11 +01:00
Docusaurus bot
parent
4d6437aacd
commit
594ed89734
18 changed files with 108 additions and 108 deletions
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
|
|
@ -80,7 +80,7 @@ reason to keep using legacy transaction formats.</p>
|
|||
<span class="hljs-keyword">val</span> privkey = <span class="hljs-type">ECPrivateKey</span>()
|
||||
<span class="hljs-comment">// privkey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> pubkey = privkey.publicKey
|
||||
<span class="hljs-comment">// pubkey: org.bitcoins.crypto.ECPublicKey = ECPublicKey(03b9f14792e899ba0003d98bfb229be21b85cf808cfe9f8835d47a3d13642c9d91)</span>
|
||||
<span class="hljs-comment">// pubkey: org.bitcoins.crypto.ECPublicKey = ECPublicKey(03bbc4d29b4a1bd17ef7d8afb5686547b94fcf8109d7ba51e5da6d207435f7b487)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> segwitAddress = {
|
||||
<span class="hljs-comment">// see https://bitcoin.org/en/glossary/pubkey-script</span>
|
||||
|
|
@ -89,10 +89,10 @@ reason to keep using legacy transaction formats.</p>
|
|||
<span class="hljs-keyword">val</span> scriptPubKey = <span class="hljs-type">P2WPKHWitnessSPKV0</span>(pubkey)
|
||||
<span class="hljs-type">Bech32Address</span>(scriptPubKey, <span class="hljs-type">TestNet3</span>)
|
||||
}
|
||||
<span class="hljs-comment">// segwitAddress: Bech32Address = tb1q0wfufw50xg6w32m52nq8jg0u3yhmzru54p3mfk</span>
|
||||
<span class="hljs-comment">// segwitAddress: Bech32Address = tb1qaauw5jr5ydd97zqeymzqky7h4r8ns40dwe9g07</span>
|
||||
|
||||
println(segwitAddress.toString)
|
||||
<span class="hljs-comment">// tb1q0wfufw50xg6w32m52nq8jg0u3yhmzru54p3mfk</span>
|
||||
<span class="hljs-comment">// tb1qaauw5jr5ydd97zqeymzqky7h4r8ns40dwe9g07</span>
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="generating-legacy-base58-addresses"></a><a href="#generating-legacy-base58-addresses" 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>Generating legacy (base58) addresses</h2>
|
||||
<p>If you need to generate legacy addresses for backwards
|
||||
|
|
@ -101,10 +101,10 @@ Take a look:</p>
|
|||
<pre><code class="hljs css language-scala"><span class="hljs-comment">// we're reusing the same private/public key pair</span>
|
||||
<span class="hljs-comment">// from before. don't do this in an actual application!</span>
|
||||
<span class="hljs-keyword">val</span> legacyAddress = <span class="hljs-type">P2PKHAddress</span>(pubkey, <span class="hljs-type">TestNet3</span>)
|
||||
<span class="hljs-comment">// legacyAddress: P2PKHAddress = mrnNRnLpJbhRMwZ4VVQt9LoeCjZvVFv64c</span>
|
||||
<span class="hljs-comment">// legacyAddress: P2PKHAddress = n3MAeEZdHgYSEFEb4fStrSf4whW8Nyo6g7</span>
|
||||
|
||||
println(legacyAddress.toString)
|
||||
<span class="hljs-comment">// mrnNRnLpJbhRMwZ4VVQt9LoeCjZvVFv64c</span>
|
||||
<span class="hljs-comment">// n3MAeEZdHgYSEFEb4fStrSf4whW8Nyo6g7</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/next/core/core-intro"><span class="arrow-prev">← </span><span>Core Module</span></a><a class="docs-next button" href="/docs/next/core/hd-keys"><span>HD Key Generation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#generating-segwit-bech32-addresses">Generating SegWit (bech32) addresses</a></li><li><a href="#generating-legacy-base58-addresses">Generating legacy (base58) addresses</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/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) {
|
||||
|
|
|
|||
|
|
@ -80,7 +80,7 @@ reason to keep using legacy transaction formats.</p>
|
|||
<span class="hljs-keyword">val</span> privkey = <span class="hljs-type">ECPrivateKey</span>()
|
||||
<span class="hljs-comment">// privkey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> pubkey = privkey.publicKey
|
||||
<span class="hljs-comment">// pubkey: org.bitcoins.crypto.ECPublicKey = ECPublicKey(03b9f14792e899ba0003d98bfb229be21b85cf808cfe9f8835d47a3d13642c9d91)</span>
|
||||
<span class="hljs-comment">// pubkey: org.bitcoins.crypto.ECPublicKey = ECPublicKey(03bbc4d29b4a1bd17ef7d8afb5686547b94fcf8109d7ba51e5da6d207435f7b487)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> segwitAddress = {
|
||||
<span class="hljs-comment">// see https://bitcoin.org/en/glossary/pubkey-script</span>
|
||||
|
|
@ -89,10 +89,10 @@ reason to keep using legacy transaction formats.</p>
|
|||
<span class="hljs-keyword">val</span> scriptPubKey = <span class="hljs-type">P2WPKHWitnessSPKV0</span>(pubkey)
|
||||
<span class="hljs-type">Bech32Address</span>(scriptPubKey, <span class="hljs-type">TestNet3</span>)
|
||||
}
|
||||
<span class="hljs-comment">// segwitAddress: Bech32Address = tb1q0wfufw50xg6w32m52nq8jg0u3yhmzru54p3mfk</span>
|
||||
<span class="hljs-comment">// segwitAddress: Bech32Address = tb1qaauw5jr5ydd97zqeymzqky7h4r8ns40dwe9g07</span>
|
||||
|
||||
println(segwitAddress.toString)
|
||||
<span class="hljs-comment">// tb1q0wfufw50xg6w32m52nq8jg0u3yhmzru54p3mfk</span>
|
||||
<span class="hljs-comment">// tb1qaauw5jr5ydd97zqeymzqky7h4r8ns40dwe9g07</span>
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="generating-legacy-base58-addresses"></a><a href="#generating-legacy-base58-addresses" 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>Generating legacy (base58) addresses</h2>
|
||||
<p>If you need to generate legacy addresses for backwards
|
||||
|
|
@ -101,10 +101,10 @@ Take a look:</p>
|
|||
<pre><code class="hljs css language-scala"><span class="hljs-comment">// we're reusing the same private/public key pair</span>
|
||||
<span class="hljs-comment">// from before. don't do this in an actual application!</span>
|
||||
<span class="hljs-keyword">val</span> legacyAddress = <span class="hljs-type">P2PKHAddress</span>(pubkey, <span class="hljs-type">TestNet3</span>)
|
||||
<span class="hljs-comment">// legacyAddress: P2PKHAddress = mrnNRnLpJbhRMwZ4VVQt9LoeCjZvVFv64c</span>
|
||||
<span class="hljs-comment">// legacyAddress: P2PKHAddress = n3MAeEZdHgYSEFEb4fStrSf4whW8Nyo6g7</span>
|
||||
|
||||
println(legacyAddress.toString)
|
||||
<span class="hljs-comment">// mrnNRnLpJbhRMwZ4VVQt9LoeCjZvVFv64c</span>
|
||||
<span class="hljs-comment">// n3MAeEZdHgYSEFEb4fStrSf4whW8Nyo6g7</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/next/core/core-intro"><span class="arrow-prev">← </span><span>Core Module</span></a><a class="docs-next button" href="/docs/next/core/hd-keys"><span>HD Key Generation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#generating-segwit-bech32-addresses">Generating SegWit (bech32) addresses</a></li><li><a href="#generating-legacy-base58-addresses">Generating legacy (base58) addresses</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/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) {
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
|
|
@ -86,13 +86,13 @@ use that to generate further private and public keys:</p>
|
|||
<span class="hljs-comment">// how long our phrase ends up being</span>
|
||||
<span class="hljs-comment">// 256 bits of entropy results in 24 words</span>
|
||||
<span class="hljs-keyword">val</span> entropy: <span class="hljs-type">BitVector</span> = <span class="hljs-type">MnemonicCode</span>.getEntropy256Bits
|
||||
<span class="hljs-comment">// entropy: BitVector = BitVector(256 bits, 0x25acc0d79ae6d2f1aa2016279372378372679910cd7397e6468a341ad7c619a4)</span>
|
||||
<span class="hljs-comment">// entropy: BitVector = BitVector(256 bits, 0x22ac8525217b24e326e5dc4a9c988967d181dce99adc7f73e9ce40cb49012669)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mnemonicCode = <span class="hljs-type">MnemonicCode</span>.fromEntropy(entropy)
|
||||
<span class="hljs-comment">// mnemonicCode: MnemonicCode = Masked(MnemonicCodeImpl)</span>
|
||||
|
||||
mnemonicCode.words <span class="hljs-comment">// the phrase the user should write down</span>
|
||||
<span class="hljs-comment">// res0: Vector[String] = Vector(certain, gravity, curious, cupboard, honey, juice, possible, actress, chest, oppose, mistake, alone, chapter, smart, drip, purpose, obey, cram, penalty, habit, pulp, toast, grief, margin) // the phrase the user should write down</span>
|
||||
<span class="hljs-comment">// res0: Vector[String] = Vector(cargo, goddess, enable, drill, rather, immense, oppose, romance, enhance, tooth, car, soul, blossom, unveil, please, fortune, legal, palm, inform, light, region, letter, often, crush) // the phrase the user should write down</span>
|
||||
|
||||
<span class="hljs-comment">// the password argument is an optional, extra security</span>
|
||||
<span class="hljs-comment">// measure. all MnemonicCode instances will give you a</span>
|
||||
|
|
@ -108,7 +108,7 @@ mnemonicCode.words <span class="hljs-comment">// the phrase the user should writ
|
|||
bip39Seed)
|
||||
<span class="hljs-comment">// xpriv: ExtPrivateKey = Masked(ExtPrivateKeyImpl)</span>
|
||||
<span class="hljs-keyword">val</span> xpub = xpriv.extPublicKey
|
||||
<span class="hljs-comment">// xpub: ExtPublicKey = zpub6jftahH18ngZwQc4TJuqYoZndAvSdUhWrrRjyQvHP64atR3sMVFy6HoKq7DLT9jP9PDiNjHWvNVUXxu2r8g9WD9ZbsrNZFTFbgwYRhB8fMr</span>
|
||||
<span class="hljs-comment">// xpub: ExtPublicKey = zpub6jftahH18ngZxShnqBDVeCRqNYJ8xCyqXWgDPUYeyscYMmCtptdGrsLDf7K3VB9DFLZ3HtV3UZNCWqgdCEqktmMkeC3BtWCMDCpBKBBgeSD</span>
|
||||
|
||||
<span class="hljs-comment">// you can now use the generated xpriv to derive further</span>
|
||||
<span class="hljs-comment">// private or public keys</span>
|
||||
|
|
@ -154,7 +154,7 @@ spend or steal any of your money.</p>
|
|||
<span class="hljs-comment">// can generate addresses with it!</span>
|
||||
accountXpriv.extPublicKey
|
||||
}
|
||||
<span class="hljs-comment">// accountXpub: ExtPublicKey = zpub6qNayQnjuQXEyxNBGUv78cBJFzhCDzbwBxpphSmmKfQEhNjaCc8wTaHcbdt4PmyGXhQ4w9PLNVNwyTiGg252AAJfV7EZAnpoGHUYARGD8ge</span>
|
||||
<span class="hljs-comment">// accountXpub: ExtPublicKey = zpub6rd9sqtyz4872dtaNEgeGiBGBnGRBaW5E6emoh5Ui5S2BT4QFQY9Qf4FvtihjZjaFFcUwCLBXyDqewkBq4bJDn5u26yHchp6J2MducQYZDR</span>
|
||||
|
||||
<span class="hljs-comment">// address no. 0 ---------------┐</span>
|
||||
<span class="hljs-comment">// external address ----------┐ |</span>
|
||||
|
|
@ -177,12 +177,12 @@ spend or steal any of your money.</p>
|
|||
<span class="hljs-keyword">val</span> scriptPubKey = <span class="hljs-type">P2WPKHWitnessSPKV0</span>(pubkey)
|
||||
<span class="hljs-type">Bech32Address</span>(scriptPubKey, <span class="hljs-type">TestNet3</span>)
|
||||
}
|
||||
<span class="hljs-comment">// firstAccountAddress: Bech32Address = tb1qzhcc4vr0amg6q5d4d8dvprv5n4v4lvxgxh0vgx</span>
|
||||
<span class="hljs-comment">// firstAccountAddress: Bech32Address = tb1qyfehua94r7qpvn24vvlkedwwpr557jz75fxlsl</span>
|
||||
|
||||
<span class="hljs-comment">// tada! We just generated an address you can send money to,</span>
|
||||
<span class="hljs-comment">// without having access to the private key!</span>
|
||||
firstAccountAddress.value
|
||||
<span class="hljs-comment">// res2: String = tb1qzhcc4vr0amg6q5d4d8dvprv5n4v4lvxgxh0vgx</span>
|
||||
<span class="hljs-comment">// res2: String = tb1qyfehua94r7qpvn24vvlkedwwpr557jz75fxlsl</span>
|
||||
|
||||
<span class="hljs-comment">// you can now continue deriving addresses from the same public</span>
|
||||
<span class="hljs-comment">// key, by imitating what we did above. To get the next</span>
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@ use that to generate further private and public keys:</p>
|
|||
<span class="hljs-comment">// how long our phrase ends up being</span>
|
||||
<span class="hljs-comment">// 256 bits of entropy results in 24 words</span>
|
||||
<span class="hljs-keyword">val</span> entropy: <span class="hljs-type">BitVector</span> = <span class="hljs-type">MnemonicCode</span>.getEntropy256Bits
|
||||
<span class="hljs-comment">// entropy: BitVector = BitVector(256 bits, 0x25acc0d79ae6d2f1aa2016279372378372679910cd7397e6468a341ad7c619a4)</span>
|
||||
<span class="hljs-comment">// entropy: BitVector = BitVector(256 bits, 0x22ac8525217b24e326e5dc4a9c988967d181dce99adc7f73e9ce40cb49012669)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mnemonicCode = <span class="hljs-type">MnemonicCode</span>.fromEntropy(entropy)
|
||||
<span class="hljs-comment">// mnemonicCode: MnemonicCode = Masked(MnemonicCodeImpl)</span>
|
||||
|
||||
mnemonicCode.words <span class="hljs-comment">// the phrase the user should write down</span>
|
||||
<span class="hljs-comment">// res0: Vector[String] = Vector(certain, gravity, curious, cupboard, honey, juice, possible, actress, chest, oppose, mistake, alone, chapter, smart, drip, purpose, obey, cram, penalty, habit, pulp, toast, grief, margin) // the phrase the user should write down</span>
|
||||
<span class="hljs-comment">// res0: Vector[String] = Vector(cargo, goddess, enable, drill, rather, immense, oppose, romance, enhance, tooth, car, soul, blossom, unveil, please, fortune, legal, palm, inform, light, region, letter, often, crush) // the phrase the user should write down</span>
|
||||
|
||||
<span class="hljs-comment">// the password argument is an optional, extra security</span>
|
||||
<span class="hljs-comment">// measure. all MnemonicCode instances will give you a</span>
|
||||
|
|
@ -108,7 +108,7 @@ mnemonicCode.words <span class="hljs-comment">// the phrase the user should writ
|
|||
bip39Seed)
|
||||
<span class="hljs-comment">// xpriv: ExtPrivateKey = Masked(ExtPrivateKeyImpl)</span>
|
||||
<span class="hljs-keyword">val</span> xpub = xpriv.extPublicKey
|
||||
<span class="hljs-comment">// xpub: ExtPublicKey = zpub6jftahH18ngZwQc4TJuqYoZndAvSdUhWrrRjyQvHP64atR3sMVFy6HoKq7DLT9jP9PDiNjHWvNVUXxu2r8g9WD9ZbsrNZFTFbgwYRhB8fMr</span>
|
||||
<span class="hljs-comment">// xpub: ExtPublicKey = zpub6jftahH18ngZxShnqBDVeCRqNYJ8xCyqXWgDPUYeyscYMmCtptdGrsLDf7K3VB9DFLZ3HtV3UZNCWqgdCEqktmMkeC3BtWCMDCpBKBBgeSD</span>
|
||||
|
||||
<span class="hljs-comment">// you can now use the generated xpriv to derive further</span>
|
||||
<span class="hljs-comment">// private or public keys</span>
|
||||
|
|
@ -154,7 +154,7 @@ spend or steal any of your money.</p>
|
|||
<span class="hljs-comment">// can generate addresses with it!</span>
|
||||
accountXpriv.extPublicKey
|
||||
}
|
||||
<span class="hljs-comment">// accountXpub: ExtPublicKey = zpub6qNayQnjuQXEyxNBGUv78cBJFzhCDzbwBxpphSmmKfQEhNjaCc8wTaHcbdt4PmyGXhQ4w9PLNVNwyTiGg252AAJfV7EZAnpoGHUYARGD8ge</span>
|
||||
<span class="hljs-comment">// accountXpub: ExtPublicKey = zpub6rd9sqtyz4872dtaNEgeGiBGBnGRBaW5E6emoh5Ui5S2BT4QFQY9Qf4FvtihjZjaFFcUwCLBXyDqewkBq4bJDn5u26yHchp6J2MducQYZDR</span>
|
||||
|
||||
<span class="hljs-comment">// address no. 0 ---------------┐</span>
|
||||
<span class="hljs-comment">// external address ----------┐ |</span>
|
||||
|
|
@ -177,12 +177,12 @@ spend or steal any of your money.</p>
|
|||
<span class="hljs-keyword">val</span> scriptPubKey = <span class="hljs-type">P2WPKHWitnessSPKV0</span>(pubkey)
|
||||
<span class="hljs-type">Bech32Address</span>(scriptPubKey, <span class="hljs-type">TestNet3</span>)
|
||||
}
|
||||
<span class="hljs-comment">// firstAccountAddress: Bech32Address = tb1qzhcc4vr0amg6q5d4d8dvprv5n4v4lvxgxh0vgx</span>
|
||||
<span class="hljs-comment">// firstAccountAddress: Bech32Address = tb1qyfehua94r7qpvn24vvlkedwwpr557jz75fxlsl</span>
|
||||
|
||||
<span class="hljs-comment">// tada! We just generated an address you can send money to,</span>
|
||||
<span class="hljs-comment">// without having access to the private key!</span>
|
||||
firstAccountAddress.value
|
||||
<span class="hljs-comment">// res2: String = tb1qzhcc4vr0amg6q5d4d8dvprv5n4v4lvxgxh0vgx</span>
|
||||
<span class="hljs-comment">// res2: String = tb1qyfehua94r7qpvn24vvlkedwwpr557jz75fxlsl</span>
|
||||
|
||||
<span class="hljs-comment">// you can now continue deriving addresses from the same public</span>
|
||||
<span class="hljs-comment">// key, by imitating what we did above. To get the next</span>
|
||||
|
|
|
|||
|
|
@ -64,7 +64,7 @@
|
|||
});
|
||||
</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/core/txbuilder.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">TxBuilder Example</h1></header><article><div><span><p>Bitcoin-S features a transaction building API that allows you to construct and sign Bitcoin transactions. Here's an example of how to use it</p>
|
||||
<pre><code class="hljs css language-scala"><span class="hljs-keyword">implicit</span> <span class="hljs-keyword">val</span> ec: <span class="hljs-type">ExecutionContext</span> = <span class="hljs-type">ExecutionContext</span>.<span class="hljs-type">Implicits</span>.global
|
||||
<span class="hljs-comment">// ec: ExecutionContext = scala.concurrent.impl.ExecutionContextImpl$$anon$3@42bff32b[Running, parallelism = 2, size = 0, active = 0, running = 0, steals = 0, tasks = 0, submissions = 0]</span>
|
||||
<span class="hljs-comment">// ec: ExecutionContext = scala.concurrent.impl.ExecutionContextImpl$$anon$3@541a6465[Running, parallelism = 2, size = 0, active = 0, running = 0, steals = 0, tasks = 0, submissions = 0]</span>
|
||||
|
||||
<span class="hljs-comment">// Initialize a transaction builder</span>
|
||||
<span class="hljs-keyword">val</span> builder = <span class="hljs-type">RawTxBuilder</span>()
|
||||
|
|
@ -74,19 +74,19 @@
|
|||
<span class="hljs-keyword">val</span> privKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
<span class="hljs-comment">// privKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> pubKey = privKey.publicKey
|
||||
<span class="hljs-comment">// pubKey: ECPublicKey = ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)</span>
|
||||
<span class="hljs-comment">// pubKey: ECPublicKey = ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)</span>
|
||||
|
||||
<span class="hljs-comment">// this is the script that the TxBuilder is going to create a</span>
|
||||
<span class="hljs-comment">// script signature that validly spends this scriptPubKey</span>
|
||||
<span class="hljs-keyword">val</span> creditingSpk = <span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = privKey.publicKey)
|
||||
<span class="hljs-comment">// creditingSpk: P2PKHScriptPubKey = pkh(716ccebd578a159c818b8e150aa20257ff71204e)</span>
|
||||
<span class="hljs-comment">// creditingSpk: P2PKHScriptPubKey = pkh(3e8632fa557076048db09e4aaabebe4f8788497a)</span>
|
||||
<span class="hljs-keyword">val</span> amount = <span class="hljs-number">10000.</span>satoshis
|
||||
<span class="hljs-comment">// amount: Satoshis = 10000 sats</span>
|
||||
|
||||
<span class="hljs-comment">// this is the UTXO we are going to be spending</span>
|
||||
<span class="hljs-keyword">val</span> utxo =
|
||||
<span class="hljs-type">TransactionOutput</span>(value = amount, scriptPubKey = creditingSpk)
|
||||
<span class="hljs-comment">// utxo: TransactionOutput = TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))</span>
|
||||
<span class="hljs-comment">// utxo: TransactionOutput = TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))</span>
|
||||
|
||||
<span class="hljs-comment">// the private key that locks the funds for the script we are spending too</span>
|
||||
<span class="hljs-keyword">val</span> destinationPrivKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
|
|
@ -99,7 +99,7 @@
|
|||
<span class="hljs-comment">// the script that corresponds to destination private key, this is what is receiving the money</span>
|
||||
<span class="hljs-keyword">val</span> destinationSPK =
|
||||
<span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = destinationPrivKey.publicKey)
|
||||
<span class="hljs-comment">// destinationSPK: P2PKHScriptPubKey = pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)</span>
|
||||
<span class="hljs-comment">// destinationSPK: P2PKHScriptPubKey = pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)</span>
|
||||
|
||||
<span class="hljs-comment">// this is where we are sending money too</span>
|
||||
<span class="hljs-comment">// we could add more destinations here if we</span>
|
||||
|
|
@ -110,7 +110,7 @@
|
|||
|
||||
<span class="hljs-type">Vector</span>(destination0)
|
||||
}
|
||||
<span class="hljs-comment">// destinations: Vector[TransactionOutput] = Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)))</span>
|
||||
<span class="hljs-comment">// destinations: Vector[TransactionOutput] = Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)))</span>
|
||||
|
||||
<span class="hljs-comment">// Add the destinations to the tx builder</span>
|
||||
builder ++= destinations
|
||||
|
|
@ -123,17 +123,17 @@ builder ++= destinations
|
|||
inputs = <span class="hljs-type">Vector</span>.empty,
|
||||
outputs = <span class="hljs-type">Vector</span>(utxo),
|
||||
lockTime = <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// creditingTx: BaseTransaction = BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// creditingTx: BaseTransaction = BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// this is the information we need from the crediting TX</span>
|
||||
<span class="hljs-comment">// to properly "link" it in the transaction we are creating</span>
|
||||
<span class="hljs-keyword">val</span> outPoint = <span class="hljs-type">TransactionOutPoint</span>(creditingTx.txId, <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// outPoint: TransactionOutPoint = TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0)</span>
|
||||
<span class="hljs-comment">// outPoint: TransactionOutPoint = TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0)</span>
|
||||
<span class="hljs-keyword">val</span> input = <span class="hljs-type">TransactionInput</span>(
|
||||
outPoint,
|
||||
<span class="hljs-type">EmptyScriptSignature</span>,
|
||||
sequenceNumber = <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// input: TransactionInput = TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// input: TransactionInput = TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// Add a new input to our builder</span>
|
||||
builder += input
|
||||
|
|
@ -141,11 +141,11 @@ builder += input
|
|||
|
||||
<span class="hljs-comment">// We can now generate a RawTxBuilderResult ready to be finalized</span>
|
||||
<span class="hljs-keyword">val</span> builderResult = builder.result()
|
||||
<span class="hljs-comment">// builderResult: RawTxBuilderResult = RawTxBuilderResult(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// builderResult: RawTxBuilderResult = RawTxBuilderResult(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// this contains the information needed to analyze our input during finalization</span>
|
||||
<span class="hljs-keyword">val</span> inputInfo = <span class="hljs-type">P2PKHInputInfo</span>(outPoint, amount, privKey.publicKey)
|
||||
<span class="hljs-comment">// inputInfo: P2PKHInputInfo = P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1))</span>
|
||||
<span class="hljs-comment">// inputInfo: P2PKHInputInfo = P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864))</span>
|
||||
|
||||
<span class="hljs-comment">// this is how much we are going to pay as a fee to the network</span>
|
||||
<span class="hljs-comment">// for this example, we are going to pay 1 satoshi per byte</span>
|
||||
|
|
@ -155,18 +155,18 @@ builder += input
|
|||
<span class="hljs-keyword">val</span> changePrivKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
<span class="hljs-comment">// changePrivKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> changeSPK = <span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = changePrivKey.publicKey)
|
||||
<span class="hljs-comment">// changeSPK: P2PKHScriptPubKey = pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333)</span>
|
||||
<span class="hljs-comment">// changeSPK: P2PKHScriptPubKey = pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049)</span>
|
||||
|
||||
<span class="hljs-comment">// We chose a finalizer that adds a change output to our tx based on a fee rate</span>
|
||||
<span class="hljs-keyword">val</span> finalizer = <span class="hljs-type">StandardNonInteractiveFinalizer</span>(
|
||||
<span class="hljs-type">Vector</span>(inputInfo),
|
||||
feeRate,
|
||||
changeSPK)
|
||||
<span class="hljs-comment">// finalizer: StandardNonInteractiveFinalizer = StandardNonInteractiveFinalizer(Vector(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1))),1 sats/byte,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))</span>
|
||||
<span class="hljs-comment">// finalizer: StandardNonInteractiveFinalizer = StandardNonInteractiveFinalizer(Vector(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864))),1 sats/byte,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))</span>
|
||||
|
||||
<span class="hljs-comment">// We can now finalize the tx builder result from earlier with this finalizer</span>
|
||||
<span class="hljs-keyword">val</span> unsignedTx: <span class="hljs-type">Transaction</span> = finalizer.buildTx(builderResult)
|
||||
<span class="hljs-comment">// unsignedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)), TransactionOutput(4775 sats,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// unsignedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)), TransactionOutput(4775 sats,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// We now turn to signing the unsigned transaction</span>
|
||||
<span class="hljs-comment">// this contains all the information we need to</span>
|
||||
|
|
@ -176,12 +176,12 @@ builder += input
|
|||
signers = <span class="hljs-type">Vector</span>(privKey),
|
||||
hashType =
|
||||
<span class="hljs-type">HashType</span>.sigHashAll)
|
||||
<span class="hljs-comment">// utxoInfo: ScriptSignatureParams[P2PKHInputInfo] = ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1)))</span>
|
||||
<span class="hljs-comment">// utxoInfo: ScriptSignatureParams[P2PKHInputInfo] = ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1)))</span>
|
||||
|
||||
<span class="hljs-comment">// all of the UTXO spending information, since we only have</span>
|
||||
<span class="hljs-comment">// one input, this is just one element</span>
|
||||
<span class="hljs-keyword">val</span> utxoInfos: <span class="hljs-type">Vector</span>[<span class="hljs-type">ScriptSignatureParams</span>[<span class="hljs-type">InputInfo</span>]] = <span class="hljs-type">Vector</span>(utxoInfo)
|
||||
<span class="hljs-comment">// utxoInfos: Vector[ScriptSignatureParams[InputInfo]] = Vector(ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1))))</span>
|
||||
<span class="hljs-comment">// utxoInfos: Vector[ScriptSignatureParams[InputInfo]] = Vector(ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1))))</span>
|
||||
|
||||
<span class="hljs-comment">// Yay! Now we use the RawTxSigner object to sign the tx.</span>
|
||||
<span class="hljs-comment">// The 'sign' method is going produce a validly signed transaction</span>
|
||||
|
|
@ -197,7 +197,7 @@ builder += input
|
|||
utxoInfos = utxoInfos,
|
||||
expectedFeeRate = feeRate
|
||||
)
|
||||
<span class="hljs-comment">// signedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),P2PKHScriptSignature(ECPublicKeyBytes(ByteVector(33 bytes, 0x035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)), ECDigitalSignature(304402206a7441ac82758d61e19490bc7cbc8c76f9482fe06bf6c0f69aa5968e3cfbd3900220113e3f6b1786f5721544596aa3821ab7980eda243bfc70f60b8e483ec337c95801)),UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)), TransactionOutput(4775 sats,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// signedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),P2PKHScriptSignature(ECPublicKeyBytes(ByteVector(33 bytes, 0x025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)), ECDigitalSignature(30440220498e1d29ab857ec1cf121a5394742dce359ee17be723880db248482adcad1b7702201f8c6754025e44326e43c0a0da6a16564de09c504ac976e725b0a3a74508ce3401)),UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)), TransactionOutput(4775 sats,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))),UInt32Impl(0))</span>
|
||||
</code></pre>
|
||||
<pre><code class="hljs css language-scala">signedTx.inputs.length
|
||||
<span class="hljs-comment">// res2: Int = 1</span>
|
||||
|
|
@ -207,7 +207,7 @@ signedTx.outputs.length
|
|||
|
||||
<span class="hljs-comment">//remember, you can call .hex on any bitcoin-s data structure to get the hex representation!</span>
|
||||
signedTx.hex
|
||||
<span class="hljs-comment">// res4: String = 02000000012e3e9b0efe03bcf1da57a450b71c9c2372b13e5d3d1f26a7ce112cedd71ecb8b000000006a47304402206a7441ac82758d61e19490bc7cbc8c76f9482fe06bf6c0f69aa5968e3cfbd3900220113e3f6b1786f5721544596aa3821ab7980eda243bfc70f60b8e483ec337c9580121035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1000000000288130000000000001976a914c8deb6f5f60496340801911843f5ce80a1b1da4b88aca7120000000000001976a914785bfbb5b7b525d040e634fd7e7e23c38faad33388ac00000000</span>
|
||||
<span class="hljs-comment">// res4: String = 020000000191063aa5983bf91e597ee03247bdd140830dbf0f893e9cdd9be91fb6bfa8ca2e000000006a4730440220498e1d29ab857ec1cf121a5394742dce359ee17be723880db248482adcad1b7702201f8c6754025e44326e43c0a0da6a16564de09c504ac976e725b0a3a74508ce340121025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864000000000288130000000000001976a91493efa2f3e1146f563107b1823722a17a36dce5ea88aca7120000000000001976a914a54c0e5b22b512d016077758a4b0b2e5ec1c404988ac00000000</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/next/core/dlc"><span class="arrow-prev">← </span><span>Discreet Log Contract Data Structures</span></a><a class="docs-next button" href="/docs/next/core/lightning-network"><span>Lightning Network Data Types</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"></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) {
|
||||
|
|
|
|||
|
|
@ -64,7 +64,7 @@
|
|||
});
|
||||
</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/core/txbuilder.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">TxBuilder Example</h1></header><article><div><span><p>Bitcoin-S features a transaction building API that allows you to construct and sign Bitcoin transactions. Here's an example of how to use it</p>
|
||||
<pre><code class="hljs css language-scala"><span class="hljs-keyword">implicit</span> <span class="hljs-keyword">val</span> ec: <span class="hljs-type">ExecutionContext</span> = <span class="hljs-type">ExecutionContext</span>.<span class="hljs-type">Implicits</span>.global
|
||||
<span class="hljs-comment">// ec: ExecutionContext = scala.concurrent.impl.ExecutionContextImpl$$anon$3@42bff32b[Running, parallelism = 2, size = 0, active = 0, running = 0, steals = 0, tasks = 0, submissions = 0]</span>
|
||||
<span class="hljs-comment">// ec: ExecutionContext = scala.concurrent.impl.ExecutionContextImpl$$anon$3@541a6465[Running, parallelism = 2, size = 0, active = 0, running = 0, steals = 0, tasks = 0, submissions = 0]</span>
|
||||
|
||||
<span class="hljs-comment">// Initialize a transaction builder</span>
|
||||
<span class="hljs-keyword">val</span> builder = <span class="hljs-type">RawTxBuilder</span>()
|
||||
|
|
@ -74,19 +74,19 @@
|
|||
<span class="hljs-keyword">val</span> privKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
<span class="hljs-comment">// privKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> pubKey = privKey.publicKey
|
||||
<span class="hljs-comment">// pubKey: ECPublicKey = ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)</span>
|
||||
<span class="hljs-comment">// pubKey: ECPublicKey = ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)</span>
|
||||
|
||||
<span class="hljs-comment">// this is the script that the TxBuilder is going to create a</span>
|
||||
<span class="hljs-comment">// script signature that validly spends this scriptPubKey</span>
|
||||
<span class="hljs-keyword">val</span> creditingSpk = <span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = privKey.publicKey)
|
||||
<span class="hljs-comment">// creditingSpk: P2PKHScriptPubKey = pkh(716ccebd578a159c818b8e150aa20257ff71204e)</span>
|
||||
<span class="hljs-comment">// creditingSpk: P2PKHScriptPubKey = pkh(3e8632fa557076048db09e4aaabebe4f8788497a)</span>
|
||||
<span class="hljs-keyword">val</span> amount = <span class="hljs-number">10000.</span>satoshis
|
||||
<span class="hljs-comment">// amount: Satoshis = 10000 sats</span>
|
||||
|
||||
<span class="hljs-comment">// this is the UTXO we are going to be spending</span>
|
||||
<span class="hljs-keyword">val</span> utxo =
|
||||
<span class="hljs-type">TransactionOutput</span>(value = amount, scriptPubKey = creditingSpk)
|
||||
<span class="hljs-comment">// utxo: TransactionOutput = TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))</span>
|
||||
<span class="hljs-comment">// utxo: TransactionOutput = TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))</span>
|
||||
|
||||
<span class="hljs-comment">// the private key that locks the funds for the script we are spending too</span>
|
||||
<span class="hljs-keyword">val</span> destinationPrivKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
|
|
@ -99,7 +99,7 @@
|
|||
<span class="hljs-comment">// the script that corresponds to destination private key, this is what is receiving the money</span>
|
||||
<span class="hljs-keyword">val</span> destinationSPK =
|
||||
<span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = destinationPrivKey.publicKey)
|
||||
<span class="hljs-comment">// destinationSPK: P2PKHScriptPubKey = pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)</span>
|
||||
<span class="hljs-comment">// destinationSPK: P2PKHScriptPubKey = pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)</span>
|
||||
|
||||
<span class="hljs-comment">// this is where we are sending money too</span>
|
||||
<span class="hljs-comment">// we could add more destinations here if we</span>
|
||||
|
|
@ -110,7 +110,7 @@
|
|||
|
||||
<span class="hljs-type">Vector</span>(destination0)
|
||||
}
|
||||
<span class="hljs-comment">// destinations: Vector[TransactionOutput] = Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)))</span>
|
||||
<span class="hljs-comment">// destinations: Vector[TransactionOutput] = Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)))</span>
|
||||
|
||||
<span class="hljs-comment">// Add the destinations to the tx builder</span>
|
||||
builder ++= destinations
|
||||
|
|
@ -123,17 +123,17 @@ builder ++= destinations
|
|||
inputs = <span class="hljs-type">Vector</span>.empty,
|
||||
outputs = <span class="hljs-type">Vector</span>(utxo),
|
||||
lockTime = <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// creditingTx: BaseTransaction = BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// creditingTx: BaseTransaction = BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// this is the information we need from the crediting TX</span>
|
||||
<span class="hljs-comment">// to properly "link" it in the transaction we are creating</span>
|
||||
<span class="hljs-keyword">val</span> outPoint = <span class="hljs-type">TransactionOutPoint</span>(creditingTx.txId, <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// outPoint: TransactionOutPoint = TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0)</span>
|
||||
<span class="hljs-comment">// outPoint: TransactionOutPoint = TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0)</span>
|
||||
<span class="hljs-keyword">val</span> input = <span class="hljs-type">TransactionInput</span>(
|
||||
outPoint,
|
||||
<span class="hljs-type">EmptyScriptSignature</span>,
|
||||
sequenceNumber = <span class="hljs-type">UInt32</span>.zero)
|
||||
<span class="hljs-comment">// input: TransactionInput = TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// input: TransactionInput = TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// Add a new input to our builder</span>
|
||||
builder += input
|
||||
|
|
@ -141,11 +141,11 @@ builder += input
|
|||
|
||||
<span class="hljs-comment">// We can now generate a RawTxBuilderResult ready to be finalized</span>
|
||||
<span class="hljs-keyword">val</span> builderResult = builder.result()
|
||||
<span class="hljs-comment">// builderResult: RawTxBuilderResult = RawTxBuilderResult(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// builderResult: RawTxBuilderResult = RawTxBuilderResult(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// this contains the information needed to analyze our input during finalization</span>
|
||||
<span class="hljs-keyword">val</span> inputInfo = <span class="hljs-type">P2PKHInputInfo</span>(outPoint, amount, privKey.publicKey)
|
||||
<span class="hljs-comment">// inputInfo: P2PKHInputInfo = P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1))</span>
|
||||
<span class="hljs-comment">// inputInfo: P2PKHInputInfo = P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864))</span>
|
||||
|
||||
<span class="hljs-comment">// this is how much we are going to pay as a fee to the network</span>
|
||||
<span class="hljs-comment">// for this example, we are going to pay 1 satoshi per byte</span>
|
||||
|
|
@ -155,18 +155,18 @@ builder += input
|
|||
<span class="hljs-keyword">val</span> changePrivKey = <span class="hljs-type">ECPrivateKey</span>.freshPrivateKey
|
||||
<span class="hljs-comment">// changePrivKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-keyword">val</span> changeSPK = <span class="hljs-type">P2PKHScriptPubKey</span>(pubKey = changePrivKey.publicKey)
|
||||
<span class="hljs-comment">// changeSPK: P2PKHScriptPubKey = pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333)</span>
|
||||
<span class="hljs-comment">// changeSPK: P2PKHScriptPubKey = pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049)</span>
|
||||
|
||||
<span class="hljs-comment">// We chose a finalizer that adds a change output to our tx based on a fee rate</span>
|
||||
<span class="hljs-keyword">val</span> finalizer = <span class="hljs-type">StandardNonInteractiveFinalizer</span>(
|
||||
<span class="hljs-type">Vector</span>(inputInfo),
|
||||
feeRate,
|
||||
changeSPK)
|
||||
<span class="hljs-comment">// finalizer: StandardNonInteractiveFinalizer = StandardNonInteractiveFinalizer(Vector(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1))),1 sats/byte,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))</span>
|
||||
<span class="hljs-comment">// finalizer: StandardNonInteractiveFinalizer = StandardNonInteractiveFinalizer(Vector(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864))),1 sats/byte,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))</span>
|
||||
|
||||
<span class="hljs-comment">// We can now finalize the tx builder result from earlier with this finalizer</span>
|
||||
<span class="hljs-keyword">val</span> unsignedTx: <span class="hljs-type">Transaction</span> = finalizer.buildTx(builderResult)
|
||||
<span class="hljs-comment">// unsignedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)), TransactionOutput(4775 sats,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// unsignedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),EmptyScriptSignature,UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)), TransactionOutput(4775 sats,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))),UInt32Impl(0))</span>
|
||||
|
||||
<span class="hljs-comment">// We now turn to signing the unsigned transaction</span>
|
||||
<span class="hljs-comment">// this contains all the information we need to</span>
|
||||
|
|
@ -176,12 +176,12 @@ builder += input
|
|||
signers = <span class="hljs-type">Vector</span>(privKey),
|
||||
hashType =
|
||||
<span class="hljs-type">HashType</span>.sigHashAll)
|
||||
<span class="hljs-comment">// utxoInfo: ScriptSignatureParams[P2PKHInputInfo] = ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1)))</span>
|
||||
<span class="hljs-comment">// utxoInfo: ScriptSignatureParams[P2PKHInputInfo] = ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1)))</span>
|
||||
|
||||
<span class="hljs-comment">// all of the UTXO spending information, since we only have</span>
|
||||
<span class="hljs-comment">// one input, this is just one element</span>
|
||||
<span class="hljs-keyword">val</span> utxoInfos: <span class="hljs-type">Vector</span>[<span class="hljs-type">ScriptSignatureParams</span>[<span class="hljs-type">InputInfo</span>]] = <span class="hljs-type">Vector</span>(utxoInfo)
|
||||
<span class="hljs-comment">// utxoInfos: Vector[ScriptSignatureParams[InputInfo]] = Vector(ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),10000 sats,ECPublicKey(035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(716ccebd578a159c818b8e150aa20257ff71204e))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1))))</span>
|
||||
<span class="hljs-comment">// utxoInfos: Vector[ScriptSignatureParams[InputInfo]] = Vector(ScriptSignatureParams(P2PKHInputInfo(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),10000 sats,ECPublicKey(025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)),BaseTransaction(Int32Impl(1),Vector(),Vector(TransactionOutput(10000 sats,pkh(3e8632fa557076048db09e4aaabebe4f8788497a))),UInt32Impl(0)),Vector(Masked(ECPrivateKey)),SIGHASH_ALL(Int32Impl(1))))</span>
|
||||
|
||||
<span class="hljs-comment">// Yay! Now we use the RawTxSigner object to sign the tx.</span>
|
||||
<span class="hljs-comment">// The 'sign' method is going produce a validly signed transaction</span>
|
||||
|
|
@ -197,7 +197,7 @@ builder += input
|
|||
utxoInfos = utxoInfos,
|
||||
expectedFeeRate = feeRate
|
||||
)
|
||||
<span class="hljs-comment">// signedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(8bcb1ed7ed2c11cea7261f3d5d3eb172239c1cb750a457daf1bc03fe0e9b3e2e:0),P2PKHScriptSignature(ECPublicKeyBytes(ByteVector(33 bytes, 0x035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1)), ECDigitalSignature(304402206a7441ac82758d61e19490bc7cbc8c76f9482fe06bf6c0f69aa5968e3cfbd3900220113e3f6b1786f5721544596aa3821ab7980eda243bfc70f60b8e483ec337c95801)),UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(c8deb6f5f60496340801911843f5ce80a1b1da4b)), TransactionOutput(4775 sats,pkh(785bfbb5b7b525d040e634fd7e7e23c38faad333))),UInt32Impl(0))</span>
|
||||
<span class="hljs-comment">// signedTx: Transaction = BaseTransaction(Int32Impl(2),Vector(TransactionInputImpl(TransactionOutPoint(2ecaa8bfb61fe99bdd9c3e890fbf0d8340d1bd4732e07e591ef93b98a53a0691:0),P2PKHScriptSignature(ECPublicKeyBytes(ByteVector(33 bytes, 0x025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864)), ECDigitalSignature(30440220498e1d29ab857ec1cf121a5394742dce359ee17be723880db248482adcad1b7702201f8c6754025e44326e43c0a0da6a16564de09c504ac976e725b0a3a74508ce3401)),UInt32Impl(0))),Vector(TransactionOutput(5000 sats,pkh(93efa2f3e1146f563107b1823722a17a36dce5ea)), TransactionOutput(4775 sats,pkh(a54c0e5b22b512d016077758a4b0b2e5ec1c4049))),UInt32Impl(0))</span>
|
||||
</code></pre>
|
||||
<pre><code class="hljs css language-scala">signedTx.inputs.length
|
||||
<span class="hljs-comment">// res2: Int = 1</span>
|
||||
|
|
@ -207,7 +207,7 @@ signedTx.outputs.length
|
|||
|
||||
<span class="hljs-comment">//remember, you can call .hex on any bitcoin-s data structure to get the hex representation!</span>
|
||||
signedTx.hex
|
||||
<span class="hljs-comment">// res4: String = 02000000012e3e9b0efe03bcf1da57a450b71c9c2372b13e5d3d1f26a7ce112cedd71ecb8b000000006a47304402206a7441ac82758d61e19490bc7cbc8c76f9482fe06bf6c0f69aa5968e3cfbd3900220113e3f6b1786f5721544596aa3821ab7980eda243bfc70f60b8e483ec337c9580121035c545fc48b25bdc9884098c0a5d077436d4e0dafa213de3a83cdeb01a3dd20e1000000000288130000000000001976a914c8deb6f5f60496340801911843f5ce80a1b1da4b88aca7120000000000001976a914785bfbb5b7b525d040e634fd7e7e23c38faad33388ac00000000</span>
|
||||
<span class="hljs-comment">// res4: String = 020000000191063aa5983bf91e597ee03247bdd140830dbf0f893e9cdd9be91fb6bfa8ca2e000000006a4730440220498e1d29ab857ec1cf121a5394742dce359ee17be723880db248482adcad1b7702201f8c6754025e44326e43c0a0da6a16564de09c504ac976e725b0a3a74508ce340121025a57af9e4b4bc3f17e60c934dc096fdc55475fd895bfe8b6ef69f0ac57572864000000000288130000000000001976a91493efa2f3e1146f563107b1823722a17a36dce5ea88aca7120000000000001976a914a54c0e5b22b512d016077758a4b0b2e5ec1c404988ac00000000</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/next/core/dlc"><span class="arrow-prev">← </span><span>Discreet Log Contract Data Structures</span></a><a class="docs-next button" href="/docs/next/core/lightning-network"><span>Lightning Network Data Types</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"></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) {
|
||||
|
|
|
|||
|
|
@ -96,13 +96,13 @@
|
|||
<span class="hljs-comment">// extPrivKey: ExtPrivateKey = Masked(ExtPrivateKeyImpl)</span>
|
||||
|
||||
extPrivKey.sign(<span class="hljs-type">DoubleSha256Digest</span>.empty.bytes)
|
||||
<span class="hljs-comment">// res0: ECDigitalSignature = ECDigitalSignature(30450221009b21bbfe40523e6b974ca690416d681a12e3df604c701591f2b9830b58bce30b02205b255116e2440b1d4840e6c4c49736df759ef4c22dc9215877c894a0577f17a7)</span>
|
||||
<span class="hljs-comment">// res0: ECDigitalSignature = ECDigitalSignature(304402202debc9b774fe3af1c96d746ee3c4b54ebf45f01a85d0f5fe8d3f7ed9e05df6450220305353e207a4d9d189688603953aa0cd16b2c01082887d6726646a29622fb548)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> path = <span class="hljs-type">BIP32Path</span>(<span class="hljs-type">Vector</span>(<span class="hljs-type">BIP32Node</span>(<span class="hljs-number">0</span>,<span class="hljs-literal">false</span>)))
|
||||
<span class="hljs-comment">// path: BIP32Path = m/0</span>
|
||||
|
||||
extPrivKey.sign(<span class="hljs-type">DoubleSha256Digest</span>.empty.bytes,path)
|
||||
<span class="hljs-comment">// res1: ECDigitalSignature = ECDigitalSignature(304402200dfb11eb98dae1817a94c7968da591993e977896bfb8d801a9e827d51fd79c2b02201cea9206a67ae54720f5950483ed9a90e741405385825b5660826be433f50b6d)</span>
|
||||
<span class="hljs-comment">// res1: ECDigitalSignature = ECDigitalSignature(3045022100d55eaa23478c972f643d7496ae7c859db74d693608a252bbe0ee57574fc39f7a0220418595aa17b3bc394f35481545dec6c8842744b3be78e5a1df3bed6504f24412)</span>
|
||||
</code></pre>
|
||||
<p>With <code>ExtSign</code>, you can use <code>ExtPrivateKey</code> to sign transactions inside of <code>TxBuilder</code> since <code>UTXOSpendingInfo</code> takes in <code>Sign</code> as a parameter.</p>
|
||||
<p>You can also provide a <code>path</code> to use to derive a child <code>ExtPrivateKey</code>, and then sign with that child private key</p>
|
||||
|
|
|
|||
|
|
@ -96,13 +96,13 @@
|
|||
<span class="hljs-comment">// extPrivKey: ExtPrivateKey = Masked(ExtPrivateKeyImpl)</span>
|
||||
|
||||
extPrivKey.sign(<span class="hljs-type">DoubleSha256Digest</span>.empty.bytes)
|
||||
<span class="hljs-comment">// res0: ECDigitalSignature = ECDigitalSignature(30450221009b21bbfe40523e6b974ca690416d681a12e3df604c701591f2b9830b58bce30b02205b255116e2440b1d4840e6c4c49736df759ef4c22dc9215877c894a0577f17a7)</span>
|
||||
<span class="hljs-comment">// res0: ECDigitalSignature = ECDigitalSignature(304402202debc9b774fe3af1c96d746ee3c4b54ebf45f01a85d0f5fe8d3f7ed9e05df6450220305353e207a4d9d189688603953aa0cd16b2c01082887d6726646a29622fb548)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> path = <span class="hljs-type">BIP32Path</span>(<span class="hljs-type">Vector</span>(<span class="hljs-type">BIP32Node</span>(<span class="hljs-number">0</span>,<span class="hljs-literal">false</span>)))
|
||||
<span class="hljs-comment">// path: BIP32Path = m/0</span>
|
||||
|
||||
extPrivKey.sign(<span class="hljs-type">DoubleSha256Digest</span>.empty.bytes,path)
|
||||
<span class="hljs-comment">// res1: ECDigitalSignature = ECDigitalSignature(304402200dfb11eb98dae1817a94c7968da591993e977896bfb8d801a9e827d51fd79c2b02201cea9206a67ae54720f5950483ed9a90e741405385825b5660826be433f50b6d)</span>
|
||||
<span class="hljs-comment">// res1: ECDigitalSignature = ECDigitalSignature(3045022100d55eaa23478c972f643d7496ae7c859db74d693608a252bbe0ee57574fc39f7a0220418595aa17b3bc394f35481545dec6c8842744b3be78e5a1df3bed6504f24412)</span>
|
||||
</code></pre>
|
||||
<p>With <code>ExtSign</code>, you can use <code>ExtPrivateKey</code> to sign transactions inside of <code>TxBuilder</code> since <code>UTXOSpendingInfo</code> takes in <code>Sign</code> as a parameter.</p>
|
||||
<p>You can also provide a <code>path</code> to use to derive a child <code>ExtPrivateKey</code>, and then sign with that child private key</p>
|
||||
|
|
|
|||
|
|
@ -130,7 +130,7 @@ libraryDependencies += <span class="hljs-string">"org.bitcoin-s"</span> %% <span
|
|||
<h3><a class="anchor" aria-hidden="true" id="nightly-builds"></a><a href="#nightly-builds" 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>Nightly builds</h3>
|
||||
<p>You can also run on the bleeding edge of Bitcoin-S, by
|
||||
adding a snapshot build to your <code>build.sbt</code>. The most
|
||||
recent snapshot published is <code>1.8.0-193-e8ee5d73-SNAPSHOT</code>.</p>
|
||||
recent snapshot published is <code>1.8.0-194-4e6c6815-SNAPSHOT</code>.</p>
|
||||
<p>To fetch snapshots, you will need to add the correct
|
||||
resolver in your <code>build.sbt</code>:</p>
|
||||
<pre><code class="hljs css language-sbt">resolvers += Resolver.sonatypeRepo(<span class="hljs-string">"snapshots"</span>)
|
||||
|
|
|
|||
|
|
@ -130,7 +130,7 @@ libraryDependencies += <span class="hljs-string">"org.bitcoin-s"</span> %% <span
|
|||
<h3><a class="anchor" aria-hidden="true" id="nightly-builds"></a><a href="#nightly-builds" 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>Nightly builds</h3>
|
||||
<p>You can also run on the bleeding edge of Bitcoin-S, by
|
||||
adding a snapshot build to your <code>build.sbt</code>. The most
|
||||
recent snapshot published is <code>1.8.0-193-e8ee5d73-SNAPSHOT</code>.</p>
|
||||
recent snapshot published is <code>1.8.0-194-4e6c6815-SNAPSHOT</code>.</p>
|
||||
<p>To fetch snapshots, you will need to add the correct
|
||||
resolver in your <code>build.sbt</code>:</p>
|
||||
<pre><code class="hljs css language-sbt">resolvers += Resolver.sonatypeRepo(<span class="hljs-string">"snapshots"</span>)
|
||||
|
|
|
|||
|
|
@ -77,14 +77,14 @@
|
|||
|
||||
<span class="hljs-comment">//get 256 bits of random entropy</span>
|
||||
<span class="hljs-keyword">val</span> entropy = <span class="hljs-type">MnemonicCode</span>.getEntropy256Bits
|
||||
<span class="hljs-comment">// entropy: scodec.bits.BitVector = BitVector(256 bits, 0x95b9d9336c3631a2ab21bed27e8e098e04841f32cb27388fe524a720073f03e4)</span>
|
||||
<span class="hljs-comment">// entropy: scodec.bits.BitVector = BitVector(256 bits, 0x8a5ae6c70c60533ebdb97557f1b38d9121764acda2704a3e4659a419634f7186)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mnemonic = <span class="hljs-type">MnemonicCode</span>.fromEntropy(entropy)
|
||||
<span class="hljs-comment">// mnemonic: MnemonicCode = Masked(MnemonicCodeImpl)</span>
|
||||
|
||||
<span class="hljs-comment">//you can print that mnemonic seed with this</span>
|
||||
println(mnemonic.words)
|
||||
<span class="hljs-comment">// Vector(noble, solution, error, such, glide, spend, prosper, daughter, sponsor, virtual, list, bright, embark, auto, sleep, gossip, decade, left, empty, exact, about, panel, auto, myth)</span>
|
||||
<span class="hljs-comment">// Vector(medal, strong, range, boat, ahead, palm, want, concert, fitness, mirror, toddler, car, blast, century, custom, evoke, enforce, vendor, nose, else, normal, police, ship, taxi)</span>
|
||||
</code></pre>
|
||||
<p>Now that we have a <code>MnemonicCode</code> that was securely generated, we need to now create <code>KeyManagerParams</code> which tells us how to generate
|
||||
generate specific kinds of addresses for wallets.</p>
|
||||
|
|
@ -99,7 +99,7 @@ generate specific kinds of addresses for wallets.</p>
|
|||
<pre><code class="hljs css language-scala"><span class="hljs-comment">//this will create a temp directory with the prefix 'key-manager-example` that will</span>
|
||||
<span class="hljs-comment">//have a file in it called "encrypted-bitcoin-s-seed.json"</span>
|
||||
<span class="hljs-keyword">val</span> seedPath = <span class="hljs-type">Files</span>.createTempDirectory(<span class="hljs-string">"key-manager-example"</span>).resolve(<span class="hljs-type">WalletStorage</span>.<span class="hljs-type">ENCRYPTED_SEED_FILE_NAME</span>)
|
||||
<span class="hljs-comment">// seedPath: Path = /tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json</span>
|
||||
<span class="hljs-comment">// seedPath: Path = /tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json</span>
|
||||
|
||||
<span class="hljs-comment">//let's create a native segwit key manager</span>
|
||||
<span class="hljs-keyword">val</span> purpose = <span class="hljs-type">HDPurposes</span>.<span class="hljs-type">SegWit</span>
|
||||
|
|
@ -110,19 +110,19 @@ generate specific kinds of addresses for wallets.</p>
|
|||
<span class="hljs-comment">// network: RegTest.type = RegTest</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> kmParams = <span class="hljs-type">KeyManagerParams</span>(seedPath, purpose, network)
|
||||
<span class="hljs-comment">// kmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json,m/84',RegTest)</span>
|
||||
<span class="hljs-comment">// kmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json,m/84',RegTest)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> aesPasswordOpt = <span class="hljs-type">Some</span>(<span class="hljs-type">AesPassword</span>.fromString(<span class="hljs-string">"password"</span>))
|
||||
<span class="hljs-comment">// aesPasswordOpt: Some[AesPassword] = Some(Masked(AesPassword))</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> km = <span class="hljs-type">BIP39KeyManager</span>.initializeWithMnemonic(aesPasswordOpt, mnemonic, <span class="hljs-type">None</span>, kmParams)
|
||||
<span class="hljs-comment">// km: Either[KeyManagerInitializeError, BIP39KeyManager] = Right(org.bitcoins.keymanager.bip39.BIP39KeyManager@1fdb390c)</span>
|
||||
<span class="hljs-comment">// km: Either[KeyManagerInitializeError, BIP39KeyManager] = Right(org.bitcoins.keymanager.bip39.BIP39KeyManager@644c848f)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> rootXPub = km.right.get.getRootXPub
|
||||
<span class="hljs-comment">// rootXPub: ExtPublicKey = vpub5SLqN2bLY4WeaBbTLRwTZ9v1jyvuBhyxrXQrR8mEswWS5uHvYw3twqgaCftgGhX1y4afo59qvyVeBa3hMgMgydwpgRjgdyZaaDHqdqrZhrV</span>
|
||||
<span class="hljs-comment">// rootXPub: ExtPublicKey = vpub5SLqN2bLY4WeYZZCMajpNLksN2rzXmMZ1cE4kqKecNjUiD4zUBYun9CUQLrsMas2GzxDDRsr8kRWSPvyLmzMQYwwUg2eeRTQ7YyK97p68ho</span>
|
||||
|
||||
println(rootXPub)
|
||||
<span class="hljs-comment">// vpub5SLqN2bLY4WeaBbTLRwTZ9v1jyvuBhyxrXQrR8mEswWS5uHvYw3twqgaCftgGhX1y4afo59qvyVeBa3hMgMgydwpgRjgdyZaaDHqdqrZhrV</span>
|
||||
<span class="hljs-comment">// vpub5SLqN2bLY4WeYZZCMajpNLksN2rzXmMZ1cE4kqKecNjUiD4zUBYun9CUQLrsMas2GzxDDRsr8kRWSPvyLmzMQYwwUg2eeRTQ7YyK97p68ho</span>
|
||||
</code></pre>
|
||||
<p>Which should print something that looks like this</p>
|
||||
<p><code>vpub5SLqN2bLY4WeXxMqwJHJFBEwxSscGB2uDUnsTS3edVjZEwTrQDFDNqoR2xLqARQPabGaXsHSTenTRcqm2EnB9MpuC4vSk3LqSgNmGGZtuq7</code></p>
|
||||
|
|
@ -131,17 +131,17 @@ println(rootXPub)
|
|||
again after initializing it once. You can use the same <code>mnemonic</code> for different networks, which you control <code>KeyManagerParams</code>.</p>
|
||||
<pre><code class="hljs css language-scala"><span class="hljs-comment">//let's create a nested segwit key manager for mainnet</span>
|
||||
<span class="hljs-keyword">val</span> mainnetKmParams = <span class="hljs-type">KeyManagerParams</span>(seedPath, <span class="hljs-type">HDPurposes</span>.<span class="hljs-type">SegWit</span>, <span class="hljs-type">MainNet</span>)
|
||||
<span class="hljs-comment">// mainnetKmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json,m/84',MainNet)</span>
|
||||
<span class="hljs-comment">// mainnetKmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json,m/84',MainNet)</span>
|
||||
|
||||
<span class="hljs-comment">//we do not need to all `initializeWithMnemonic()` again as we have saved the seed to dis</span>
|
||||
<span class="hljs-keyword">val</span> mainnetKeyManager = <span class="hljs-type">BIP39KeyManager</span>.fromMnemonic(mnemonic, mainnetKmParams, <span class="hljs-type">None</span>, <span class="hljs-type">Instant</span>.now)
|
||||
<span class="hljs-comment">// mainnetKeyManager: BIP39KeyManager = org.bitcoins.keymanager.bip39.BIP39KeyManager@2e42dd8c</span>
|
||||
<span class="hljs-comment">// mainnetKeyManager: BIP39KeyManager = org.bitcoins.keymanager.bip39.BIP39KeyManager@7c4ad6da</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mainnetXpub = mainnetKeyManager.getRootXPub
|
||||
<span class="hljs-comment">// mainnetXpub: ExtPublicKey = zpub6jftahH18ngZyNMvfs5xPWJ2RrWgxBwxWyVjYiLnPy1xJJYqZZi9S6K8HVj2GL8hbd3tnyY5mcuqiiVxEU1kAagE9nXNycqXf7YRC7t97wf</span>
|
||||
<span class="hljs-comment">// mainnetXpub: ExtPublicKey = zpub6jftahH18ngZwkKfh1tKCh8t3uSnJFKYg4JwtQuC8QEzvcKuUpDAGPq2VAhDMDUhuZRSDLG5yPqhyYPEDZeQbVgLx2pLz4jMCTDthSrncWP</span>
|
||||
|
||||
println(mainnetXpub)
|
||||
<span class="hljs-comment">// zpub6jftahH18ngZyNMvfs5xPWJ2RrWgxBwxWyVjYiLnPy1xJJYqZZi9S6K8HVj2GL8hbd3tnyY5mcuqiiVxEU1kAagE9nXNycqXf7YRC7t97wf</span>
|
||||
<span class="hljs-comment">// zpub6jftahH18ngZwkKfh1tKCh8t3uSnJFKYg4JwtQuC8QEzvcKuUpDAGPq2VAhDMDUhuZRSDLG5yPqhyYPEDZeQbVgLx2pLz4jMCTDthSrncWP</span>
|
||||
</code></pre>
|
||||
<p>Which gives us something that looks like this</p>
|
||||
<p><code>zpub6jftahH18ngZw98KGjRo5XcxeKTQ2eztsvskb1dC9XF5TLimQquTs6Ry7nBBA425D9joXmfgJJCexmJ1u2SELJZJfRi95gcnXadLpZzYb5c</code></p>
|
||||
|
|
|
|||
|
|
@ -77,14 +77,14 @@
|
|||
|
||||
<span class="hljs-comment">//get 256 bits of random entropy</span>
|
||||
<span class="hljs-keyword">val</span> entropy = <span class="hljs-type">MnemonicCode</span>.getEntropy256Bits
|
||||
<span class="hljs-comment">// entropy: scodec.bits.BitVector = BitVector(256 bits, 0x95b9d9336c3631a2ab21bed27e8e098e04841f32cb27388fe524a720073f03e4)</span>
|
||||
<span class="hljs-comment">// entropy: scodec.bits.BitVector = BitVector(256 bits, 0x8a5ae6c70c60533ebdb97557f1b38d9121764acda2704a3e4659a419634f7186)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mnemonic = <span class="hljs-type">MnemonicCode</span>.fromEntropy(entropy)
|
||||
<span class="hljs-comment">// mnemonic: MnemonicCode = Masked(MnemonicCodeImpl)</span>
|
||||
|
||||
<span class="hljs-comment">//you can print that mnemonic seed with this</span>
|
||||
println(mnemonic.words)
|
||||
<span class="hljs-comment">// Vector(noble, solution, error, such, glide, spend, prosper, daughter, sponsor, virtual, list, bright, embark, auto, sleep, gossip, decade, left, empty, exact, about, panel, auto, myth)</span>
|
||||
<span class="hljs-comment">// Vector(medal, strong, range, boat, ahead, palm, want, concert, fitness, mirror, toddler, car, blast, century, custom, evoke, enforce, vendor, nose, else, normal, police, ship, taxi)</span>
|
||||
</code></pre>
|
||||
<p>Now that we have a <code>MnemonicCode</code> that was securely generated, we need to now create <code>KeyManagerParams</code> which tells us how to generate
|
||||
generate specific kinds of addresses for wallets.</p>
|
||||
|
|
@ -99,7 +99,7 @@ generate specific kinds of addresses for wallets.</p>
|
|||
<pre><code class="hljs css language-scala"><span class="hljs-comment">//this will create a temp directory with the prefix 'key-manager-example` that will</span>
|
||||
<span class="hljs-comment">//have a file in it called "encrypted-bitcoin-s-seed.json"</span>
|
||||
<span class="hljs-keyword">val</span> seedPath = <span class="hljs-type">Files</span>.createTempDirectory(<span class="hljs-string">"key-manager-example"</span>).resolve(<span class="hljs-type">WalletStorage</span>.<span class="hljs-type">ENCRYPTED_SEED_FILE_NAME</span>)
|
||||
<span class="hljs-comment">// seedPath: Path = /tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json</span>
|
||||
<span class="hljs-comment">// seedPath: Path = /tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json</span>
|
||||
|
||||
<span class="hljs-comment">//let's create a native segwit key manager</span>
|
||||
<span class="hljs-keyword">val</span> purpose = <span class="hljs-type">HDPurposes</span>.<span class="hljs-type">SegWit</span>
|
||||
|
|
@ -110,19 +110,19 @@ generate specific kinds of addresses for wallets.</p>
|
|||
<span class="hljs-comment">// network: RegTest.type = RegTest</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> kmParams = <span class="hljs-type">KeyManagerParams</span>(seedPath, purpose, network)
|
||||
<span class="hljs-comment">// kmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json,m/84',RegTest)</span>
|
||||
<span class="hljs-comment">// kmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json,m/84',RegTest)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> aesPasswordOpt = <span class="hljs-type">Some</span>(<span class="hljs-type">AesPassword</span>.fromString(<span class="hljs-string">"password"</span>))
|
||||
<span class="hljs-comment">// aesPasswordOpt: Some[AesPassword] = Some(Masked(AesPassword))</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> km = <span class="hljs-type">BIP39KeyManager</span>.initializeWithMnemonic(aesPasswordOpt, mnemonic, <span class="hljs-type">None</span>, kmParams)
|
||||
<span class="hljs-comment">// km: Either[KeyManagerInitializeError, BIP39KeyManager] = Right(org.bitcoins.keymanager.bip39.BIP39KeyManager@1fdb390c)</span>
|
||||
<span class="hljs-comment">// km: Either[KeyManagerInitializeError, BIP39KeyManager] = Right(org.bitcoins.keymanager.bip39.BIP39KeyManager@644c848f)</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> rootXPub = km.right.get.getRootXPub
|
||||
<span class="hljs-comment">// rootXPub: ExtPublicKey = vpub5SLqN2bLY4WeaBbTLRwTZ9v1jyvuBhyxrXQrR8mEswWS5uHvYw3twqgaCftgGhX1y4afo59qvyVeBa3hMgMgydwpgRjgdyZaaDHqdqrZhrV</span>
|
||||
<span class="hljs-comment">// rootXPub: ExtPublicKey = vpub5SLqN2bLY4WeYZZCMajpNLksN2rzXmMZ1cE4kqKecNjUiD4zUBYun9CUQLrsMas2GzxDDRsr8kRWSPvyLmzMQYwwUg2eeRTQ7YyK97p68ho</span>
|
||||
|
||||
println(rootXPub)
|
||||
<span class="hljs-comment">// vpub5SLqN2bLY4WeaBbTLRwTZ9v1jyvuBhyxrXQrR8mEswWS5uHvYw3twqgaCftgGhX1y4afo59qvyVeBa3hMgMgydwpgRjgdyZaaDHqdqrZhrV</span>
|
||||
<span class="hljs-comment">// vpub5SLqN2bLY4WeYZZCMajpNLksN2rzXmMZ1cE4kqKecNjUiD4zUBYun9CUQLrsMas2GzxDDRsr8kRWSPvyLmzMQYwwUg2eeRTQ7YyK97p68ho</span>
|
||||
</code></pre>
|
||||
<p>Which should print something that looks like this</p>
|
||||
<p><code>vpub5SLqN2bLY4WeXxMqwJHJFBEwxSscGB2uDUnsTS3edVjZEwTrQDFDNqoR2xLqARQPabGaXsHSTenTRcqm2EnB9MpuC4vSk3LqSgNmGGZtuq7</code></p>
|
||||
|
|
@ -131,17 +131,17 @@ println(rootXPub)
|
|||
again after initializing it once. You can use the same <code>mnemonic</code> for different networks, which you control <code>KeyManagerParams</code>.</p>
|
||||
<pre><code class="hljs css language-scala"><span class="hljs-comment">//let's create a nested segwit key manager for mainnet</span>
|
||||
<span class="hljs-keyword">val</span> mainnetKmParams = <span class="hljs-type">KeyManagerParams</span>(seedPath, <span class="hljs-type">HDPurposes</span>.<span class="hljs-type">SegWit</span>, <span class="hljs-type">MainNet</span>)
|
||||
<span class="hljs-comment">// mainnetKmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example10287740887131431698/encrypted-bitcoin-s-seed.json,m/84',MainNet)</span>
|
||||
<span class="hljs-comment">// mainnetKmParams: KeyManagerParams = KeyManagerParams(/tmp/key-manager-example3537093587539385895/encrypted-bitcoin-s-seed.json,m/84',MainNet)</span>
|
||||
|
||||
<span class="hljs-comment">//we do not need to all `initializeWithMnemonic()` again as we have saved the seed to dis</span>
|
||||
<span class="hljs-keyword">val</span> mainnetKeyManager = <span class="hljs-type">BIP39KeyManager</span>.fromMnemonic(mnemonic, mainnetKmParams, <span class="hljs-type">None</span>, <span class="hljs-type">Instant</span>.now)
|
||||
<span class="hljs-comment">// mainnetKeyManager: BIP39KeyManager = org.bitcoins.keymanager.bip39.BIP39KeyManager@2e42dd8c</span>
|
||||
<span class="hljs-comment">// mainnetKeyManager: BIP39KeyManager = org.bitcoins.keymanager.bip39.BIP39KeyManager@7c4ad6da</span>
|
||||
|
||||
<span class="hljs-keyword">val</span> mainnetXpub = mainnetKeyManager.getRootXPub
|
||||
<span class="hljs-comment">// mainnetXpub: ExtPublicKey = zpub6jftahH18ngZyNMvfs5xPWJ2RrWgxBwxWyVjYiLnPy1xJJYqZZi9S6K8HVj2GL8hbd3tnyY5mcuqiiVxEU1kAagE9nXNycqXf7YRC7t97wf</span>
|
||||
<span class="hljs-comment">// mainnetXpub: ExtPublicKey = zpub6jftahH18ngZwkKfh1tKCh8t3uSnJFKYg4JwtQuC8QEzvcKuUpDAGPq2VAhDMDUhuZRSDLG5yPqhyYPEDZeQbVgLx2pLz4jMCTDthSrncWP</span>
|
||||
|
||||
println(mainnetXpub)
|
||||
<span class="hljs-comment">// zpub6jftahH18ngZyNMvfs5xPWJ2RrWgxBwxWyVjYiLnPy1xJJYqZZi9S6K8HVj2GL8hbd3tnyY5mcuqiiVxEU1kAagE9nXNycqXf7YRC7t97wf</span>
|
||||
<span class="hljs-comment">// zpub6jftahH18ngZwkKfh1tKCh8t3uSnJFKYg4JwtQuC8QEzvcKuUpDAGPq2VAhDMDUhuZRSDLG5yPqhyYPEDZeQbVgLx2pLz4jMCTDthSrncWP</span>
|
||||
</code></pre>
|
||||
<p>Which gives us something that looks like this</p>
|
||||
<p><code>zpub6jftahH18ngZw98KGjRo5XcxeKTQ2eztsvskb1dC9XF5TLimQquTs6Ry7nBBA425D9joXmfgJJCexmJ1u2SELJZJfRi95gcnXadLpZzYb5c</code></p>
|
||||
|
|
|
|||
|
|
@ -115,13 +115,13 @@ println(<span class="hljs-string">s"Verified with NativeSecp256k1 again=<span cl
|
|||
<span class="hljs-comment">// privKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> publicKey = privKey.publicKey
|
||||
<span class="hljs-comment">// publicKey: ECPublicKey = ECPublicKey(0252ad905156f5b7038ec448ee7a177c3dfb06fa5a1914f4c32548221ade73ffa6)</span>
|
||||
<span class="hljs-comment">// publicKey: ECPublicKey = ECPublicKey(03ee6f7421c61f86fab49cf341692baa8f6dd82d4cd7c948673bf037007bf15e2c)</span>
|
||||
<span class="hljs-keyword">val</span> dataToSign = <span class="hljs-type">DoubleSha256Digest</span>.empty
|
||||
<span class="hljs-comment">// dataToSign: DoubleSha256Digest = DoubleSha256Digest(0000000000000000000000000000000000000000000000000000000000000000)</span>
|
||||
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> signature = privKey.sign(dataToSign.bytes)
|
||||
<span class="hljs-comment">// signature: ECDigitalSignature = ECDigitalSignature(304402205dd795e725ceb596d3f894cee0e2c883990847f748a855442d64643ae2d78fd802205ac0e4ca5fadb14da755bdd376baab5dabc40df39e3b75f6d54bdc95fff371cd)</span>
|
||||
<span class="hljs-comment">// signature: ECDigitalSignature = ECDigitalSignature(3045022100fc83daccccb8ad78b9bdf296b5fbe37d6fe1a3812442f23cdf2730057ae828870220255f174a80bb7708e7ff53d86ff08f3eb3240469a440c70bc574dcb5477e7230)</span>
|
||||
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> verified = publicKey.verify(dataToSign.bytes, signature)
|
||||
|
|
|
|||
|
|
@ -115,13 +115,13 @@ println(<span class="hljs-string">s"Verified with NativeSecp256k1 again=<span cl
|
|||
<span class="hljs-comment">// privKey: ECPrivateKey = Masked(ECPrivateKey)</span>
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> publicKey = privKey.publicKey
|
||||
<span class="hljs-comment">// publicKey: ECPublicKey = ECPublicKey(0252ad905156f5b7038ec448ee7a177c3dfb06fa5a1914f4c32548221ade73ffa6)</span>
|
||||
<span class="hljs-comment">// publicKey: ECPublicKey = ECPublicKey(03ee6f7421c61f86fab49cf341692baa8f6dd82d4cd7c948673bf037007bf15e2c)</span>
|
||||
<span class="hljs-keyword">val</span> dataToSign = <span class="hljs-type">DoubleSha256Digest</span>.empty
|
||||
<span class="hljs-comment">// dataToSign: DoubleSha256Digest = DoubleSha256Digest(0000000000000000000000000000000000000000000000000000000000000000)</span>
|
||||
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> signature = privKey.sign(dataToSign.bytes)
|
||||
<span class="hljs-comment">// signature: ECDigitalSignature = ECDigitalSignature(304402205dd795e725ceb596d3f894cee0e2c883990847f748a855442d64643ae2d78fd802205ac0e4ca5fadb14da755bdd376baab5dabc40df39e3b75f6d54bdc95fff371cd)</span>
|
||||
<span class="hljs-comment">// signature: ECDigitalSignature = ECDigitalSignature(3045022100fc83daccccb8ad78b9bdf296b5fbe37d6fe1a3812442f23cdf2730057ae828870220255f174a80bb7708e7ff53d86ff08f3eb3240469a440c70bc574dcb5477e7230)</span>
|
||||
|
||||
<span class="hljs-comment">// calls bouncy castle indirectly via CryptoContext</span>
|
||||
<span class="hljs-keyword">val</span> verified = publicKey.verify(dataToSign.bytes, signature)
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue