blockchain

Documentation

Index

• func LoadOrNewBlockchain(db dbm.DB, genesisDoc *genesis.GenesisDoc, logger *logging.Logger) (*blockchain, error)
• func NewRoot(genesisDoc *genesis.GenesisDoc) *root
• func NewTip(chainID string, genesisTime time.Time, genesisHash []byte) *tip
• type Blockchain
• type MutableBlockchain
• type PersistedState
  • func Decode(encodedState []byte) (*PersistedState, error)
• type Root
• type Tip

Functions

func LoadOrNewBlockchain

func LoadOrNewBlockchain(db dbm.DB, genesisDoc *genesis.GenesisDoc,
	logger *logging.Logger) (*blockchain, error)

func NewRoot

func NewRoot(genesisDoc *genesis.GenesisDoc) *root

func NewTip

func NewTip(chainID string, genesisTime time.Time, genesisHash []byte) *tip

Create genesis Tip

Types

type Blockchain

type Blockchain interface {
	// Read locker
	sync.Locker
	Root
	Tip
	// Returns an immutable copy of the tip
	Tip() Tip
	// Returns a copy of the current validator set
	Validators() []acm.Validator
}

Burrow's portion of the Blockchain state

type MutableBlockchain

type MutableBlockchain interface {
	Blockchain
	CommitBlock(blockTime time.Time, blockHash, appHash []byte) error
}

type PersistedState

type PersistedState struct {
	AppHashAfterLastBlock []byte
	LastBlockHeight       uint64
	GenesisDoc            genesis.GenesisDoc
}

func Decode

func Decode(encodedState []byte) (*PersistedState, error)

type Root

type Root interface {
	// GenesisHash precomputed from GenesisDoc
	GenesisHash() []byte
	GenesisDoc() genesis.GenesisDoc
}

Immutable Root of blockchain

type Tip

type Tip interface {
	// ChainID precomputed from GenesisDoc
	ChainID() string
	// All Last* references are to the block last committed
	LastBlockHeight() uint64
	LastBlockTime() time.Time
	LastBlockHash() []byte
	// Note this is the hash of the application state after the most recently committed block's transactions executed
	// and so lastBlock.Header.AppHash will be one block older than our AppHashAfterLastBlock (i.e. Tendermint closes
	// the AppHash we return from ABCI Commit into the _next_ block)
	AppHashAfterLastBlock() []byte
}

Immutable pointer to the current tip of the blockchain