native

package
v0.106.1 Latest Latest
Warning

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

 Go to latest Published: Jun 3, 2024 License: MIT Imports: 52 Imported by: 6

Documentation

Overview

Package native contains Neo native contracts.

Index

Constants

View Source 
const (
	ManagementContractID = -1

	// PrefixContract is a prefix used to store contract states inside Management native contract.
	PrefixContract = 8
)
View Source 
const (

	// NEOTotalSupply is the total amount of NEO in the system.
	NEOTotalSupply = 100000000
	// DefaultRegisterPrice is the default price for candidate register.
	DefaultRegisterPrice = 1000 * GASFactor
)
View Source 
const (

	// DefaultOracleRequestPrice is the default amount GAS needed for an oracle request.
	DefaultOracleRequestPrice = 5000_0000

	// MinimumResponseGas is the minimum response fee permitted for a request.
	MinimumResponseGas = 10_000_000
)
View Source 
const (

	// DefaultStoragePrice is the price to pay for 1 byte of storage.
	DefaultStoragePrice = 100000
)
View Source 
const (

	// DesignationEventName is the name of the designation event.
	DesignationEventName = "Designation"
)
View Source 
const GASFactor = NEOTotalSupply

GASFactor is a divisor for finding GAS integral value.

Variables

View Source 
var (
	ErrAlreadyDesignated = errors.New("already designated given role at current block")
	ErrEmptyNodeList     = errors.New("node list is empty")
	ErrInvalidIndex      = errors.New("invalid index")
	ErrInvalidRole       = errors.New("invalid role")
	ErrLargeNodeList     = errors.New("node list is too large")
	ErrNoBlock           = errors.New("no persisting block in the context")
)

Various errors.

View Source 
var (
	ErrBigArgument      = errors.New("some of the arguments are invalid")
	ErrInvalidWitness   = errors.New("witness check failed")
	ErrLowResponseGas   = errors.New("not enough gas for response")
	ErrNotEnoughGas     = errors.New("gas limit exceeded")
	ErrRequestNotFound  = errors.New("oracle request not found")
	ErrResponseNotFound = errors.New("oracle response not found")
)

Various validation errors.

View Source 
var (
	// ErrInvalidBase is returned when the base is invalid.
	ErrInvalidBase = errors.New("invalid base")
	// ErrInvalidFormat is returned when the string is not a number.
	ErrInvalidFormat = errors.New("invalid format")
	// ErrTooBigInput is returned when the input exceeds the size limit.
	ErrTooBigInput = errors.New("input is too big")
)

Functions

func Call added in v0.91.0 

func Call(ic *interop.Context) error

Call calls the specified native contract method.

func CreateOracleResponseScript added in v0.99.0 

func CreateOracleResponseScript(nativeOracleHash util.Uint160) []byte

CreateOracleResponseScript returns a script that is used to create the native Oracle response.

func GetContract added in v0.100.0 

func GetContract(d *dao.Simple, hash util.Uint160) (*state.Contract, error)

GetContract returns a contract with the given hash from the given DAO.

func GetContractByID added in v0.100.0 

func GetContractByID(d *dao.Simple, id int32) (*state.Contract, error)

GetContractByID returns a contract with the given ID from the given DAO.

func GetContractScriptHash added in v0.100.0 

func GetContractScriptHash(d *dao.Simple, id int32) (util.Uint160, error)

GetContractScriptHash returns a contract hash associated with the given ID from the given DAO.

func Keccak256 added in v0.106.0 

func Keccak256(data []byte) util.Uint256

Keccak256 hashes the incoming byte slice using the keccak256 algorithm.

func MakeContractKey added in v0.97.3 

func MakeContractKey(h util.Uint160) []byte

MakeContractKey creates a key from the account script hash.

func OnPersist added in v0.92.0 

func OnPersist(ic *interop.Context) error

OnPersist calls OnPersist methods for all native contracts.

func PostPersist added in v0.92.0 

func PostPersist(ic *interop.Context) error

PostPersist calls PostPersist methods for all native contracts.

func PutContractState added in v0.99.1 

func PutContractState(d *dao.Simple, cs *state.Contract) error

PutContractState saves given contract state into given DAO.

Types

type Contracts 

type Contracts struct {
	Management *Management
	Ledger     *Ledger
	NEO        *NEO
	GAS        *GAS
	Policy     *Policy
	Oracle     *Oracle
	Designate  *Designate
	Notary     *Notary
	Crypto     *Crypto
	Std        *Std
	Contracts  []interop.Contract
	// contains filtered or unexported fields
}

Contracts is a set of registered native contracts.

func NewContracts 

func NewContracts(cfg config.ProtocolConfiguration) *Contracts

NewContracts returns a new set of native contracts with new GAS, NEO, Policy, Oracle, Designate and (optional) Notary contracts.

func (*Contracts) ByHash 

func (cs *Contracts) ByHash(h util.Uint160) interop.Contract

ByHash returns a native contract with the specified hash.

func (*Contracts) ByName added in v0.92.0 

func (cs *Contracts) ByName(name string) interop.Contract

ByName returns a native contract with the specified name.

func (*Contracts) GetPersistScript 

func (cs *Contracts) GetPersistScript() []byte

GetPersistScript returns a VM script calling "onPersist" syscall for native contracts.

func (*Contracts) GetPostPersistScript added in v0.92.0 

func (cs *Contracts) GetPostPersistScript() []byte

GetPostPersistScript returns a VM script calling "postPersist" syscall for native contracts.

type Crypto added in v0.94.0 

type Crypto struct {
	interop.ContractMD
}

Crypto represents CryptoLib contract.

func (*Crypto) ActiveIn added in v0.104.0 

func (c *Crypto) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Crypto) Initialize added in v0.94.0 

func (c *Crypto) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize implements the Contract interface.

func (*Crypto) InitializeCache added in v0.101.4 

func (c *Crypto) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache implements the Contract interface.

func (*Crypto) Metadata added in v0.94.0 

func (c *Crypto) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Crypto) OnPersist added in v0.94.0 

func (c *Crypto) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Crypto) PostPersist added in v0.94.0 

func (c *Crypto) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

type Designate added in v0.92.0 

type Designate struct {
	interop.ContractMD
	NEO *NEO

	OracleService atomic.Value
	// NotaryService represents a Notary node module.
	NotaryService atomic.Value
	// StateRootService represents a StateRoot node module.
	StateRootService *stateroot.Module
	// contains filtered or unexported fields
}

Designate represents a designation contract.

func (*Designate) ActiveIn added in v0.104.0 

func (s *Designate) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Designate) DesignateAsRole added in v0.92.0 

func (s *Designate) DesignateAsRole(ic *interop.Context, r noderoles.Role, pubs keys.PublicKeys) error

DesignateAsRole sets nodes for role r.

func (*Designate) GetDesignatedByRole added in v0.92.0 

func (s *Designate) GetDesignatedByRole(d *dao.Simple, r noderoles.Role, index uint32) (keys.PublicKeys, uint32, error)

GetDesignatedByRole returns nodes for role r.

func (*Designate) GetLastDesignatedHash added in v0.93.0 

func (s *Designate) GetLastDesignatedHash(d *dao.Simple, r noderoles.Role) (util.Uint160, error)

GetLastDesignatedHash returns the last designated hash of the given role.

func (*Designate) Initialize added in v0.92.0 

func (s *Designate) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes Designation contract. It is called once at native Management's OnPersist at the genesis block, and we can't properly fill the cache at this point, as there are no roles data in the storage.

func (*Designate) InitializeCache added in v0.97.3 

func (s *Designate) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache fills native Designate cache from DAO. It is called at non-zero height, thus we can fetch the roles data right from the storage.

func (*Designate) Metadata added in v0.92.0 

func (s *Designate) Metadata() *interop.ContractMD

Metadata returns contract metadata.

func (*Designate) OnPersist added in v0.92.0 

func (s *Designate) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Designate) PostPersist added in v0.92.0 

func (s *Designate) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

type DesignationCache added in v0.99.0 

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

func (*DesignationCache) Copy added in v0.99.0 

func (c *DesignationCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type GAS 

type GAS struct {
	NEO    *NEO
	Policy *Policy
	// contains filtered or unexported fields
}

GAS represents GAS native contract.

func (*GAS) ActiveIn added in v0.104.0 

func (g *GAS) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*GAS) BalanceOf added in v0.97.1 

func (g *GAS) BalanceOf(d *dao.Simple, acc util.Uint160) *big.Int

BalanceOf returns native GAS token balance for the acc.

func (*GAS) Decimals 

func (c *GAS) Decimals(_ *interop.Context, _ []stackitem.Item) stackitem.Item

func (*GAS) Initialize 

func (g *GAS) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes a GAS contract.

func (*GAS) InitializeCache added in v0.101.4 

func (g *GAS) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache implements the Contract interface.

func (*GAS) Metadata 

func (c *GAS) Metadata() *interop.ContractMD

func (*GAS) OnPersist 

func (g *GAS) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*GAS) PostPersist added in v0.92.0 

func (g *GAS) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

func (*GAS) Symbol 

func (c *GAS) Symbol(_ *interop.Context, _ []stackitem.Item) stackitem.Item

func (*GAS) TotalSupply 

func (c *GAS) TotalSupply(ic *interop.Context, _ []stackitem.Item) stackitem.Item

func (*GAS) Transfer 

func (c *GAS) Transfer(ic *interop.Context, args []stackitem.Item) stackitem.Item

func (*GAS) TransferInternal added in v0.91.0 

func (c *GAS) TransferInternal(ic *interop.Context, from, to util.Uint160, amount *big.Int, data stackitem.Item) error

TransferInternal transfers NEO across accounts.

type HashFunc added in v0.106.0 

type HashFunc func([]byte) util.Uint256

HashFunc is a delegate representing a hasher function with 256 bytes output length.

type IDList added in v0.92.0 

type IDList []uint64

IDList is a list of oracle request IDs.

func (*IDList) FromStackItem added in v0.96.0 

func (l *IDList) FromStackItem(it stackitem.Item) error

FromStackItem implements stackitem.Convertible.

func (*IDList) Remove added in v0.92.0 

func (l *IDList) Remove(id uint64) bool

Remove removes id from the list.

func (IDList) ToStackItem added in v0.96.0 

func (l IDList) ToStackItem() (stackitem.Item, error)

ToStackItem implements stackitem.Convertible. It never returns an error.

type Ledger added in v0.93.0 

type Ledger struct {
	interop.ContractMD
}

Ledger provides an interface to blocks/transactions storage for smart contracts. It's not a part of the proper chain's state, so it's just a proxy between regular Blockchain/DAO interface and smart contracts.

func (*Ledger) ActiveIn added in v0.104.0 

func (l *Ledger) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Ledger) Initialize added in v0.93.0 

func (l *Ledger) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize implements the Contract interface.

func (*Ledger) InitializeCache added in v0.101.4 

func (l *Ledger) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache implements the Contract interface.

func (*Ledger) Metadata added in v0.93.0 

func (l *Ledger) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Ledger) OnPersist added in v0.93.0 

func (l *Ledger) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Ledger) PostPersist added in v0.93.0 

func (l *Ledger) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

type Management added in v0.92.0 

type Management struct {
	interop.ContractMD
	NEO    *NEO
	Policy *Policy
}

Management is a contract-managing native contract.

func (*Management) ActiveIn added in v0.104.0 

func (m *Management) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Management) Deploy added in v0.92.0 

func (m *Management) Deploy(ic *interop.Context, sender util.Uint160, neff *nef.File, manif *manifest.Manifest) (*state.Contract, error)

Deploy creates a contract's hash/ID and saves a new contract into the given DAO. It doesn't run _deploy method and doesn't emit notification.

func (*Management) Destroy added in v0.92.0 

func (m *Management) Destroy(d *dao.Simple, hash util.Uint160) error

Destroy drops the given contract from DAO along with its storage. It doesn't emit notification.

func (*Management) GetNEP11Contracts added in v0.98.0 

func (m *Management) GetNEP11Contracts(d *dao.Simple) []util.Uint160

GetNEP11Contracts returns hashes of all deployed contracts that support NEP-11 standard. The list is updated every PostPersist, so until PostPersist is called, the result for the previous block is returned.

func (*Management) GetNEP17Contracts added in v0.97.1 

func (m *Management) GetNEP17Contracts(d *dao.Simple) []util.Uint160

GetNEP17Contracts returns hashes of all deployed contracts that support NEP-17 standard. The list is updated every PostPersist, so until PostPersist is called, the result for the previous block is returned.

func (*Management) Initialize added in v0.92.0 

func (m *Management) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize implements the Contract interface.

func (*Management) InitializeCache added in v0.92.0 

func (m *Management) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache initializes contract cache with the proper values from storage. Cache initialization should be done apart from Initialize because Initialize is called only when deploying native contracts.

func (*Management) Metadata added in v0.92.0 

func (m *Management) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Management) OnPersist added in v0.92.0 

func (m *Management) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Management) PostPersist added in v0.92.0 

func (m *Management) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

func (*Management) Update added in v0.92.0 

func (m *Management) Update(ic *interop.Context, hash util.Uint160, neff *nef.File, manif *manifest.Manifest) (*state.Contract, error)

Update updates contract's script and/or manifest in the given DAO. It doesn't run _deploy method and doesn't emit notification.

type ManagementCache added in v0.99.0 

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

func (*ManagementCache) Copy added in v0.99.0 

func (c *ManagementCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type NEO 

type NEO struct {
	GAS    *GAS
	Policy *Policy
	// contains filtered or unexported fields
}

NEO represents NEO native contract.

func (*NEO) ActiveIn added in v0.104.0 

func (n *NEO) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*NEO) BalanceOf added in v0.97.1 

func (n *NEO) BalanceOf(d *dao.Simple, acc util.Uint160) (*big.Int, uint32)

BalanceOf returns native NEO token balance for the acc.

func (*NEO) CalculateBonus added in v0.92.0 

func (n *NEO) CalculateBonus(ic *interop.Context, acc util.Uint160, end uint32) (*big.Int, error)

CalculateBonus calculates amount of gas generated for holding value NEO from start to end block and having voted for active committee member.

func (*NEO) CalculateNEOHolderReward added in v0.92.0 

func (n *NEO) CalculateNEOHolderReward(d *dao.Simple, value *big.Int, start, end uint32) (*big.Int, error)

CalculateNEOHolderReward return GAS reward for holding `value` of NEO from start to end block.

func (*NEO) ComputeNextBlockValidators added in v0.92.0 

func (n *NEO) ComputeNextBlockValidators(d *dao.Simple) keys.PublicKeys

ComputeNextBlockValidators computes an actual list of current validators that is relevant for the latest processed dBFT epoch and based on the changes made by register/unregister/vote calls during the latest epoch. Note: this method isn't actually "computes" new committee list and calculates new validators list from it. Instead, it uses cache, and the cache itself is updated during the PostPersist of the last block of every epoch.

func (*NEO) Decimals 

func (c *NEO) Decimals(_ *interop.Context, _ []stackitem.Item) stackitem.Item

func (*NEO) GetCandidates added in v0.91.0 

func (n *NEO) GetCandidates(d *dao.Simple) ([]state.Validator, error)

GetCandidates returns current registered validators list with keys and votes.

func (*NEO) GetCommitteeAddress added in v0.92.0 

func (n *NEO) GetCommitteeAddress(d *dao.Simple) util.Uint160

GetCommitteeAddress returns address of the committee.

func (*NEO) GetCommitteeMembers added in v0.92.0 

func (n *NEO) GetCommitteeMembers(d *dao.Simple) keys.PublicKeys

GetCommitteeMembers returns public keys of nodes in committee using cached value.

func (*NEO) GetGASPerBlock added in v0.92.0 

func (n *NEO) GetGASPerBlock(d *dao.Simple, index uint32) *big.Int

GetGASPerBlock returns gas generated for block with provided index.

func (*NEO) GetNextBlockValidatorsInternal 

func (n *NEO) GetNextBlockValidatorsInternal(d *dao.Simple) keys.PublicKeys

GetNextBlockValidatorsInternal returns next block validators.

func (*NEO) Initialize 

func (n *NEO) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes a NEO contract.

func (*NEO) InitializeCache added in v0.92.0 

func (n *NEO) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache initializes all NEO cache with the proper values from the storage. Cache initialization should be done apart from Initialize because Initialize is called only when deploying native contracts. InitializeCache implements the Contract interface.

func (*NEO) Metadata 

func (c *NEO) Metadata() *interop.ContractMD

func (*NEO) ModifyAccountVotes 

func (n *NEO) ModifyAccountVotes(acc *state.NEOBalance, d *dao.Simple, value *big.Int, isNewVote bool) error

ModifyAccountVotes modifies votes of the specified account by value (can be negative). typ specifies if this modify is occurring during transfer or vote (with old or new validator).

func (*NEO) OnPersist 

func (n *NEO) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*NEO) PostPersist added in v0.92.0 

func (n *NEO) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

func (*NEO) RegisterCandidateInternal added in v0.91.0 

func (n *NEO) RegisterCandidateInternal(ic *interop.Context, pub *keys.PublicKey) error

RegisterCandidateInternal registers pub as a new candidate.

func (*NEO) SetGASPerBlock added in v0.92.0 

func (n *NEO) SetGASPerBlock(ic *interop.Context, index uint32, gas *big.Int) error

SetGASPerBlock sets gas generated for blocks after index.

func (*NEO) Symbol 

func (c *NEO) Symbol(_ *interop.Context, _ []stackitem.Item) stackitem.Item

func (*NEO) TotalSupply 

func (c *NEO) TotalSupply(ic *interop.Context, _ []stackitem.Item) stackitem.Item

func (*NEO) Transfer 

func (c *NEO) Transfer(ic *interop.Context, args []stackitem.Item) stackitem.Item

func (*NEO) TransferInternal added in v0.91.0 

func (c *NEO) TransferInternal(ic *interop.Context, from, to util.Uint160, amount *big.Int, data stackitem.Item) error

TransferInternal transfers NEO across accounts.

func (*NEO) UnregisterCandidateInternal added in v0.91.0 

func (n *NEO) UnregisterCandidateInternal(ic *interop.Context, pub *keys.PublicKey) error

UnregisterCandidateInternal unregisters pub as a candidate.

func (*NEO) VoteInternal 

func (n *NEO) VoteInternal(ic *interop.Context, h util.Uint160, pub *keys.PublicKey) error

VoteInternal votes from account h for validarors specified in pubs.

type NamedCurveHash added in v0.106.0 

type NamedCurveHash byte

NamedCurveHash identifies a pair of named elliptic curve and hash function. 

const (
	Secp256k1Sha256    NamedCurveHash = 22
	Secp256r1Sha256    NamedCurveHash = 23
	Secp256k1Keccak256 NamedCurveHash = 122
	Secp256r1Keccak256 NamedCurveHash = 123
)

Various pairs of named elliptic curves and hash functions.

type NeoCache added in v0.99.0 

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

func (*NeoCache) Copy added in v0.99.0 

func (c *NeoCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type NodeList added in v0.92.0 

type NodeList keys.PublicKeys

NodeList represents a list of oracle nodes.

func (*NodeList) FromStackItem added in v0.96.0 

func (l *NodeList) FromStackItem(it stackitem.Item) error

FromStackItem implements stackitem.Convertible.

func (NodeList) ToStackItem added in v0.96.0 

func (l NodeList) ToStackItem() (stackitem.Item, error)

ToStackItem implements stackitem.Convertible. It never returns an error.

type Notary added in v0.92.0 

type Notary struct {
	interop.ContractMD
	GAS    *GAS
	NEO    *NEO
	Desig  *Designate
	Policy *Policy
}

Notary represents Notary native contract.

func (*Notary) ActiveIn added in v0.104.0 

func (n *Notary) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Notary) BalanceOf added in v0.92.0 

func (n *Notary) BalanceOf(dao *dao.Simple, acc util.Uint160) *big.Int

BalanceOf is an internal representation of `balanceOf` Notary method.

func (*Notary) ExpirationOf added in v0.92.0 

func (n *Notary) ExpirationOf(dao *dao.Simple, acc util.Uint160) uint32

ExpirationOf is an internal representation of `expirationOf` Notary method.

func (*Notary) GetDepositFor added in v0.92.0 

func (n *Notary) GetDepositFor(dao *dao.Simple, acc util.Uint160) *state.Deposit

GetDepositFor returns state.Deposit for the account specified. It returns nil in case the deposit is not found in the storage and panics in case of any other error.

func (*Notary) GetMaxNotValidBeforeDelta added in v0.92.0 

func (n *Notary) GetMaxNotValidBeforeDelta(dao *dao.Simple) uint32

GetMaxNotValidBeforeDelta is an internal representation of Notary getMaxNotValidBeforeDelta method.

func (*Notary) GetNotaryNodes added in v0.92.0 

func (n *Notary) GetNotaryNodes(d *dao.Simple) (keys.PublicKeys, error)

GetNotaryNodes returns public keys of notary nodes.

func (*Notary) Initialize added in v0.92.0 

func (n *Notary) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes Notary native contract and implements the Contract interface.

func (*Notary) InitializeCache added in v0.99.0 

func (n *Notary) InitializeCache(blockHeight uint32, d *dao.Simple) error

func (*Notary) Metadata added in v0.92.0 

func (n *Notary) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Notary) OnPersist added in v0.92.0 

func (n *Notary) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Notary) PostPersist added in v0.92.0 

func (n *Notary) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

type NotaryCache added in v0.99.0 

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

func (*NotaryCache) Copy added in v0.99.0 

func (c *NotaryCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type NotaryService added in v0.99.1 

type NotaryService interface {
	UpdateNotaryNodes(pubs keys.PublicKeys)
}

NotaryService is a Notary module interface.

type Oracle added in v0.92.0 

type Oracle struct {
	interop.ContractMD
	GAS *GAS
	NEO *NEO

	Desig *Designate

	// Module is an oracle module capable of talking with the external world.
	Module atomic.Value
	// contains filtered or unexported fields
}

Oracle represents Oracle native contract.

func (*Oracle) ActiveIn added in v0.104.0 

func (o *Oracle) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Oracle) FinishInternal added in v0.92.0 

func (o *Oracle) FinishInternal(ic *interop.Context) error

FinishInternal processes an oracle response.

func (*Oracle) GetIDListInternal added in v0.92.0 

func (o *Oracle) GetIDListInternal(d *dao.Simple, url string) (*IDList, error)

GetIDListInternal returns the request by ID and key under which it is stored.

func (*Oracle) GetOracleNodes added in v0.92.0 

func (o *Oracle) GetOracleNodes(d *dao.Simple) (keys.PublicKeys, error)

GetOracleNodes returns public keys of oracle nodes.

func (*Oracle) GetOracleResponseScript added in v0.93.0 

func (o *Oracle) GetOracleResponseScript() []byte

GetOracleResponseScript returns a script for the transaction with an oracle response.

func (*Oracle) GetRequestInternal added in v0.92.0 

func (o *Oracle) GetRequestInternal(d *dao.Simple, id uint64) (*state.OracleRequest, error)

GetRequestInternal returns the request by ID and key under which it is stored.

func (*Oracle) GetRequests added in v0.99.2 

func (o *Oracle) GetRequests(d *dao.Simple) (map[uint64]*state.OracleRequest, error)

GetRequests returns all requests which have not been finished yet.

func (*Oracle) GetScriptHash added in v0.92.0 

func (o *Oracle) GetScriptHash(d *dao.Simple) (util.Uint160, error)

GetScriptHash returns script hash of oracle nodes.

func (*Oracle) Initialize added in v0.92.0 

func (o *Oracle) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes an Oracle contract.

func (*Oracle) InitializeCache added in v0.99.0 

func (o *Oracle) InitializeCache(blockHeight uint32, d *dao.Simple) error

func (*Oracle) Metadata added in v0.92.0 

func (o *Oracle) Metadata() *interop.ContractMD

Metadata returns contract metadata.

func (*Oracle) OnPersist added in v0.92.0 

func (o *Oracle) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Oracle) PostPersist added in v0.92.0 

func (o *Oracle) PostPersist(ic *interop.Context) error

PostPersist represents `postPersist` method.

func (*Oracle) PutRequestInternal added in v0.92.0 

func (o *Oracle) PutRequestInternal(id uint64, req *state.OracleRequest, d *dao.Simple) error

PutRequestInternal puts the oracle request with the specified id to d.

func (*Oracle) RequestInternal added in v0.92.0 

func (o *Oracle) RequestInternal(ic *interop.Context, url string, filter *string, cb string, userData stackitem.Item, gas *big.Int) error

RequestInternal processes an oracle request.

type OracleCache added in v0.99.0 

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

func (*OracleCache) Copy added in v0.99.0 

func (c *OracleCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type OracleService added in v0.99.1 

type OracleService interface {
	// AddRequests processes new requests.
	AddRequests(map[uint64]*state.OracleRequest)
	// RemoveRequests removes already processed requests.
	RemoveRequests([]uint64)
	// UpdateOracleNodes updates oracle nodes.
	UpdateOracleNodes(keys.PublicKeys)
	// UpdateNativeContract updates oracle contract native script and hash.
	UpdateNativeContract([]byte, []byte, util.Uint160, int)
	// Start runs oracle module.
	Start()
	// Shutdown shutdowns oracle module.
	Shutdown()
}

OracleService specifies oracle module interface.

type Policy 

type Policy struct {
	interop.ContractMD
	NEO *NEO
	// contains filtered or unexported fields
}

Policy represents Policy native contract.

func (*Policy) ActiveIn added in v0.104.0 

func (p *Policy) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Policy) CheckPolicy 

func (p *Policy) CheckPolicy(d *dao.Simple, tx *transaction.Transaction) error

CheckPolicy checks whether a transaction conforms to the current policy restrictions, like not being signed by a blocked account or not exceeding the block-level system fee limit.

func (*Policy) GetAttributeFeeInternal added in v0.104.0 

func (p *Policy) GetAttributeFeeInternal(d *dao.Simple, t transaction.AttrType) int64

GetAttributeFeeInternal returns required transaction's attribute fee.

func (*Policy) GetExecFeeFactorInternal added in v0.92.0 

func (p *Policy) GetExecFeeFactorInternal(d *dao.Simple) int64

GetExecFeeFactorInternal returns current execution fee factor.

func (*Policy) GetFeePerByteInternal 

func (p *Policy) GetFeePerByteInternal(dao *dao.Simple) int64

GetFeePerByteInternal returns required transaction's fee per byte.

func (*Policy) GetMaxVerificationGas added in v0.91.0 

func (p *Policy) GetMaxVerificationGas(dao *dao.Simple) int64

GetMaxVerificationGas returns the maximum gas allowed to be burned during verification.

func (*Policy) GetStoragePriceInternal added in v0.92.0 

func (p *Policy) GetStoragePriceInternal(d *dao.Simple) int64

GetStoragePriceInternal returns current execution fee factor.

func (*Policy) Initialize 

func (p *Policy) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize initializes Policy native contract and implements the Contract interface.

func (*Policy) InitializeCache added in v0.99.0 

func (p *Policy) InitializeCache(blockHeight uint32, d *dao.Simple) error

func (*Policy) IsBlocked added in v0.99.0 

func (p *Policy) IsBlocked(dao *dao.Simple, hash util.Uint160) bool

IsBlocked checks whether provided account is blocked. Normally it uses Policy cache, falling back to the DB queries when Policy cache is not available yet (the only case is native cache initialization pipeline, where native Neo cache is being initialized before the Policy's one).

func (*Policy) Metadata 

func (p *Policy) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Policy) OnPersist 

func (p *Policy) OnPersist(ic *interop.Context) error

OnPersist implements Contract interface.

func (*Policy) PostPersist added in v0.92.0 

func (p *Policy) PostPersist(ic *interop.Context) error

PostPersist implements Contract interface.

type PolicyCache added in v0.99.0 

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

func (*PolicyCache) Copy added in v0.99.0 

func (c *PolicyCache) Copy() dao.NativeContractCache

Copy implements NativeContractCache interface.

type Std added in v0.94.0 

type Std struct {
	interop.ContractMD
}

Std represents an StdLib contract.

func (*Std) ActiveIn added in v0.104.0 

func (s *Std) ActiveIn() *config.Hardfork

ActiveIn implements the Contract interface.

func (*Std) Initialize added in v0.94.0 

func (s *Std) Initialize(ic *interop.Context, hf *config.Hardfork, newMD *interop.HFSpecificContractMD) error

Initialize implements the Contract interface.

func (*Std) InitializeCache added in v0.101.4 

func (s *Std) InitializeCache(blockHeight uint32, d *dao.Simple) error

InitializeCache implements the Contract interface.

func (*Std) Metadata added in v0.94.0 

func (s *Std) Metadata() *interop.ContractMD

Metadata implements the Contract interface.

func (*Std) OnPersist added in v0.94.0 

func (s *Std) OnPersist(ic *interop.Context) error

OnPersist implements the Contract interface.

func (*Std) PostPersist added in v0.94.0 

func (s *Std) PostPersist(ic *interop.Context) error

PostPersist implements the Contract interface.

Source Files

View all Source files

Directories

Path Synopsis
native_test
helpers/policyhelper
package nativehashes contains hashes of all native contracts in their LE and Uint160 representation.
 package nativehashes contains hashes of all native contracts in their LE and Uint160 representation.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.