btcd/btcec
Olaoluwa Osuntokun d6d38ad4ae
btcec/v2/schnorr: add initial BIP-340 schnorr sig implementation
In this commit, we add an initial implementation of BIP-340. Mirroring
the recently added `ecsda` package, we create a new `schnorr` package
with a unique `Signature` type and `ParsePubkey` function. The new
`Signature` type implements the fixed-sized 64-byte signatures, and the
`ParsePubkey` method only accepts pubkeys that are 32-bytes in length,
with an implicit sign byte.

The signing implementation by default, deviates from BIP-340 as it opts
to use rfc6979 deterministic signatures by default, which means callers
don't need to always pass in their own `auxNonce` randomness. A set of
functional arguments allows callers to pass in their own value, which is
the way all the included test vectors function.

The other optional functional argument added is the `FastSign` option
that allows callers to skip the final step of verifying each signature
they generate.
2022-01-31 14:25:47 -08:00
..
ecdsa btcec/v2: create new ecdsa package 2022-01-31 14:25:39 -08:00
schnorr btcec/v2/schnorr: add initial BIP-340 schnorr sig implementation 2022-01-31 14:25:47 -08:00
bench_test.go btcec/v2: create new ecdsa package 2022-01-31 14:25:39 -08:00
btcec_test.go btcec/v2: create new ecdsa package 2022-01-31 14:25:39 -08:00
btcec.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
ciphering_test.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
ciphering.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
curve.go btcec/v2: retain copyright notices from decred developers for all files 2022-01-26 16:10:26 -08:00
doc.go Relicense to the btcsuite developers. 2015-05-01 12:00:56 -05:00
error.go btcec/v2: retain copyright notices from decred developers for all files 2022-01-26 16:10:26 -08:00
field_test.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
field.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
go.mod btcec/v2: create new ecdsa package 2022-01-31 14:25:39 -08:00
go.sum btcec/v2: create new ecdsa package 2022-01-31 14:25:39 -08:00
modnscalar.go btcec/v2: retain copyright notices from decred developers for all files 2022-01-26 16:10:26 -08:00
privkey.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
pubkey_test.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
pubkey.go btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00
README.md btcec: convert package into go module, alias to dcrec 2022-01-26 16:10:14 -08:00

btcec

Build Status ISC License GoDoc

Package btcec implements elliptic curve cryptography needed for working with Bitcoin (secp256k1 only for now). It is designed so that it may be used with the standard crypto/ecdsa packages provided with go. A comprehensive suite of test is provided to ensure proper functionality. Package btcec was originally based on work from ThePiachu which is licensed under the same terms as Go, but it has signficantly diverged since then. The btcsuite developers original is licensed under the liberal ISC license.

Although this package was primarily written for btcd, it has intentionally been designed so it can be used as a standalone package for any projects needing to use secp256k1 elliptic curve cryptography.

Installation and Updating

$ go install -u -v github.com/btcsuite/btcd/btcec/v2

Examples

  • Sign Message
    Demonstrates signing a message with a secp256k1 private key that is first parsed form raw bytes and serializing the generated signature.

  • Verify Signature
    Demonstrates verifying a secp256k1 signature against a public key that is first parsed from raw bytes. The signature is also parsed from raw bytes.

License

Package btcec is licensed under the copyfree ISC License except for btcec.go and btcec_test.go which is under the same license as Go.