// Copyright 2017 The go-ethereum Authors // This file is part of the go-ethereum library. // // The go-ethereum library is free software: you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // The go-ethereum library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License // along with the go-ethereum library. If not, see . package types import ( "errors" "io" "github.com/ethereum/go-ethereum/common" "github.com/ethereum/go-ethereum/rlp" ) var ( // IstanbulDigest represents a hash of "Istanbul practical byzantine fault tolerance" // to identify whether the block is from Istanbul consensus engine IstanbulDigest = common.HexToHash("0x63746963616c2062797a616e74696e65206661756c7420746f6c6572616e6365") IstanbulExtraVanity = 32 // Fixed number of extra-data bytes reserved for validator vanity IstanbulExtraSeal = 65 // Fixed number of extra-data bytes reserved for validator seal // ErrInvalidIstanbulHeaderExtra is returned if the length of extra-data is less than 32 bytes ErrInvalidIstanbulHeaderExtra = errors.New("invalid istanbul header extra-data") ) type IstanbulExtra struct { Validators []common.Address Seal []byte CommittedSeal [][]byte } // EncodeRLP serializes ist into the Ethereum RLP format. func (ist *IstanbulExtra) EncodeRLP(w io.Writer) error { return rlp.Encode(w, []interface{}{ ist.Validators, ist.Seal, ist.CommittedSeal, }) } // DecodeRLP implements rlp.Decoder, and load the istanbul fields from a RLP stream. func (ist *IstanbulExtra) DecodeRLP(s *rlp.Stream) error { var istanbulExtra struct { Validators []common.Address Seal []byte CommittedSeal [][]byte } if err := s.Decode(&istanbulExtra); err != nil { return err } ist.Validators, ist.Seal, ist.CommittedSeal = istanbulExtra.Validators, istanbulExtra.Seal, istanbulExtra.CommittedSeal return nil } // ExtractIstanbulExtra extracts all values of the IstanbulExtra from the header. It returns an // error if the length of the given extra-data is less than 32 bytes or the extra-data can not // be decoded. func ExtractIstanbulExtra(h *Header) (*IstanbulExtra, error) { if len(h.Extra) < IstanbulExtraVanity { return nil, ErrInvalidIstanbulHeaderExtra } var istanbulExtra *IstanbulExtra err := rlp.DecodeBytes(h.Extra[IstanbulExtraVanity:], &istanbulExtra) if err != nil { return nil, err } return istanbulExtra, nil } // IstanbulFilteredHeader returns a filtered header which some information (like seal, committed seals) // are clean to fulfill the Istanbul hash rules. It returns nil if the extra-data cannot be // decoded/encoded by rlp. func IstanbulFilteredHeader(h *Header, keepSeal bool) *Header { newHeader := CopyHeader(h) istanbulExtra, err := ExtractIstanbulExtra(newHeader) if err != nil { return nil } if !keepSeal { istanbulExtra.Seal = []byte{} } istanbulExtra.CommittedSeal = [][]byte{} payload, err := rlp.EncodeToBytes(&istanbulExtra) if err != nil { return nil } newHeader.Extra = append(newHeader.Extra[:IstanbulExtraVanity], payload...) return newHeader }