compiler

Documentation

Index

• func Compile(name string, r io.Reader) ([]byte, error)
• func CompileAndSave(src string, o *Options) ([]byte, error)
• type DebugInfo
  • func CodeGen(info *buildInfo) ([]byte, *DebugInfo, error)
  • func CompileWithDebugInfo(name string, r io.Reader) ([]byte, *DebugInfo, error)
  • func (di *DebugInfo) ConvertToManifest(fs smartcontract.PropertyState, events []manifest.Event, ...) (*manifest.Manifest, error)
• type DebugMethodName
  • func (d *DebugMethodName) MarshalJSON() ([]byte, error)
  • func (d *DebugMethodName) UnmarshalJSON(data []byte) error
• type DebugParam
  • func (d *DebugParam) MarshalJSON() ([]byte, error)
  • func (d *DebugParam) ToManifestParameter() (manifest.Parameter, error)
  • func (d *DebugParam) UnmarshalJSON(data []byte) error
• type DebugRange
  • func (d *DebugRange) MarshalJSON() ([]byte, error)
  • func (d *DebugRange) UnmarshalJSON(data []byte) error
• type DebugSeqPoint
  • func (d *DebugSeqPoint) MarshalJSON() ([]byte, error)
  • func (d *DebugSeqPoint) UnmarshalJSON(data []byte) error
• type EventDebugInfo
  • func (e *EventDebugInfo) ToManifestEvent() (manifest.Event, error)
• type MethodDebugInfo
  • func (m *MethodDebugInfo) ToManifestMethod() (manifest.Method, error)
• type Options
• type Syscall

Functions

func Compile

func Compile(name string, r io.Reader) ([]byte, error)

Compile compiles a Go program into bytecode that can run on the NEO virtual machine. If `r != nil`, `name` is interpreted as a filename, and `r` as file contents. Otherwise `name` is either file name or name of the directory containing source files.

func CompileAndSave

func CompileAndSave(src string, o *Options) ([]byte, error)

CompileAndSave will compile and save the file to disk in the NEF format.

Types

type DebugInfo

type DebugInfo struct {
	MainPkg   string            `json:"-"`
	Hash      util.Uint160      `json:"hash"`
	Documents []string          `json:"documents"`
	Methods   []MethodDebugInfo `json:"methods"`
	Events    []EventDebugInfo  `json:"events"`
}

DebugInfo represents smart-contract debug information.

func CodeGen

func CodeGen(info *buildInfo) ([]byte, *DebugInfo, error)

CodeGen compiles the program to bytecode.

func CompileWithDebugInfo

func CompileWithDebugInfo(name string, r io.Reader) ([]byte, *DebugInfo, error)

CompileWithDebugInfo compiles a Go program into bytecode and emits debug info.

func (*DebugInfo) ConvertToManifest

func (di *DebugInfo) ConvertToManifest(fs smartcontract.PropertyState, events []manifest.Event, supportedStandards ...string) (*manifest.Manifest, error)

ConvertToManifest converts contract to the manifest.Manifest struct for debugger. Note: manifest is taken from the external source, however it can be generated ad-hoc. See #1038.

type DebugMethodName

type DebugMethodName struct {
	Namespace string
	Name      string
}

DebugMethodName is a combination of a namespace and name.

func (*DebugMethodName) MarshalJSON

func (d *DebugMethodName) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*DebugMethodName) UnmarshalJSON

func (d *DebugMethodName) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type DebugParam

type DebugParam struct {
	Name string `json:"name"`
	Type string `json:"type"`
}

DebugParam represents variables's name and type.

func (*DebugParam) MarshalJSON

func (d *DebugParam) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*DebugParam) ToManifestParameter

func (d *DebugParam) ToManifestParameter() (manifest.Parameter, error)

ToManifestParameter converts DebugParam to manifest.Parameter

func (*DebugParam) UnmarshalJSON

func (d *DebugParam) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type DebugRange

type DebugRange struct {
	Start uint16
	End   uint16
}

DebugRange represents method's section in bytecode.

func (*DebugRange) MarshalJSON

func (d *DebugRange) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*DebugRange) UnmarshalJSON

func (d *DebugRange) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type DebugSeqPoint

type DebugSeqPoint struct {
	// Opcode is an opcode's address.
	Opcode int
	// Document is an index of file where sequence point occurs.
	Document int
	// StartLine is the first line of the break-pointed statement.
	StartLine int
	// StartCol is the first column of the break-pointed statement.
	StartCol int
	// EndLine is the last line of the break-pointed statement.
	EndLine int
	// EndCol is the last column of the break-pointed statement.
	EndCol int
}

DebugSeqPoint represents break-point for debugger.

func (*DebugSeqPoint) MarshalJSON

func (d *DebugSeqPoint) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*DebugSeqPoint) UnmarshalJSON

func (d *DebugSeqPoint) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type EventDebugInfo

type EventDebugInfo struct {
	ID string `json:"id"`
	// Name is a human-readable event name in a format "{namespace},{name}".
	Name       string       `json:"name"`
	Parameters []DebugParam `json:"params"`
}

EventDebugInfo represents smart-contract's event debug information.

func (*EventDebugInfo) ToManifestEvent

func (e *EventDebugInfo) ToManifestEvent() (manifest.Event, error)

ToManifestEvent converts EventDebugInfo to manifest.Event

type MethodDebugInfo

type MethodDebugInfo struct {
	// ID is the actual name of the method.
	ID string `json:"id"`
	// Name is the name of the method with the first letter in a lowercase
	// together with the namespace it belongs to. We need to keep the first letter
	// lowercased to match manifest standards.
	Name DebugMethodName `json:"name"`
	// IsExported defines whether method is exported.
	IsExported bool `json:"-"`
	// Range is the range of smart-contract's opcodes corresponding to the method.
	Range DebugRange `json:"range"`
	// Parameters is a list of method's parameters.
	Parameters []DebugParam `json:"params"`
	// ReturnType is method's return type.
	ReturnType string   `json:"return"`
	Variables  []string `json:"variables"`
	// SeqPoints is a map between source lines and byte-code instruction offsets.
	SeqPoints []DebugSeqPoint `json:"sequence-points"`
}

MethodDebugInfo represents smart-contract's method debug information.

func (*MethodDebugInfo) ToManifestMethod

func (m *MethodDebugInfo) ToManifestMethod() (manifest.Method, error)

ToManifestMethod converts MethodDebugInfo to manifest.Method

type Options

type Options struct {
	// The extension of the output file default set to .nef
	Ext string

	// The name of the output file.
	Outfile string

	// The name of the output for debug info.
	DebugInfo string

	// The name of the output for contract manifest file.
	ManifestFile string

	// Contract features.
	ContractFeatures smartcontract.PropertyState

	// Runtime notifications.
	ContractEvents []manifest.Event

	// The list of standards supported by the contract.
	ContractSupportedStandards []string
}

Options contains all the parameters that affect the behaviour of the compiler.

type Syscall

type Syscall struct {
	API                   string
	ConvertResultToStruct bool
}

Syscall represents NEO or System syscall API with flag for proper AVM generation