wasmhost

package
v1.0.3-alpha.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 20, 2024 License: Apache-2.0 Imports: 22 Imported by: 0

Documentation

Index

Constants

View Source
const (
	FuncAbort        = "abort"
	FuncFdWrite      = "fd_write"
	FuncHostStateGet = "hostStateGet"
	FuncHostStateSet = "hostStateSet"
	ModuleEnv        = "env"
	ModuleWasi1      = "wasi_unstable"
	ModuleWasi2      = "wasi_snapshot_preview1"
	ModuleWasmLib    = "WasmLib"
)
View Source
const (
	FuncDefault = "_default"
)

Variables

View Source
var (
	// DisableWasmTimeout can be used to disable the annoying timeout during debugging
	DisableWasmTimeout = true

	// HostTracing turns on debug tracing for ScHost calls
	HostTracing = false

	// WasmTimeout set this to non-zero for a one-time override of the defaultTimeout
	WasmTimeout = 0 * time.Second
)
View Source
var (
	EventSubscribers []func(topic string, timestamp uint64, payload []byte)
)
View Source
var GoWasmVM func() WasmVM

Functions

func Connect

func Connect(h wasmlib.ScHost) wasmlib.ScHost

provide implementation for Wasm-only function

func GetProcessor

func GetProcessor(wasmBytes []byte, log *logger.Logger) (isc.VMProcessor, error)

GetProcessor creates a new Wasm VM processor.

Types

type ISandbox

type ISandbox interface {
	Call(funcNr int32, params []byte) []byte
	Logf(format string, args ...interface{})
	Tracef(format string, args ...interface{})
}

type ScOnloadFunc

type ScOnloadFunc func(index int32) *wasmlib.ScExportMap

type WasmContext

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

func NewWasmContext

func NewWasmContext(proc *WasmProcessor, function string) *WasmContext

func NewWasmContextForSoloContext

func NewWasmContextForSoloContext(function string, sandbox ISandbox) *WasmContext

func (*WasmContext) Call

func (wc *WasmContext) Call(ctx interface{}) dict.Dict

func (*WasmContext) ExportName

func (wc *WasmContext) ExportName(index int32, name string)

func (*WasmContext) FunctionFromCode

func (wc *WasmContext) FunctionFromCode(code uint32) string

func (*WasmContext) GasBudget added in v0.3.0

func (wc *WasmContext) GasBudget() uint64

GasBudget is a callback from the VM that asks for the remaining gas budget of the Wasp sandbox. The VM will update the gas budget for the Wasm code with this value just before returning to the Wasm code.

func (*WasmContext) GasBurned added in v0.3.0

func (wc *WasmContext) GasBurned(burned uint64)

GasBurned is a callback from the VM that sets the remaining gas budget. It will update the gas budget for the Wasp sandbox with the amount of gas burned by the Wasm code thus far just before calling sandbox.

func (*WasmContext) GasDisable added in v0.3.0

func (wc *WasmContext) GasDisable(disable bool)

func (*WasmContext) IsView

func (wc *WasmContext) IsView() bool

func (*WasmContext) RunScFunction added in v0.3.0

func (wc *WasmContext) RunScFunction(functionName string) (err error)

func (*WasmContext) Sandbox

func (wc *WasmContext) Sandbox(funcNr int32, params []byte) []byte

func (*WasmContext) StateDelete

func (wc *WasmContext) StateDelete(key []byte)

func (*WasmContext) StateExists

func (wc *WasmContext) StateExists(key []byte) bool

func (*WasmContext) StateGet

func (wc *WasmContext) StateGet(key []byte) []byte

func (*WasmContext) StateSet

func (wc *WasmContext) StateSet(key, value []byte)

type WasmContextSandbox

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

WasmContextSandbox is the host side of the WasmLib Sandbox interface It acts as a change-resistant layer to wrap changes to the ISC sandbox, to limit bothering users of WasmLib as little as possible with those changes.

func NewWasmContextSandbox

func NewWasmContextSandbox(wc *WasmContext, ctx interface{}) *WasmContextSandbox

func (*WasmContextSandbox) Call

func (s *WasmContextSandbox) Call(funcNr int32, params []byte) []byte

func (*WasmContextSandbox) Logf added in v1.0.3

func (s *WasmContextSandbox) Logf(format string, args ...interface{})

func (*WasmContextSandbox) Panicf

func (s *WasmContextSandbox) Panicf(format string, args ...interface{})

func (*WasmContextSandbox) Tracef

func (s *WasmContextSandbox) Tracef(format string, args ...interface{})

type WasmConvertor

type WasmConvertor struct{}

WasmConvertor converts ISC data types to WasmLib data types

func (WasmConvertor) IscAddress added in v0.3.0

func (cvt WasmConvertor) IscAddress(scAddress *wasmtypes.ScAddress) iotago.Address

func (WasmConvertor) IscAgentID added in v0.3.0

func (cvt WasmConvertor) IscAgentID(scAgentID *wasmtypes.ScAgentID) isc.AgentID

func (WasmConvertor) IscAllowance added in v0.3.0

func (cvt WasmConvertor) IscAllowance(assets *wasmlib.ScAssets) *isc.Assets

func (WasmConvertor) IscBigInt added in v0.3.0

func (cvt WasmConvertor) IscBigInt(amount wasmtypes.ScBigInt) *big.Int

func (WasmConvertor) IscChainID added in v0.3.0

func (cvt WasmConvertor) IscChainID(chainID *wasmtypes.ScChainID) isc.ChainID

func (WasmConvertor) IscHash added in v0.3.0

func (cvt WasmConvertor) IscHash(hash *wasmtypes.ScHash) *hashing.HashValue

func (WasmConvertor) IscHname added in v0.3.0

func (cvt WasmConvertor) IscHname(hname wasmtypes.ScHname) isc.Hname

func (WasmConvertor) IscNFTID added in v0.3.0

func (cvt WasmConvertor) IscNFTID(nftID *wasmtypes.ScNftID) *iotago.NFTID

func (WasmConvertor) IscRequestID added in v0.3.0

func (cvt WasmConvertor) IscRequestID(requestID *wasmtypes.ScRequestID) isc.RequestID

func (WasmConvertor) IscTokenID added in v0.3.0

func (cvt WasmConvertor) IscTokenID(tokenID *wasmtypes.ScTokenID) iotago.NativeTokenID

func (WasmConvertor) ScAddress

func (cvt WasmConvertor) ScAddress(address iotago.Address) wasmtypes.ScAddress

func (WasmConvertor) ScAgentID

func (cvt WasmConvertor) ScAgentID(agentID isc.AgentID) wasmtypes.ScAgentID

func (WasmConvertor) ScBalances added in v0.3.0

func (cvt WasmConvertor) ScBalances(allowance *isc.Assets) *wasmlib.ScBalances

func (WasmConvertor) ScBigInt added in v0.3.0

func (cvt WasmConvertor) ScBigInt(bigInt *big.Int) wasmtypes.ScBigInt

func (WasmConvertor) ScChainID

func (cvt WasmConvertor) ScChainID(chainID isc.ChainID) wasmtypes.ScChainID

func (WasmConvertor) ScHash

func (cvt WasmConvertor) ScHash(hash hashing.HashValue) wasmtypes.ScHash

func (WasmConvertor) ScHname

func (cvt WasmConvertor) ScHname(hname isc.Hname) wasmtypes.ScHname

func (WasmConvertor) ScNftID added in v0.3.0

func (cvt WasmConvertor) ScNftID(nftID *iotago.NFTID) wasmtypes.ScNftID

func (WasmConvertor) ScRequestID

func (cvt WasmConvertor) ScRequestID(requestID isc.RequestID) wasmtypes.ScRequestID

func (WasmConvertor) ScTokenID added in v0.3.0

func (cvt WasmConvertor) ScTokenID(nativeTokenID iotago.NativeTokenID) wasmtypes.ScTokenID

func (WasmConvertor) ToBigInt added in v0.3.0

func (cvt WasmConvertor) ToBigInt(amount interface{}) *big.Int

type WasmFuncTable

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

func NewWasmFuncTable

func NewWasmFuncTable() *WasmFuncTable

func (*WasmFuncTable) FunctionFromCode

func (t *WasmFuncTable) FunctionFromCode(code uint32) string

func (*WasmFuncTable) SetExport

func (t *WasmFuncTable) SetExport(index int32, functionName string)

type WasmGoVM

type WasmGoVM struct {
	WasmVMBase
	// contains filtered or unexported fields
}

func (*WasmGoVM) Interrupt

func (vm *WasmGoVM) Interrupt()

func (*WasmGoVM) LoadWasm

func (vm *WasmGoVM) LoadWasm(wasmData []byte) error

func (*WasmGoVM) NewInstance

func (vm *WasmGoVM) NewInstance(wc *WasmContext) WasmVM

func (*WasmGoVM) RunFunction

func (vm *WasmGoVM) RunFunction(functionName string, args ...interface{}) error

func (*WasmGoVM) RunScFunction

func (vm *WasmGoVM) RunScFunction(index int32) (err error)

func (*WasmGoVM) UnsafeMemory

func (vm *WasmGoVM) UnsafeMemory() []byte

type WasmProcessor

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

func (*WasmProcessor) Entrypoints added in v1.0.3

func (proc *WasmProcessor) Entrypoints() map[isc.Hname]isc.ProcessorEntryPoint

func (*WasmProcessor) GetCurrentContext added in v0.3.0

func (proc *WasmProcessor) GetCurrentContext() *WasmContext

func (*WasmProcessor) GetDefaultEntryPoint

func (proc *WasmProcessor) GetDefaultEntryPoint() isc.VMProcessorEntryPoint

func (*WasmProcessor) GetDescription

func (proc *WasmProcessor) GetDescription() string

func (*WasmProcessor) GetEntryPoint

func (proc *WasmProcessor) GetEntryPoint(code isc.Hname) (isc.VMProcessorEntryPoint, bool)

func (*WasmProcessor) IsView

func (proc *WasmProcessor) IsView(function string) bool

func (*WasmProcessor) RegisterContext added in v0.3.0

func (proc *WasmProcessor) RegisterContext(wc *WasmContext)

func (*WasmProcessor) UnregisterContext added in v0.3.0

func (proc *WasmProcessor) UnregisterContext(wc *WasmContext)

type WasmTimeVM

type WasmTimeVM struct {
	WasmVMBase
	// contains filtered or unexported fields
}

func (*WasmTimeVM) GasBudget

func (vm *WasmTimeVM) GasBudget(budget uint64)

GasBudget sets the gas budget for the VM.

func (*WasmTimeVM) GasBurned

func (vm *WasmTimeVM) GasBurned() uint64

GasBurned will return the gas burned since the last time GasBudget() was called

func (*WasmTimeVM) Interrupt

func (vm *WasmTimeVM) Interrupt()

func (*WasmTimeVM) LinkHost

func (vm *WasmTimeVM) LinkHost() (err error)

func (*WasmTimeVM) LoadWasm

func (vm *WasmTimeVM) LoadWasm(wasmData []byte) (err error)

func (*WasmTimeVM) NewInstance

func (vm *WasmTimeVM) NewInstance(wc *WasmContext) WasmVM

func (*WasmTimeVM) RunFunction

func (vm *WasmTimeVM) RunFunction(functionName string, args ...interface{}) error

func (*WasmTimeVM) RunScFunction

func (vm *WasmTimeVM) RunScFunction(index int32) error

func (*WasmTimeVM) UnsafeMemory

func (vm *WasmTimeVM) UnsafeMemory() []byte

type WasmVM

type WasmVM interface {
	GasBudget(budget uint64)
	GasBurned() uint64
	Interrupt()
	LinkHost() error
	LoadWasm(wasmData []byte) error
	NewInstance(wc *WasmContext) WasmVM
	RunFunction(functionName string, args ...interface{}) error
	RunScFunction(index int32) error
	UnsafeMemory() []byte
	VMGetBytes(offset int32, size int32) []byte
	VMGetSize() int32
	VMSetBytes(offset int32, size int32, bytes []byte) int32
}

func NewWasmGoVM

func NewWasmGoVM(scName string, onLoad ScOnloadFunc) WasmVM

func NewWasmTimeVM

func NewWasmTimeVM() WasmVM

type WasmVMBase

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

func (*WasmVMBase) GasBudget

func (vm *WasmVMBase) GasBudget(budget uint64)

func (*WasmVMBase) GasBurned

func (vm *WasmVMBase) GasBurned() uint64

func (*WasmVMBase) HostAbort

func (vm *WasmVMBase) HostAbort(errMsg, fileName, line, col int32)

func (*WasmVMBase) HostFdWrite

func (vm *WasmVMBase) HostFdWrite(fd, iovs, size, written int32) int32

func (*WasmVMBase) HostStateGet

func (vm *WasmVMBase) HostStateGet(keyRef, keyLen, valRef, valLen int32) int32

func (*WasmVMBase) HostStateSet

func (vm *WasmVMBase) HostStateSet(keyRef, keyLen, valRef, valLen int32)

func (*WasmVMBase) Instantiate

func (vm *WasmVMBase) Instantiate(proc *WasmProcessor) error

func (*WasmVMBase) LinkHost

func (vm *WasmVMBase) LinkHost() error

func (*WasmVMBase) Run

func (vm *WasmVMBase) Run(runner func() error) (err error)

func (*WasmVMBase) VMGetBytes

func (vm *WasmVMBase) VMGetBytes(offset, size int32) []byte

func (*WasmVMBase) VMGetSize

func (vm *WasmVMBase) VMGetSize() int32

func (*WasmVMBase) VMSetBytes

func (vm *WasmVMBase) VMSetBytes(offset, size int32, bytes []byte) int32

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL