aboutsummaryrefslogblamecommitdiffstats
path: root/miner/miner.go
blob: dc0591b9a0ca5ac7ab3761bd17eea85416996ffc (plain) (tree)
1
2
3
4
5
6
7
8
9
                                         
                                                
  
                                                                                  



                                                                              
                                                                             
                                                                 
                                                               


                                                                           
                                                                                  
 
                                                               


             
             
                  
                     
 
                                                  
                                                
                                              

                                                    
                                                        
                                               
                                               
                                             
                                                
                                             

 








                                                              
                   

                          
                      
 


                               
                        



                                                                                          

 
                                                                                           






                                                                        


                         

 



                                                                                                            

                                                                                                               
    
                                       
                                       



                                                            
                                                                       
                                                                                                      








                                                                               



                                                                                 

                 

 



                                                  
                                             



                                                                 
                                   

 
                                                                
                                               
                                          
                                
                              

                                                  
                                                                                                                 

                      
                                          



                                                              
 
                                                                                                              
                           
                                   
 
 

                           

                                               

 
                                          
                          

                             


                                   



                                            



                                                 
                                           
                                         


                                                                            
                                               


                                                    

              
 
 
                                                 
                                                             

                                                                                                               
                                   
                  
 
 


                                                                    
 
 
                                                    


                                                                 




                                                



                                                      
// Copyright 2014 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 <http://www.gnu.org/licenses/>.

// Package miner implements Ethereum block creation and mining.
package miner

import (
    "fmt"
    "math/big"
    "sync/atomic"

    "github.com/ethereum/go-ethereum/accounts"
    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/core"
    "github.com/ethereum/go-ethereum/core/state"
    "github.com/ethereum/go-ethereum/core/types"
    "github.com/ethereum/go-ethereum/eth/downloader"
    "github.com/ethereum/go-ethereum/ethdb"
    "github.com/ethereum/go-ethereum/event"
    "github.com/ethereum/go-ethereum/log"
    "github.com/ethereum/go-ethereum/params"
    "github.com/ethereum/go-ethereum/pow"
)

// Backend wraps all methods required for mining.
type Backend interface {
    AccountManager() *accounts.Manager
    BlockChain() *core.BlockChain
    TxPool() *core.TxPool
    ChainDb() ethdb.Database
}

// Miner creates blocks and searches for proof-of-work values.
type Miner struct {
    mux *event.TypeMux

    worker *worker

    threads  int
    coinbase common.Address
    mining   int32
    eth      Backend
    pow      pow.PoW

    canStart    int32 // can start indicates whether we can start the mining operation
    shouldStart int32 // should start indicates whether we should start after sync
}

func New(eth Backend, config *params.ChainConfig, mux *event.TypeMux, pow pow.PoW) *Miner {
    miner := &Miner{
        eth:      eth,
        mux:      mux,
        pow:      pow,
        worker:   newWorker(config, common.Address{}, eth, mux),
        canStart: 1,
    }
    go miner.update()

    return miner
}

// update keeps track of the downloader events. Please be aware that this is a one shot type of update loop.
// It's entered once and as soon as `Done` or `Failed` has been broadcasted the events are unregistered and
// the loop is exited. This to prevent a major security vuln where external parties can DOS you with blocks
// and halt your mining operation for as long as the DOS continues.
func (self *Miner) update() {
    events := self.mux.Subscribe(downloader.StartEvent{}, downloader.DoneEvent{}, downloader.FailedEvent{})
out:
    for ev := range events.Chan() {
        switch ev.Data.(type) {
        case downloader.StartEvent:
            atomic.StoreInt32(&self.canStart, 0)
            if self.Mining() {
                self.Stop()
                atomic.StoreInt32(&self.shouldStart, 1)
                log.Info(fmt.Sprint("Mining operation aborted due to sync operation"))
            }
        case downloader.DoneEvent, downloader.FailedEvent:
            shouldStart := atomic.LoadInt32(&self.shouldStart) == 1

            atomic.StoreInt32(&self.canStart, 1)
            atomic.StoreInt32(&self.shouldStart, 0)
            if shouldStart {
                self.Start(self.coinbase, self.threads)
            }
            // unsubscribe. we're only interested in this event once
            events.Unsubscribe()
            // stop immediately and ignore all further pending events
            break out
        }
    }
}

func (m *Miner) GasPrice() *big.Int {
    return new(big.Int).Set(m.worker.gasPrice)
}

func (m *Miner) SetGasPrice(price *big.Int) {
    // FIXME block tests set a nil gas price. Quick dirty fix
    if price == nil {
        return
    }
    m.worker.setGasPrice(price)
}

func (self *Miner) Start(coinbase common.Address, threads int) {
    atomic.StoreInt32(&self.shouldStart, 1)
    self.worker.setEtherbase(coinbase)
    self.coinbase = coinbase
    self.threads = threads

    if atomic.LoadInt32(&self.canStart) == 0 {
        log.Info(fmt.Sprint("Can not start mining operation due to network sync (starts when finished)"))
        return
    }
    atomic.StoreInt32(&self.mining, 1)

    for i := 0; i < threads; i++ {
        self.worker.register(NewCpuAgent(i, self.pow))
    }

    log.Info(fmt.Sprintf("Starting mining operation (CPU=%d TOT=%d)\n", threads, len(self.worker.agents)))
    self.worker.start()
    self.worker.commitNewWork()
}

func (self *Miner) Stop() {
    self.worker.stop()
    atomic.StoreInt32(&self.mining, 0)
    atomic.StoreInt32(&self.shouldStart, 0)
}

func (self *Miner) Register(agent Agent) {
    if self.Mining() {
        agent.Start()
    }
    self.worker.register(agent)
}

func (self *Miner) Unregister(agent Agent) {
    self.worker.unregister(agent)
}

func (self *Miner) Mining() bool {
    return atomic.LoadInt32(&self.mining) > 0
}

func (self *Miner) HashRate() (tot int64) {
    tot += int64(self.pow.Hashrate())
    // do we care this might race? is it worth we're rewriting some
    // aspects of the worker/locking up agents so we can get an accurate
    // hashrate?
    for agent := range self.worker.agents {
        if _, ok := agent.(*CpuAgent); !ok {
            tot += agent.GetHashRate()
        }
    }
    return
}

func (self *Miner) SetExtra(extra []byte) error {
    if uint64(len(extra)) > params.MaximumExtraDataSize {
        return fmt.Errorf("Extra exceeds max length. %d > %v", len(extra), params.MaximumExtraDataSize)
    }
    self.worker.setExtra(extra)
    return nil
}

// Pending returns the currently pending block and associated state.
func (self *Miner) Pending() (*types.Block, *state.StateDB) {
    return self.worker.pending()
}

// PendingBlock returns the currently pending block.
//
// Note, to access both the pending block and the pending state
// simultaneously, please use Pending(), as the pending state can
// change between multiple method calls
func (self *Miner) PendingBlock() *types.Block {
    return self.worker.pendingBlock()
}

func (self *Miner) SetEtherbase(addr common.Address) {
    self.coinbase = addr
    self.worker.setEtherbase(addr)
}