// 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 filters import ( "github.com/ethereum/go-ethereum/common" "github.com/ethereum/go-ethereum/core" "github.com/ethereum/go-ethereum/core/types" "github.com/ethereum/go-ethereum/core/vm" "github.com/ethereum/go-ethereum/ethdb" ) type AccountChange struct { Address, StateAddress []byte } // Filtering interface type Filter struct { db ethdb.Database earliest int64 latest int64 skip int address []common.Address max int topics [][]common.Hash BlockCallback func(*types.Block, vm.Logs) TransactionCallback func(*types.Transaction) LogsCallback func(vm.Logs) } // Create a new filter which uses a bloom filter on blocks to figure out whether a particular block // is interesting or not. func New(db ethdb.Database) *Filter { return &Filter{db: db} } // Set the earliest and latest block for filtering. // -1 = latest block (i.e., the current block) // hash = particular hash from-to func (self *Filter) SetEarliestBlock(earliest int64) { self.earliest = earliest } func (self *Filter) SetLatestBlock(latest int64) { self.latest = latest } func (self *Filter) SetAddress(addr []common.Address) { self.address = addr } func (self *Filter) SetTopics(topics [][]common.Hash) { self.topics = topics } func (self *Filter) SetMax(max int) { self.max = max } func (self *Filter) SetSkip(skip int) { self.skip = skip } // Run filters logs with the current parameters set func (self *Filter) Find() vm.Logs { earliestBlock := core.GetBlock(self.db, core.GetHeadBlockHash(self.db)) var earliestBlockNo uint64 = uint64(self.earliest) if self.earliest == -1 { earliestBlockNo = earliestBlock.NumberU64() } var latestBlockNo uint64 = uint64(self.latest) if self.latest == -1 { latestBlockNo = earliestBlock.NumberU64() } var ( logs vm.Logs block *types.Block ) hash := core.GetCanonicalHash(self.db, latestBlockNo) if hash != (common.Hash{}) { block = core.GetBlock(self.db, hash) } done: for i := 0; block != nil; i++ { // Quit on latest switch { case block.NumberU64() == 0: break done case block.NumberU64() < earliestBlockNo: break done } // Use bloom filtering to see if this block is interesting given the // current parameters if self.bloomFilter(block) { // Get the logs of the block var ( receipts = core.GetBlockReceipts(self.db, block.Hash()) unfiltered vm.Logs ) for _, receipt := range receipts { unfiltered = append(unfiltered, receipt.Logs()...) } logs = append(logs, self.FilterLogs(unfiltered)...) } block = core.GetBlock(self.db, block.ParentHash()) } return logs } func includes(addresses []common.Address, a common.Address) bool { for _, addr := range addresses { if addr == a { return true } } return false } func (self *Filter) FilterLogs(logs vm.Logs) vm.Logs { var ret vm.Logs // Filter the logs for interesting stuff Logs: for _, log := range logs { if len(self.address) > 0 && !includes(self.address, log.Address) { continue } logTopics := make([]common.Hash, len(self.topics)) copy(logTopics, log.Topics) // If the to filtered topics is greater than the amount of topics in // logs, skip. if len(self.topics) > len(log.Topics) { continue Logs } for i, topics := range self.topics { var match bool for _, topic := range topics { // common.Hash{} is a match all (wildcard) if (topic == common.Hash{}) || log.Topics[i] == topic { match = true break } } if !match { continue Logs } } ret = append(ret, log) } return ret } func (self *Filter) bloomFilter(block *types.Block) bool { if len(self.address) > 0 { var included bool for _, addr := range self.address { if types.BloomLookup(block.Bloom(), addr) { included = true break } } if !included { return false } } for _, sub := range self.topics { var included bool for _, topic := range sub { if (topic == common.Hash{}) || types.BloomLookup(block.Bloom(), topic) { included = true break } } if !included { return false } } return true }