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 SetSchemaVersion(state kv.KVStore, v isc.SchemaVersion)
• 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
• type StateAccess
  • func NewStateAccess(store kv.KVStoreReader) *StateAccess
  • func (sa *StateAccess) SchemaVersion() isc.SchemaVersion

Constants

const (
	VarSchemaVersion            = "v" // covered in: TestDeployNativeContract
	VarContractRegistry         = "r" // covered in: TestDeployNativeContract
	VarDeployPermissionsEnabled = "a" // covered in: TestDeployNativeContract
	VarDeployPermissions        = "p" // covered in: TestDeployNativeContract
)

state variables

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

request parameters

Variables

var (
	// Funcs
	FuncDeployContract           = coreutil.Func("deployContract")
	FuncGrantDeployPermission    = coreutil.Func("grantDeployPermission")
	FuncRevokeDeployPermission   = coreutil.Func("revokeDeployPermission")
	FuncRequireDeployPermissions = coreutil.Func("requireDeployPermissions")

	// Views
	ViewFindContract       = coreutil.ViewFunc("findContract")
	ViewGetContractRecords = coreutil.ViewFunc("getContractRecords")
)

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 SetSchemaVersion

func SetSchemaVersion(state kv.KVStore, v isc.SchemaVersion)

Types

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

type StateAccess

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

func NewStateAccess

func NewStateAccess(store kv.KVStoreReader) *StateAccess

func (*StateAccess) SchemaVersion

func (sa *StateAccess) SchemaVersion() isc.SchemaVersion