cpuminer

README

cpuminer

Overview

This package is currently a work in progress. It works without issue since it used in several of the integration tests, but the API is not really ready for consumption as it has simply been refactored out of the main codebase for now.

Installation and Updating

$ go get -u git.parallelcoin.io/dev/9/mining/cpuminer

License

Package cpuminer is licensed under the copyfree ISC License.

Documentation

Index

• Variables
• func UseLogger(logger *cl.SubSystem)
• type CPUMiner
  • func New(cfg *Config) *CPUMiner
  • func (m *CPUMiner) GenerateNBlocks(n uint32, algo string) ([]*chainhash.Hash, error)
  • func (m *CPUMiner) GetAlgo() (name string)
  • func (m *CPUMiner) HashesPerSecond() float64
  • func (m *CPUMiner) IsMining() bool
  • func (m *CPUMiner) NumWorkers() int32
  • func (m *CPUMiner) SetAlgo(name string)
  • func (m *CPUMiner) SetNumWorkers(numWorkers int32)
  • func (m *CPUMiner) Start()
  • func (m *CPUMiner) Stop()
• type Config

Variables

var Log = cl.NewSubSystem("chain/mining/cpu", ll.DEFAULT)

Log is the logger for the peer package

Functions

func UseLogger

func UseLogger(
	logger *cl.SubSystem)

UseLogger uses a specified Logger to output package logging info.

Types

type CPUMiner

type CPUMiner struct {
	sync.Mutex
	// contains filtered or unexported fields
}

func New

func New(
	cfg *Config,
) *CPUMiner

New returns a new instance of a CPU miner for the provided configuration. Use Start to begin the mining process. See the documentation for CPUMiner type for more details.

func (*CPUMiner) GenerateNBlocks

func (
	m *CPUMiner,
) GenerateNBlocks(
	n uint32, algo string) ([]*chainhash.Hash, error)

GenerateNBlocks generates the requested number of blocks. It is self contained in that it creates block templates and attempts to solve them while detecting when it is performing stale work and reacting accordingly by generating a new block template. When a block is solved, it is submitted. The function returns a list of the hashes of generated blocks.

func (*CPUMiner) GetAlgo

func (
	m *CPUMiner,
) GetAlgo() (name string)

GetAlgo returns the algorithm currently configured for the miner

func (*CPUMiner) HashesPerSecond

func (
	m *CPUMiner,
) HashesPerSecond() float64

HashesPerSecond returns the number of hashes per second the mining process is performing. 0 is returned if the miner is not currently running. This function is safe for concurrent access.

func (*CPUMiner) IsMining

func (
	m *CPUMiner,
) IsMining() bool

IsMining returns whether or not the CPU miner has been started and is therefore currenting mining. This function is safe for concurrent access.

func (*CPUMiner) NumWorkers

func (
	m *CPUMiner,
) NumWorkers() int32

NumWorkers returns the number of workers which are running to solve blocks. This function is safe for concurrent access.

func (*CPUMiner) SetAlgo

func (
	m *CPUMiner,
) SetAlgo(
	name string)

SetAlgo sets the algorithm for the CPU miner

func (*CPUMiner) SetNumWorkers

func (
	m *CPUMiner,
) SetNumWorkers(
	numWorkers int32,
)

SetNumWorkers sets the number of workers to create which solve blocks. Any negative values will cause a default number of workers to be used which is based on the number of processor cores in the system. A value of 0 will cause all CPU mining to be stopped. This function is safe for concurrent access.

func (*CPUMiner) Start

func (
	m *CPUMiner,
) Start()

This function is safe for concurrent access.

func (*CPUMiner) Stop

func (
	m *CPUMiner,
) Stop()

Stop gracefully stops the mining process by signalling all workers, and the speed monitor to quit. Calling this function when the CPU miner has not already been started will have no effect. This function is safe for concurrent access.

type Config

type Config struct {

	// Blockchain gives access for the miner to information about the chain
	Blockchain *blockchain.BlockChain

	// ChainParams identifies which chain parameters the cpu miner is associated with.
	ChainParams *chaincfg.Params

	// BlockTemplateGenerator identifies the instance to use in order to generate block templates that the miner will attempt to solve.
	BlockTemplateGenerator *mining.BlkTmplGenerator

	// MiningAddrs is a list of payment addresses to use for the generated blocks.  Each generated block will randomly choose one of them.
	MiningAddrs []util.Address

	// ProcessBlock defines the function to call with any solved blocks. It typically must run the provided block through the same set of rules and handling as any other block coming from the network.
	ProcessBlock func(*util.Block, blockchain.BehaviorFlags) (bool, error)

	// ConnectedCount defines the function to use to obtain how many other peers the server is connected to.  This is used by the automatic persistent mining routine to determine whether or it should attempt mining.  This is useful because there is no point in mining when not connected to any peers since there would no be anyone to send any found blocks to.
	ConnectedCount func() int32

	// IsCurrent defines the function to use to obtain whether or not the block chain is current.  This is used by the automatic persistent mining routine to determine whether or it should attempt mining. This is useful because there is no point in mining if the chain is not current since any solved blocks would be on a side chain and and up orphaned anyways.
	IsCurrent func() bool

	// Algo is the name of the type of PoW used for the block header.
	Algo string

	// NumThreads is the number of threads set in the configuration for the CPUMiner
	NumThreads uint32
}