# Nimbus # Copyright (c) 2018 Status Research & Development GmbH # Licensed under either of # * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or # http://www.apache.org/licenses/LICENSE-2.0) # * MIT license ([LICENSE-MIT](LICENSE-MIT) or # http://opensource.org/licenses/MIT) # at your option. This file may not be copied, modified, or distributed except # according to those terms. ## ## Tuoole & Utils for Clique PoA Consensus Protocol ## ================================================ ## ## For details see ## `EIP-225 `_ ## and ## `go-ethereum `_ ## ## Caveat: Not supporting RLP serialisation encode()/decode() ## import std/[algorithm, strformat, times], ../../chain_config, ../../constants, ../../db/db_chain, ../../utils, ./clique_defs, eth/[common, rlp], stew/[objects, results], stint type EthSortOrder* = enum EthDescending = SortOrder.Descending.ord EthAscending = SortOrder.Ascending.ord {.push raises: [Defect].} # ------------------------------------------------------------------------------ # Private helpers # ------------------------------------------------------------------------------ func zeroItem[T](t: typedesc[T]): T {.inline.} = discard # ------------------------------------------------------------------------------ # Public functions # ------------------------------------------------------------------------------ proc isZero*[T: EthAddress|Hash256|Duration](a: T): bool = ## `true` if `a` is all zero a == zeroItem(T) proc sorted*(e: openArray[EthAddress]; order = EthAscending): seq[EthAddress] = proc eCmp(x, y: EthAddress): int = for n in 0 ..< x.len: if x[n] < y[n]: return -1 elif y[n] < x[n]: return 1 e.sorted(cmp = eCmp, order = order.SortOrder) proc cliqueResultErr*(w: CliqueError): CliqueResult = ## Return error result (syntactic sugar) err(w) proc extraDataAddresses*(extraData: Blob): seq[EthAddress] = ## Extract signer addresses from extraData header field proc toEthAddress(a: openArray[byte]; start: int): EthAddress {.inline.} = toArray(EthAddress.len, a[start ..< start + EthAddress.len]) if EXTRA_VANITY + EXTRA_SEAL < extraData.len and ((extraData.len - (EXTRA_VANITY + EXTRA_SEAL)) mod EthAddress.len) == 0: var addrOffset = EXTRA_VANITY while addrOffset + EthAddress.len <= extraData.len - EXTRA_SEAL: result.add extraData.toEthAddress(addrOffset) addrOffset += EthAddress.len proc getBlockHeaderResult*(db: BaseChainDB; number: BlockNumber): Result[BlockHeader,void] {. gcsafe, raises: [Defect,RlpError].} = ## Slightly re-phrased dbChain.getBlockHeader(..) command var header: BlockHeader if db_chain.getBlockHeader(db, number, header): return ok(header) err() # core/types/block.go(343): func (b *Block) WithSeal(header [..] proc withHeader*(b: EthBlock; header: BlockHeader): EthBlock = ## New block with the data from `b` but the header replaced with the ## argument one. EthBlock( header: header, txs: b.txs, uncles: b.uncles) # consensus/misc/forks.go(30): func VerifyForkHashes(config [..] proc verifyForkHashes*(c: var ChainConfig; header: BlockHeader): CliqueResult {. gcsafe, raises: [Defect,ValueError].} = ## Verify that blocks conforming to network hard-forks do have the correct ## hashes, to avoid clients going off on different chains. # If the homestead reprice hash is set, validate it if c.eip150Block.isZero or c.eip150Block != header.blockNumber: return ok() let hash = header.hash if c.eip150Hash.isZero or c.eip150Hash == hash: return ok() return err((errCliqueGasRepriceFork, &"Homestead gas reprice fork: have {c.eip150Hash}, want {hash}")) # ------------------------------------------------------------------------------ # Seal hash support # ------------------------------------------------------------------------------ # clique/clique.go(730): func encodeSigHeader(w [..] proc encodeSealHeader*(header: BlockHeader): seq[byte] = ## Cut sigature off `extraData` header field and consider new `baseFee` ## field for Eip1559. doAssert EXTRA_SEAL < header.extraData.len var rlpHeader = header rlpHeader.extraData.setLen(header.extraData.len - EXTRA_SEAL) rlp.encode(rlpHeader) # clique/clique.go(688): func SealHash(header *types.Header) common.Hash { proc hashSealHeader*(header: BlockHeader): Hash256 = ## Returns the hash of a block prior to it being sealed. header.encodeSealHeader.keccakHash # ------------------------------------------------------------------------------ # End # ------------------------------------------------------------------------------