runtime

package
v0.2.1 Latest Latest
Warning

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

 Go to latest Published: May 12, 2020 License: Apache-2.0 Imports: 20 Imported by: 54

README

Cadence Runtime

Usage

  • go run ./cmd <filename>

Development

Update the parser
  • antlr -listener -visitor -Dlanguage=Go -package parser parser/Cadence.g4

Documentation

Index

Constants

View Source 
const (
	AddressPrefix            = ast.AddressPrefix
	TransactionPrefix string = "T"
	ScriptPrefix      string = "S"
)

Variables

This section is empty.

Functions

func CodeToHashValue added in v0.2.0 

func CodeToHashValue(code []byte) *interpreter.ArrayValue

func FormatErrorMessage 

func FormatErrorMessage(message string, useColor bool) string

func PrettyPrintError 

func PrettyPrintError(err error, filename string, code string, useColor bool) string

Types

type Address 

type Address = common.Address

type AddressLocation 

type AddressLocation = ast.AddressLocation

type BlockValue 

type BlockValue struct {
	Height    interpreter.UInt64Value
	ID        *interpreter.ArrayValue
	Timestamp interpreter.Fix64Value
}

func NewBlockValue added in v0.2.0 

func NewBlockValue(height uint64, id [stdlib.BlockIDSize]byte, timestamp time.Time) BlockValue

func (BlockValue) Copy 

func (v BlockValue) Copy() interpreter.Value

func (BlockValue) DynamicType 

func (BlockValue) DynamicType(*interpreter.Interpreter) interpreter.DynamicType

func (BlockValue) GetMember 

func (v BlockValue) GetMember(_ *interpreter.Interpreter, _ interpreter.LocationRange, name string) interpreter.Value

func (BlockValue) GetOwner 

func (BlockValue) GetOwner() *common.Address

func (BlockValue) IDAsByteArray added in v0.2.0 

func (v BlockValue) IDAsByteArray() [stdlib.BlockIDSize]byte

func (BlockValue) IsValue 

func (BlockValue) IsValue()

func (BlockValue) Modified added in v0.2.1 

func (BlockValue) Modified() bool

func (BlockValue) SetMember 

func (v BlockValue) SetMember(_ *interpreter.Interpreter, _ interpreter.LocationRange, _ string, _ interpreter.Value)

func (BlockValue) SetOwner 

func (BlockValue) SetOwner(_ *common.Address)

func (BlockValue) String 

func (v BlockValue) String() string

type ComputationLimitExceededError added in v0.2.0 

type ComputationLimitExceededError struct {
	Limit uint64
}

func (ComputationLimitExceededError) Error added in v0.2.0 

func (e ComputationLimitExceededError) Error() string

type EmptyRuntimeInterface 

type EmptyRuntimeInterface struct{}

func (*EmptyRuntimeInterface) AddAccountKey 

func (i *EmptyRuntimeInterface) AddAccountKey(_ Address, _ []byte) error

func (*EmptyRuntimeInterface) CacheProgram added in v0.2.0 

func (i *EmptyRuntimeInterface) CacheProgram(_ Location, _ *ast.Program) error

func (*EmptyRuntimeInterface) CheckCode 

func (i *EmptyRuntimeInterface) CheckCode(_ Address, _ []byte) error

func (*EmptyRuntimeInterface) CreateAccount 

func (i *EmptyRuntimeInterface) CreateAccount(_ [][]byte) (address Address, err error)

func (*EmptyRuntimeInterface) DecodeArgument added in v0.2.0 

func (i *EmptyRuntimeInterface) DecodeArgument(_ []byte, _ cadence.Type) (cadence.Value, error)

func (*EmptyRuntimeInterface) EmitEvent 

func (i *EmptyRuntimeInterface) EmitEvent(_ cadence.Event)

func (*EmptyRuntimeInterface) GenerateUUID 

func (i *EmptyRuntimeInterface) GenerateUUID() uint64

func (*EmptyRuntimeInterface) GetCachedProgram added in v0.2.0 

func (i *EmptyRuntimeInterface) GetCachedProgram(_ Location) (*ast.Program, error)

func (*EmptyRuntimeInterface) GetComputationLimit added in v0.2.0 

func (i *EmptyRuntimeInterface) GetComputationLimit() uint64

func (*EmptyRuntimeInterface) GetSigningAccounts 

func (i *EmptyRuntimeInterface) GetSigningAccounts() []Address

func (*EmptyRuntimeInterface) GetValue 

func (i *EmptyRuntimeInterface) GetValue(_, _, _ []byte) (value []byte, err error)

func (*EmptyRuntimeInterface) Log 

func (i *EmptyRuntimeInterface) Log(_ string)

func (*EmptyRuntimeInterface) RemoveAccountKey 

func (i *EmptyRuntimeInterface) RemoveAccountKey(_ Address, _ int) (publicKey []byte, err error)

func (*EmptyRuntimeInterface) ResolveImport 

func (i *EmptyRuntimeInterface) ResolveImport(_ Location) ([]byte, error)

func (*EmptyRuntimeInterface) SetValue 

func (i *EmptyRuntimeInterface) SetValue(_, _, _, _ []byte) error

func (*EmptyRuntimeInterface) UpdateAccountCode 

func (i *EmptyRuntimeInterface) UpdateAccountCode(_ Address, _ []byte, _ bool) error

func (*EmptyRuntimeInterface) ValueExists 

func (i *EmptyRuntimeInterface) ValueExists(_, _, _ []byte) (exists bool, err error)

type Error 

type Error struct {
	Err error
}

Error is the containing type for all errors produced by the runtime.

func (Error) Error 

func (e Error) Error() string

func (Error) Unwrap 

func (e Error) Unwrap() error

type FileLocation 

type FileLocation string

func (FileLocation) ID 

func (l FileLocation) ID() ast.LocationID

func (FileLocation) String 

func (l FileLocation) String() string

type ImportResolver 

type ImportResolver = func(location Location) (program *ast.Program, e error)

type Interface 

type Interface interface {
	// ResolveImport resolves an import of a program.
	ResolveImport(Location) ([]byte, error)
	// GetCachedProgram attempts to get a parsed program from a cache.
	GetCachedProgram(Location) (*ast.Program, error)
	// CacheProgram adds a parsed program to a cache.
	CacheProgram(Location, *ast.Program) error
	// GetValue gets a value for the given key in the storage, controlled and owned by the given accounts.
	GetValue(owner, controller, key []byte) (value []byte, err error)
	// SetValue sets a value for the given key in the storage, controlled and owned by the given accounts.
	SetValue(owner, controller, key, value []byte) (err error)
	// CreateAccount creates a new account with the given public keys and code.
	CreateAccount(publicKeys [][]byte) (address Address, err error)
	// AddAccountKey appends a key to an account.
	AddAccountKey(address Address, publicKey []byte) error
	// RemoveAccountKey removes a key from an account by index.
	RemoveAccountKey(address Address, index int) (publicKey []byte, err error)
	// CheckCode checks the validity of the code.
	CheckCode(address Address, code []byte) (err error)
	// UpdateAccountCode updates the code associated with an account.
	UpdateAccountCode(address Address, code []byte, checkPermission bool) (err error)
	// GetSigningAccounts returns the signing accounts.
	GetSigningAccounts() []Address
	// Log logs a string.
	Log(string)
	// EmitEvent is called when an event is emitted by the runtime.
	EmitEvent(cadence.Event)
	// ValueExists returns true if the given key exists in the storage, controlled and owned by the given accounts.
	ValueExists(owner, controller, key []byte) (exists bool, err error)
	// GenerateUUID is called to generate a UUID.
	GenerateUUID() uint64
	// GetComputationLimit returns the computation limit. A value <= 0 means there is no limit
	GetComputationLimit() uint64
	// DecodeArgument decodes a transaction argument against the given type.
	DecodeArgument(b []byte, t cadence.Type) (cadence.Value, error)
}

type InvalidTransactionArgumentError added in v0.2.0 

type InvalidTransactionArgumentError struct {
	Index int
	Err   error
}

func (*InvalidTransactionArgumentError) Error added in v0.2.0 

func (e *InvalidTransactionArgumentError) Error() string

func (*InvalidTransactionArgumentError) Unwrap added in v0.2.0 

func (e *InvalidTransactionArgumentError) Unwrap() error

type InvalidTransactionAuthorizerCountError added in v0.2.0 

type InvalidTransactionAuthorizerCountError struct {
	Expected int
	Actual   int
}

func (InvalidTransactionAuthorizerCountError) Error added in v0.2.0 

func (e InvalidTransactionAuthorizerCountError) Error() string

type InvalidTransactionCountError 

type InvalidTransactionCountError struct {
	Count int
}

func (InvalidTransactionCountError) Error 

func (e InvalidTransactionCountError) Error() string

type InvalidTransactionParameterCountError 

type InvalidTransactionParameterCountError struct {
	Expected int
	Actual   int
}

func (InvalidTransactionParameterCountError) Error 

func (e InvalidTransactionParameterCountError) Error() string

type InvalidTypeAssignmentError added in v0.2.0 

type InvalidTypeAssignmentError struct {
	Value interpreter.Value
	Type  sema.Type
	Err   error
}

func (*InvalidTypeAssignmentError) Error added in v0.2.0 

func (e *InvalidTypeAssignmentError) Error() string

func (*InvalidTypeAssignmentError) Unwrap added in v0.2.0 

func (e *InvalidTypeAssignmentError) Unwrap() error

type Location 

type Location = ast.Location

type LocationID 

type LocationID = ast.LocationID

type Metrics added in v0.2.0 

type Metrics interface {
	ProgramParsed(location ast.Location, duration time.Duration)
	ProgramChecked(location ast.Location, duration time.Duration)
	ProgramInterpreted(location ast.Location, duration time.Duration)
	ValueEncoded(duration time.Duration)
	ValueDecoded(duration time.Duration)
}

type REPL 

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

func NewREPL 

func NewREPL(onError func(error), onResult func(interpreter.Value)) (*REPL, error)

func (*REPL) Accept 

func (r *REPL) Accept(code string) (inputIsComplete bool)

func (*REPL) Suggestions 

func (r *REPL) Suggestions() (result []REPLSuggestion)

type REPLLocation 

type REPLLocation struct{}

func (REPLLocation) ID 

func (l REPLLocation) ID() LocationID

func (REPLLocation) String 

func (l REPLLocation) String() string

type REPLSuggestion added in v0.2.0 

type REPLSuggestion struct {
	Name, Description string
}

type Runtime 

type Runtime interface {
	// ExecuteScript executes the given script.
	//
	// This function returns an error if the program has errors (e.g syntax errors, type errors),
	// or if the execution fails.
	ExecuteScript(script []byte, runtimeInterface Interface, location Location) (cadence.Value, error)

	// ExecuteTransaction executes the given transaction.
	//
	// This function returns an error if the program has errors (e.g syntax errors, type errors),
	// or if the execution fails.
	ExecuteTransaction(script []byte, arguments [][]byte, runtimeInterface Interface, location Location) error

	// ParseAndCheckProgram parses and checks the given code without executing the program.
	//
	// This function returns an error if the program contains any syntax or semantic errors.
	ParseAndCheckProgram(code []byte, runtimeInterface Interface, location Location) error
}

Runtime is a runtime capable of executing Cadence.

func NewInterpreterRuntime 

func NewInterpreterRuntime() Runtime

NewInterpreterRuntime returns a interpreter-based version of the Flow runtime.

type ScriptLocation 

type ScriptLocation []byte

func (ScriptLocation) ID 

func (l ScriptLocation) ID() ast.LocationID

func (ScriptLocation) String 

func (l ScriptLocation) String() string

type StringLocation 

type StringLocation = ast.StringLocation

type TransactionLocation 

type TransactionLocation []byte

func (TransactionLocation) ID 

func (l TransactionLocation) ID() ast.LocationID

func (TransactionLocation) String 

func (l TransactionLocation) String() string

Source Files

View all Source files

Directories

Path Synopsis
cmd
execute
main
interface_entry
intervalst
lexer
tests
utils

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.