miner

package
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 27, 2025 License: GPL-3.0 Imports: 31 Imported by: 0

Documentation

Overview

Package miner implements Ethereum block creation and mining.

Index

Constants

This section is empty.

Variables

View Source
var DefaultConfig = Config{
	GasCeil:  45_000_000,
	GasPrice: big.NewInt(params.Wei),

	Recommit: 2 * time.Second,
}

DefaultConfig contains default settings for miner.

Functions

This section is empty.

Types

type Backend

type Backend interface {
	BlockChain() *core.BlockChain
	TxPool() *txpool.TxPool
}

Backend wraps all methods required for mining. Only full node is capable to offer all the functions here.

type BackendWithHistoricalState

type BackendWithHistoricalState interface {
	StateAtBlock(ctx context.Context, block *types.Block, reexec uint64, base *state.StateDB, readOnly bool, preferDisk bool) (*state.StateDB, tracers.StateReleaseFunc, error)
}

type BackendWithInterop

type BackendWithInterop interface {
	CheckAccessList(ctx context.Context, inboxEntries []common.Hash, minSafety interoptypes.SafetyLevel, executingDescriptor interoptypes.ExecutingDescriptor) error

	// GetFailsafeEnabled reads the local failsafe status from the backend
	GetSupervisorFailsafe() bool

	// QueryFailsafe queries the supervisor over RPC for the failsafe status,
	// caches it in the backend, and returns the status.
	QueryFailsafe(ctx context.Context) (bool, error)
}

type BuildPayloadArgs

type BuildPayloadArgs struct {
	Parent       common.Hash           // The parent block to build payload on top
	Timestamp    uint64                // The provided timestamp of generated payload
	FeeRecipient common.Address        // The provided recipient address for collecting transaction fee
	Random       common.Hash           // The provided randomness value
	Withdrawals  types.Withdrawals     // The provided withdrawals
	BeaconRoot   *common.Hash          // The provided beaconRoot (Cancun)
	Version      engine.PayloadVersion // Versioning byte for payload id calculation.

	NoTxPool      bool                 // Optimism addition: option to disable tx pool contents from being included
	Transactions  []*types.Transaction // Optimism addition: txs forced into the block via engine API
	GasLimit      *uint64              // Optimism addition: override gas limit of the block to build
	EIP1559Params []byte               // Optimism addition: encodes Holocene EIP-1559 params
}

BuildPayloadArgs contains the provided parameters for building payload. Check engine-api specification for more details. https://github.com/ethereum/execution-apis/blob/main/src/engine/cancun.md#payloadattributesv3

func (*BuildPayloadArgs) Id

func (args *BuildPayloadArgs) Id() engine.PayloadID

Id computes an 8-byte identifier by hashing the components of the payload arguments.

type Config

type Config struct {
	Etherbase           common.Address `toml:"-"`          // Deprecated
	PendingFeeRecipient common.Address `toml:"-"`          // Address for pending block rewards.
	ExtraData           hexutil.Bytes  `toml:",omitempty"` // Block extra data set by the miner
	GasCeil             uint64         // Target gas ceiling for mined blocks.
	GasPrice            *big.Int       // Minimum gas price for mining a transaction
	Recommit            time.Duration  // The time interval for miner to re-create mining work.

	RollupComputePendingBlock             bool // Compute the pending block from tx-pool, instead of copying the latest-block
	RollupTransactionConditionalRateLimit int  // Total number of conditional cost units allowed in a second

	EffectiveGasCeil uint64   // if non-zero, a gas ceiling to apply independent of the header's gaslimit value
	MaxDATxSize      *big.Int `toml:",omitempty"` // if non-nil, don't include any txs with data availability size larger than this in any built block
	MaxDABlockSize   *big.Int `toml:",omitempty"` // if non-nil, then don't build a block requiring more than this amount of total data availability
}

Config is the configuration parameters of mining.

type Miner

type Miner struct {
	// contains filtered or unexported fields
}

Miner is the main object which takes care of submitting new work to consensus engine and gathering the sealing result.

func New

func New(eth Backend, config Config, engine consensus.Engine) *Miner

New creates a new miner with provided config.

func (*Miner) BuildPayload

func (miner *Miner) BuildPayload(args *BuildPayloadArgs, witness bool) (*Payload, error)

BuildPayload builds the payload according to the provided parameters.

func (*Miner) Close

func (miner *Miner) Close()

func (*Miner) Pending

func (miner *Miner) Pending() (*types.Block, types.Receipts, *state.StateDB)

Pending returns the currently pending block and associated receipts, logs and statedb. The returned values can be nil in case the pending block is not initialized.

func (*Miner) SetExtra

func (miner *Miner) SetExtra(extra []byte) error

SetExtra sets the content used to initialize the block extra field.

func (*Miner) SetGasCeil

func (miner *Miner) SetGasCeil(ceil uint64)

SetGasCeil sets the gaslimit to strive for when mining blocks post 1559. For pre-1559 blocks, it sets the ceiling.

func (*Miner) SetGasTip

func (miner *Miner) SetGasTip(tip *big.Int) error

SetGasTip sets the minimum gas tip for inclusion.

func (*Miner) SetMaxDASize

func (miner *Miner) SetMaxDASize(maxTxSize, maxBlockSize *big.Int)

SetMaxDASize sets the maximum data availability size currently allowed for inclusion. 0 means no maximum.

func (*Miner) SetPrioAddresses

func (miner *Miner) SetPrioAddresses(prio []common.Address)

SetPrioAddresses sets a list of addresses to prioritize for transaction inclusion.

type Payload

type Payload struct {
	// contains filtered or unexported fields
}

Payload wraps the built payload(block waiting for sealing). According to the engine-api specification, EL should build the initial version of the payload which has an empty transaction set and then keep update it in order to maximize the revenue. Therefore, the empty-block here is always available and full-block will be set/updated afterwards.

func (*Payload) Resolve

func (payload *Payload) Resolve() *engine.ExecutionPayloadEnvelope

Resolve returns the latest built payload and also terminates the background thread for updating payload. It's safe to be called multiple times.

func (*Payload) ResolveEmpty

func (payload *Payload) ResolveEmpty() *engine.ExecutionPayloadEnvelope

ResolveEmpty is basically identical to Resolve, but it expects empty block only. It's only used in tests.

func (*Payload) ResolveFull

func (payload *Payload) ResolveFull() *engine.ExecutionPayloadEnvelope

ResolveFull is basically identical to Resolve, but it expects full block only. Don't call Resolve until ResolveFull returns, otherwise it might block forever.

func (*Payload) WaitFull

func (payload *Payload) WaitFull()

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL