alphabet

Documentation

Overview

Package alphabet implements Alphabet contract which is deployed to FS chain.

Alphabet contract is designed to support GAS production and vote for new validators in FS chain. NEO token is required to produce GAS and vote for a new committee. It can be distributed among alphabet nodes of the Inner Ring. However, some of them may be malicious, and some NEO can be lost. It will destabilize the economics of FS chain. To avoid it, all 100,000,000 NEO are distributed among all alphabet contracts.

To identify alphabet contracts, they are named with letters of the Glagolitic alphabet. Names are set at contract deploy. Alphabet nodes of the Inner Ring communicate with one of the alphabetical contracts to emit GAS. To vote for a new list of side chain committee, alphabet nodes of the Inner Ring create multisignature transactions for each alphabet contract.

Contract notifications

Alphabet contract does not produce notifications to process.

Index

• func Emit()
• func Gas() int
• func Name() string
• func Neo() int
• func OnNEP17Payment(from interop.Hash160, amount int, data any)
• func Update(script []byte, manifest []byte, data any)
• func Verify() bool
• func Version() int
• func Vote(epoch int, candidates []interop.PublicKey)

Functions

func Emit

func Emit()

Emit method produces FS chain GAS and distributes it among Inner Ring nodes and proxy contract. It can be invoked only by an Alphabet node of the Inner Ring.

To produce GAS, an alphabet contract transfers all available NEO from the contract account to itself. 50% of the GAS in the contract account are transferred to proxy contract. 43.75% of the GAS are equally distributed among all Inner Ring nodes. Remaining 6.25% of the GAS stay in the contract.

func Gas

func Gas() int

Gas returns the amount of FS chain GAS stored in the contract account.

func Name

func Name() string

Name returns the Glagolitic name of the contract.

func Neo

func Neo() int

Neo returns the amount of FS chain NEO stored in the contract account.

func OnNEP17Payment

func OnNEP17Payment(from interop.Hash160, amount int, data any)

OnNEP17Payment is a callback for NEP-17 compatible native GAS and NEO contracts.

func Update

func Update(script []byte, manifest []byte, data any)

Update method updates contract source code and manifest. It can be invoked only by committee.

func Verify

func Verify() bool

Verify checks whether carrier transaction contains either (2/3N + 1) or (N/2 + 1) valid multi-signature of the NeoFS Alphabet.

func Version

func Version() int

Version returns the version of the contract.

func Vote

func Vote(epoch int, candidates []interop.PublicKey)

Vote method votes for the FS chain committee. It requires multisignature from Alphabet nodes of the Inner Ring.

This method is used when governance changes the list of Alphabet nodes of the Inner Ring. Alphabet nodes share keys with FS chain validators, therefore it is required to change them as well. To do that, NEO holders (which are alphabet contracts) should vote for a new committee.