protocol

func FindLatest ¶

func FindLatest(state protocol.State, headers storage.Headers) (*flow.Header, []*flow.Header, error)

FindLatest returns:

• [first value] latest finalized header
• [second value] all known descendants (i.e. pending blocks)
• No errors expected during normal operations.

All returned blocks have been verified by the compliance layer, i.e. they are guaranteed to be valid. The descendants are listed in ancestor-first order, i.e. for any block B = descendants[i], B's parent must be included at an index _smaller_ than i, unless B's parent is the latest finalized block.

Note: this is an expensive method, which is intended to help recover from a crash, e.g. help to re-built the in-memory consensus state.