v8

Documentation

Index

• Constants
• Variables
• type Module
  • func NewModule(id, code string) *Module
• type Modules
  • func NewModules() Modules
  • func (ms Modules) Del(id string)
  • func (ms Modules) Get(id string) *Module
  • func (ms Modules) Set(m *Module)
• type Sandbox
  • func GetSandbox(cSbx C.SandboxPtr) (*Sandbox, bool)
  • func NewSandbox(e *VM) *Sandbox
  • func (sbx *Sandbox) Compile(contract *contract.Contract) (string, error)
  • func (sbx *Sandbox) Execute(preparedCode string) (string, int64, error)
  • func (sbx *Sandbox) Init(vmType vmPoolType)
  • func (sbx *Sandbox) Prepare(contract *contract.Contract, function string, args []interface{}) (string, error)
  • func (sbx *Sandbox) Release()
  • func (sbx *Sandbox) SetGasLimit(limit int64)
  • func (sbx *Sandbox) SetHost(host *host.Host)
  • func (sbx *Sandbox) SetJSPath(path string, vmType vmPoolType)
• type VM
  • func NewVM(vmType vmPoolType, jsPath string) *VM
  • func NewVMWithChannel(vmType vmPoolType, jsPath string, releaseChannel chan *VM) *VM
  • func (e *VM) Run(code, api string, args ...interface{}) (interface{}, error)
• type VMPool
  • func NewVMPool(compilePoolSize, runPoolSize int) *VMPool
  • func (vmp *VMPool) Compile(contract *contract.Contract) (string, error)
  • func (vmp *VMPool) Init() error
  • func (vmp *VMPool) LoadAndCall(host *host.Host, contract *contract.Contract, api string, args ...interface{}) (rtn []interface{}, cost *contract.Cost, err error)
  • func (vmp *VMPool) Release()
  • func (vmp *VMPool) SetJSPath(path string)

Constants

const (
	TransferSuccess = iota
	TransferInvalidAmount
	TransferBalanceNotEnough
	TransferUnexpectedError
)

todo replace this error code with c++ error code transfer err list

const (
	BlockInfoSuccess = iota
	BlockInfoUnexpectedError
)

blockInfo err list

const (
	TxInfoSuccess = iota
	TxInfoUnexpectedError
)

txInfo err list

const (
	ContractCallSuccess = iota
	ContractCallUnexpectedError
)

contractCall err list

const (
	APICallSuccess = iota
	APICallUnexpectedError
)

APICall err list

const (
	ConsoleLogSuccess = iota
	ConsoleLogUnexpectedError
	ConsoleLogNoLoggerError
	ConsoleLogInvalidLogLevelError
)

const Console log status

const (
	CompileVMPool vmPoolType = iota // vm pool with compiled startup data
	RunVMPool
)

Variables

var CVMInitOnce = sync.Once{}

CVMInitOnce vm init once

var ErrInvalidDbValType = errors.New("invalid db value type")

ErrInvalidDbValType error

Types

type Module

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

Module JavaScript module.

func NewModule

func NewModule(id, code string) *Module

NewModule create new Module.

type Modules

type Modules map[string]*Module

Modules module map.

func NewModules

func NewModules() Modules

NewModules create new Modules.

func (Modules) Del

func (ms Modules) Del(id string)

Del del module with specified id.

func (Modules) Get

func (ms Modules) Get(id string) *Module

Get get module with specified id.

func (Modules) Set

func (ms Modules) Set(m *Module)

Set set module to modules.

type Sandbox

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

Sandbox is an execution environment that allows separate, unrelated, JavaScript code to run in a single instance of IVM.

func GetSandbox

func GetSandbox(cSbx C.SandboxPtr) (*Sandbox, bool)

GetSandbox from sandbox map by sandbox ptr

func NewSandbox

func NewSandbox(e *VM) *Sandbox

NewSandbox generate new sandbox for VM and insert into sandbox map

func (*Sandbox) Compile

func (sbx *Sandbox) Compile(contract *contract.Contract) (string, error)

Compile contract before execution, return compiled code

func (*Sandbox) Execute

func (sbx *Sandbox) Execute(preparedCode string) (string, int64, error)

Execute prepared code, return results, gasUsed

func (*Sandbox) Init

func (sbx *Sandbox) Init(vmType vmPoolType)

nolint Init add system functions

func (*Sandbox) Prepare

func (sbx *Sandbox) Prepare(contract *contract.Contract, function string, args []interface{}) (string, error)

Prepare for contract, inject code

func (*Sandbox) Release

func (sbx *Sandbox) Release()

Release release sandbox and delete from map

func (*Sandbox) SetGasLimit

func (sbx *Sandbox) SetGasLimit(limit int64)

SetGasLimit set gas limit in context

func (*Sandbox) SetHost

func (sbx *Sandbox) SetHost(host *host.Host)

SetHost set host in sandbox and set gas limit

func (*Sandbox) SetJSPath

func (sbx *Sandbox) SetJSPath(path string, vmType vmPoolType)

SetJSPath set js path and ReloadVM

type VM

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

VM contains isolate instance, which is a v8 VM with its own heap.

func NewVM

func NewVM(vmType vmPoolType, jsPath string) *VM

NewVM return new vm with isolate and sandbox

func NewVMWithChannel

func NewVMWithChannel(vmType vmPoolType, jsPath string, releaseChannel chan *VM) *VM

NewVMWithChannel return new vm with release channel

func (*VM) Run

func (e *VM) Run(code, api string, args ...interface{}) (interface{}, error)

Run load contract from code and invoke api function

type VMPool

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

VMPool manage all V8VM instance.

func NewVMPool

func NewVMPool(compilePoolSize, runPoolSize int) *VMPool

NewVMPool create new VMPool instance.

func (*VMPool) Compile

func (vmp *VMPool) Compile(contract *contract.Contract) (string, error)

Compile compile js code to binary.

func (*VMPool) Init

func (vmp *VMPool) Init() error

Init init VMPool.

func (*VMPool) LoadAndCall

func (vmp *VMPool) LoadAndCall(host *host.Host, contract *contract.Contract, api string, args ...interface{}) (rtn []interface{}, cost *contract.Cost, err error)

LoadAndCall load compiled Javascript code and run code with specified api and args

func (*VMPool) Release

func (vmp *VMPool) Release()

Release release all V8VM instance in VMPool

func (*VMPool) SetJSPath

func (vmp *VMPool) SetJSPath(path string)

SetJSPath set standard Javascript library path.