Generating Addresses
Almost all Bitcoin applications need to generate addresses for their users somehow. There's a lot going on in getting a correct bitcoin address, but our APIs make it possible to to get started with all types of addresses in a matter of minutes.
Generating SegWit (bech32) addresses
Generating native SegWit addresses in the bech32 format is something that all Bitcoin applications should enable, as it makes the transaction fees less expensive, and also makes the addresses more readable by humans. However, it has seen slower than necessary adoption. With Bitcoin-S you can generate bech32 addresses in four(!) lines of code (not counting comments and imports), so now there's no reason to keep using legacy transaction formats.
// this generates a random private key
val privkey = ECPrivateKey()
// privkey: ECPrivateKey = Masked(ECPrivateKey)
val pubkey = privkey.publicKey
// pubkey: org.bitcoins.crypto.ECPublicKey = ECPublicKey(03d274ddb80d100ff1f00fb8c344181d9ddcf58710e1c59fd5b718020b6b92bc86)
val segwitAddress = {
// see https://bitcoin.org/en/glossary/pubkey-script
// for reading resources on the details of scriptPubKeys
// pay-to-witness-pubkey-hash scriptPubKey V0
val scriptPubKey = P2WPKHWitnessSPKV0(pubkey)
Bech32Address(scriptPubKey, TestNet3)
}
// segwitAddress: Bech32Address = tb1qz5eg3us8x4hmsdd7s50qg0q2pak8ccxzv09n9u
println(segwitAddress.toString)
// tb1qz5eg3us8x4hmsdd7s50qg0q2pak8ccxzv09n9u
Generating legacy (base58) addresses
If you need to generate legacy addresses for backwards compatability reasons, that's also a walk in the park. Take a look:
// we're reusing the same private/public key pair
// from before. don't do this in an actual application!
val legacyAddress = P2PKHAddress(pubkey, TestNet3)
// legacyAddress: P2PKHAddress = mhT32K3MAwhME1sXJ8uqe9U5De2b3SA44J
println(legacyAddress.toString)
// mhT32K3MAwhME1sXJ8uqe9U5De2b3SA44J