mirror of
https://github.com/bitcoin-s/bitcoin-s.git
synced 2025-02-25 07:17:32 +01:00
65 lines
3 KiB
Markdown
65 lines
3 KiB
Markdown
|
---
|
||
|
|
id: version-1.7.0-sign
|
||
|
|
title: Sign API
|
||
|
|
original_id: sign
|
||
|
|
---
|
||
|
|
|
||
|
|
### The [`Sign` API](/api/org/bitcoins/crypto/Sign)
|
||
|
|
|
||
|
|
This is the API we define to sign things with. It takes in an arbitrary byte vector and returns a `Future[ECDigitalSignature]`. The reason we incorporate `Future`s here is for extensibility of this API. We would like to provide implementations of this API for hardware devices, which need to be asynchrnous since they may require user input.
|
||
|
|
|
||
|
|
From [Sign.scala](/api/org/bitcoins/crypto/Sign):
|
||
|
|
|
||
|
|
```scala
|
||
|
|
import scodec.bits._
|
||
|
|
import org.bitcoins.crypto._
|
||
|
|
import scala.concurrent._
|
||
|
|
import scala.concurrent.duration._
|
||
|
|
|
||
|
|
trait Sign {
|
||
|
|
def signFunction: ByteVector => Future[ECDigitalSignature]
|
||
|
|
|
||
|
|
def signFuture(bytes: ByteVector): Future[ECDigitalSignature] =
|
||
|
|
signFunction(bytes)
|
||
|
|
|
||
|
|
def sign(bytes: ByteVector): ECDigitalSignature = {
|
||
|
|
Await.result(signFuture(bytes), 30.seconds)
|
||
|
|
}
|
||
|
|
|
||
|
|
def publicKey: ECPublicKey
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
The `ByteVector` that is input to the `signFunction` should be the hash that is output from [`TransactionSignatureSerializer`](/api/org/bitcoins/core/crypto/TransactionSignatureSerializer)'s `hashForSignature` method. Our in-memory [`BaseECKey`](/api/org/bitcoins/crypto/BaseECKey) types implement the `Sign` API.
|
||
|
|
|
||
|
|
If you wanted to implement a new `Sign` api for a hardware wallet, you can easily pass it into the `TxBuilder`/`Signer` classes to allow for you to use those devices to sign with Bitcoin-S.
|
||
|
|
|
||
|
|
This API is currently used to sign ordinary transactions with our [`Signer`](/api/org/bitcoins/core/wallet/signer/Signer)s. The `Signer` subtypes (i.e. `P2PKHSigner`) implement the specific functionality needed to produce a valid digital signature for their corresponding script type.
|
||
|
|
|
||
|
|
|
||
|
|
### The [`ExtSign`](/api/org/bitcoins/crypto/Sign) API.
|
||
|
|
|
||
|
|
An [ExtKey](/api/org/bitcoins/core/crypto/ExtKey) is a data structure that can be used to generate more keys from a parent key. For more information look at [hd-keys.md](../core/hd-keys.md)
|
||
|
|
|
||
|
|
You can sign with `ExtPrivateKey` the same way you could with a normal `ECPrivateKey`.
|
||
|
|
|
||
|
|
```scala
|
||
|
|
import org.bitcoins.core.hd._
|
||
|
|
import org.bitcoins.core.crypto._
|
||
|
|
|
||
|
|
val extPrivKey = ExtPrivateKey(ExtKeyVersion.SegWitMainNetPriv)
|
||
|
|
// extPrivKey: ExtPrivateKey = Masked(ExtPrivateKeyImpl)
|
||
|
|
|
||
|
|
extPrivKey.sign(DoubleSha256Digest.empty.bytes)
|
||
|
|
// res0: ECDigitalSignature = ECDigitalSignature(304402201e9e132ba14eb6d03672195ec50ae783d8f17112e0fa93a7ddc5cf42c5ebd23d022036a78727ecc5e1fe88256838e57c92af9f993f2d245f97ecb6a5d5548764ca88)
|
||
|
|
|
||
|
|
val path = BIP32Path(Vector(BIP32Node(0,false)))
|
||
|
|
// path: BIP32Path = m/0
|
||
|
|
|
||
|
|
extPrivKey.sign(DoubleSha256Digest.empty.bytes,path)
|
||
|
|
// res1: ECDigitalSignature = ECDigitalSignature(30440220673de4f0250c2aeeb966add7458f31007797c22d3c7b7480d8c7adde7c1091a3022045813e7f920764f1c55ba1fccd8886dfe3dd8b7ed3a0150e0d72aef4b97a9c94)
|
||
|
|
```
|
||
|
|
|
||
|
|
With `ExtSign`, you can use `ExtPrivateKey` to sign transactions inside of `TxBuilder` since `UTXOSpendingInfo` takes in `Sign` as a parameter.
|
||
|
|
|
||
|
|
You can also provide a `path` to use to derive a child `ExtPrivateKey`, and then sign with that child private key
|