block

Documentation

Index

• func Number(blockID thor.Bytes32) uint32
• type Block
  • func Compose(header *Header, txs tx.Transactions) *Block
  • func (b *Block) Body() *Body
  • func (b *Block) DecodeRLP(s *rlp.Stream) error
  • func (b *Block) EncodeRLP(w io.Writer) error
  • func (b *Block) Header() *Header
  • func (b *Block) Size() metric.StorageSize
  • func (b *Block) String() string
  • func (b *Block) Transactions() tx.Transactions
  • func (b *Block) WithSignature(sig []byte) *Block
• type Body
• type Builder
  • func (b *Builder) Beneficiary(addr thor.Address) *Builder
  • func (b *Builder) Build() *Block
  • func (b *Builder) GasLimit(limit uint64) *Builder
  • func (b *Builder) GasUsed(used uint64) *Builder
  • func (b *Builder) ParentID(id thor.Bytes32) *Builder
  • func (b *Builder) ReceiptsRoot(hash thor.Bytes32) *Builder
  • func (b *Builder) StateRoot(hash thor.Bytes32) *Builder
  • func (b *Builder) Timestamp(ts uint64) *Builder
  • func (b *Builder) TotalScore(score uint64) *Builder
  • func (b *Builder) Transaction(tx *tx.Transaction) *Builder
  • func (b *Builder) TransactionFeatures(features tx.Features) *Builder
• type GasLimit
  • func (gl GasLimit) Adjust(delta int64) uint64
  • func (gl GasLimit) IsValid(parentGasLimit uint64) bool
  • func (gl GasLimit) Qualify(parentGasLimit uint64) uint64
• type Header
  • func (h *Header) Beneficiary() thor.Address
  • func (h *Header) DecodeRLP(s *rlp.Stream) error
  • func (h *Header) EncodeRLP(w io.Writer) error
  • func (h *Header) GasLimit() uint64
  • func (h *Header) GasUsed() uint64
  • func (h *Header) ID() (id thor.Bytes32)
  • func (h *Header) Number() uint32
  • func (h *Header) ParentID() thor.Bytes32
  • func (h *Header) ReceiptsRoot() thor.Bytes32
  • func (h *Header) Signature() []byte
  • func (h *Header) Signer() (signer thor.Address, err error)
  • func (h *Header) SigningHash() (hash thor.Bytes32)
  • func (h *Header) StateRoot() thor.Bytes32
  • func (h *Header) String() string
  • func (h *Header) Timestamp() uint64
  • func (h *Header) TotalScore() uint64
  • func (h *Header) TxsFeatures() tx.Features
  • func (h *Header) TxsRoot() thor.Bytes32
• type Raw
  • func (r Raw) DecodeBody() (*Body, error)
  • func (r Raw) DecodeHeader() (*Header, error)

Functions

func Number

func Number(blockID thor.Bytes32) uint32

Number extract block number from block id.

Types

type Block

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

Block is an immutable block type.

func Compose

func Compose(header *Header, txs tx.Transactions) *Block

Compose compose a block with all needed components Note: This method is usually to recover a block by its portions, and the TxsRoot is not verified. To build up a block, use a Builder.

func (*Block) Body

func (b *Block) Body() *Body

Body returns body of a block.

func (*Block) DecodeRLP

func (b *Block) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder.

func (*Block) EncodeRLP

func (b *Block) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder.

func (*Block) Header

func (b *Block) Header() *Header

Header returns the block header.

func (*Block) Size

func (b *Block) Size() metric.StorageSize

Size returns block size in bytes.

func (*Block) String

func (b *Block) String() string

func (*Block) Transactions

func (b *Block) Transactions() tx.Transactions

Transactions returns a copy of transactions.

func (*Block) WithSignature

func (b *Block) WithSignature(sig []byte) *Block

WithSignature create a new block object with signature set.

type Body

type Body struct {
	Txs tx.Transactions
}

Body defines body of a block.

type Builder

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

Builder to make it easy to build a block object.

func (*Builder) Beneficiary

func (b *Builder) Beneficiary(addr thor.Address) *Builder

Beneficiary set recipient of reward.

func (*Builder) Build

func (b *Builder) Build() *Block

Build build a block object.

func (*Builder) GasLimit

func (b *Builder) GasLimit(limit uint64) *Builder

GasLimit set gas limit.

func (*Builder) GasUsed

func (b *Builder) GasUsed(used uint64) *Builder

GasUsed set gas used.

func (*Builder) ParentID

func (b *Builder) ParentID(id thor.Bytes32) *Builder

ParentID set parent id.

func (*Builder) ReceiptsRoot

func (b *Builder) ReceiptsRoot(hash thor.Bytes32) *Builder

ReceiptsRoot set receipts root.

func (*Builder) StateRoot

func (b *Builder) StateRoot(hash thor.Bytes32) *Builder

StateRoot set state root.

func (*Builder) Timestamp

func (b *Builder) Timestamp(ts uint64) *Builder

Timestamp set timestamp.

func (*Builder) TotalScore

func (b *Builder) TotalScore(score uint64) *Builder

TotalScore set total score.

func (*Builder) Transaction

func (b *Builder) Transaction(tx *tx.Transaction) *Builder

Transaction add a transaction.

func (*Builder) TransactionFeatures

func (b *Builder) TransactionFeatures(features tx.Features) *Builder

TransactionFeatures set supported transaction features

type GasLimit

type GasLimit uint64

GasLimit to support block gas limit validation and adjustment.

func (GasLimit) Adjust

func (gl GasLimit) Adjust(delta int64) uint64

Adjust suppose the receiver is parent gas limit, and calculate a valid gas limit value by apply `delta`.

func (GasLimit) IsValid

func (gl GasLimit) IsValid(parentGasLimit uint64) bool

IsValid returns if the receiver is valid according to parent gas limit.

func (GasLimit) Qualify

func (gl GasLimit) Qualify(parentGasLimit uint64) uint64

Qualify qualify the receiver according to parent gas limit, and returns the qualified gas limit value.

type Header

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

Header contains almost all information about a block, except block body. It's immutable.

func (*Header) Beneficiary

func (h *Header) Beneficiary() thor.Address

Beneficiary returns reward recipient.

func (*Header) DecodeRLP

func (h *Header) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder.

func (*Header) EncodeRLP

func (h *Header) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder

func (*Header) GasLimit

func (h *Header) GasLimit() uint64

GasLimit returns gas limit of this block.

func (*Header) GasUsed

func (h *Header) GasUsed() uint64

GasUsed returns gas used by txs.

func (*Header) ID

func (h *Header) ID() (id thor.Bytes32)

ID computes id of block. The block ID is defined as: blockNumber + hash(signingHash, signer)[4:].

func (*Header) Number

func (h *Header) Number() uint32

Number returns sequential number of this block.

func (*Header) ParentID

func (h *Header) ParentID() thor.Bytes32

ParentID returns id of parent block.

func (*Header) ReceiptsRoot

func (h *Header) ReceiptsRoot() thor.Bytes32

ReceiptsRoot returns merkle root of tx receipts.

func (*Header) Signature

func (h *Header) Signature() []byte

Signature returns signature.

func (*Header) Signer

func (h *Header) Signer() (signer thor.Address, err error)

Signer extract signer of the block from signature.

func (*Header) SigningHash

func (h *Header) SigningHash() (hash thor.Bytes32)

SigningHash computes hash of all header fields excluding signature.

func (*Header) StateRoot

func (h *Header) StateRoot() thor.Bytes32

StateRoot returns account state merkle root just afert this block being applied.

func (*Header) String

func (h *Header) String() string

func (*Header) Timestamp

func (h *Header) Timestamp() uint64

Timestamp returns timestamp of this block.

func (*Header) TotalScore

func (h *Header) TotalScore() uint64

TotalScore returns total score that cumulated from genesis block to this one.

func (*Header) TxsFeatures

func (h *Header) TxsFeatures() tx.Features

TxsFeatures returns supported txs features.

func (*Header) TxsRoot

func (h *Header) TxsRoot() thor.Bytes32

TxsRoot returns merkle root of txs contained in this block.

type Raw

type Raw []byte

Raw allows to partially decode components of a block.

func (Raw) DecodeBody

func (r Raw) DecodeBody() (*Body, error)

DecodeBody decode only the body.

func (Raw) DecodeHeader

func (r Raw) DecodeHeader() (*Header, error)

DecodeHeader decode only the header.