root

Documentation

Index

• Constants
• Variables
• func DecodeContractRegistry(contractRegistry *collections.ImmutableMap) (map[isc.Hname]*ContractRecord, error)
• func GetContractRegistry(state kv.KVStore) *collections.Map
• func GetContractRegistryR(state kv.KVStoreReader) *collections.ImmutableMap
• func GetSchemaVersion(state kv.KVStoreReader) uint32
• func SetSchemaVersion(state kv.KVStore, v uint32)
• func SubscribeBlockContext(state kv.KVStore, contract, openFunc, closeFunc isc.Hname)
• type BlockContextSubscription
  • func GetBlockContextSubscriptions(state kv.KVStoreReader) []BlockContextSubscription
  • func (s *BlockContextSubscription) Encode() []byte
• type ContractRecord
  • func ContractRecordFromBytes(data []byte) (*ContractRecord, error)
  • func ContractRecordFromContractInfo(itf *coreutil.ContractInfo) *ContractRecord
  • func FindContract(state kv.KVStoreReader, hname isc.Hname) *ContractRecord
  • func (p *ContractRecord) Bytes() []byte
  • func (p *ContractRecord) Hname() isc.Hname
  • func (p *ContractRecord) Read(r io.Reader) error
  • func (p *ContractRecord) Write(w io.Writer) error

Constants

const (
	StateVarSchemaVersion = "v"

	StateVarContractRegistry          = "r"
	StateVarDeployPermissionsEnabled  = "a"
	StateVarDeployPermissions         = "p"
	StateVarBlockContextSubscriptions = "b"
)

state variables

const (
	ParamDeployer                 = "dp"
	ParamHname                    = "hn"
	ParamName                     = "nm"
	ParamProgramHash              = "ph"
	ParamContractRecData          = "dt"
	ParamContractFound            = "cf"
	ParamDeployPermissionsEnabled = "de"
)

param variables

Variables

var (
	FuncDeployContract           = coreutil.Func("deployContract")
	FuncGrantDeployPermission    = coreutil.Func("grantDeployPermission")
	FuncRevokeDeployPermission   = coreutil.Func("revokeDeployPermission")
	FuncRequireDeployPermissions = coreutil.Func("requireDeployPermissions")
	ViewFindContract             = coreutil.ViewFunc("findContract")
	ViewGetContractRecords       = coreutil.ViewFunc("getContractRecords")
)

function names

var Contract = coreutil.NewContract(coreutil.CoreContractRoot)

Functions

func DecodeContractRegistry

func DecodeContractRegistry(contractRegistry *collections.ImmutableMap) (map[isc.Hname]*ContractRecord, error)

DecodeContractRegistry encodes the whole contract registry from the map into a Go map.

func GetContractRegistry

func GetContractRegistry(state kv.KVStore) *collections.Map

func GetContractRegistryR

func GetContractRegistryR(state kv.KVStoreReader) *collections.ImmutableMap

func GetSchemaVersion

func GetSchemaVersion(state kv.KVStoreReader) uint32

func SetSchemaVersion

func SetSchemaVersion(state kv.KVStore, v uint32)

func SubscribeBlockContext

func SubscribeBlockContext(state kv.KVStore, contract, openFunc, closeFunc isc.Hname)

Types

type BlockContextSubscription

type BlockContextSubscription struct {
	Contract  isc.Hname
	OpenFunc  isc.Hname
	CloseFunc isc.Hname
}

func GetBlockContextSubscriptions

func GetBlockContextSubscriptions(state kv.KVStoreReader) []BlockContextSubscription

GetBlockContextSubscriptions returns all contracts that are subscribed to block context, in deterministic order

func (*BlockContextSubscription) Encode

func (s *BlockContextSubscription) Encode() []byte

type ContractRecord

type ContractRecord struct {
	// The ProgramHash uniquely defines the program of the smart contract
	// It is interpreted either as one of builtin contracts (including examples)
	// or a hash (reference) to the of the blob in 'blob' contract in the 'program binary' format,
	// i.e. with at least 2 pre-defined fields:
	//  - VarFieldVType
	//  - VarFieldProgramBinary
	ProgramHash hashing.HashValue
	// Unique name of the contract on the chain. The real identity of the instance on the chain
	// is hname(name) =  isc.Hn(name)
	Name string
}

ContractRecord is a structure which contains metadata of the deployed contract instance

func ContractRecordFromBytes

func ContractRecordFromBytes(data []byte) (*ContractRecord, error)

func ContractRecordFromContractInfo

func ContractRecordFromContractInfo(itf *coreutil.ContractInfo) *ContractRecord

func FindContract

func FindContract(state kv.KVStoreReader, hname isc.Hname) *ContractRecord

FindContract is an internal utility function which finds a contract in the KVStore It is called from within the 'root' contract as well as VMContext and viewcontext objects It is not directly exposed to the sandbox If contract is not found by the given hname, nil is returned

func (*ContractRecord) Bytes

func (p *ContractRecord) Bytes() []byte

func (*ContractRecord) Hname

func (p *ContractRecord) Hname() isc.Hname

func (*ContractRecord) Read

func (p *ContractRecord) Read(r io.Reader) error

func (*ContractRecord) Write

func (p *ContractRecord) Write(w io.Writer) error