logicrunner

Documentation

Overview

Package logicrunner - infrastructure for executing smartcontracts

Index

• type Arguments
• type ArtifactManager
• type Executor
• type LogicRunner
  • func NewLogicRunner(am ArtifactManager) (*LogicRunner, error)
  • func (r *LogicRunner) Execute(ref string, method string, args Arguments) ([]byte, []byte, error)
  • func (r *LogicRunner) GetExecutor(t MachineType) (Executor, error)
  • func (r *LogicRunner) RegisterExecutor(t MachineType, e Executor) error
• type MachineType
• type Object
• type Reference

Types

type Arguments

type Arguments []byte

Arguments is a dedicated type for arguments, that represented as bynary cbored blob

type ArtifactManager

type ArtifactManager interface {
	Get(ref string) (data []byte, codeRef Reference, err error)
}

ArtifactManager interface

type Executor

type Executor interface {
	Exec(codeRef Reference, data []byte, method string, args Arguments) (newObjectState []byte, methodResults Arguments, err error)
}

Executor is an interface for implementers of one particular machine type

type LogicRunner

type LogicRunner struct {
	Executors       [MachineTypesTotalCount]Executor
	ArtifactManager ArtifactManager
}

LogicRunner is a general interface of contract executor

func NewLogicRunner

func NewLogicRunner(am ArtifactManager) (*LogicRunner, error)

NewLogicRunner is constructor for `LogicRunner`

func (*LogicRunner) Execute

func (r *LogicRunner) Execute(ref string, method string, args Arguments) ([]byte, []byte, error)

Execute runs a method on an object, ATM just thin proxy to `GoPlugin.Exec`

func (*LogicRunner) GetExecutor

func (r *LogicRunner) GetExecutor(t MachineType) (Executor, error)

GetExecutor returns an executor for the `MachineType` if it was registered (`RegisterExecutor`), returns error otherwise

func (*LogicRunner) RegisterExecutor

func (r *LogicRunner) RegisterExecutor(t MachineType, e Executor) error

RegisterExecutor registers an executor for particular `MachineType`

type MachineType

type MachineType int

MachineType is a type of virtual machine

const (
	MachineTypeBuiltin MachineType = iota
	MachineTypeGoPlugin

	MachineTypesTotalCount
)

Real constants of MachineType

type Object

type Object struct {
	MachineType MachineType
	Reference   Reference
	Data        []byte
}

Object is an inner representation of storage object for transfwering it over API

type Reference

type Reference string

Reference is a contract address