// (c) 2025, Lux Industries, Inc. All rights reserved. // See the file LICENSE for licensing terms. package core import ( "encoding/json" "fmt" "math/big" "github.com/luxfi/geth/core/tracing" "github.com/luxfi/log" "github.com/luxfi/evm/core/extstate" "github.com/luxfi/evm/core/state" "github.com/luxfi/evm/params" "github.com/luxfi/evm/precompile/contract" "github.com/luxfi/evm/precompile/registry" "github.com/luxfi/evm/stateupgrade" ) // ApplyPrecompileActivations checks if any of the precompiles specified by the chain config are enabled or disabled by the block // transition from `parentTimestamp` to the timestamp set in `blockContext`. If this is the case, it calls [registry.Module]'s Configure // to apply the necessary state transitions for the upgrade. // This function is called within genesis setup to configure the starting state for precompiles enabled at genesis. // In block processing and building, [ApplyUpgrades] is called instead which also applies state upgrades. func ApplyPrecompileActivations(c *params.ChainConfig, parentTimestamp *uint64, blockContext contract.ConfigurationBlockContext, statedb *state.StateDB) error { blockTimestamp := blockContext.Timestamp() // Note: [registry.RegisteredModules] returns precompiles sorted by module addresses. // This ensures: // - the order we call [registry.Module]'s Configure for each precompile is consistent // - even if precompiles read/write state other than their own they will observe // an identical global state in a deterministic order when they are configured. extra := params.GetExtra(c) for _, module := range registry.RegisteredModules() { for _, activatingConfig := range extra.GetActivatingPrecompileConfigs(module.Address(), parentTimestamp, blockTimestamp, extra.PrecompileUpgrades) { // If this transition activates the upgrade, configure the stateful precompile. // (or deconfigure it if it is being disabled.) if activatingConfig.IsDisabled() { log.Info("Disabling precompile", "name", module.ConfigKey()) statedb.SelfDestruct(module.Address()) // Calling [state.StateDB]'s Finalise here effectively commits the SelfDestruct call and wipes the contract state. // This enables re-configuration of the same contract state in the same block. // Without an immediate Finalise call after the SelfDestruct, a reconfigured precompiled state can be wiped out // since SelfDestruct will be committed after the reconfiguration. statedb.Finalise(true) continue } var printIntf interface{} marshalled, err := json.Marshal(activatingConfig) if err == nil { printIntf = string(marshalled) } else { printIntf = activatingConfig } log.Info("Activating new precompile", "name", module.ConfigKey(), "config", printIntf) // Set the nonce of the precompile's address (as is done when a contract is created) to ensure // that it is marked as non-empty and will not be cleaned up when the statedb is finalized. statedb.SetNonce(module.Address(), 1, tracing.NonceChangeUnspecified) // Set the code of the precompile's address to a non-zero length byte slice to ensure that the precompile // can be called from within Solidity contracts. Solidity adds a check before invoking a contract to ensure // that it does not attempt to invoke a non-existent contract. statedb.SetCode(module.Address(), []byte{0x1}) extstatedb := extstate.New(statedb) if configurator := module.Configurator(); configurator != nil { if conf, ok := configurator.(contract.Configurator); ok { if err := conf.Configure(params.GetExtra(c), activatingConfig, extstatedb, blockContext); err != nil { return fmt.Errorf("could not configure precompile, name: %s, reason: %w", module.ConfigKey(), err) } } } } } return nil } // applyStateUpgrades checks if any of the state upgrades specified by the chain config are activated by the block // transition from [parentTimestamp] to the timestamp set in [header]. If this is the case, it calls [Configure] // to apply the necessary state transitions for the upgrade. func applyStateUpgrades(c *params.ChainConfig, parentTimestamp *uint64, blockContext contract.ConfigurationBlockContext, statedb *state.StateDB) error { // Apply state upgrades configExtra := params.GetExtra(c) extstatedb := extstate.New(statedb) for _, upgrade := range configExtra.GetActivatingStateUpgrades(parentTimestamp, blockContext.Timestamp(), configExtra.StateUpgrades) { log.Info("Applying state upgrade", "blockNumber", blockContext.Number(), "upgrade", upgrade) if err := stateupgrade.Configure(&upgrade, c, extstatedb, blockContext); err != nil { return fmt.Errorf("could not configure state upgrade: %w", err) } } return nil } // ApplyUpgrades checks if any of the precompile or state upgrades specified by the chain config are activated by the block // transition from [parentTimestamp] to the timestamp set in [header]. If this is the case, it calls [Configure] // to apply the necessary state transitions for the upgrade. // This function is called: // - in block processing to update the state when processing a block. // - in the miner to apply the state upgrades when producing a block. func ApplyUpgrades(c *params.ChainConfig, parentTimestamp *uint64, blockContext contract.ConfigurationBlockContext, statedb *state.StateDB) error { if err := ApplyPrecompileActivations(c, parentTimestamp, blockContext, statedb); err != nil { return err } return applyStateUpgrades(c, parentTimestamp, blockContext, statedb) } // BlockContext implements [contract.ConfigurationBlockContext]. type BlockContext struct { number *big.Int timestamp uint64 } // NewBlockContext creates a [BlockContext] using the block number // and block timestamp provided. This function is usually necessary to convert // a `*types.Block` to be passed as a [contract.ConfigurationBlockContext] // to [ApplyUpgrades]. func NewBlockContext(number *big.Int, timestamp uint64) *BlockContext { return &BlockContext{ number: number, timestamp: timestamp, } } func (bc *BlockContext) Number() *big.Int { return bc.number } func (bc *BlockContext) Timestamp() uint64 { return bc.timestamp }