prysm-pulse/beacon-chain/blockchain/service.go

// Package blockchain defines the life-cycle and status of the beacon chain.
package blockchain

import (
	"context"
	"errors"
	"fmt"
	"time"

	"github.com/prysmaticlabs/prysm/beacon-chain/powchain"
	"github.com/prysmaticlabs/prysm/beacon-chain/types"
	"github.com/prysmaticlabs/prysm/shared/event"
	"github.com/sirupsen/logrus"
)

var log = logrus.WithField("prefix", "blockchain")

type beaconDB interface {
	GetBlock(h [32]byte) (*types.Block, error)
	GetChainHead() (*types.Block, error)
	GetActiveState() (*types.ActiveState, error)
	GetCrystallizedState() (*types.CrystallizedState, error)
	GetGenesisTime() (time.Time, error)
	HasBlock(h [32]byte) bool
	SaveBlock(block *types.Block) error
	SaveUnfinalizedBlockState(aState *types.ActiveState, cState *types.CrystallizedState) error
	UpdateChainHead(head *types.Block, aState *types.ActiveState, cState *types.CrystallizedState) error
}

// ChainService represents a service that handles the internal
// logic of managing the full PoS beacon chain.
type ChainService struct {
	ctx                            context.Context
	cancel                         context.CancelFunc
	beaconDB                       beaconDB
	web3Service                    *powchain.Web3Service
	incomingBlockFeed              *event.Feed
	incomingBlockChan              chan *types.Block
	processedBlockChan             chan *types.Block
	canonicalBlockFeed             *event.Feed
	canonicalCrystallizedStateFeed *event.Feed
	genesisTime                    time.Time
	unfinalizedBlocks              map[[32]byte]*statePair
	enablePOWChain                 bool
}

// Config options for the service.
type Config struct {
	BeaconBlockBuf   int
	IncomingBlockBuf int
	Web3Service      *powchain.Web3Service
	BeaconDB         beaconDB
	DevMode          bool
	EnablePOWChain   bool
}

// Struct used to represent an unfinalized block's state pair
// (active state, crystallized state) tuple.
type statePair struct {
	crystallizedState *types.CrystallizedState
	activeState       *types.ActiveState
	cycleTransition   bool
}

// NewChainService instantiates a new service instance that will
// be registered into a running beacon node.
func NewChainService(ctx context.Context, cfg *Config) (*ChainService, error) {
	ctx, cancel := context.WithCancel(ctx)
	return &ChainService{
		ctx:                            ctx,
		cancel:                         cancel,
		beaconDB:                       cfg.BeaconDB,
		web3Service:                    cfg.Web3Service,
		incomingBlockChan:              make(chan *types.Block, cfg.IncomingBlockBuf),
		processedBlockChan:             make(chan *types.Block),
		incomingBlockFeed:              new(event.Feed),
		canonicalBlockFeed:             new(event.Feed),
		canonicalCrystallizedStateFeed: new(event.Feed),
		unfinalizedBlocks:              make(map[[32]byte]*statePair),
		enablePOWChain:                 cfg.EnablePOWChain,
	}, nil
}

// Start a blockchain service's main event loop.
func (c *ChainService) Start() {
	log.Info("Starting service")

	var err error
	c.genesisTime, err = c.beaconDB.GetGenesisTime()
	if err != nil {
		log.Fatal(err)
		return
	}

	// TODO(#675): Initialize unfinalizedBlocks map from disk in case this
	// is a beacon node restarting.
	go c.updateHead(c.processedBlockChan)
	go c.blockProcessing(c.processedBlockChan)
}

// Stop the blockchain service's main event loop and associated goroutines.
func (c *ChainService) Stop() error {
	defer c.cancel()

	log.Info("Stopping service")
	return nil
}

// IncomingBlockFeed returns a feed that any service can send incoming p2p blocks into.
// The chain service will subscribe to this feed in order to process incoming blocks.
func (c *ChainService) IncomingBlockFeed() *event.Feed {
	return c.incomingBlockFeed
}

// CanonicalBlockFeed returns a channel that is written to
// whenever a new block is determined to be canonical in the chain.
func (c *ChainService) CanonicalBlockFeed() *event.Feed {
	return c.canonicalBlockFeed
}

// CanonicalCrystallizedStateFeed returns a feed that is written to
// whenever a new crystallized state is determined to be canonical in the chain.
func (c *ChainService) CanonicalCrystallizedStateFeed() *event.Feed {
	return c.canonicalCrystallizedStateFeed
}

// doesPoWBlockExist checks if the referenced PoW block exists.
func (c *ChainService) doesPoWBlockExist(block *types.Block) bool {
	powBlock, err := c.web3Service.Client().BlockByHash(context.Background(), block.PowChainRef())
	if err != nil {
		log.Debugf("fetching PoW block corresponding to mainchain reference failed: %v", err)
		return false
	}

	return powBlock != nil
}

// updateHead applies the fork choice rule to the beacon chain
// at the start of each new slot interval. The function looks
// at an in-memory slice of block hashes pending processing and
// selects the best block according to the in-protocol fork choice
// rule as canonical. This block is then persisted to storage.
func (c *ChainService) updateHead(processedBlock <-chan *types.Block) {
	for {
		select {
		case <-c.ctx.Done():
			return
		case block := <-processedBlock:
			if block == nil {
				continue
			}

			h, err := block.Hash()
			if err != nil {
				log.Errorf("Could not hash incoming block: %v", err)
				continue
			}

			log.Info("Updating chain head...")
			currentHead, err := c.beaconDB.GetChainHead()
			if err != nil {
				log.Errorf("Could not get current chain head: %v", err)
				continue
			}
			currentcState, err := c.beaconDB.GetCrystallizedState()
			if err != nil {
				log.Errorf("Could not get current crystallized state: %v", err)
				continue
			}

			blockcState := c.unfinalizedBlocks[h].crystallizedState

			var headUpdated bool
			newHead := currentHead
			// If both blocks have the same crystallized state root, we favor one which has
			// the higher slot.
			if currentHead.CrystallizedStateRoot() == block.CrystallizedStateRoot() {
				if block.SlotNumber() > currentHead.SlotNumber() {
					newHead = block
					headUpdated = true
				}
				// 2a. Pick the block with the higher last_finalized_slot.
				// 2b. If same, pick the block with the higher last_justified_slot.
			} else if blockcState.LastFinalizedSlot() > currentcState.LastFinalizedSlot() {
				newHead = block
				headUpdated = true
			} else if blockcState.LastFinalizedSlot() == currentcState.LastFinalizedSlot() {
				if blockcState.LastJustifiedSlot() > currentcState.LastJustifiedSlot() {
					newHead = block
					headUpdated = true
				} else if blockcState.LastJustifiedSlot() == currentcState.LastJustifiedSlot() {
					if block.SlotNumber() > currentHead.SlotNumber() {
						newHead = block
						headUpdated = true
					}
				}
			}

			// If no new head was found, we do not update the chain.
			if !headUpdated {
				log.Info("Chain head not updated")
				continue
			}

			// TODO(#674): Handle chain reorgs.
			var newCState *types.CrystallizedState
			if c.unfinalizedBlocks[h].cycleTransition {
				newCState = blockcState
			}
			if err := c.beaconDB.UpdateChainHead(newHead, c.unfinalizedBlocks[h].activeState, newCState); err != nil {
				log.Errorf("Failed to update chain: %v", err)
				continue
			}
			log.WithField("blockHash", fmt.Sprintf("0x%x", h)).Info("Chain head block and state updated")
			// We fire events that notify listeners of a new block (or crystallized state in
			// the case of a state transition). This is useful for the beacon node's gRPC
			// server to stream these events to beacon clients.
			if c.unfinalizedBlocks[h].cycleTransition {
				c.canonicalCrystallizedStateFeed.Send(blockcState)
			}
			c.canonicalBlockFeed.Send(newHead)
		}
	}
}

func (c *ChainService) executeStateTransition(
	cState *types.CrystallizedState,
	aState *types.ActiveState,
	block *types.Block) (*types.CrystallizedState, error) {

	var err error
	log.Infof("Executing state transition for slot: %d", block.SlotNumber())
	for cState.IsCycleTransition(block.SlotNumber()) {
		cState, err = cState.NewStateRecalculations(aState, block)
		if err != nil {
			return nil, err
		}
	}

	return cState, nil
}

func (c *ChainService) blockProcessing(processedBlock chan<- *types.Block) {
	subBlock := c.incomingBlockFeed.Subscribe(c.incomingBlockChan)
	defer subBlock.Unsubscribe()
	for {
		select {
		case <-c.ctx.Done():
			log.Debug("Chain service context closed, exiting goroutine")
			return

		// Listen for a newly received incoming block from the sync service.
		case block := <-c.incomingBlockChan:
			if err := c.processBlock(block); err != nil {
				log.Error(err)
				processedBlock <- nil
				continue
			}

			// Push the block to trigger the fork choice rule.
			processedBlock <- block
		}
	}
}

func (c *ChainService) processBlock(block *types.Block) error {
	blockHash, err := block.Hash()
	if err != nil {
		return fmt.Errorf("Failed to get hash of block: %v", err)
	}

	if c.enablePOWChain && !c.doesPoWBlockExist(block) {
		return errors.New("Proof-of-Work chain reference in block does not exist")
	}

	parent, err := c.beaconDB.GetBlock(block.ParentHash())
	if err != nil {
		return fmt.Errorf("Could not get parent block: %v", err)
	}
	if parent == nil {
		return fmt.Errorf("Block points to nil parent: %#x", block.ParentHash())
	}

	aState, err := c.beaconDB.GetActiveState()
	if err != nil {
		return fmt.Errorf("Failed to get active state: %v", err)
	}
	cState, err := c.beaconDB.GetCrystallizedState()
	if err != nil {
		return fmt.Errorf("Failed to get crystallized state: %v", err)
	}

	if valid := block.IsValid(
		c.beaconDB,
		aState,
		cState,
		parent.SlotNumber(),
		c.genesisTime,
	); !valid {
		return errors.New("Block failed validity conditions")
	}

	// If the block is valid, we compute its associated state tuple (active, crystallized)
	// and apply a block scoring function.
	var didCycleTransition bool
	if cState.IsCycleTransition(block.SlotNumber()) {
		cState, err = c.executeStateTransition(cState, aState, block)
		if err != nil {
			return fmt.Errorf("Initialize new cycle transition failed: %v", err)
		}
		didCycleTransition = true
	}

	aState, err = aState.CalculateNewActiveState(
		block,
		cState,
		parent.SlotNumber(),
	)
	if err != nil {
		return fmt.Errorf("Compute active state failed: %v", err)
	}

	if err := c.beaconDB.SaveBlock(block); err != nil {
		return fmt.Errorf("Failed to save block: %v", err)
	}
	if err := c.beaconDB.SaveUnfinalizedBlockState(aState, cState); err != nil {
		return fmt.Errorf("Error persisting unfinalized block's state: %v", err)
	}

	log.Infof("Processed block: %#x", blockHash)

	c.unfinalizedBlocks[blockHash] = &statePair{
		crystallizedState: cState,
		activeState:       aState,
		cycleTransition:   didCycleTransition,
	}

	return nil
}