bls

Documentation

Index

• Constants
• Variables
• func PublicKeyToCompressedBytes(pk *PublicKey) []byte
• func PublicKeyToUncompressedBytes(key *PublicKey) []byte
• func SignatureToBytes(sig *Signature) []byte
• func Verify(pk *PublicKey, sig *Signature, msg []byte) bool
• func VerifyProofOfPossession(pk *PublicKey, sig *Signature, msg []byte) bool
• type AggregatePublicKey
• type AggregateSignature
• type LocalSigner
  • func NewSigner() (*LocalSigner, error)
  • func SecretKeyFromBytes(skBytes []byte) (*LocalSigner, error)
  • func (s *LocalSigner) PublicKey() *PublicKey
  • func (s *LocalSigner) Sign(msg []byte) *Signature
  • func (s *LocalSigner) SignProofOfPossession(msg []byte) *Signature
  • func (s *LocalSigner) ToBytes() []byte
• type PublicKey
  • func AggregatePublicKeys(pks []*PublicKey) (*PublicKey, error)
  • func PublicKeyFromCompressedBytes(pkBytes []byte) (*PublicKey, error)
  • func PublicKeyFromValidUncompressedBytes(pkBytes []byte) *PublicKey
• type SecretKey
• type Signature
  • func AggregateSignatures(sigs []*Signature) (*Signature, error)
  • func SignatureFromBytes(sigBytes []byte) (*Signature, error)
• type Signer

Constants

const PublicKeyLen = blst.BLST_P1_COMPRESS_BYTES

const SecretKeyLen = blst.BLST_SCALAR_BYTES

const SignatureLen = blst.BLST_P2_COMPRESS_BYTES

Variables

var (
	ErrNoPublicKeys              = errors.New("no public keys")
	ErrFailedPublicKeyDecompress = errors.New("couldn't decompress public key")
)

var (
	ErrFailedSignatureDecompress = errors.New("couldn't decompress signature")
)

Functions

func PublicKeyToCompressedBytes

func PublicKeyToCompressedBytes(pk *PublicKey) []byte

PublicKeyToCompressedBytes returns the compressed big-endian format of the public key.

func PublicKeyToUncompressedBytes

func PublicKeyToUncompressedBytes(key *PublicKey) []byte

PublicKeyToUncompressedBytes returns the uncompressed big-endian format of the public key.

func SignatureToBytes

func SignatureToBytes(sig *Signature) []byte

SignatureToBytes returns the compressed big-endian format of the signature.

func Verify

func Verify(pk *PublicKey, sig *Signature, msg []byte) bool

Verify the [sig] of [msg] against the [pk]. The [sig] and [pk] may have been an aggregation of other signatures and keys. Invariant: [pk] and [sig] have both been validated.

func VerifyProofOfPossession

func VerifyProofOfPossession(pk *PublicKey, sig *Signature, msg []byte) bool

Verify the possession of the secret pre-image of [sk] by verifying a [sig] of [msg] against the [pk]. The [sig] and [pk] may have been an aggregation of other signatures and keys. Invariant: [pk] and [sig] have both been validated.

Types

type AggregatePublicKey

type AggregatePublicKey = blst.P1Aggregate

type AggregateSignature

type AggregateSignature = blst.P2Aggregate

type LocalSigner

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

func NewSigner

func NewSigner() (*LocalSigner, error)

NewSecretKey generates a new secret key from the local source of cryptographically secure randomness.

func SecretKeyFromBytes

func SecretKeyFromBytes(skBytes []byte) (*LocalSigner, error)

SecretKeyFromBytes parses the big-endian format of the secret key into a secret key.

func (*LocalSigner) PublicKey

func (s *LocalSigner) PublicKey() *PublicKey

PublicKey returns the public key that corresponds to this secret key.

func (*LocalSigner) Sign

func (s *LocalSigner) Sign(msg []byte) *Signature

Sign [msg] to authorize this message

func (*LocalSigner) SignProofOfPossession

func (s *LocalSigner) SignProofOfPossession(msg []byte) *Signature

Sign [msg] to prove the ownership

func (*LocalSigner) ToBytes

func (s *LocalSigner) ToBytes() []byte

ToBytes returns the big-endian format of the secret key.

type PublicKey

type PublicKey = blst.P1Affine

func AggregatePublicKeys

func AggregatePublicKeys(pks []*PublicKey) (*PublicKey, error)

AggregatePublicKeys aggregates a non-zero number of public keys into a single aggregated public key. Invariant: all [pks] have been validated.

func PublicKeyFromCompressedBytes

func PublicKeyFromCompressedBytes(pkBytes []byte) (*PublicKey, error)

PublicKeyFromCompressedBytes parses the compressed big-endian format of the public key into a public key.

func PublicKeyFromValidUncompressedBytes

func PublicKeyFromValidUncompressedBytes(pkBytes []byte) *PublicKey

PublicKeyFromValidUncompressedBytes parses the uncompressed big-endian format of the public key into a public key. It is assumed that the provided bytes are valid.

type SecretKey

type SecretKey = blst.SecretKey

type Signature

type Signature = blst.P2Affine

func AggregateSignatures

func AggregateSignatures(sigs []*Signature) (*Signature, error)

AggregateSignatures aggregates a non-zero number of signatures into a single aggregated signature. Invariant: all [sigs] have been validated.

func SignatureFromBytes

func SignatureFromBytes(sigBytes []byte) (*Signature, error)

SignatureFromBytes parses the compressed big-endian format of the signature into a signature.

type Signer

type Signer interface {
	PublicKey() *PublicKey
	Sign(msg []byte) *Signature
	SignProofOfPossession(msg []byte) *Signature
}