handler

Documentation

Index

• Constants
• func MakeCOAAddress(index uint64) types.Address
• func MakePrecompileAddress(index uint64) types.Address
• type Account
  • func (a *Account) Address() types.Address
  • func (a *Account) Balance() types.Balance
  • func (a *Account) Call(to types.Address, data types.Data, gaslimit types.GasLimit, ...) *types.ResultSummary
  • func (a *Account) Code() types.Code
  • func (a *Account) CodeHash() []byte
  • func (a *Account) Deploy(code types.Code, gaslimit types.GasLimit, balance types.Balance) *types.ResultSummary
  • func (a *Account) Deposit(v *types.FLOWTokenVault)
  • func (a *Account) Nonce() uint64
  • func (a *Account) Transfer(to types.Address, balance types.Balance)
  • func (a *Account) Withdraw(b types.Balance) *types.FLOWTokenVault
• type AddressAllocator
  • func NewAddressAllocator() *AddressAllocator
  • func (aa *AddressAllocator) AllocateCOAAddress(uuid uint64) types.Address
  • func (aa *AddressAllocator) AllocatePrecompileAddress(index uint64) types.Address
  • func (aa *AddressAllocator) COAFactoryAddress() types.Address
  • func (aa *AddressAllocator) NativeTokenBridgeAddress() types.Address
• type BlockStore
  • func NewBlockStore(backend types.Backend, rootAddress flow.Address) *BlockStore
  • func (bs *BlockStore) BlockHash(height uint64) (gethCommon.Hash, error)
  • func (bs *BlockStore) BlockProposal() (*types.Block, error)
  • func (bs *BlockStore) CommitBlockProposal() error
  • func (bs *BlockStore) LatestBlock() (*types.Block, error)
  • func (bs *BlockStore) ResetBlockProposal() error
• type ContractHandler
  • func NewContractHandler(flowChainID flow.ChainID, evmContractAddress flow.Address, ...) *ContractHandler
  • func (h *ContractHandler) AccountByAddress(addr types.Address, isAuthorized bool) types.Account
  • func (h *ContractHandler) BatchRun(rlpEncodedTxs [][]byte, coinbase types.Address) []*types.ResultSummary
  • func (h *ContractHandler) DeployCOA(uuid uint64) types.Address
  • func (h *ContractHandler) DryRun(rlpEncodedTx []byte, from types.Address) *types.ResultSummary
  • func (h *ContractHandler) EVMContractAddress() common.Address
  • func (h *ContractHandler) FlowTokenAddress() common.Address
  • func (h *ContractHandler) GenerateResourceUUID() uint64
  • func (h *ContractHandler) LastExecutedBlock() *types.Block
  • func (h *ContractHandler) Run(rlpEncodedTx []byte, coinbase types.Address) *types.ResultSummary
  • func (h *ContractHandler) RunOrPanic(rlpEncodedTx []byte, coinbase types.Address)

Constants

const (
	BlockHashListCapacity    = 16
	BlockStoreLatestBlockKey = "LatestBlock"
	BlockStoreBlockHashesKey = "LatestBlockHashes"
)

const RandomSourceTypeValueFieldName = "value"

const ValidationResultTypeIsValidFieldName = "isValid"

Functions

func MakeCOAAddress

func MakeCOAAddress(index uint64) types.Address

func MakePrecompileAddress

func MakePrecompileAddress(index uint64) types.Address

Types

type Account

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

func (*Account) Address

func (a *Account) Address() types.Address

Address returns the address associated with the account

func (*Account) Balance

func (a *Account) Balance() types.Balance

Balance returns the balance of this account

Note: we don't meter any extra computation given reading data from the storage already transalates into computation

func (*Account) Call

func (a *Account) Call(to types.Address, data types.Data, gaslimit types.GasLimit, balance types.Balance) *types.ResultSummary

Call calls a smart contract function with the given data it would limit the gas used according to the limit provided given it doesn't goes beyond what Flow transaction allows. the balance would be deducted from the OFA account and would be transferred to the target address

func (*Account) Code

func (a *Account) Code() types.Code

Code returns the code of this account

Note: we don't meter any extra computation given reading data from the storage already transalates into computation

func (*Account) CodeHash

func (a *Account) CodeHash() []byte

CodeHash returns the code hash of this account

Note: we don't meter any extra computation given reading data from the storage already transalates into computation

func (*Account) Deploy

func (a *Account) Deploy(code types.Code, gaslimit types.GasLimit, balance types.Balance) *types.ResultSummary

Deploy deploys a contract to the EVM environment the new deployed contract would be at the returned address contained in the result summary as data and the contract data is not controlled by the caller accounts

func (*Account) Deposit

func (a *Account) Deposit(v *types.FLOWTokenVault)

Deposit deposits the token from the given vault into the flow evm main vault and update the account balance with the new amount

func (*Account) Nonce

func (a *Account) Nonce() uint64

Nonce returns the nonce of this account

Note: we don't meter any extra computation given reading data from the storage already transalates into computation

func (*Account) Transfer

func (a *Account) Transfer(to types.Address, balance types.Balance)

Transfer transfers tokens between accounts

func (*Account) Withdraw

func (a *Account) Withdraw(b types.Balance) *types.FLOWTokenVault

Withdraw deducts the balance from the account and withdraw and return flow token from the Flex main vault.

type AddressAllocator

type AddressAllocator struct {
}

func NewAddressAllocator

func NewAddressAllocator() *AddressAllocator

NewAddressAllocator constructs a new statefull address allocator

func (*AddressAllocator) AllocateCOAAddress

func (aa *AddressAllocator) AllocateCOAAddress(uuid uint64) types.Address

AllocateCOAAddress allocates an address for COA

func (*AddressAllocator) AllocatePrecompileAddress

func (aa *AddressAllocator) AllocatePrecompileAddress(index uint64) types.Address

func (*AddressAllocator) COAFactoryAddress

func (aa *AddressAllocator) COAFactoryAddress() types.Address

func (*AddressAllocator) NativeTokenBridgeAddress

func (aa *AddressAllocator) NativeTokenBridgeAddress() types.Address

type BlockStore

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

func NewBlockStore

func NewBlockStore(backend types.Backend, rootAddress flow.Address) *BlockStore

NewBlockStore constructs a new block store

func (*BlockStore) BlockHash

func (bs *BlockStore) BlockHash(height uint64) (gethCommon.Hash, error)

BlockHash returns the block hash for the last x blocks

func (*BlockStore) BlockProposal

func (bs *BlockStore) BlockProposal() (*types.Block, error)

BlockProposal returns the block proposal to be updated by the handler

func (*BlockStore) CommitBlockProposal

func (bs *BlockStore) CommitBlockProposal() error

CommitBlockProposal commits the block proposal to the chain

func (*BlockStore) LatestBlock

func (bs *BlockStore) LatestBlock() (*types.Block, error)

LatestBlock returns the latest executed block

func (*BlockStore) ResetBlockProposal

func (bs *BlockStore) ResetBlockProposal() error

ResetBlockProposal resets the block proposal

type ContractHandler

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

ContractHandler is responsible for triggering calls to emulator, metering, event emission and updating the block

func NewContractHandler

func NewContractHandler(
	flowChainID flow.ChainID,
	evmContractAddress flow.Address,
	flowTokenAddress common.Address,
	randomBeaconAddress flow.Address,
	blockStore types.BlockStore,
	addressAllocator types.AddressAllocator,
	backend types.Backend,
	emulator types.Emulator,
) *ContractHandler

func (*ContractHandler) AccountByAddress

func (h *ContractHandler) AccountByAddress(addr types.Address, isAuthorized bool) types.Account

AccountByAddress returns the account for the given address, if isAuthorized is set, account is controlled by the FVM (COAs)

func (*ContractHandler) BatchRun

func (h *ContractHandler) BatchRun(rlpEncodedTxs [][]byte, coinbase types.Address) []*types.ResultSummary

BatchRun tries to run batch of rlp-encoded transactions and collects the gas fees and pay it to the coinbase address provided. All transactions provided in the batch are included in a single block, except for invalid transactions

func (*ContractHandler) DeployCOA

func (h *ContractHandler) DeployCOA(uuid uint64) types.Address

DeployCOA deploys a cadence-owned-account and returns the address

func (*ContractHandler) DryRun

func (h *ContractHandler) DryRun(
	rlpEncodedTx []byte,
	from types.Address,
) *types.ResultSummary

func (*ContractHandler) EVMContractAddress

func (h *ContractHandler) EVMContractAddress() common.Address

func (*ContractHandler) FlowTokenAddress

func (h *ContractHandler) FlowTokenAddress() common.Address

func (*ContractHandler) GenerateResourceUUID

func (h *ContractHandler) GenerateResourceUUID() uint64

func (*ContractHandler) LastExecutedBlock

func (h *ContractHandler) LastExecutedBlock() *types.Block

LastExecutedBlock returns the last executed block

func (*ContractHandler) Run

func (h *ContractHandler) Run(rlpEncodedTx []byte, coinbase types.Address) *types.ResultSummary

Run tries to run an rlpencoded evm transaction and collects the gas fees and pay it to the coinbase address provided.

func (*ContractHandler) RunOrPanic

func (h *ContractHandler) RunOrPanic(rlpEncodedTx []byte, coinbase types.Address)

RunOrPanic runs an rlpencoded evm transaction and collects the gas fees and pay it to the coinbase address provided.