forked from TrueCloudLab/neoneo-go
113 lines
4.7 KiB
Go
113 lines
4.7 KiB
Go
/*
|
|
Package runtime provides various service functions related to execution environment.
|
|
It has similar function to Runtime class in .net framwork for Neo.
|
|
*/
|
|
package runtime
|
|
|
|
import (
|
|
"github.com/nspcc-dev/neo-go/pkg/interop"
|
|
"github.com/nspcc-dev/neo-go/pkg/interop/neogointernal"
|
|
)
|
|
|
|
// Trigger values to compare with GetTrigger result.
|
|
const (
|
|
OnPersist byte = 0x01
|
|
PostPersist byte = 0x02
|
|
Application byte = 0x40
|
|
Verification byte = 0x20
|
|
)
|
|
|
|
// BurnGas burns provided amount of GAS. It uses `System.Runtime.BurnGas` syscall.
|
|
func BurnGas(gas int) {
|
|
neogointernal.Syscall1NoReturn("System.Runtime.BurnGas", gas)
|
|
}
|
|
|
|
// CheckWitness verifies if the given script hash (160-bit BE value in a 20 byte
|
|
// slice) or key (compressed serialized 33-byte form) is one of the signers of
|
|
// this invocation. It uses `System.Runtime.CheckWitness` syscall.
|
|
func CheckWitness(hashOrKey []byte) bool {
|
|
return neogointernal.Syscall1("System.Runtime.CheckWitness", hashOrKey).(bool)
|
|
}
|
|
|
|
// Log instructs VM to log the given message. It's mostly used for debugging
|
|
// purposes as these messages are not saved anywhere normally and usually are
|
|
// only visible in the VM logs. This function uses `System.Runtime.Log` syscall.
|
|
func Log(message string) {
|
|
neogointernal.Syscall1NoReturn("System.Runtime.Log", message)
|
|
}
|
|
|
|
// Notify sends a notification (collecting all arguments in an array) to the
|
|
// executing environment. Unlike Log it can accept any data along with the event name
|
|
// and resulting notification is saved in application log. It's intended to be used as a
|
|
// part of contract's API to external systems, these events can be monitored
|
|
// from outside and act upon accordingly. This function uses
|
|
// `System.Runtime.Notify` syscall.
|
|
func Notify(name string, args ...interface{}) {
|
|
neogointernal.Syscall2NoReturn("System.Runtime.Notify", name, args)
|
|
}
|
|
|
|
// GetAddressVersion returns the address version of the current protocol. The
|
|
// address version represents the byte used to prepend to Neo addresses when
|
|
// encoding them. The default value for Neo3 is 53 (0x35). This function uses
|
|
// `System.Runtime.GetAddressVersion` syscall.
|
|
func GetAddressVersion() int {
|
|
return neogointernal.Syscall0("System.Runtime.GetAddressVersion").(int)
|
|
}
|
|
|
|
// GetNetwork returns network magic number. This function uses
|
|
// `System.Runtime.GetNetwork` syscall.
|
|
func GetNetwork() int {
|
|
return neogointernal.Syscall0("System.Runtime.GetNetwork").(int)
|
|
}
|
|
|
|
// GetTime returns the timestamp of the most recent block. Note that when running
|
|
// script in test mode this would be the last accepted (persisted) block in the
|
|
// chain, but when running as a part of the new block the time returned is the
|
|
// time of this (currently being processed) block. This function uses
|
|
// `System.Runtime.GetTime` syscall.
|
|
func GetTime() int {
|
|
return neogointernal.Syscall0("System.Runtime.GetTime").(int)
|
|
}
|
|
|
|
// GetTrigger returns the smart contract invocation trigger which can be either
|
|
// verification or application. It can be used to differentiate running contract
|
|
// as a part of verification process from running it as a regular application.
|
|
// Some interop functions (especially ones that change the state in any way) are
|
|
// not available when running with verification trigger. This function uses
|
|
// `System.Runtime.GetTrigger` syscall.
|
|
func GetTrigger() byte {
|
|
return neogointernal.Syscall0("System.Runtime.GetTrigger").(byte)
|
|
}
|
|
|
|
// GasLeft returns the amount of gas available for the current execution.
|
|
// This function uses `System.Runtime.GasLeft` syscall.
|
|
func GasLeft() int {
|
|
return neogointernal.Syscall0("System.Runtime.GasLeft").(int)
|
|
}
|
|
|
|
// GetNotifications returns notifications emitted by contract h.
|
|
// 'nil' literal means no filtering. It returns slice consisting of following elements:
|
|
// [ scripthash of notification's contract , emitted item ].
|
|
// This function uses `System.Runtime.GetNotifications` syscall.
|
|
func GetNotifications(h interop.Hash160) [][]interface{} {
|
|
return neogointernal.Syscall1("System.Runtime.GetNotifications", h).([][]interface{})
|
|
}
|
|
|
|
// GetInvocationCounter returns how many times current contract was invoked during current tx execution.
|
|
// This function uses `System.Runtime.GetInvocationCounter` syscall.
|
|
func GetInvocationCounter() int {
|
|
return neogointernal.Syscall0("System.Runtime.GetInvocationCounter").(int)
|
|
}
|
|
|
|
// Platform returns the platform name, which is set to be `NEO`. This function uses
|
|
// `System.Runtime.Platform` syscall.
|
|
func Platform() []byte {
|
|
return neogointernal.Syscall0("System.Runtime.Platform").([]byte)
|
|
}
|
|
|
|
// GetRandom returns pseudo-random number which depends on block nonce and tx hash.
|
|
// Each invocation will return a different number. This function uses
|
|
// `System.Runtime.GetRandom` syscall.
|
|
func GetRandom() int {
|
|
return neogointernal.Syscall0("System.Runtime.GetRandom").(int)
|
|
}
|