secp256k1

Documentation

Overview

Package secp256k1 wraps the bitcoin secp256k1 C library.

Index

• Constants
• Variables
• func CompressPubkey(x, y *big.Int) []byte
• func DecompressPubkey(pubkey []byte) (x, y *big.Int)
• func GetPublicKey(prikey []byte) ([]byte, error)
• func NewPrivateKey() []byte
• func PrivateKeyVerify(prikey []byte) bool
• func RecoverPubkey(msg []byte, sig []byte) ([]byte, error)
• func Sign(msg []byte, seckey []byte) ([]byte, error)
• func VerifySignature(pubkey, msg, signature []byte) bool
• type BitCurve
  • func S256() *BitCurve
  • func (BitCurve *BitCurve) Add(x1, y1, x2, y2 *big.Int) (*big.Int, *big.Int)
  • func (BitCurve *BitCurve) Double(x1, y1 *big.Int) (*big.Int, *big.Int)
  • func (BitCurve *BitCurve) IsOnCurve(x, y *big.Int) bool
  • func (BitCurve *BitCurve) Marshal(x, y *big.Int) []byte
  • func (BitCurve *BitCurve) Params() *elliptic.CurveParams
  • func (BitCurve *BitCurve) ScalarBaseMult(k []byte) (*big.Int, *big.Int)
  • func (BitCurve *BitCurve) ScalarMult(Bx, By *big.Int, scalar []byte) (*big.Int, *big.Int)
  • func (BitCurve *BitCurve) Unmarshal(data []byte) (x, y *big.Int)
• type Key
  • func GenerateKey() *Key
  • func GenerateKeyK1() *Key
  • func NewKey(privateKey, publicKey []byte) *Key
  • func (k *Key) Clear()
  • func (k *Key) PrivateKey() []byte
  • func (k *Key) PublicKey() []byte
• type Signer
  • func NewSecp256k1Signer() *Signer
  • func (s *Signer) Algorithm() crypto.Algorithm
  • func (s *Signer) InitSigner(privateKey []byte) error
  • func (s *Signer) RecoverPublicKey(data []byte, signature *crypto.Signature) (publicKey []byte, err error)
  • func (s *Signer) Sign(data []byte) (signature *crypto.Signature, err error)
  • func (s *Signer) Verify(publicKey []byte, data []byte, signature *crypto.Signature) bool

Constants

const (
	// EcdsaPrivateKeyLength key length
	PrivateKeyLength = 32
	PublicKeyLength  = 65
)

Variables

var (
	ErrInvalidMsgLen       = errors.New("invalid message length, need 32 bytes")
	ErrInvalidSignatureLen = errors.New("invalid signature length")
	ErrInvalidRecoveryID   = errors.New("invalid signature recovery id")
	ErrInvalidKey          = errors.New("invalid private key")
	ErrInvalidPubkey       = errors.New("invalid public key")
	ErrSignFailed          = errors.New("signing failed")
	ErrRecoverFailed       = errors.New("recovery failed")
	ErrGetPublicKeyFailed  = errors.New("private key to public failed")
)

Functions

func CompressPubkey

func CompressPubkey(x, y *big.Int) []byte

CompressPubkey encodes a public key to 33-byte compressed format.

func DecompressPubkey

func DecompressPubkey(pubkey []byte) (x, y *big.Int)

DecompressPubkey parses a public key in the 33-byte compressed format. It returns non-nil coordinates if the public key is valid.

func GetPublicKey

func GetPublicKey(prikey []byte) ([]byte, error)

func NewPrivateKey

func NewPrivateKey() []byte

NewPrikey generate a ecdsa private key by secp256k1

func PrivateKeyVerify

func PrivateKeyVerify(prikey []byte) bool

PrikeyVerify check private is ok for secp256k1

func RecoverPubkey

func RecoverPubkey(msg []byte, sig []byte) ([]byte, error)

RecoverPubkey returns the the public key of the signer. msg must be the 32-byte hash of the message to be signed. sig must be a 65-byte compact ECDSA signature containing the recovery id as the last element.

func Sign

func Sign(msg []byte, seckey []byte) ([]byte, error)

Sign creates a recoverable ECDSA signature. The produced signature is in the 65-byte [R || S || V] format where V is 0 or 1.

The caller is responsible for ensuring that msg cannot be chosen directly by an attacker. It is usually preferable to use a cryptographic hash function on any input before handing it to this function.

func VerifySignature

func VerifySignature(pubkey, msg, signature []byte) bool

VerifySignature checks that the given pubkey created signature over message. The signature should be in [R || S] format.

Types

type BitCurve

type BitCurve struct {
	P       *big.Int // the order of the underlying field
	N       *big.Int // the order of the base point
	B       *big.Int // the constant of the BitCurve equation
	Gx, Gy  *big.Int // (x,y) of the base point
	BitSize int      // the size of the underlying field
}

A BitCurve represents a Koblitz Curve with a=0. See http://www.hyperelliptic.org/EFD/g1p/auto-shortw.html

func S256

func S256() *BitCurve

S256 returns a BitCurve which implements secp256k1.

func (*BitCurve) Add

func (BitCurve *BitCurve) Add(x1, y1, x2, y2 *big.Int) (*big.Int, *big.Int)

Add returns the sum of (x1,y1) and (x2,y2)

func (*BitCurve) Double

func (BitCurve *BitCurve) Double(x1, y1 *big.Int) (*big.Int, *big.Int)

Double returns 2*(x,y)

func (*BitCurve) IsOnCurve

func (BitCurve *BitCurve) IsOnCurve(x, y *big.Int) bool

IsOnBitCurve returns true if the given (x,y) lies on the BitCurve.

func (*BitCurve) Marshal

func (BitCurve *BitCurve) Marshal(x, y *big.Int) []byte

Marshal converts a point into the form specified in section 4.3.6 of ANSI X9.62.

func (*BitCurve) Params

func (BitCurve *BitCurve) Params() *elliptic.CurveParams

func (*BitCurve) ScalarBaseMult

func (BitCurve *BitCurve) ScalarBaseMult(k []byte) (*big.Int, *big.Int)

ScalarBaseMult returns k*G, where G is the base point of the group and k is an integer in big-endian form.

func (*BitCurve) ScalarMult

func (BitCurve *BitCurve) ScalarMult(Bx, By *big.Int, scalar []byte) (*big.Int, *big.Int)

func (*BitCurve) Unmarshal

func (BitCurve *BitCurve) Unmarshal(data []byte) (x, y *big.Int)

Unmarshal converts a point, serialised by Marshal, into an x, y pair. On error, x = nil.

type Key

type Key struct {
	// contains filtered or unexported fields
}

func GenerateKey

func GenerateKey() *Key

用ecdsa包，通过k1曲线产生私钥

func GenerateKeyK1

func GenerateKeyK1() *Key

直接用k1包来产生私钥, 与上应该一样的功能

func NewKey

func NewKey(privateKey, publicKey []byte) *Key

func (*Key) Clear

func (k *Key) Clear()

func (*Key) PrivateKey

func (k *Key) PrivateKey() []byte

func (*Key) PublicKey

func (k *Key) PublicKey() []byte

type Signer

type Signer struct {
	// contains filtered or unexported fields
}

func NewSecp256k1Signer

func NewSecp256k1Signer() *Signer

func (*Signer) Algorithm

func (s *Signer) Algorithm() crypto.Algorithm

func (*Signer) InitSigner

func (s *Signer) InitSigner(privateKey []byte) error

func (*Signer) RecoverPublicKey

func (s *Signer) RecoverPublicKey(data []byte, signature *crypto.Signature) (publicKey []byte, err error)

func (*Signer) Sign

func (s *Signer) Sign(data []byte) (signature *crypto.Signature, err error)

func (*Signer) Verify

func (s *Signer) Verify(publicKey []byte, data []byte, signature *crypto.Signature) bool