hooks

package
v1.4.0 Latest Latest
Warning

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

 Go to latest Published: Nov 11, 2022 License: GPL-3.0 Imports: 31 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var ErrAddressLengthNotCorrect = errors.New("address length is not correct")

ErrAddressLengthNotCorrect signals that an account does not have the correct address

View Source 
var ErrEmptyCode = errors.New("empty code in provided smart contract holding account")

ErrEmptyCode signals that an account does not contain code

View Source 
var ErrNotImplemented = errors.New("not implemented")

ErrNotImplemented signals that a functionality can not be used as it is not implemented

View Source 
var ErrVMTypeLengthIsNotCorrect = errors.New("vm type length is not correct")

ErrVMTypeLengthIsNotCorrect signals that the vm type length is not correct

Functions

This section is empty.

Types

type ArgBlockChainHook 

type ArgBlockChainHook struct {
	Accounts              state.AccountsAdapter
	PubkeyConv            core.PubkeyConverter
	StorageService        dataRetriever.StorageService
	DataPool              dataRetriever.PoolsHolder
	BlockChain            data.ChainHandler
	ShardCoordinator      sharding.Coordinator
	Marshalizer           marshal.Marshalizer
	Uint64Converter       typeConverters.Uint64ByteSliceConverter
	BuiltInFunctions      vmcommon.BuiltInFunctionContainer
	NFTStorageHandler     vmcommon.SimpleESDTNFTStorageHandler
	GlobalSettingsHandler vmcommon.ESDTGlobalSettingsHandler
	CompiledSCPool        storage.Cacher
	ConfigSCStorage       config.StorageConfig
	EnableEpochs          config.EnableEpochs
	EpochNotifier         vmcommon.EpochNotifier
	EnableEpochsHandler   common.EnableEpochsHandler
	WorkingDir            string
	NilCompiledSCStore    bool
}

ArgBlockChainHook represents the arguments structure for the blockchain hook

type BlockChainHookImpl 

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

BlockChainHookImpl is a wrapper over AccountsAdapter that satisfy vmcommon.BlockchainHook interface

func NewBlockChainHookImpl 

func NewBlockChainHookImpl(
	args ArgBlockChainHook,
) (*BlockChainHookImpl, error)

NewBlockChainHookImpl creates a new BlockChainHookImpl instance

func (*BlockChainHookImpl) ApplyFiltersOnCodeMetadata added in v1.3.7 

func (bh *BlockChainHookImpl) ApplyFiltersOnCodeMetadata(codeMetadata vmcommon.CodeMetadata) vmcommon.CodeMetadata

ApplyFiltersOnCodeMetadata will apply all known filters on the provided code metadata value

func (*BlockChainHookImpl) ClearCompiledCodes added in v1.1.12 

func (bh *BlockChainHookImpl) ClearCompiledCodes()

ClearCompiledCodes deletes the compiled codes from storage and cache

func (*BlockChainHookImpl) Close added in v1.2.0 

func (bh *BlockChainHookImpl) Close() error

Close closes/cleans up the blockchain hook

func (*BlockChainHookImpl) CurrentEpoch 

func (bh *BlockChainHookImpl) CurrentEpoch() uint32

CurrentEpoch returns the current epoch

func (*BlockChainHookImpl) CurrentNonce 

func (bh *BlockChainHookImpl) CurrentNonce() uint64

CurrentNonce returns the nonce from the current block

func (*BlockChainHookImpl) CurrentRandomSeed 

func (bh *BlockChainHookImpl) CurrentRandomSeed() []byte

CurrentRandomSeed returns the random seed from the current header

func (*BlockChainHookImpl) CurrentRound 

func (bh *BlockChainHookImpl) CurrentRound() uint64

CurrentRound returns the round from the current block

func (*BlockChainHookImpl) CurrentTimeStamp 

func (bh *BlockChainHookImpl) CurrentTimeStamp() uint64

CurrentTimeStamp return the timestamp from the current block

func (*BlockChainHookImpl) DeleteCompiledCode added in v1.1.12 

func (bh *BlockChainHookImpl) DeleteCompiledCode(codeHash []byte)

DeleteCompiledCode deletes the compiled code from storage and cache

func (*BlockChainHookImpl) EpochConfirmed added in v1.3.0 

func (bh *BlockChainHookImpl) EpochConfirmed(epoch uint32, _ uint64)

EpochConfirmed is called whenever a new epoch is confirmed

func (*BlockChainHookImpl) FilterCodeMetadataForUpgrade added in v1.3.7 

func (bh *BlockChainHookImpl) FilterCodeMetadataForUpgrade(input []byte) ([]byte, error)

FilterCodeMetadataForUpgrade will filter the provided input bytes as a correctly constructed vmcommon.CodeMetadata bytes taking into account the activation flags for the future flags. This should be used in the upgrade SC process

func (*BlockChainHookImpl) GetAllState added in v1.0.114 

func (bh *BlockChainHookImpl) GetAllState(_ []byte) (map[string][]byte, error)

GetAllState returns the underlying state of a given account TODO remove this func completely

func (*BlockChainHookImpl) GetBlockhash 

func (bh *BlockChainHookImpl) GetBlockhash(nonce uint64) ([]byte, error)

GetBlockhash returns the header hash for a requested nonce delta

func (*BlockChainHookImpl) GetBuiltinFunctionNames added in v1.0.104 

func (bh *BlockChainHookImpl) GetBuiltinFunctionNames() vmcommon.FunctionNames

GetBuiltinFunctionNames returns the built-in function names

func (*BlockChainHookImpl) GetBuiltinFunctionsContainer added in v1.2.10 

func (bh *BlockChainHookImpl) GetBuiltinFunctionsContainer() vmcommon.BuiltInFunctionContainer

GetBuiltinFunctionsContainer returns the built-in functions container

func (*BlockChainHookImpl) GetCode 

func (bh *BlockChainHookImpl) GetCode(account vmcommon.UserAccountHandler) []byte

GetCode returns the code for the given account

func (*BlockChainHookImpl) GetCompiledCode added in v1.1.12 

func (bh *BlockChainHookImpl) GetCompiledCode(codeHash []byte) (bool, []byte)

GetCompiledCode returns the compiled code if it is found in the cache or storage

func (*BlockChainHookImpl) GetESDTToken added in v1.1.39 

func (bh *BlockChainHookImpl) GetESDTToken(address []byte, tokenID []byte, nonce uint64) (*esdt.ESDigitalToken, error)

GetESDTToken returns the unmarshalled esdt data for the given key

func (*BlockChainHookImpl) GetShardOfAddress added in v1.0.133 

func (bh *BlockChainHookImpl) GetShardOfAddress(address []byte) uint32

GetShardOfAddress is the hook that returns the shard of a given address

func (*BlockChainHookImpl) GetSnapshot added in v1.1.60 

func (bh *BlockChainHookImpl) GetSnapshot() int

GetSnapshot gets the number of entries in the journal as a snapshot id

func (*BlockChainHookImpl) GetStateRootHash 

func (bh *BlockChainHookImpl) GetStateRootHash() []byte

GetStateRootHash returns the state root hash from the last committed block

func (*BlockChainHookImpl) GetStorageData 

func (bh *BlockChainHookImpl) GetStorageData(accountAddress []byte, index []byte) ([]byte, uint32, error)

GetStorageData returns the storage value of a variable held in account's data trie

func (*BlockChainHookImpl) GetUserAccount added in v1.0.133 

func (bh *BlockChainHookImpl) GetUserAccount(address []byte) (vmcommon.UserAccountHandler, error)

GetUserAccount returns the balance of a shard account

func (*BlockChainHookImpl) IsInterfaceNil 

func (bh *BlockChainHookImpl) IsInterfaceNil() bool

IsInterfaceNil returns true if there is no value under the interface

func (*BlockChainHookImpl) IsLimitedTransfer added in v1.3.29 

func (bh *BlockChainHookImpl) IsLimitedTransfer(tokenID []byte) bool

IsLimitedTransfer returns true if the transfers

func (*BlockChainHookImpl) IsPaused added in v1.3.29 

func (bh *BlockChainHookImpl) IsPaused(tokenID []byte) bool

IsPaused returns true if the transfers for the given token ID are paused

func (*BlockChainHookImpl) IsPayable added in v1.0.147 

func (bh *BlockChainHookImpl) IsPayable(sndAddress []byte, recvAddress []byte) (bool, error)

IsPayable checks whether the provided address can receive ERD or not

func (*BlockChainHookImpl) IsSmartContract added in v1.0.133 

func (bh *BlockChainHookImpl) IsSmartContract(address []byte) bool

IsSmartContract returns whether the address points to a smart contract

func (*BlockChainHookImpl) LastEpoch 

func (bh *BlockChainHookImpl) LastEpoch() uint32

LastEpoch returns the epoch from the last committed block

func (*BlockChainHookImpl) LastNonce 

func (bh *BlockChainHookImpl) LastNonce() uint64

LastNonce returns the nonce from the last committed block

func (*BlockChainHookImpl) LastRandomSeed 

func (bh *BlockChainHookImpl) LastRandomSeed() []byte

LastRandomSeed returns the random seed from the last committed block

func (*BlockChainHookImpl) LastRound 

func (bh *BlockChainHookImpl) LastRound() uint64

LastRound returns the round from the last committed block

func (*BlockChainHookImpl) LastTimeStamp 

func (bh *BlockChainHookImpl) LastTimeStamp() uint64

LastTimeStamp returns the timeStamp from the last committed block

func (*BlockChainHookImpl) NewAddress 

func (bh *BlockChainHookImpl) NewAddress(creatorAddress []byte, creatorNonce uint64, vmType []byte) ([]byte, error)

NewAddress is a hook which creates a new smart contract address from the creators address and nonce The address is created by applied keccak256 on the appended value off creator address and nonce Prefix mask is applied for first 8 bytes 0, and for bytes 9-10 - VM type Suffix mask is applied - last 2 bytes are for the shard ID - mask is applied as suffix mask

func (*BlockChainHookImpl) NumberOfShards added in v1.1.12 

func (bh *BlockChainHookImpl) NumberOfShards() uint32

NumberOfShards returns the number of shards

func (*BlockChainHookImpl) ProcessBuiltInFunction added in v1.0.103 

func (bh *BlockChainHookImpl) ProcessBuiltInFunction(input *vmcommon.ContractCallInput) (*vmcommon.VMOutput, error)

ProcessBuiltInFunction is the hook through which a smart contract can execute a built-in function

func (*BlockChainHookImpl) RevertToSnapshot added in v1.1.60 

func (bh *BlockChainHookImpl) RevertToSnapshot(snapshot int) error

RevertToSnapshot reverts snapshots up to the specified one

func (*BlockChainHookImpl) SaveCompiledCode added in v1.1.12 

func (bh *BlockChainHookImpl) SaveCompiledCode(codeHash []byte, code []byte)

SaveCompiledCode saves the compiled code to cache and storage

func (*BlockChainHookImpl) SaveNFTMetaDataToSystemAccount added in v1.2.35 

func (bh *BlockChainHookImpl) SaveNFTMetaDataToSystemAccount(tx data.TransactionHandler) error

SaveNFTMetaDataToSystemAccount will save NFT meta data to system account for the given transaction

func (*BlockChainHookImpl) SetCurrentHeader 

func (bh *BlockChainHookImpl) SetCurrentHeader(hdr data.HeaderHandler)

SetCurrentHeader sets current header to be used by smart contracts

type VMCryptoHook 

type VMCryptoHook struct {
}

VMCryptoHook is a wrapper used in vm implementation

func NewVMCryptoHook 

func NewVMCryptoHook() *VMCryptoHook

NewVMCryptoHook creates a new instance of a vm crypto hook

func (*VMCryptoHook) Ecrecover 

func (vmch *VMCryptoHook) Ecrecover(_ []byte, _ []byte, _ []byte, _ []byte) ([]byte, error)

Ecrecover calculates the corresponding Ethereum address for the public key which created the given signature https://ewasm.readthedocs.io/en/mkdocs/system_contracts/

func (*VMCryptoHook) IsInterfaceNil added in v1.1.12 

func (vmch *VMCryptoHook) IsInterfaceNil() bool

IsInterfaceNil returns true if the underlying object is nil

func (*VMCryptoHook) Keccak256 

func (vmch *VMCryptoHook) Keccak256(data []byte) ([]byte, error)

Keccak256 returns a keccak 256 hash of the input string. Should return in hex format.

func (*VMCryptoHook) Ripemd160 

func (vmch *VMCryptoHook) Ripemd160(data []byte) ([]byte, error)

Ripemd160 is a legacy hash and should not be used for new applications

func (*VMCryptoHook) Sha256 

func (vmch *VMCryptoHook) Sha256(data []byte) ([]byte, error)

Sha256 returns a sha 256 hash of the input string. Should return in hex format.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.