tcrypto

Documentation

Overview

Package tcrypto stands for Threshold Cryptography. It provides a structure for storing a distributed key share and several high level functions to work with it.

Distributed key shares are usually generated using a DKG procedure. See the `dkg` package for the generation part. This package provides a way to use them.

Index

• type DKShare
  • func DKShareFromBytes(buf []byte, suite Suite) (*DKShare, error)
  • func NewDKShare(index uint16, n uint16, t uint16, sharedPublic kyber.Point, ...) (*DKShare, error)
  • func (s *DKShare) Bytes() []byte
  • func (s *DKShare) Read(r io.Reader) error
  • func (s *DKShare) RecoverFullSignature(sigShares [][]byte, data []byte) (*bls.SignatureWithPublicKey, error)
  • func (s *DKShare) SignShare(data []byte) (tbls.SigShare, error)
  • func (s *DKShare) VerifyMasterSignature(data, signature []byte) error
  • func (s *DKShare) VerifyOwnSigShare(data []byte, sigshare tbls.SigShare) error
  • func (s *DKShare) VerifySigShare(data []byte, sigshare tbls.SigShare) error
  • func (s *DKShare) Write(w io.Writer) error
• type Suite
  • func DefaultSuite() Suite

Types

type DKShare

type DKShare struct {
	Address       ledgerstate.Address
	Index         *uint16 // nil, if the current node is not a member of a group sharing the key.
	N             uint16
	T             uint16
	SharedPublic  kyber.Point
	PublicCommits []kyber.Point
	PublicShares  []kyber.Point
	PrivateShare  kyber.Scalar
	// contains filtered or unexported fields
}

DKShare stands for the information stored on a node as a result of the DKG procedure.

func DKShareFromBytes

func DKShareFromBytes(buf []byte, suite Suite) (*DKShare, error)

DKShareFromBytes reads DKShare from bytes.

func NewDKShare

func NewDKShare(
	index uint16,
	n uint16,
	t uint16,
	sharedPublic kyber.Point,
	publicCommits []kyber.Point,
	publicShares []kyber.Point,
	privateShare kyber.Scalar,
) (*DKShare, error)

NewDKShare creates new share of the key.

func (*DKShare) Bytes

func (s *DKShare) Bytes() []byte

Bytes returns byte representation of the share.

func (*DKShare) Read

func (s *DKShare) Read(r io.Reader) error

func (*DKShare) RecoverFullSignature

func (s *DKShare) RecoverFullSignature(sigShares [][]byte, data []byte) (*bls.SignatureWithPublicKey, error)

RecoverFullSignature generates (recovers) master signature from partial sigshares. returns signature as defined in the value Tangle

func (*DKShare) SignShare

func (s *DKShare) SignShare(data []byte) (tbls.SigShare, error)

SignShare signs the data with the own key share. returns SigShare, which contains signature and the index

func (*DKShare) VerifyMasterSignature

func (s *DKShare) VerifyMasterSignature(data, signature []byte) error

VerifyMasterSignature checks signature against master public key NOTE: Not used.

func (*DKShare) VerifyOwnSigShare

func (s *DKShare) VerifyOwnSigShare(data []byte, sigshare tbls.SigShare) error

VerifyOwnSigShare is only used for assertions NOTE: Not used.

func (*DKShare) VerifySigShare

func (s *DKShare) VerifySigShare(data []byte, sigshare tbls.SigShare) error

VerifySigShare verifies the signature of a particular share.

func (*DKShare) Write

func (s *DKShare) Write(w io.Writer) error

Write returns byte representation of this struct.

type Suite

type Suite interface {
	kyber.Group
	pairing.Suite
	key.Suite
}

func DefaultSuite

func DefaultSuite() Suite