types

package
v0.0.0-...-bcff216 Latest Latest
Warning

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

 Go to latest Published: Jul 28, 2020 License: MIT Imports: 18 Imported by: 0

Documentation

Overview

Package types defines the types used by go-libonomy consensus algorithms and structs

Index

Constants

View Source 
const (
	// AddressLength is the expected length of the address
	AddressLength = 20
)
View Source 
const (
	// Hash32Length is 32, the expected length of the hash
	Hash32Length = 32
)

Variables

View Source 
var (
	Big1   = big.NewInt(1)
	Big2   = big.NewInt(2)
	Big3   = big.NewInt(3)
	Big0   = big.NewInt(0)
	Big32  = big.NewInt(32)
	Big256 = big.NewInt(256)
	Big257 = big.NewInt(257)
)

Common big integers often used

View Source 
var EmptyTransactionID = TransactionID{}

EmptyTransactionID is a canonical empty TransactionID.

Functions

func BlockIdsAsBytes 

func BlockIdsAsBytes(ids []BlockID) ([]byte, error)

BlockIdsAsBytes serializes a slice of BlockIDs.

func BytesToInterface 

func BytesToInterface(buf []byte, i interface{}) error

BytesToInterface deserializes any type. ⚠️ Pass the interface by reference

func InterfaceToBytes 

func InterfaceToBytes(i interface{}) ([]byte, error)

InterfaceToBytes serializes any type. ⚠️ Pass the interface by reference

Types

type Address 

type Address [AddressLength]byte

Address represents the 20 byte address of an libonomy account.

func BigToAddress 

func BigToAddress(b *big.Int) Address

BigToAddress returns Address with byte values of b. If b is larger than len(h), b will be cropped from the left.

func BytesToAddress 

func BytesToAddress(b []byte) Address

BytesToAddress returns Address with value b. If b is larger than len(h), b will be cropped from the left.

func HexToAddress 

func HexToAddress(s string) Address

HexToAddress returns Address with byte values of s. If s is larger than len(h), s will be cropped from the left.

func StringToAddress 

func StringToAddress(s string) (Address, error)

StringToAddress returns Address with byte values of s. If s is larger than len(h), s will be cropped from the left. It is identical to HexToAddress, except decoding errors are returned instead of swallowed.

func (Address) Big 

func (a Address) Big() *big.Int

Big converts an address to a big integer.

func (Address) Bytes 

func (a Address) Bytes() []byte

Bytes gets the string representation of the underlying address.

func (Address) Format 

func (a Address) Format(s fmt.State, c rune)

Format implements fmt.Formatter, forcing the byte slice to be formatted as is, without going through the stringer interface used for logging.

func (Address) Hash 

func (a Address) Hash() Hash32

Hash converts an address to a hash by left-padding it with zeros.

func (Address) Hex 

func (a Address) Hex() string

Hex returns an EIP55-compliant hex string representation of the address.

func (*Address) SetBytes 

func (a *Address) SetBytes(b []byte)

SetBytes sets the address to the value of b. If b is larger than len(a) it will panic.

func (Address) Short 

func (a Address) Short() string

Short returns the first 7 characters of the address hex representation (incl. "0x"), for logging purposes.

func (Address) String 

func (a Address) String() string

String implements fmt.Stringer.

type Block 

type Block struct {
	MiniBlock

	Signature []byte
	// contains filtered or unexported fields
}

Block includes all of a block's fields, including signature and a cache of the BlockID and MinerID.

func NewExistingBlock 

func NewExistingBlock(layerIndex LayerID, data []byte) *Block

NewExistingBlock returns a block in the given layer with the given arbitrary data. The block is signed with a random keypair that isn't stored anywhere. This method should be phased out of use in production code (it's currently used in tests and the temporary genesis flow).

func SortBlocks 

func SortBlocks(ids []*Block) []*Block

SortBlocks sorts a list of Blocks in lexicographic order of their IDs, in-place.

func (*Block) Bytes 

func (b *Block) Bytes() []byte

Bytes returns the serialization of the MiniBlock.

func (Block) Hash32 

func (b Block) Hash32() Hash32

Hash32 returns a Hash32 whose first 20 bytes are the bytes of this BlockID, it is right-padded with zeros. This implements the sync.item interface.

func (*Block) ID 

func (b *Block) ID() BlockID

ID returns the BlockID.

func (*Block) Initialize 

func (b *Block) Initialize()

Initialize calculates and sets the block's cached ID and MinerID. This should be called once all the other fields of the block are set.

func (*Block) MinerID 

func (b *Block) MinerID() *signing.PublicKey

MinerID returns this block's miner's Edwards public key.

func (Block) ShortString 

func (b Block) ShortString() string

ShortString returns a the first 5 characters of the ID, for logging purposes.

type BlockEligibilityProof 

type BlockEligibilityProof struct {
	// J is the counter value used to generate this eligibility proof. Each value of J must only be used once.
	J uint32

	// Sig is the VRF signature from which the block's LayerID is derived.
	Sig []byte
}

BlockEligibilityProof includes the required values that, along with the miner's VRF public key, allow non-interactive block eligibility validation.

type BlockHeader 

type BlockHeader struct {
	LayerIndex LayerID
	// ATXID            ATXID
	EligibilityProof BlockEligibilityProof
	Data             []byte
	Coin             bool
	Timestamp        int64
	BlockVotes       []BlockID
	ViewEdges        []BlockID
}

BlockHeader includes all of a block's fields, except the list of transaction IDs, activation transaction IDs and the signature. TODO: consider combining this with MiniBlock, since this type isn't used independently anywhere.

func (*BlockHeader) AddView 

func (b *BlockHeader) AddView(id BlockID)

AddView adds a block to this block's view.

func (*BlockHeader) AddVote 

func (b *BlockHeader) AddVote(id BlockID)

AddVote adds a vote to the list of block votes.

func (BlockHeader) Layer 

func (b BlockHeader) Layer() LayerID

Layer returns the block's LayerID.

type BlockID 

type BlockID Hash20

BlockID is a 20-byte sha256 sum of the serialized block, used to identify it.

func BlockIDs 

func BlockIDs(blocks []*Block) []BlockID

BlockIDs returns a slice of BlockIDs corresponding to the given blocks.

func BytesToBlockIds 

func BytesToBlockIds(blockIds []byte) ([]BlockID, error)

BytesToBlockIds deserializes a slice of BlockIDs.

func SortBlockIDs 

func SortBlockIDs(ids []BlockID) []BlockID

SortBlockIDs sorts a list of BlockIDs in lexicographic order, in-place.

func (BlockID) AsHash32 

func (id BlockID) AsHash32() Hash32

AsHash32 returns a Hash32 whose first 20 bytes are the bytes of this BlockID, it is right-padded with zeros.

func (BlockID) Compare 

func (id BlockID) Compare(other BlockID) bool

Compare returns true if other (the given BlockID) is less than this BlockID, by lexicographic comparison.

func (BlockID) Field 

func (id BlockID) Field() log.Field

Field returns a log field. Implements the LoggableField interface.

func (BlockID) String 

func (id BlockID) String() string

String returns the 5-character prefix of the hex representation of the ID.

func (BlockID) ToBytes 

func (id BlockID) ToBytes() []byte

ToBytes returns the BlockID as a byte slice.

type DoubleCache 

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

DoubleCache is a structure for storing which keys have been encountered before. It's initialized with a size and it stores between size and 2*size keys. Every time the cache size reaches 2*size and a new value is added, the oldest size keys are discarded and the size drops back to size. DoubleCache is thread safe.

func NewDoubleCache 

func NewDoubleCache(size uint) *DoubleCache

NewDoubleCache returns a new DoubleCache.

func (*DoubleCache) GetOrInsert 

func (a *DoubleCache) GetOrInsert(key Hash12) bool

GetOrInsert checks if a value is already in the cache, otherwise it adds it. Returns bool whether or not the value was found in the cache (true - already in cache, false - wasn't in cache before this was called).

type Hash12 

type Hash12 [hash12Length]byte

Hash12 represents the first 12 bytes of sha256, mostly used for internal caches

func CalcBlocksHash12 

func CalcBlocksHash12(view []BlockID) (h Hash12)

CalcBlocksHash12 returns the 12-byte sha256 sum of the block IDs, sorted in lexicographic order.

func CalcHash12 

func CalcHash12(data []byte) (h Hash12)

CalcHash12 returns the 12-byte prefix of the sha256 sum of the given byte slice.

func CalcMessageHash12 

func CalcMessageHash12(msg []byte, protocol string) Hash12

CalcMessageHash12 returns the 12-byte sha256 sum of the given msg suffixed with protocol.

func (Hash12) Field 

func (h Hash12) Field(name string) log.Field

Field returns a log field. Implements the LoggableField interface.

type Hash20 

type Hash20 [hash20Length]byte

Hash20 represents the 20-byte sha256 hash of arbitrary data.

func (Hash20) Big 

func (h Hash20) Big() *big.Int

Big converts a hash to a big integer.

func (Hash20) Bytes 

func (h Hash20) Bytes() []byte

Bytes gets the byte representation of the underlying hash.

func (Hash20) Field 

func (h Hash20) Field(name string) log.Field

Field returns a log field. Implements the LoggableField interface.

func (Hash20) Format 

func (h Hash20) Format(s fmt.State, c rune)

Format implements fmt.Formatter, forcing the byte slice to be formatted as is, without going through the stringer interface used for logging.

func (Hash20) Hex 

func (h Hash20) Hex() string

Hex converts a hash to a hex string.

func (Hash20) MarshalText 

func (h Hash20) MarshalText() ([]byte, error)

MarshalText returns the hex representation of h.

func (*Hash20) SetBytes 

func (h *Hash20) SetBytes(b []byte)

SetBytes sets the hash to the value of b. If b is larger than len(h), b will be cropped from the left.

func (Hash20) ShortString 

func (h Hash20) ShortString() string

ShortString returns a the first 5 characters of the hash, for logging purposes.

func (Hash20) String 

func (h Hash20) String() string

String implements the stringer interface and is used also by the logger when doing full logging into a file.

func (Hash20) ToHash32 

func (h Hash20) ToHash32() (h32 Hash32)

ToHash32 returns a Hash32 whose first 20 bytes are the bytes of this Hash20, it is right-padded with zeros.

func (*Hash20) UnmarshalJSON 

func (h *Hash20) UnmarshalJSON(input []byte) error

UnmarshalJSON parses a hash in hex syntax.

func (*Hash20) UnmarshalText 

func (h *Hash20) UnmarshalText(input []byte) error

UnmarshalText parses a hash in hex syntax.

type Hash32 

type Hash32 [Hash32Length]byte

Hash32 represents the 32-byte sha256 hash of arbitrary data.

func BytesToHash 

func BytesToHash(b []byte) Hash32

BytesToHash sets b to hash. If b is larger than len(h), b will be cropped from the left.

func CalcBlockHash32Presorted 

func CalcBlockHash32Presorted(sortedView []BlockID, additionalBytes []byte) Hash32

CalcBlockHash32Presorted returns the 32-byte sha256 sum of the block IDs, in the order given. The pre-image is prefixed with additionalBytes.

func CalcBlocksHash32 

func CalcBlocksHash32(view []BlockID, additionalBytes []byte) Hash32

CalcBlocksHash32 returns the 32-byte sha256 sum of the block IDs, sorted in lexicographic order. The pre-image is prefixed with additionalBytes.

func CalcHash32 

func CalcHash32(data []byte) Hash32

CalcHash32 returns the 32-byte sha256 sum of the given data.

func HexToHash32 

func HexToHash32(s string) Hash32

HexToHash32 sets byte representation of s to hash. If b is larger than len(h), b will be cropped from the left.

func (Hash32) Bytes 

func (h Hash32) Bytes() []byte

Bytes gets the byte representation of the underlying hash.

func (Hash32) Field 

func (h Hash32) Field(name string) log.Field

Field returns a log field. Implements the LoggableField interface.

func (Hash32) Format 

func (h Hash32) Format(s fmt.State, c rune)

Format implements fmt.Formatter, forcing the byte slice to be formatted as is, without going through the stringer interface used for logging.

func (Hash32) Generate 

func (h Hash32) Generate(rand *rand.Rand, _ int) reflect.Value

Generate implements testing/quick.Generator.

func (Hash32) Hex 

func (h Hash32) Hex() string

Hex converts a hash to a hex string.

func (Hash32) MarshalText 

func (h Hash32) MarshalText() ([]byte, error)

MarshalText returns the hex representation of h.

func (*Hash32) Scan 

func (h *Hash32) Scan(src interface{}) error

Scan implements Scanner for database/sql.

func (*Hash32) SetBytes 

func (h *Hash32) SetBytes(b []byte)

SetBytes sets the hash to the value of b. If b is larger than len(h), b will be cropped from the left.

func (Hash32) ShortString 

func (h Hash32) ShortString() string

ShortString returns a the first 5 characters of the hash, for logging purposes.

func (Hash32) String 

func (h Hash32) String() string

String implements the stringer interface and is used also by the logger when doing full logging into a file.

func (Hash32) ToHash20 

func (h Hash32) ToHash20() (h20 Hash20)

ToHash20 returns a Hash20, whose the 20-byte prefix of this Hash32.

func (*Hash32) UnmarshalJSON 

func (h *Hash32) UnmarshalJSON(input []byte) error

UnmarshalJSON parses a hash in hex syntax.

func (*Hash32) UnmarshalText 

func (h *Hash32) UnmarshalText(input []byte) error

UnmarshalText parses a hash in hex syntax.

type InnerTransaction 

type InnerTransaction struct {
	AccountNonce uint64
	Recipient    Address
	GasLimit     uint64
	Fee          uint64
	Amount       uint64
}

InnerTransaction includes all of a transaction's fields, except the signature (origin and id aren't stored).

type Layer 

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

Layer contains a list of blocks and their corresponding LayerID.

func NewExistingLayer 

func NewExistingLayer(idx LayerID, blocks []*Block) *Layer

NewExistingLayer returns a new layer with the given list of blocks without validation.

func NewLayer 

func NewLayer(layerIndex LayerID) *Layer

NewLayer returns a layer with no blocks.

func (*Layer) AddBlock 

func (l *Layer) AddBlock(block *Block)

AddBlock adds a block to this layer. Panics if the block's index doesn't match the layer.

func (*Layer) Blocks 

func (l *Layer) Blocks() []*Block

Blocks returns the list of blocks in this layer.

func (Layer) Hash 

func (l Layer) Hash() Hash32

Hash returns the 32-byte sha256 sum of the block IDs in this layer, sorted in lexicographic order.

func (*Layer) Index 

func (l *Layer) Index() LayerID

Index returns the layer's ID.

func (*Layer) SetBlocks 

func (l *Layer) SetBlocks(blocks []*Block)

SetBlocks sets the list of blocks for the layer without validation.

type LayerID 

type LayerID uint64

LayerID is a uint64 representing a layer number. It is zero-based.

func (LayerID) Add 

func (l LayerID) Add(layers uint16) LayerID

Add returns the LayerID that's layers (the param passed into this method) after l (this LayerID).

func (LayerID) Field 

func (l LayerID) Field() log.Field

Field returns a log field. Implements the LoggableField interface.

func (LayerID) ToBytes 

func (l LayerID) ToBytes() []byte

ToBytes returns the byte representation of the LayerID, using little endian encoding.

func (LayerID) Uint64 

func (l LayerID) Uint64() uint64

Uint64 returns the LayerID as a uint64.

type MiniBlock 

type MiniBlock struct {
	BlockHeader
	TxIDs []TransactionID
}

MiniBlock includes all of a block's fields, except for the signature. This structure is serialized and signed to produce the block signature.

type NodeID 

type NodeID struct {
	// Key is the miner's Edwards public key
	Key string

	// VRFPublicKey is the miner's public key used for VRF. The VRF scheme used is BLS.
	VRFPublicKey []byte
}

NodeID contains a miner's two public keys.

func (NodeID) Field 

func (id NodeID) Field() log.Field

Field returns a log field. Implements the LoggableField interface.

func (NodeID) ShortString 

func (id NodeID) ShortString() string

ShortString returns a the first 5 characters of the ID, for logging purposes.

func (NodeID) String 

func (id NodeID) String() string

String returns a string representation of the NodeID, for logging purposes. It implements the Stringer interface.

func (NodeID) ToBytes 

func (id NodeID) ToBytes() []byte

ToBytes returns the byte representation of the Edwards public key.

type Reward 

type Reward struct {
	Layer               LayerID
	TotalReward         uint64
	LayerRewardEstimate uint64
}

Reward is a virtual reward transaction, which the node keeps track of for the gRPC api.

type StorageSize 

type StorageSize float64

StorageSize is a wrapper around a float value that supports user friendly formatting.

func (StorageSize) String 

func (s StorageSize) String() string

String implements the stringer interface.

func (StorageSize) TerminalString 

func (s StorageSize) TerminalString() string

TerminalString implements log.TerminalStringer, formatting a string for console output during logging.

type Transaction 

type Transaction struct {
	InnerTransaction
	Signature [64]byte
	// contains filtered or unexported fields
}

Transaction contains all transaction fields, including the signature and cached origin address and transaction ID.

func BytesAsTransaction 

func BytesAsTransaction(buf []byte) (*Transaction, error)

BytesAsTransaction deserializes a Transaction.

func (*Transaction) CalcAndSetOrigin 

func (t *Transaction) CalcAndSetOrigin() error

CalcAndSetOrigin extracts the public key from the transaction's signature and caches it as the transaction's origin address.

func (*Transaction) Hash32 

func (t *Transaction) Hash32() Hash32

Hash32 returns the TransactionID as a Hash32.

func (*Transaction) ID 

func (t *Transaction) ID() TransactionID

ID returns the transaction's ID. If it's not cached, it's calculated, cached and returned.

func (*Transaction) Origin 

func (t *Transaction) Origin() Address

Origin returns the transaction's origin address: the public key extracted from the transaction signature.

func (*Transaction) SetOrigin 

func (t *Transaction) SetOrigin(origin Address)

SetOrigin sets the cache of the transaction's origin address.

func (*Transaction) ShortString 

func (t *Transaction) ShortString() string

ShortString returns a the first 5 characters of the ID, for logging purposes.

func (*Transaction) String 

func (t *Transaction) String() string

String returns a string representation of the Transaction, for logging purposes. It implements the fmt.Stringer interface.

type TransactionID 

type TransactionID Hash32

TransactionID is a 32-byte sha256 sum of the transaction, used as an identifier.

func (TransactionID) Bytes 

func (id TransactionID) Bytes() []byte

Bytes returns the TransactionID as a byte slice.

func (TransactionID) Field 

func (id TransactionID) Field() log.Field

Field returns a log field. Implements the LoggableField interface.

func (TransactionID) Hash32 

func (id TransactionID) Hash32() Hash32

Hash32 returns the TransactionID as a Hash32.

func (TransactionID) ShortString 

func (id TransactionID) ShortString() string

ShortString returns a the first 5 characters of the ID, for logging purposes.

func (TransactionID) String 

func (id TransactionID) String() string

String returns a hexadecimal representation of the TransactionID with "0x" prepended, for logging purposes. It implements the fmt.Stringer interface.

type TryMutex 

type TryMutex struct {
	sync.Mutex
}

TryMutex is a simple sync.Mutex with the ability to try to Lock.

func (*TryMutex) TryLock 

func (m *TryMutex) TryLock() bool

TryLock tries to lock m. It returns true in case of success, false otherwise.

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.