handler

Documentation

Index

• func GetServiceEventWhitelist() []string
• func IsServiceEvent(event cadence.Event, chain flow.Chain) bool
• type AuthorizedAccountsForContractDeploymentFunc
• type ContractHandler
  • func NewContractHandler(accounts *state.Accounts, restrictedDeploymentEnabled bool, ...) *ContractHandler
  • func (h *ContractHandler) Commit() ([]programs.ContractUpdateKey, error)
  • func (h *ContractHandler) GetContract(address runtime.Address, name string) (code []byte, err error)
  • func (h *ContractHandler) GetContractNames(address runtime.Address) (names []string, err error)
  • func (h *ContractHandler) HasUpdates() bool
  • func (h *ContractHandler) RemoveContract(address runtime.Address, name string, signingAccounts []runtime.Address) (err error)
  • func (h *ContractHandler) Rollback() error
  • func (h *ContractHandler) SetContract(address runtime.Address, name string, code []byte, ...) (err error)
  • func (h *ContractHandler) UpdateKeys() []programs.ContractUpdateKey
• type EventCollection
  • func NewEventCollection() *EventCollection
  • func (e *EventCollection) AppendEvent(event flow.Event, size uint64)
  • func (e *EventCollection) AppendServiceEvent(event flow.Event, size uint64)
  • func (e *EventCollection) Child() *EventCollection
  • func (e *EventCollection) Events() []flow.Event
  • func (e *EventCollection) Merge(other *EventCollection)
  • func (e *EventCollection) ServiceEvents() []flow.Event
  • func (e *EventCollection) TotalByteSize() uint64
• type EventHandler
  • func NewEventHandler(chain flow.Chain, eventCollectionEnabled bool, ...) *EventHandler
  • func (h *EventHandler) EmitEvent(event cadence.Event, txID flow.Identifier, txIndex uint32, payer flow.Address) error
  • func (h *EventHandler) EventCollection() *EventCollection
  • func (h *EventHandler) Events() []flow.Event
  • func (h *EventHandler) ServiceEvents() []flow.Event
• type ProgramsHandler
  • func NewProgramsHandler(programs *programs.Programs, stateHolder *state.StateHolder) *ProgramsHandler
  • func (h *ProgramsHandler) Cleanup() error
  • func (h *ProgramsHandler) Get(location common.Location) (*interpreter.Program, bool)
  • func (h *ProgramsHandler) Set(location common.Location, program *interpreter.Program) error

Functions

func GetServiceEventWhitelist

func GetServiceEventWhitelist() []string

func IsServiceEvent

func IsServiceEvent(event cadence.Event, chain flow.Chain) bool

Types

type AuthorizedAccountsForContractDeploymentFunc

type AuthorizedAccountsForContractDeploymentFunc func() []common.Address

type ContractHandler

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

ContractHandler handles all interaction with smart contracts such as get/set/update it also captures all changes as deltas and only commit them when called so smart contract updates can be delayed until end of the tx execution

func NewContractHandler

func NewContractHandler(accounts *state.Accounts,
	restrictedDeploymentEnabled bool,
	authorizedAccounts AuthorizedAccountsForContractDeploymentFunc) *ContractHandler

func (*ContractHandler) Commit

func (h *ContractHandler) Commit() ([]programs.ContractUpdateKey, error)

func (*ContractHandler) GetContract

func (h *ContractHandler) GetContract(address runtime.Address, name string) (code []byte, err error)

func (*ContractHandler) GetContractNames

func (h *ContractHandler) GetContractNames(address runtime.Address) (names []string, err error)

func (*ContractHandler) HasUpdates

func (h *ContractHandler) HasUpdates() bool

func (*ContractHandler) RemoveContract

func (h *ContractHandler) RemoveContract(address runtime.Address, name string, signingAccounts []runtime.Address) (err error)

func (*ContractHandler) Rollback

func (h *ContractHandler) Rollback() error

func (*ContractHandler) SetContract

func (h *ContractHandler) SetContract(address runtime.Address, name string, code []byte, signingAccounts []runtime.Address) (err error)

func (*ContractHandler) UpdateKeys

func (h *ContractHandler) UpdateKeys() []programs.ContractUpdateKey

type EventCollection

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

func NewEventCollection

func NewEventCollection() *EventCollection

func (*EventCollection) AppendEvent

func (e *EventCollection) AppendEvent(event flow.Event, size uint64)

func (*EventCollection) AppendServiceEvent

func (e *EventCollection) AppendServiceEvent(event flow.Event, size uint64)

func (*EventCollection) Child

func (e *EventCollection) Child() *EventCollection

func (*EventCollection) Events

func (e *EventCollection) Events() []flow.Event

func (*EventCollection) Merge

func (e *EventCollection) Merge(other *EventCollection)

Merge merges another event collection into this event collection

func (*EventCollection) ServiceEvents

func (e *EventCollection) ServiceEvents() []flow.Event

func (*EventCollection) TotalByteSize

func (e *EventCollection) TotalByteSize() uint64

type EventHandler

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

EventHandler collect events, separates out service events, and enforces event size limits

func NewEventHandler

func NewEventHandler(chain flow.Chain,
	eventCollectionEnabled bool,
	serviceEventCollectionEnabled bool,
	eventCollectionByteSizeLimit uint64) *EventHandler

NewEventHandler constructs a new EventHandler

func (*EventHandler) EmitEvent

func (h *EventHandler) EmitEvent(event cadence.Event,
	txID flow.Identifier,
	txIndex uint32,
	payer flow.Address) error

func (*EventHandler) EventCollection

func (h *EventHandler) EventCollection() *EventCollection

func (*EventHandler) Events

func (h *EventHandler) Events() []flow.Event

func (*EventHandler) ServiceEvents

func (h *EventHandler) ServiceEvents() []flow.Event

type ProgramsHandler

type ProgramsHandler struct {
	Programs *programs.Programs
	// contains filtered or unexported fields
}

ProgramsHandler manages operations using Programs storage. It's separation of concern for hostEnv Cadence contract guarantees that Get/Set methods will be called in a LIFO manner, so we use stack based approach here. During successful execution stack should be cleared naturally, making cleanup method essentially no-op. But if something goes wrong, all nested views must be merged in order to make sure they are recorded

func NewProgramsHandler

func NewProgramsHandler(programs *programs.Programs, stateHolder *state.StateHolder) *ProgramsHandler

func (*ProgramsHandler) Cleanup

func (h *ProgramsHandler) Cleanup() error

func (*ProgramsHandler) Get

func (h *ProgramsHandler) Get(location common.Location) (*interpreter.Program, bool)

func (*ProgramsHandler) Set

func (h *ProgramsHandler) Set(location common.Location, program *interpreter.Program) error