runtime

Documentation

Index

• type CadenceRuntimeConstructor
• type Environment
• type ReusableCadenceRuntime
  • func NewReusableCadenceRuntime(rt runtime.Runtime, config runtime.Config) *ReusableCadenceRuntime
  • func (reusable *ReusableCadenceRuntime) ExecuteScript(script runtime.Script, location common.Location) (cadence.Value, error)
  • func (reusable *ReusableCadenceRuntime) InvokeContractFunction(contractLocation common.AddressLocation, functionName string, ...) (cadence.Value, error)
  • func (reusable *ReusableCadenceRuntime) NewTransactionExecutor(script runtime.Script, location common.Location) runtime.Executor
  • func (reusable *ReusableCadenceRuntime) ReadStored(address common.Address, path cadence.Path) (cadence.Value, error)
  • func (reusable *ReusableCadenceRuntime) SetFvmEnvironment(fvmEnv Environment)
• type ReusableCadenceRuntimePool
  • func NewCustomReusableCadenceRuntimePool(poolSize int, config runtime.Config, ...) ReusableCadenceRuntimePool
  • func NewReusableCadenceRuntimePool(poolSize int, config runtime.Config) ReusableCadenceRuntimePool
  • func (pool ReusableCadenceRuntimePool) Borrow(fvmEnv Environment) *ReusableCadenceRuntime
  • func (pool ReusableCadenceRuntimePool) Return(reusable *ReusableCadenceRuntime)
• type WrappedCadenceExecutor
  • func (we WrappedCadenceExecutor) Execute() error
  • func (we WrappedCadenceExecutor) Preprocess() error
  • func (we WrappedCadenceExecutor) Result() (cadence.Value, error)
• type WrappedCadenceRuntime
  • func (wr WrappedCadenceRuntime) ExecuteScript(s runtime.Script, c runtime.Context) (cadence.Value, error)
  • func (wr WrappedCadenceRuntime) ExecuteTransaction(s runtime.Script, c runtime.Context) error
  • func (wr WrappedCadenceRuntime) InvokeContractFunction(contractLocation common.AddressLocation, functionName string, ...) (cadence.Value, error)
  • func (wr WrappedCadenceRuntime) NewContractFunctionExecutor(contractLocation common.AddressLocation, functionName string, ...) runtime.Executor
  • func (wr WrappedCadenceRuntime) NewScriptExecutor(s runtime.Script, c runtime.Context) runtime.Executor
  • func (wr WrappedCadenceRuntime) NewTransactionExecutor(s runtime.Script, c runtime.Context) runtime.Executor
  • func (wr WrappedCadenceRuntime) ParseAndCheckProgram(source []byte, context runtime.Context) (*interpreter.Program, error)
  • func (wr WrappedCadenceRuntime) ReadStored(address common.Address, path cadence.Path, context runtime.Context) (cadence.Value, error)
  • func (wr WrappedCadenceRuntime) Storage(context runtime.Context) (*runtime.Storage, *interpreter.Interpreter, error)

Types

type CadenceRuntimeConstructor

type CadenceRuntimeConstructor func(config runtime.Config) runtime.Runtime

type Environment

type Environment interface {
	runtime.Interface

	RandomSourceHistory() ([]byte, error)
}

Note: this is a subset of environment.Environment, redeclared to handle circular dependency.

type ReusableCadenceRuntime

type ReusableCadenceRuntime struct {
	runtime.Runtime
	TxRuntimeEnv     runtime.Environment
	ScriptRuntimeEnv runtime.Environment
	// contains filtered or unexported fields
}

func NewReusableCadenceRuntime

func NewReusableCadenceRuntime(rt runtime.Runtime, config runtime.Config) *ReusableCadenceRuntime

func (*ReusableCadenceRuntime) ExecuteScript

func (reusable *ReusableCadenceRuntime) ExecuteScript(
	script runtime.Script,
	location common.Location,
) (
	cadence.Value,
	error,
)

func (*ReusableCadenceRuntime) InvokeContractFunction

func (reusable *ReusableCadenceRuntime) InvokeContractFunction(
	contractLocation common.AddressLocation,
	functionName string,
	arguments []cadence.Value,
	argumentTypes []sema.Type,
) (
	cadence.Value,
	error,
)

func (*ReusableCadenceRuntime) NewTransactionExecutor

func (reusable *ReusableCadenceRuntime) NewTransactionExecutor(
	script runtime.Script,
	location common.Location,
) runtime.Executor

func (*ReusableCadenceRuntime) ReadStored

func (reusable *ReusableCadenceRuntime) ReadStored(
	address common.Address,
	path cadence.Path,
) (
	cadence.Value,
	error,
)

func (*ReusableCadenceRuntime) SetFvmEnvironment

func (reusable *ReusableCadenceRuntime) SetFvmEnvironment(fvmEnv Environment)

type ReusableCadenceRuntimePool

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

func NewCustomReusableCadenceRuntimePool

func NewCustomReusableCadenceRuntimePool(
	poolSize int,
	config runtime.Config,
	newCustomRuntime CadenceRuntimeConstructor,
) ReusableCadenceRuntimePool

func NewReusableCadenceRuntimePool

func NewReusableCadenceRuntimePool(
	poolSize int,
	config runtime.Config,
) ReusableCadenceRuntimePool

func (ReusableCadenceRuntimePool) Borrow

func (pool ReusableCadenceRuntimePool) Borrow(
	fvmEnv Environment,
) *ReusableCadenceRuntime

func (ReusableCadenceRuntimePool) Return

func (pool ReusableCadenceRuntimePool) Return(
	reusable *ReusableCadenceRuntime,
)

type WrappedCadenceExecutor

type WrappedCadenceExecutor struct {
	runtime.Executor
}

func (WrappedCadenceExecutor) Execute

func (we WrappedCadenceExecutor) Execute() error

func (WrappedCadenceExecutor) Preprocess

func (we WrappedCadenceExecutor) Preprocess() error

func (WrappedCadenceExecutor) Result

func (we WrappedCadenceExecutor) Result() (cadence.Value, error)

type WrappedCadenceRuntime

type WrappedCadenceRuntime struct {
	runtime.Runtime
}

WrappedCadenceRuntime wraps cadence runtime to handle errors. Errors from cadence runtime should be handled with `errors.HandleRuntimeError` before the FVM can understand them. Handling all possible locations, where the error could be coming from, here, makes it impossible to forget to handle the error.

func (WrappedCadenceRuntime) ExecuteScript

func (wr WrappedCadenceRuntime) ExecuteScript(s runtime.Script, c runtime.Context) (cadence.Value, error)

func (WrappedCadenceRuntime) ExecuteTransaction

func (wr WrappedCadenceRuntime) ExecuteTransaction(s runtime.Script, c runtime.Context) error

func (WrappedCadenceRuntime) InvokeContractFunction

func (wr WrappedCadenceRuntime) InvokeContractFunction(
	contractLocation common.AddressLocation,
	functionName string,
	arguments []cadence.Value,
	argumentTypes []sema.Type,
	context runtime.Context,
) (cadence.Value, error)

func (WrappedCadenceRuntime) NewContractFunctionExecutor

func (wr WrappedCadenceRuntime) NewContractFunctionExecutor(
	contractLocation common.AddressLocation,
	functionName string,
	arguments []cadence.Value,
	argumentTypes []sema.Type,
	context runtime.Context,
) runtime.Executor

func (WrappedCadenceRuntime) NewScriptExecutor

func (wr WrappedCadenceRuntime) NewScriptExecutor(s runtime.Script, c runtime.Context) runtime.Executor

func (WrappedCadenceRuntime) NewTransactionExecutor

func (wr WrappedCadenceRuntime) NewTransactionExecutor(s runtime.Script, c runtime.Context) runtime.Executor

func (WrappedCadenceRuntime) ParseAndCheckProgram

func (wr WrappedCadenceRuntime) ParseAndCheckProgram(source []byte, context runtime.Context) (*interpreter.Program, error)

func (WrappedCadenceRuntime) ReadStored

func (wr WrappedCadenceRuntime) ReadStored(address common.Address, path cadence.Path, context runtime.Context) (cadence.Value, error)

func (WrappedCadenceRuntime) Storage

func (wr WrappedCadenceRuntime) Storage(context runtime.Context) (*runtime.Storage, *interpreter.Interpreter, error)