Documentation ¶
Index ¶
- Variables
- type ArgBlockChainHook
- type BlockChainHookImpl
- func (bh *BlockChainHookImpl) ClearCompiledCodes()
- func (bh *BlockChainHookImpl) CurrentEpoch() uint32
- func (bh *BlockChainHookImpl) CurrentNonce() uint64
- func (bh *BlockChainHookImpl) CurrentRandomSeed() []byte
- func (bh *BlockChainHookImpl) CurrentRound() uint64
- func (bh *BlockChainHookImpl) CurrentTimeStamp() uint64
- func (bh *BlockChainHookImpl) DeleteCompiledCode(codeHash []byte)
- func (bh *BlockChainHookImpl) GetAllState(_ []byte) (map[string][]byte, error)
- func (bh *BlockChainHookImpl) GetBlockhash(nonce uint64) ([]byte, error)
- func (bh *BlockChainHookImpl) GetBuiltInFunctions() process.BuiltInFunctionContainer
- func (bh *BlockChainHookImpl) GetBuiltinFunctionNames() vmcommon.FunctionNames
- func (bh *BlockChainHookImpl) GetCode(account vmcommon.UserAccountHandler) []byte
- func (bh *BlockChainHookImpl) GetCompiledCode(codeHash []byte) (bool, []byte)
- func (bh *BlockChainHookImpl) GetESDTToken(address []byte, tokenID []byte, nonce uint64) (*esdt.ESDigitalToken, error)
- func (bh *BlockChainHookImpl) GetShardOfAddress(address []byte) uint32
- func (bh *BlockChainHookImpl) GetStateRootHash() []byte
- func (bh *BlockChainHookImpl) GetStorageData(accountAddress []byte, index []byte) ([]byte, error)
- func (bh *BlockChainHookImpl) GetUserAccount(address []byte) (vmcommon.UserAccountHandler, error)
- func (bh *BlockChainHookImpl) IsInterfaceNil() bool
- func (bh *BlockChainHookImpl) IsPayable(address []byte) (bool, error)
- func (bh *BlockChainHookImpl) IsSmartContract(address []byte) bool
- func (bh *BlockChainHookImpl) LastEpoch() uint32
- func (bh *BlockChainHookImpl) LastNonce() uint64
- func (bh *BlockChainHookImpl) LastRandomSeed() []byte
- func (bh *BlockChainHookImpl) LastRound() uint64
- func (bh *BlockChainHookImpl) LastTimeStamp() uint64
- func (bh *BlockChainHookImpl) NewAddress(creatorAddress []byte, creatorNonce uint64, vmType []byte) ([]byte, error)
- func (bh *BlockChainHookImpl) NumberOfShards() uint32
- func (bh *BlockChainHookImpl) ProcessBuiltInFunction(input *vmcommon.ContractCallInput) (*vmcommon.VMOutput, error)
- func (bh *BlockChainHookImpl) SaveCompiledCode(codeHash []byte, code []byte)
- func (bh *BlockChainHookImpl) SetCurrentHeader(hdr data.HeaderHandler)
- type VMCryptoHook
- func (vmch *VMCryptoHook) Ecrecover(_ []byte, _ []byte, _ []byte, _ []byte) ([]byte, error)
- func (vmch *VMCryptoHook) IsInterfaceNil() bool
- func (vmch *VMCryptoHook) Keccak256(data []byte) ([]byte, error)
- func (vmch *VMCryptoHook) Ripemd160(data []byte) ([]byte, error)
- func (vmch *VMCryptoHook) Sha256(data []byte) ([]byte, error)
Constants ¶
This section is empty.
Variables ¶
var ErrAddressLengthNotCorrect = errors.New("address length is not correct")
ErrAddressLengthNotCorrect signals that an account does not have the correct address
var ErrEmptyCode = errors.New("empty code in provided smart contract holding account")
ErrEmptyCode signals that an account does not contain code
var ErrNotImplemented = errors.New("not implemented")
ErrNotImplemented signals that a functionality can not be used as it is not implemented
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 process.BuiltInFunctionContainer CompiledSCPool storage.Cacher ConfigSCStorage config.StorageConfig 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) ClearCompiledCodes ¶ added in v1.1.12
func (bh *BlockChainHookImpl) ClearCompiledCodes()
ClearCompiledCodes deletes the compiled codes from storage and cache
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) 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) GetBuiltInFunctions ¶ added in v1.0.103
func (bh *BlockChainHookImpl) GetBuiltInFunctions() process.BuiltInFunctionContainer
GetBuiltInFunctions returns the built in functions container
func (*BlockChainHookImpl) GetBuiltinFunctionNames ¶ added in v1.0.104
func (bh *BlockChainHookImpl) GetBuiltinFunctionNames() vmcommon.FunctionNames
GetBuiltinFunctionNames returns the built in function names
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) 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, 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) IsPayable ¶ added in v1.0.147
func (bh *BlockChainHookImpl) IsPayable(address []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 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) 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) 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 ¶
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.