// Copyright 2015 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 gasprice import ( "container/heap" "context" "math/big" "sync" "github.com/holiman/uint256" "github.com/ledgerwatch/erigon/common" "github.com/ledgerwatch/erigon/core/types" "github.com/ledgerwatch/erigon/log" "github.com/ledgerwatch/erigon/params" "github.com/ledgerwatch/erigon/rpc" ) const sampleNumber = 3 // Number of transactions sampled in a block var DefaultMaxPrice = big.NewInt(500 * params.GWei) type Config struct { Blocks int Percentile int Default *big.Int `toml:",omitempty"` MaxPrice *big.Int `toml:",omitempty"` } // OracleBackend includes all necessary background APIs for oracle. type OracleBackend interface { HeaderByNumber(ctx context.Context, number rpc.BlockNumber) (*types.Header, error) BlockByNumber(ctx context.Context, number rpc.BlockNumber) (*types.Block, error) ChainConfig() *params.ChainConfig } // Oracle recommends gas prices based on the content of recent // blocks. Suitable for both light and full clients. type Oracle struct { backend OracleBackend lastHead common.Hash lastPrice *big.Int maxPrice *big.Int cacheLock sync.RWMutex checkBlocks int percentile int } // NewOracle returns a new gasprice oracle which can recommend suitable // gasprice for newly created transaction. func NewOracle(backend OracleBackend, params Config) *Oracle { blocks := params.Blocks if blocks < 1 { blocks = 1 log.Warn("Sanitizing invalid gasprice oracle sample blocks", "provided", params.Blocks, "updated", blocks) } percent := params.Percentile if percent < 0 { percent = 0 log.Warn("Sanitizing invalid gasprice oracle sample percentile", "provided", params.Percentile, "updated", percent) } if percent > 100 { percent = 100 log.Warn("Sanitizing invalid gasprice oracle sample percentile", "provided", params.Percentile, "updated", percent) } maxPrice := params.MaxPrice if maxPrice == nil || maxPrice.Int64() <= 0 { maxPrice = DefaultMaxPrice log.Warn("Sanitizing invalid gasprice oracle price cap", "provided", params.MaxPrice, "updated", maxPrice) } return &Oracle{ backend: backend, lastPrice: params.Default, maxPrice: maxPrice, checkBlocks: blocks, percentile: percent, } } // SuggestPrice returns a gasprice so that newly created transaction can // have a very high chance to be included in the following blocks. func (gpo *Oracle) SuggestPrice(ctx context.Context) (*big.Int, error) { head, _ := gpo.backend.HeaderByNumber(ctx, rpc.LatestBlockNumber) headHash := head.Hash() // If the latest gasprice is still available, return it. gpo.cacheLock.RLock() lastHead, lastPrice := gpo.lastHead, gpo.lastPrice gpo.cacheLock.RUnlock() if headHash == lastHead { return lastPrice, nil } // Try checking the cache again, maybe the last fetch fetched what we need gpo.cacheLock.RLock() lastHead, lastPrice = gpo.lastHead, gpo.lastPrice gpo.cacheLock.RUnlock() if headHash == lastHead { return lastPrice, nil } number := head.Number.Uint64() txPrices := make(sortingHeap, 0, sampleNumber*gpo.checkBlocks) for txPrices.Len() < sampleNumber*gpo.checkBlocks && number > 0 { gpo.getBlockPrices(ctx, number, sampleNumber, &txPrices) number-- } price := lastPrice if txPrices.Len() > 0 { // Item with this position needs to be extracted from the sorting heap // so we pop all the items before it percentilePosition := (txPrices.Len() - 1) * gpo.percentile / 100 for i := 0; i < percentilePosition; i++ { heap.Pop(&txPrices) } } if txPrices.Len() > 0 { // Don't need to pop it, just take from the top of the heap price = txPrices[0].ToBig() } if price.Cmp(gpo.maxPrice) > 0 { price = new(big.Int).Set(gpo.maxPrice) } gpo.cacheLock.Lock() gpo.lastHead = headHash gpo.lastPrice = price gpo.cacheLock.Unlock() return price, nil } type transactionsByGasPrice []types.Transaction func (t transactionsByGasPrice) Len() int { return len(t) } func (t transactionsByGasPrice) Swap(i, j int) { t[i], t[j] = t[j], t[i] } func (t transactionsByGasPrice) Less(i, j int) bool { return t[i].GetPrice().Cmp(t[j].GetPrice()) < 0 } // Push (part of heap.Interface) places a new link onto the end of queue func (t *transactionsByGasPrice) Push(x interface{}) { // Push and Pop use pointer receivers because they modify the slice's length, // not just its contents. l := x.(types.Transaction) *t = append(*t, l) } // Pop (part of heap.Interface) removes the first link from the queue func (t *transactionsByGasPrice) Pop() interface{} { old := *t n := len(old) x := old[n-1] *t = old[0 : n-1] return x } // getBlockPrices calculates the lowest transaction gas price in a given block // and sends it to the result channel. If the block is empty or all transactions // are sent by the miner itself(it doesn't make any sense to include this kind of // transaction prices for sampling), nil gasprice is returned. func (gpo *Oracle) getBlockPrices(ctx context.Context, blockNum uint64, limit int, s *sortingHeap) { block, err := gpo.backend.BlockByNumber(ctx, rpc.BlockNumber(blockNum)) if block == nil { return } blockTxs := block.Transactions() txs := make(transactionsByGasPrice, len(blockTxs)) copy(txs, blockTxs) heap.Init(&txs) for txs.Len() > 0 { tx := heap.Pop(&txs).(types.Transaction) sender, _ := tx.GetSender() if err == nil && sender != block.Coinbase() { heap.Push(s, tx.GetPrice()) if s.Len() >= limit { break } } } } type sortingHeap []*uint256.Int func (s sortingHeap) Len() int { return len(s) } func (s sortingHeap) Less(i, j int) bool { return s[i].Lt(s[j]) } func (s sortingHeap) Swap(i, j int) { s[i], s[j] = s[j], s[i] } // Push (part of heap.Interface) places a new link onto the end of queue func (s *sortingHeap) Push(x interface{}) { // Push and Pop use pointer receivers because they modify the slice's length, // not just its contents. l := x.(*uint256.Int) *s = append(*s, l) } // Pop (part of heap.Interface) removes the first link from the queue func (s *sortingHeap) Pop() interface{} { old := *s n := len(old) x := old[n-1] *s = old[0 : n-1] return x }