Documentation
      ¶
    
    
  
    
  
    Index ¶
- Constants
 - func Sort(fs []Function)
 - type Context
 - func (ic *Context) BaseExecFee() int64
 - func (ic *Context) GetContract(hash util.Uint160) (*state.Contract, error)
 - func (ic *Context) GetFunction(id uint32) *Function
 - func (ic *Context) GetPrice(op opcode.Opcode, parameter []byte) int64
 - func (ic *Context) SpawnVM() *vm.VM
 - func (ic *Context) SyscallHandler(_ *vm.VM, id uint32) error
 
- type Contract
 - type ContractMD
 - type Function
 - type Method
 - type MethodAndArgCount
 - type MethodAndPrice
 
Constants ¶
const (
	// DefaultBaseExecFee specifies default multiplier for opcode and syscall prices.
	DefaultBaseExecFee = 30
)
    Variables ¶
This section is empty.
Functions ¶
Types ¶
type Context ¶
type Context struct {
	Chain         blockchainer.Blockchainer
	Container     crypto.Verifiable
	Natives       []Contract
	Trigger       trigger.Type
	Block         *block.Block
	Tx            *transaction.Transaction
	DAO           *dao.Cached
	Notifications []state.NotificationEvent
	Log           *zap.Logger
	VM            *vm.VM
	Functions     [][]Function
	// contains filtered or unexported fields
}
    Context represents context in which interops are executed.
func NewContext ¶
func NewContext(trigger trigger.Type, bc blockchainer.Blockchainer, d dao.DAO, getContract func(dao.DAO, util.Uint160) (*state.Contract, error), natives []Contract, block *block.Block, tx *transaction.Transaction, log *zap.Logger) *Context
NewContext returns new interop context.
func (*Context) BaseExecFee ¶ added in v0.92.0
BaseExecFee represents factor to multiply syscall prices with.
func (*Context) GetContract ¶ added in v0.92.0
GetContract returns contract by its hash in current interop context.
func (*Context) GetFunction ¶ added in v0.91.0
GetFunction returns metadata for interop with the specified id.
func (*Context) GetPrice ¶ added in v0.93.0
GetPrice returns a price for executing op with the provided parameter.
type Contract ¶
type Contract interface {
	Initialize(*Context) error
	Metadata() *ContractMD
	OnPersist(*Context) error
	PostPersist(*Context) error
}
    Contract is an interface for all native contracts.
type ContractMD ¶
type ContractMD struct {
	state.NativeContract
	Name    string
	Methods map[MethodAndArgCount]MethodAndPrice
}
    ContractMD represents native contract instance.
func NewContractMD ¶
func NewContractMD(name string, id int32) *ContractMD
NewContractMD returns Contract with the specified list of methods.
func (*ContractMD) AddEvent ¶
func (c *ContractMD) AddEvent(name string, ps ...manifest.Parameter)
AddEvent adds new event to a native contract.
func (*ContractMD) AddMethod ¶
func (c *ContractMD) AddMethod(md *MethodAndPrice, desc *manifest.Method)
AddMethod adds new method to a native contract.
func (*ContractMD) GetMethod ¶ added in v0.93.0
func (c *ContractMD) GetMethod(name string, paramCount int) (MethodAndPrice, bool)
GetMethod returns method `name` with specified number of parameters.
type Function ¶
type Function struct {
	ID   uint32
	Name string
	Func func(*Context) error
	// ParamCount is a number of function parameters.
	ParamCount int
	Price      int64
	// RequiredFlags is a set of flags which must be set during script invocations.
	// Default value is NoneFlag i.e. no flags are required.
	RequiredFlags callflag.CallFlag
}
    Function binds function name, id with the function itself and price, it's supposed to be inited once for all interopContexts, so it doesn't use vm.InteropFuncPrice directly.
type MethodAndArgCount ¶ added in v0.93.0
MethodAndArgCount represents method's signature.