block

package

v1.11.1 Latest Latest Go to latest Published: Jan 31, 2026 License: MIT Imports: 16 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/pactus-project/pactus

Links

Open Source Insights

Documentation ¶

Index ¶

Variables
type BasicCheckError
- func (e BasicCheckError) Error() string
type Block
type Header
- func NewHeader(version protocol.Version, tme time.Time, stateRoot, prevBlockHash hash.Hash, ...) *Header
type Height
type Txs
- func NewTxs() Txs

Constants ¶

This section is empty.

Variables ¶

View Source

var ErrTooManyTransactions = errors.New("too many transactions in block")

Functions ¶

This section is empty.

Types ¶

type BasicCheckError ¶ added in v0.15.0

type BasicCheckError struct {
	Reason string
}

BasicCheckError is returned when the basic check on the certificate fails.

func (BasicCheckError) Error ¶ added in v0.15.0

func (e BasicCheckError) Error() string

type Block ¶

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

func FromBytes ¶

func FromBytes(data []byte) (*Block, error)

FromBytes constructs a new block from raw byte data.

func FromString ¶ added in v1.11.0

func FromString(str string) (*Block, error)

FromString constructs a new block from a hex-encoded string.

func MakeBlock ¶

func MakeBlock(version protocol.Version, timestamp time.Time, txs Txs,
	prevBlockHash, stateRoot hash.Hash,
	prevCert *certificate.Certificate, sortitionSeed sortition.VerifiableSeed, proposer crypto.Address,
) *Block

func NewBlock ¶

func NewBlock(header *Header, prevCert *certificate.Certificate, txs Txs) *Block

func (*Block) BasicCheck ¶ added in v0.15.0

func (b *Block) BasicCheck() error

BasicCheck performs basic validation checks on the block structure and its contents.

func (*Block) Bytes ¶

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

Bytes returns the serialized bytes for the Block. It caches the result so subsequent calls are more efficient.

func (*Block) Decode ¶

func (b *Block) Decode(r io.Reader) error

func (*Block) Encode ¶

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

func (*Block) Hash ¶

func (b *Block) Hash() hash.Hash

Hash returns the hash of the block. The hash is memorized after the first calculation.

func (b *Block) Header() *Header

func (*Block) Height ¶ added in v1.4.0

func (b *Block) Height() uint32

Height returns the height of the block. TODO: return block.Height type.

func (*Block) LogString ¶ added in v1.11.0

func (b *Block) LogString() string

LogString returns a concise string representation intended for use in logs.

func (*Block) MarshalCBOR ¶

func (b *Block) MarshalCBOR() ([]byte, error)

func (*Block) PrevCertificate ¶

func (b *Block) PrevCertificate() *certificate.Certificate

func (*Block) SerializeSize ¶

func (b *Block) SerializeSize() int

SerializeSize returns the number of bytes it would take to serialize the block.

func (*Block) Transactions ¶

func (b *Block) Transactions() Txs

func (*Block) UnmarshalCBOR ¶

func (b *Block) UnmarshalCBOR(bs []byte) error

type Header ¶

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

func NewHeader ¶

func NewHeader(version protocol.Version, tme time.Time, stateRoot, prevBlockHash hash.Hash,
	sortitionSeed sortition.VerifiableSeed, proposerAddress crypto.Address,
) *Header

func (h *Header) BasicCheck() error

func (h *Header) Decode(r io.Reader) error

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

func (h *Header) PrevBlockHash() hash.Hash

PrevBlockHash returns the previous block hash.

func (h *Header) ProposerAddress() crypto.Address

ProposerAddress returns the proposer address.

func (*Header) SerializeSize() int

SerializeSize returns the number of bytes it would take to serialize the header.

func (h *Header) SortitionSeed() sortition.VerifiableSeed

SortitionSeed returns the sortition seed.

func (h *Header) StateRoot() hash.Hash

StateRoot returns the state root hash.

func (h *Header) Time() time.Time

Time returns the block time.

func (h *Header) UnixTime() uint32

UnixTime returns the block time in Unix value.

func (h *Header) Version() protocol.Version

Version returns the block version.

type Height ¶ added in v1.11.0

type Height uint32

type Txs ¶

type Txs []*tx.Tx

func NewTxs ¶

func NewTxs() Txs

func (*Txs) Append ¶

func (txs *Txs) Append(trx *tx.Tx)

func (Txs) Get ¶

func (txs Txs) Get(i int) *tx.Tx

func (Txs) IsEmpty ¶

func (txs Txs) IsEmpty() bool

func (Txs) Len ¶

func (txs Txs) Len() int

func (*Txs) Prepend ¶

func (txs *Txs) Prepend(trx *tx.Tx)

func (*Txs) Remove ¶

func (txs *Txs) Remove(i int)

func (Txs) Root ¶

func (txs Txs) Root() hash.Hash

func (Txs) Subsidy ¶ added in v1.10.0

func (txs Txs) Subsidy() *tx.Tx

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL