Documentation
¶
Overview ¶
Package bls implements a go-wrapper around a library implementing the BLS12-381 curve and signature scheme. This package exposes a public API for verifying and aggregating BLS signatures used by Ethereum.
Index ¶
- Constants
- func AggregateCompressedSignatures(multiSigs [][]byte) (common.Signature, error)
- func AggregateSignatures(sigs []common.Signature) common.Signature
- func NewAggregateSignature() common.Signature
- func RandKey() (common.SecretKey, error)
- func VerifyMultipleSignatures(sigs [][]byte, msgs [][32]byte, pubKeys []common.PublicKey) (bool, error)
- func VerifySignature(sig []byte, msg [32]byte, pubKey common.PublicKey) (bool, error)
- type PublicKey
- type SecretKey
- type Signature
- type SignatureBatch
- func (s *SignatureBatch) AggregateBatch() (*SignatureBatch, error)
- func (s *SignatureBatch) Copy() *SignatureBatch
- func (s *SignatureBatch) Join(set *SignatureBatch) *SignatureBatch
- func (s *SignatureBatch) RemoveDuplicates() (int, *SignatureBatch, error)
- func (s *SignatureBatch) Verify() (bool, error)
- func (s *SignatureBatch) VerifyVerbosely() (bool, error)
Constants ¶
const AggregatedSignature = "bls aggregated signature"
AggregatedSignature represents aggregated signature produced by AggregateBatch()
const CurveOrder = "52435875175126190479447740508185965837690552500527637822603658699938581184513"
CurveOrder for the BLS12-381 curve.
const DomainByteLength = 4
DomainByteLength length of domain byte array.
Variables ¶
This section is empty.
Functions ¶
func AggregateCompressedSignatures ¶
AggregateCompressedSignatures converts a list of compressed signatures into a single, aggregated sig.
func AggregateSignatures ¶
AggregateSignatures converts a list of signatures into a single, aggregated sig.
func NewAggregateSignature ¶
NewAggregateSignature creates a blank aggregate signature.
Types ¶
type PublicKey ¶
PublicKey represents a BLS public key.
func AggregateMultiplePubkeys ¶
AggregateMultiplePubkeys aggregates the provided decompressed keys into a single key.
func AggregatePublicKeys ¶
AggregatePublicKeys aggregates the provided raw public keys into a single key.
func PublicKeyFromBytes ¶
PublicKeyFromBytes creates a BLS public key from a BigEndian byte slice.
type SecretKey ¶
SecretKey represents a BLS secret or private key.
func SecretKeyFromBytes ¶
SecretKeyFromBytes creates a BLS private key from a BigEndian byte slice.
type Signature ¶
Signature represents a BLS signature.
func MultipleSignaturesFromBytes ¶
MultipleSignaturesFromBytes creates a slice of BLS signatures from a LittleEndian 2d-byte slice.
func SignatureFromBytes ¶
SignatureFromBytes creates a BLS signature from a LittleEndian byte slice.
func SignatureFromBytesNoValidation ¶
SignatureFromBytesNoValidation creates a BLS signature from a LittleEndian byte slice. It does not check validity of the signature, use only when the byte slice has already been verified
type SignatureBatch ¶
type SignatureBatch struct {
Signatures [][]byte
PublicKeys []PublicKey
Messages [][32]byte
Descriptions []string
}
SignatureBatch refers to the defined set of signatures and its respective public keys and messages required to verify it.
func (*SignatureBatch) AggregateBatch ¶
func (s *SignatureBatch) AggregateBatch() (*SignatureBatch, error)
AggregateBatch aggregates common messages in the provided batch to reduce the number of pairings required when we finally verify the whole batch.
func (*SignatureBatch) Copy ¶
func (s *SignatureBatch) Copy() *SignatureBatch
Copy the attached signature batch and return it to the caller.
func (*SignatureBatch) Join ¶
func (s *SignatureBatch) Join(set *SignatureBatch) *SignatureBatch
Join merges the provided signature batch to out current one.
func (*SignatureBatch) RemoveDuplicates ¶
func (s *SignatureBatch) RemoveDuplicates() (int, *SignatureBatch, error)
RemoveDuplicates removes duplicate signature sets from the signature batch.
func (*SignatureBatch) Verify ¶
func (s *SignatureBatch) Verify() (bool, error)
Verify the current signature batch using the batch verify algorithm.
func (*SignatureBatch) VerifyVerbosely ¶
func (s *SignatureBatch) VerifyVerbosely() (bool, error)
VerifyVerbosely verifies signatures as a whole at first, if fails, fallback to verify each single signature to identify invalid ones.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package blst implements a go-wrapper around a library implementing the BLS12-381 curve and signature scheme.
|
Package blst implements a go-wrapper around a library implementing the BLS12-381 curve and signature scheme. |
|
Package common provides the BLS interfaces that are implemented by the various BLS wrappers.
|
Package common provides the BLS interfaces that are implemented by the various BLS wrappers. |
|
mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |