shcrypto

package
v0.1.6 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 16, 2021 License: MIT Imports: 10 Imported by: 13

Documentation

Index

Constants

View Source 
const BlockSize = 32

BlockSize is the size in bytes of the blocks into which a message is split up before encryption.

Variables

View Source 
var G1Comparer = gocmp.Comparer(EqualG1)
View Source 
var G2Comparer = gocmp.Comparer(EqualG2)
View Source 
var GTComparer = gocmp.Comparer(EqualGT)

Functions

func BLSVerify added in v0.1.6 

func BLSVerify(sig BLSSignature, publicKey BLSPublicKey, msg []byte) bool

BLSVerify checks that a signature over a certain message was created with the secret key corresponding to the given public key.

func DegreeFromThreshold 

func DegreeFromThreshold(threshold uint64) uint64

DegreeFromThreshold returns the degree polynomials should have for the given threshold.

func EqualG1 

func EqualG1(p1, p2 *bn256.G1) bool

EqualG1 checks if two points on G1 are equal.

func EqualG2 

func EqualG2(p1, p2 *bn256.G2) bool

EqualG2 checks if two points on G2 are equal.

func EqualGT 

func EqualGT(p1, p2 *bn256.GT) bool

EqualGT checks if two points on GT are equal.

func HashBlockToInt 

func HashBlockToInt(d Block) *big.Int

HashBlockToInt hashes a block and returns the result as an integer in Z_q.

func KeyperX 

func KeyperX(keyperIndex int) *big.Int

KeyperX computes the x value assigned to the keyper identified by its index.

func RandomBLSKeyPair added in v0.1.6 

func RandomBLSKeyPair(r io.Reader) (BLSSecretKey, BLSPublicKey, error)

RandomBLSKeyPair generates a random BLS secret and corresponding public key.

func Shuffle 

func Shuffle(txs [][]byte, key *EpochSecretKey) [][]byte

Shuffle shuffles the order of the transactions using the epoch secret key as a source of randomness.

func UnpadMessage 

func UnpadMessage(blocks []Block) ([]byte, error)

UnpadMessage returns the message provided in padded form as a sequence of blocks.

func ValidEval 

func ValidEval(v *big.Int) bool

ValidEval checks if the given value is a valid polynomial evaluation, i.e., if it is in Z_q.

func VerifyEpochSecretKeyShare 

func VerifyEpochSecretKeyShare(epochSecretKeyShare *EpochSecretKeyShare, eonPublicKeyShare *EonPublicKeyShare, epochID *EpochID) bool

VerifyEpochSecretKeyShare checks that an epoch sk share published by a keyper is correct.

func VerifyPolyEval 

func VerifyPolyEval(keyperIndex int, polyEval *big.Int, gammas *Gammas, threshold uint64) bool

VerifyPolyEval checks that the evaluation of a polynomial is consistent with the public gammas.

Types

type BLSPublicKey added in v0.1.6 

type BLSPublicKey *bn256.G1

func BLSAggregatePublicKeys added in v0.1.6 

func BLSAggregatePublicKeys(publicKeys []BLSPublicKey) BLSPublicKey

BLSAggregatePublicKeys aggregates a set of BLS public keys into one.

func BLSSecretToPublicKey added in v0.1.6 

func BLSSecretToPublicKey(secretKey BLSSecretKey) BLSPublicKey

BLSSecretToPublicKey returns the BLS public key corresponding to the given secret key.

type BLSSecretKey added in v0.1.6 

type BLSSecretKey *big.Int

type BLSSignature added in v0.1.6 

type BLSSignature *bn256.G2

func BLSAggregateSignatures added in v0.1.6 

func BLSAggregateSignatures(sigs []BLSSignature) BLSSignature

BLSAggregateSignatures aggregates a set of BLS signatures into one.

func BLSSign added in v0.1.6 

func BLSSign(msg []byte, secretKey BLSSecretKey) BLSSignature

BLSSign creates a signature over a message using a secret key.

type Block 

type Block [BlockSize]byte

Block represents a block of data.

func HashBytesToBlock 

func HashBytesToBlock(d ...[]byte) Block

HashBytesToBlock hashes the given byte slice and returns the result as a block.

func HashGTToBlock 

func HashGTToBlock(gt *bn256.GT) Block

HashGTToBlock hashes an element of GT and returns the result as a block.

func PadMessage 

func PadMessage(m []byte) []Block

PadMessage pads a message and returns it as a sequence of blocks. Implements PKCS #7 according to https://www.ietf.org/rfc/rfc2315.txt

func RandomSigma 

func RandomSigma(r io.Reader) (Block, error)

RandomSigma returns a random value to be used during encryption.

func XORBlocks 

func XORBlocks(b1 Block, b2 Block) Block

XORBlocks xors the two blocks and returns the result.

type EncryptedMessage 

type EncryptedMessage struct {
	C1 *bn256.G2
	C2 Block
	C3 []Block
}

EncryptedMessage represents the full output of the encryption procedure.

func Encrypt 

func Encrypt(message []byte, eonPublicKey *EonPublicKey, epochID *EpochID, sigma Block) *EncryptedMessage

Encrypt encrypts a message for the epoch given by its id. It uses the eon public key and randomness provided in sigma.

func (*EncryptedMessage) Decrypt 

func (m *EncryptedMessage) Decrypt(epochSecretKey *EpochSecretKey) ([]byte, error)

Decrypt decrypts the given message using the given epoch secret key.

func (*EncryptedMessage) Marshal 

func (m *EncryptedMessage) Marshal() []byte

Marshal serializes the EncryptedMessage object. It panics, if C1 is nil.

func (*EncryptedMessage) Sigma 

func (m *EncryptedMessage) Sigma(epochSecretKey *EpochSecretKey) Block

Sigma computes the sigma value of the encrypted message given the epoch secret key.

func (*EncryptedMessage) Unmarshal 

func (m *EncryptedMessage) Unmarshal(d []byte) error

Unmarshal deserializes an EncryptedMessage from the given byte slice.

type EonPublicKey 

type EonPublicKey bn256.G2

EonPublicKey represents the combined eon public key.

func ComputeEonPublicKey 

func ComputeEonPublicKey(gammas []*Gammas) *EonPublicKey

ComputeEonPublicKey computes the combined eon public key from the set of eon public key shares.

func (*EonPublicKey) Equal 

func (eonpubkey *EonPublicKey) Equal(pk2 *EonPublicKey) bool

func (*EonPublicKey) GobDecode 

func (eonpubkey *EonPublicKey) GobDecode(data []byte) error

func (*EonPublicKey) GobEncode 

func (eonpubkey *EonPublicKey) GobEncode() ([]byte, error)

func (*EonPublicKey) Marshal 

func (eonpubkey *EonPublicKey) Marshal() []byte

Marshal serialized the eon public key.

func (*EonPublicKey) Unmarshal 

func (eonpubkey *EonPublicKey) Unmarshal(m []byte) error

Unmarshal deserializes an eon public key from the given byte slice.

type EonPublicKeyShare 

type EonPublicKeyShare bn256.G2

EonPublicKeyShare represents a share of the eon public key.

func ComputeEonPublicKeyShare 

func ComputeEonPublicKeyShare(keyperIndex int, gammas []*Gammas) *EonPublicKeyShare

ComputeEonPublicKeyShare computes the eon public key share of the given keyper.

func (*EonPublicKeyShare) Equal 

func (g2 *EonPublicKeyShare) Equal(pk2 *EonPublicKeyShare) bool

func (*EonPublicKeyShare) GobDecode 

func (g2 *EonPublicKeyShare) GobDecode(data []byte) error

func (*EonPublicKeyShare) GobEncode 

func (g2 *EonPublicKeyShare) GobEncode() ([]byte, error)

type EonSecretKeyShare 

type EonSecretKeyShare big.Int

EonSecretKeyShare represents a share of the eon secret key.

func ComputeEonSecretKeyShare 

func ComputeEonSecretKeyShare(polyEvals []*big.Int) *EonSecretKeyShare

ComputeEonSecretKeyShare computes the keyper's secret key share from the set of poly evals received from the other keypers.

func (*EonSecretKeyShare) Equal 

func (esks *EonSecretKeyShare) Equal(e2 *EonSecretKeyShare) bool

func (*EonSecretKeyShare) GobDecode 

func (esks *EonSecretKeyShare) GobDecode(data []byte) error

func (*EonSecretKeyShare) GobEncode 

func (esks *EonSecretKeyShare) GobEncode() ([]byte, error)

type EpochID 

type EpochID bn256.G1

EpochID is the identifier of an epoch.

func ComputeEpochID 

func ComputeEpochID(epochIndex uint64) *EpochID

ComputeEpochID computes the id of the given epoch.

func (*EpochID) Equal 

func (g *EpochID) Equal(g2 *EpochID) bool

func (*EpochID) GobDecode 

func (g *EpochID) GobDecode(data []byte) error

func (*EpochID) GobEncode 

func (g *EpochID) GobEncode() ([]byte, error)

type EpochSecretKey 

type EpochSecretKey bn256.G1

EpochSecretKey represents an epoch secret key.

func ComputeEpochSecretKey 

func ComputeEpochSecretKey(keyperIndices []int, epochSecretKeyShares []*EpochSecretKeyShare, threshold uint64) (*EpochSecretKey, error)

ComputeEpochSecretKey computes the epoch secret key from a set of shares.

func (*EpochSecretKey) Equal 

func (g *EpochSecretKey) Equal(g2 *EpochSecretKey) bool

func (*EpochSecretKey) GobDecode 

func (g *EpochSecretKey) GobDecode(data []byte) error

func (*EpochSecretKey) GobEncode 

func (g *EpochSecretKey) GobEncode() ([]byte, error)

type EpochSecretKeyShare 

type EpochSecretKeyShare bn256.G1

EpochSecretKeyShare represents a keyper's share of the epoch sk key.

func ComputeEpochSecretKeyShare 

func ComputeEpochSecretKeyShare(eonSecretKeyShare *EonSecretKeyShare, epochID *EpochID) *EpochSecretKeyShare

ComputeEpochSecretKeyShare computes a keyper's epoch sk share.

func (*EpochSecretKeyShare) Equal 

func (g *EpochSecretKeyShare) Equal(g2 *EpochSecretKeyShare) bool

func (*EpochSecretKeyShare) GobDecode 

func (g *EpochSecretKeyShare) GobDecode(data []byte) error

func (*EpochSecretKeyShare) GobEncode 

func (g *EpochSecretKeyShare) GobEncode() ([]byte, error)

type Gammas 

type Gammas []*bn256.G2

Gammas is a sequence of G2 points based on a polynomial.

func ZeroGammas 

func ZeroGammas(degree uint64) *Gammas

ZeroGammas returns the zero value for gammas.

func (*Gammas) Degree 

func (g *Gammas) Degree() uint64

Degree returns the degree of the underlying polynomial.

func (Gammas) Equal 

func (g Gammas) Equal(g2 Gammas) bool

func (*Gammas) GobDecode 

func (g *Gammas) GobDecode(data []byte) error

GobDecode decodes a Gammas value. See https://golang.org/pkg/encoding/gob/#GobDecoder

func (*Gammas) GobEncode 

func (g *Gammas) GobEncode() ([]byte, error)

GobEncode encodes a Gammas value. See https://golang.org/pkg/encoding/gob/#GobEncoder

func (*Gammas) Pi 

func (g *Gammas) Pi(xi *big.Int) *bn256.G2

Pi computes the pi value at the given x coordinate.

type Polynomial 

type Polynomial []*big.Int

Polynomial represents a polynomial over Z_q.

func NewPolynomial 

func NewPolynomial(coefficients []*big.Int) (*Polynomial, error)

NewPolynomial creates a new polynomial from the given coefficients. It verifies the number and range of them.

func RandomPolynomial 

func RandomPolynomial(r io.Reader, degree uint64) (*Polynomial, error)

RandomPolynomial generates a random polynomial of given degree.

func (*Polynomial) Degree 

func (p *Polynomial) Degree() uint64

Degree returns the degree of the polynomial.

func (*Polynomial) Eval 

func (p *Polynomial) Eval(x *big.Int) *big.Int

Eval evaluates the polynomial at the given coordinate.

func (*Polynomial) EvalForKeyper 

func (p *Polynomial) EvalForKeyper(keyperIndex int) *big.Int

EvalForKeyper evaluates the polynomial at the position designated for the given keyper.

func (*Polynomial) Gammas 

func (p *Polynomial) Gammas() *Gammas

Gammas computes the gamma values for a given polynomial.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.