mirror of
https://github.com/luxfi/evm.git
synced 2026-09-24 00:27:44 +00:00
79 lines
2.4 KiB
Go
79 lines
2.4 KiB
Go
// (c) 2023-2024, Lux Partners Limited. All rights reserved.
|
|
// See the file LICENSE for licensing terms.
|
|
|
|
// Defines the interface for the configuration and execution of a precompile contract
|
|
package contract
|
|
|
|
import (
|
|
"math/big"
|
|
|
|
"github.com/luxdefi/node/snow"
|
|
"github.com/luxdefi/evm/precompile/precompileconfig"
|
|
"github.com/ethereum/go-ethereum/common"
|
|
)
|
|
|
|
// StatefulPrecompiledContract is the interface for executing a precompiled contract
|
|
type StatefulPrecompiledContract interface {
|
|
// Run executes the precompiled contract.
|
|
Run(accessibleState AccessibleState, caller common.Address, addr common.Address, input []byte, suppliedGas uint64, readOnly bool) (ret []byte, remainingGas uint64, err error)
|
|
}
|
|
|
|
// StateDB is the interface for accessing EVM state
|
|
type StateDB interface {
|
|
GetState(common.Address, common.Hash) common.Hash
|
|
SetState(common.Address, common.Hash, common.Hash)
|
|
|
|
SetNonce(common.Address, uint64)
|
|
GetNonce(common.Address) uint64
|
|
|
|
GetBalance(common.Address) *big.Int
|
|
AddBalance(common.Address, *big.Int)
|
|
|
|
CreateAccount(common.Address)
|
|
Exist(common.Address) bool
|
|
|
|
AddLog(addr common.Address, topics []common.Hash, data []byte, blockNumber uint64)
|
|
GetLogData() (topics [][]common.Hash, data [][]byte)
|
|
GetPredicateStorageSlots(address common.Address, index int) ([]byte, bool)
|
|
SetPredicateStorageSlots(address common.Address, predicates [][]byte)
|
|
|
|
GetTxHash() common.Hash
|
|
|
|
Suicide(common.Address) bool
|
|
Finalise(deleteEmptyObjects bool)
|
|
|
|
Snapshot() int
|
|
RevertToSnapshot(int)
|
|
}
|
|
|
|
// AccessibleState defines the interface exposed to stateful precompile contracts
|
|
type AccessibleState interface {
|
|
GetStateDB() StateDB
|
|
GetBlockContext() BlockContext
|
|
GetSnowContext() *snow.Context
|
|
GetChainConfig() precompileconfig.ChainConfig
|
|
}
|
|
|
|
// ConfigurationBlockContext defines the interface required to configure a precompile.
|
|
type ConfigurationBlockContext interface {
|
|
Number() *big.Int
|
|
Timestamp() uint64
|
|
}
|
|
|
|
type BlockContext interface {
|
|
ConfigurationBlockContext
|
|
// GetResults returns an arbitrary byte array result of verifying the predicates
|
|
// of the given transaction, precompile address pair.
|
|
GetPredicateResults(txHash common.Hash, precompileAddress common.Address) []byte
|
|
}
|
|
|
|
type Configurator interface {
|
|
MakeConfig() precompileconfig.Config
|
|
Configure(
|
|
chainConfig precompileconfig.ChainConfig,
|
|
precompileconfig precompileconfig.Config,
|
|
state StateDB,
|
|
blockContext ConfigurationBlockContext,
|
|
) error
|
|
}
|