manifest

package
v0.98.1-pre Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 3, 2021 License: MIT Imports: 14 Imported by: 3

Documentation

Index

Constants

View Source
const (
	// MethodInit is a name for default initialization method.
	MethodInit = "_initialize"

	// MethodDeploy is a name for default method called during contract deployment.
	MethodDeploy = "_deploy"

	// MethodVerify is a name for default verification method.
	MethodVerify = "verify"

	// MethodOnNEP17Payment is name of the method which is called when contract receives NEP-17 tokens.
	MethodOnNEP17Payment = "onNEP17Payment"

	// MethodOnNEP11Payment is the name of the method which is called when contract receives NEP-11 tokens.
	MethodOnNEP11Payment = "onNEP11Payment"
)
View Source
const (
	// MaxManifestSize is a max length for a valid contract manifest.
	MaxManifestSize = math.MaxUint16

	// NEP11StandardName represents the name of NEP-11 smartcontract standard.
	NEP11StandardName = "NEP-11"
	// NEP17StandardName represents the name of NEP-17 smartcontract standard.
	NEP17StandardName = "NEP-17"
	// NEP11Payable represents the name of contract interface which can receive NEP-11 tokens.
	NEP11Payable = "NEP-11-Payable"
	// NEP17Payable represents the name of contract interface which can receive NEP-17 tokens.
	NEP17Payable = "NEP-17-Payable"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type ABI

type ABI struct {
	Methods []Method `json:"methods"`
	Events  []Event  `json:"events"`
}

ABI represents a contract application binary interface.

func (*ABI) FromStackItem added in v0.93.0

func (a *ABI) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to ABI.

func (*ABI) GetEvent added in v0.92.0

func (a *ABI) GetEvent(name string) *Event

GetEvent returns event with the specified name.

func (*ABI) GetMethod added in v0.91.0

func (a *ABI) GetMethod(name string, paramCount int) *Method

GetMethod returns methods with the specified name.

func (*ABI) IsValid added in v0.93.0

func (a *ABI) IsValid() error

IsValid checks ABI consistency and correctness.

func (*ABI) ToStackItem added in v0.93.0

func (a *ABI) ToStackItem() stackitem.Item

ToStackItem converts ABI to stackitem.Item.

type Event

type Event struct {
	Name       string      `json:"name"`
	Parameters []Parameter `json:"parameters"`
}

Event is a description of a single event.

func (*Event) FromStackItem added in v0.93.0

func (e *Event) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Event.

func (*Event) IsValid added in v0.93.0

func (e *Event) IsValid() error

IsValid checks Event consistency and correctness.

func (*Event) ToStackItem added in v0.93.0

func (e *Event) ToStackItem() stackitem.Item

ToStackItem converts Event to stackitem.Item.

type Group

type Group struct {
	PublicKey *keys.PublicKey `json:"pubkey"`
	Signature []byte          `json:"signature"`
}

Group represents a group of smartcontracts identified by a public key. Every SC in a group must provide signature of it's hash to prove it belongs to a group.

func (*Group) FromStackItem added in v0.93.0

func (g *Group) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Group.

func (*Group) IsValid added in v0.91.0

func (g *Group) IsValid(h util.Uint160) error

IsValid checks whether group's signature corresponds to the given hash.

func (*Group) MarshalJSON

func (g *Group) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*Group) ToStackItem added in v0.93.0

func (g *Group) ToStackItem() stackitem.Item

ToStackItem converts Group to stackitem.Item.

func (*Group) UnmarshalJSON

func (g *Group) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type Groups added in v0.93.0

type Groups []Group

Groups is just an array of Group.

func (Groups) AreValid added in v0.93.0

func (g Groups) AreValid(h util.Uint160) error

AreValid checks for groups correctness and uniqueness.

func (Groups) Contains added in v0.98.0

func (g Groups) Contains(k *keys.PublicKey) bool

type Manifest

type Manifest struct {
	// Name is a contract's name.
	Name string `json:"name"`
	// ABI is a contract's ABI.
	ABI ABI `json:"abi"`
	// Features is a set of contract features. Currently unused.
	Features json.RawMessage `json:"features"`
	// Groups is a set of groups to which a contract belongs.
	Groups      []Group      `json:"groups"`
	Permissions []Permission `json:"permissions"`
	// SupportedStandards is a list of standards supported by the contract.
	SupportedStandards []string `json:"supportedstandards"`
	// Trusts is a set of hashes to a which contract trusts.
	Trusts WildPermissionDescs `json:"trusts"`
	// Extra is an implementation-defined user data.
	Extra json.RawMessage `json:"extra"`
}

Manifest represens contract metadata.

func DefaultManifest

func DefaultManifest(name string) *Manifest

DefaultManifest returns default contract manifest.

func NewManifest

func NewManifest(name string) *Manifest

NewManifest returns new manifest with necessary fields initialized.

func (*Manifest) CanCall

func (m *Manifest) CanCall(hash util.Uint160, toCall *Manifest, method string) bool

CanCall returns true is current contract is allowed to call method of another contract with specified hash.

func (*Manifest) FromStackItem added in v0.93.0

func (m *Manifest) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Manifest.

func (*Manifest) IsStandardSupported added in v0.97.1

func (m *Manifest) IsStandardSupported(standard string) bool

IsStandardSupported denotes whether the specified standard supported by the contract.

func (*Manifest) IsValid added in v0.91.0

func (m *Manifest) IsValid(hash util.Uint160) error

IsValid checks manifest internal consistency and correctness, one of the checks is for group signature correctness, contract hash is passed for it.

func (*Manifest) ToStackItem added in v0.93.0

func (m *Manifest) ToStackItem() (stackitem.Item, error)

ToStackItem converts Manifest to stackitem.Item.

type Method

type Method struct {
	Name       string                  `json:"name"`
	Offset     int                     `json:"offset"`
	Parameters []Parameter             `json:"parameters"`
	ReturnType smartcontract.ParamType `json:"returntype"`
	Safe       bool                    `json:"safe"`
}

Method represents method's metadata.

func (*Method) FromStackItem added in v0.93.0

func (m *Method) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Method.

func (*Method) IsValid added in v0.93.0

func (m *Method) IsValid() error

IsValid checks Method consistency and correctness.

func (*Method) ToStackItem added in v0.93.0

func (m *Method) ToStackItem() stackitem.Item

ToStackItem converts Method to stackitem.Item.

type Parameter

type Parameter struct {
	Name string                  `json:"name"`
	Type smartcontract.ParamType `json:"type"`
}

Parameter represents smartcontract's parameter's definition.

func NewParameter

func NewParameter(name string, typ smartcontract.ParamType) Parameter

NewParameter returns new parameter of specified name and type.

func (*Parameter) FromStackItem added in v0.93.0

func (p *Parameter) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Parameter.

func (*Parameter) IsValid added in v0.93.0

func (p *Parameter) IsValid() error

IsValid checks Parameter consistency and correctness.

func (*Parameter) ToStackItem added in v0.93.0

func (p *Parameter) ToStackItem() stackitem.Item

ToStackItem converts Parameter to stackitem.Item.

type Parameters added in v0.93.0

type Parameters []Parameter

Parameters is just an array of Parameter.

func (Parameters) AreValid added in v0.93.0

func (p Parameters) AreValid() error

AreValid checks all parameters for validity and consistency.

type Permission

type Permission struct {
	Contract PermissionDesc `json:"contract"`
	Methods  WildStrings    `json:"methods"`
}

Permission describes which contracts may be invoked and which methods are called.

func NewPermission

func NewPermission(typ PermissionType, args ...interface{}) *Permission

NewPermission returns new permission of a given type.

func (*Permission) FromStackItem added in v0.93.0

func (p *Permission) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to Permission.

func (*Permission) IsAllowed

func (p *Permission) IsAllowed(hash util.Uint160, m *Manifest, method string) bool

IsAllowed checks if method is allowed to be executed.

func (*Permission) IsValid added in v0.93.0

func (p *Permission) IsValid() error

IsValid checks if Permission is correct.

func (*Permission) ToStackItem added in v0.93.0

func (p *Permission) ToStackItem() stackitem.Item

ToStackItem converts Permission to stackitem.Item.

func (*Permission) UnmarshalJSON

func (p *Permission) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type PermissionDesc

type PermissionDesc struct {
	Type  PermissionType
	Value interface{}
}

PermissionDesc is a permission descriptor.

func (*PermissionDesc) Equals added in v0.95.0

func (d *PermissionDesc) Equals(v PermissionDesc) bool

Equals returns true if both PermissionDesc values are the same.

func (*PermissionDesc) FromStackItem added in v0.95.0

func (d *PermissionDesc) FromStackItem(item stackitem.Item) error

FromStackItem converts stackitem.Item to PermissionDesc.

func (*PermissionDesc) Group

func (d *PermissionDesc) Group() *keys.PublicKey

Group returns group's public key for group-permission.

func (*PermissionDesc) Hash

func (d *PermissionDesc) Hash() util.Uint160

Hash returns hash for hash-permission.

func (*PermissionDesc) Less added in v0.95.0

func (d *PermissionDesc) Less(d1 PermissionDesc) bool

Less returns true if this value is less than given PermissionDesc value.

func (*PermissionDesc) MarshalJSON

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

MarshalJSON implements json.Marshaler interface.

func (*PermissionDesc) ToStackItem added in v0.95.0

func (d *PermissionDesc) ToStackItem() stackitem.Item

ToStackItem converts PermissionDesc to stackitem.Item.

func (*PermissionDesc) UnmarshalJSON

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

UnmarshalJSON implements json.Unmarshaler interface.

type PermissionType

type PermissionType uint8

PermissionType represents permission type.

const (
	// PermissionWildcard allows everything.
	PermissionWildcard PermissionType = 0
	// PermissionHash restricts called contracts based on hash.
	PermissionHash PermissionType = 1
	// PermissionGroup restricts called contracts based on public key.
	PermissionGroup PermissionType = 2
)

type Permissions added in v0.93.0

type Permissions []Permission

Permissions is just an array of Permission.

func (Permissions) AreValid added in v0.93.0

func (ps Permissions) AreValid() error

AreValid checks each Permission and ensures there are no duplicates.

type WildPermissionDescs added in v0.95.0

type WildPermissionDescs struct {
	Value []PermissionDesc
}

WildPermissionDescs represents PermissionDescriptor set which can be wildcard.

func (*WildPermissionDescs) Add added in v0.95.0

Add adds v to the container.

func (*WildPermissionDescs) Contains added in v0.95.0

func (c *WildPermissionDescs) Contains(v PermissionDesc) bool

Contains checks if v is in the container.

func (*WildPermissionDescs) IsWildcard added in v0.95.0

func (c *WildPermissionDescs) IsWildcard() bool

IsWildcard returns true iff container is wildcard.

func (WildPermissionDescs) MarshalJSON added in v0.95.0

func (c WildPermissionDescs) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*WildPermissionDescs) Restrict added in v0.95.0

func (c *WildPermissionDescs) Restrict()

Restrict transforms container into an empty one.

func (*WildPermissionDescs) UnmarshalJSON added in v0.95.0

func (c *WildPermissionDescs) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

type WildStrings

type WildStrings struct {
	Value []string
}

WildStrings represents string set which can be wildcard.

func (*WildStrings) Add

func (c *WildStrings) Add(v string)

Add adds v to the container.

func (*WildStrings) Contains

func (c *WildStrings) Contains(v string) bool

Contains checks if v is in the container.

func (*WildStrings) IsWildcard

func (c *WildStrings) IsWildcard() bool

IsWildcard returns true iff container is wildcard.

func (WildStrings) MarshalJSON

func (c WildStrings) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler interface.

func (*WildStrings) Restrict

func (c *WildStrings) Restrict()

Restrict transforms container into an empty one.

func (*WildStrings) UnmarshalJSON

func (c *WildStrings) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler interface.

Directories

Path Synopsis
Package standard contains interfaces for well-defined standards and function for checking if arbitrary manifest complies with them.
Package standard contains interfaces for well-defined standards and function for checking if arbitrary manifest complies with them.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL