462 lines
12 KiB
Go
462 lines
12 KiB
Go
package netmap
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/binary"
|
|
"errors"
|
|
"fmt"
|
|
"math"
|
|
|
|
"github.com/nspcc-dev/neofs-api-go/v2/netmap"
|
|
)
|
|
|
|
// NetworkInfo groups information about the NeoFS network state. Mainly used to
|
|
// describe the current state of the network.
|
|
//
|
|
// NetworkInfo is mutually compatible with github.com/nspcc-dev/neofs-api-go/v2/netmap.NetworkInfo
|
|
// message. See ReadFromV2 / WriteToV2 methods.
|
|
//
|
|
// Instances can be created using built-in var declaration.
|
|
type NetworkInfo struct {
|
|
m netmap.NetworkInfo
|
|
}
|
|
|
|
// reads NetworkInfo from netmap.NetworkInfo message. If checkFieldPresence is set,
|
|
// returns an error on absence of any protocol-required field. Verifies format of any
|
|
// presented field according to NeoFS API V2 protocol.
|
|
func (x *NetworkInfo) readFromV2(m netmap.NetworkInfo, checkFieldPresence bool) error {
|
|
c := m.GetNetworkConfig()
|
|
if checkFieldPresence && c == nil {
|
|
return errors.New("missing network config")
|
|
}
|
|
|
|
if checkFieldPresence && c.NumberOfParameters() <= 0 {
|
|
return errors.New("missing network parameters")
|
|
}
|
|
|
|
var err error
|
|
mNames := make(map[string]struct{}, c.NumberOfParameters())
|
|
|
|
c.IterateParameters(func(prm *netmap.NetworkParameter) bool {
|
|
name := string(prm.GetKey())
|
|
|
|
_, was := mNames[name]
|
|
if was {
|
|
err = fmt.Errorf("duplicated parameter name: %s", name)
|
|
return true
|
|
}
|
|
|
|
mNames[name] = struct{}{}
|
|
|
|
switch name {
|
|
default:
|
|
if len(prm.GetValue()) == 0 {
|
|
err = fmt.Errorf("empty attribute value %s", name)
|
|
return true
|
|
}
|
|
case configEigenTrustAlpha:
|
|
var num uint64
|
|
|
|
num, err = decodeConfigValueUint64(prm.GetValue())
|
|
if err == nil {
|
|
if alpha := math.Float64frombits(num); alpha < 0 && alpha > 1 {
|
|
err = fmt.Errorf("EigenTrust alpha value %0.2f is out of range [0, 1]", alpha)
|
|
}
|
|
}
|
|
case
|
|
configAuditFee,
|
|
configStoragePrice,
|
|
configContainerFee,
|
|
configNamedContainerFee,
|
|
configEigenTrustNumberOfIterations,
|
|
configEpochDuration,
|
|
configIRCandidateFee,
|
|
configMaxObjSize,
|
|
configWithdrawalFee:
|
|
_, err = decodeConfigValueUint64(prm.GetValue())
|
|
}
|
|
|
|
if err != nil {
|
|
err = fmt.Errorf("invalid %s parameter: %w", name, err)
|
|
}
|
|
|
|
return err != nil
|
|
})
|
|
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
x.m = m
|
|
|
|
return nil
|
|
}
|
|
|
|
// ReadFromV2 reads NetworkInfo from the netmap.NetworkInfo message. Checks if the
|
|
// message conforms to NeoFS API V2 protocol.
|
|
//
|
|
// See also WriteToV2.
|
|
func (x *NetworkInfo) ReadFromV2(m netmap.NetworkInfo) error {
|
|
return x.readFromV2(m, true)
|
|
}
|
|
|
|
// WriteToV2 writes NetworkInfo to the netmap.NetworkInfo message. The message
|
|
// MUST NOT be nil.
|
|
//
|
|
// See also ReadFromV2.
|
|
func (x NetworkInfo) WriteToV2(m *netmap.NetworkInfo) {
|
|
*m = x.m
|
|
}
|
|
|
|
// CurrentEpoch returns epoch set using SetCurrentEpoch.
|
|
//
|
|
// Zero NetworkInfo has zero current epoch.
|
|
func (x NetworkInfo) CurrentEpoch() uint64 {
|
|
return x.m.GetCurrentEpoch()
|
|
}
|
|
|
|
// SetCurrentEpoch sets current epoch of the NeoFS network.
|
|
func (x *NetworkInfo) SetCurrentEpoch(epoch uint64) {
|
|
x.m.SetCurrentEpoch(epoch)
|
|
}
|
|
|
|
// MagicNumber returns magic number set using SetMagicNumber.
|
|
//
|
|
// Zero NetworkInfo has zero magic.
|
|
func (x NetworkInfo) MagicNumber() uint64 {
|
|
return x.m.GetMagicNumber()
|
|
}
|
|
|
|
// SetMagicNumber sets magic number of the NeoFS Sidechain.
|
|
//
|
|
// See also MagicNumber.
|
|
func (x *NetworkInfo) SetMagicNumber(epoch uint64) {
|
|
x.m.SetMagicNumber(epoch)
|
|
}
|
|
|
|
// MsPerBlock returns network parameter set using SetMsPerBlock.
|
|
func (x NetworkInfo) MsPerBlock() int64 {
|
|
return x.m.GetMsPerBlock()
|
|
}
|
|
|
|
// SetMsPerBlock sets MillisecondsPerBlock network parameter of the NeoFS Sidechain.
|
|
//
|
|
// See also MsPerBlock.
|
|
func (x *NetworkInfo) SetMsPerBlock(v int64) {
|
|
x.m.SetMsPerBlock(v)
|
|
}
|
|
|
|
func (x *NetworkInfo) setConfig(name string, val []byte) {
|
|
c := x.m.GetNetworkConfig()
|
|
if c == nil {
|
|
c = new(netmap.NetworkConfig)
|
|
|
|
var prm netmap.NetworkParameter
|
|
prm.SetKey([]byte(name))
|
|
prm.SetValue(val)
|
|
|
|
c.SetParameters(prm)
|
|
|
|
x.m.SetNetworkConfig(c)
|
|
|
|
return
|
|
}
|
|
|
|
found := false
|
|
prms := make([]netmap.NetworkParameter, 0, c.NumberOfParameters())
|
|
|
|
c.IterateParameters(func(prm *netmap.NetworkParameter) bool {
|
|
found = bytes.Equal(prm.GetKey(), []byte(name))
|
|
if found {
|
|
prm.SetValue(val)
|
|
} else {
|
|
prms = append(prms, *prm)
|
|
}
|
|
|
|
return found
|
|
})
|
|
|
|
if !found {
|
|
prms = append(prms, netmap.NetworkParameter{})
|
|
prms[len(prms)-1].SetKey([]byte(name))
|
|
prms[len(prms)-1].SetValue(val)
|
|
|
|
c.SetParameters(prms...)
|
|
}
|
|
}
|
|
|
|
func (x NetworkInfo) configValue(name string) (res []byte) {
|
|
x.m.GetNetworkConfig().IterateParameters(func(prm *netmap.NetworkParameter) bool {
|
|
if string(prm.GetKey()) == name {
|
|
res = prm.GetValue()
|
|
|
|
return true
|
|
}
|
|
|
|
return false
|
|
})
|
|
|
|
return
|
|
}
|
|
|
|
// SetRawNetworkParameter sets named NeoFS network parameter whose value is
|
|
// transmitted but not interpreted by the NeoFS API protocol.
|
|
//
|
|
// Argument MUST NOT be mutated, make a copy first.
|
|
//
|
|
// See also RawNetworkParameter, IterateRawNetworkParameters.
|
|
func (x *NetworkInfo) SetRawNetworkParameter(name string, value []byte) {
|
|
x.setConfig(name, value)
|
|
}
|
|
|
|
// RawNetworkParameter reads raw network parameter set using SetRawNetworkParameter
|
|
// by its name. Returns nil if value is missing.
|
|
//
|
|
// Return value MUST NOT be mutated, make a copy first.
|
|
//
|
|
// Zero NetworkInfo has no network parameters.
|
|
func (x *NetworkInfo) RawNetworkParameter(name string) []byte {
|
|
return x.configValue(name)
|
|
}
|
|
|
|
// IterateRawNetworkParameters iterates over all raw networks parameters set
|
|
// using SetRawNetworkParameter and passes them into f.
|
|
//
|
|
// Handler MUST NOT be nil. Handler MUST NOT mutate value parameter.
|
|
//
|
|
// Zero NetworkInfo has no network parameters.
|
|
func (x *NetworkInfo) IterateRawNetworkParameters(f func(name string, value []byte)) {
|
|
c := x.m.GetNetworkConfig()
|
|
|
|
c.IterateParameters(func(prm *netmap.NetworkParameter) bool {
|
|
name := string(prm.GetKey())
|
|
switch name {
|
|
default:
|
|
f(name, prm.GetValue())
|
|
case
|
|
configEigenTrustAlpha,
|
|
configAuditFee,
|
|
configStoragePrice,
|
|
configContainerFee,
|
|
configNamedContainerFee,
|
|
configEigenTrustNumberOfIterations,
|
|
configEpochDuration,
|
|
configIRCandidateFee,
|
|
configMaxObjSize,
|
|
configWithdrawalFee:
|
|
}
|
|
|
|
return false
|
|
})
|
|
}
|
|
|
|
func (x *NetworkInfo) setConfigUint64(name string, num uint64) {
|
|
val := make([]byte, 8)
|
|
binary.LittleEndian.PutUint64(val, num)
|
|
|
|
x.setConfig(name, val)
|
|
}
|
|
|
|
func decodeConfigValueUint64(val []byte) (uint64, error) {
|
|
if ln := len(val); ln != 8 {
|
|
return 0, fmt.Errorf("invalid uint64 parameter length %d", ln)
|
|
}
|
|
|
|
return binary.LittleEndian.Uint64(val), nil
|
|
}
|
|
|
|
func (x NetworkInfo) configUint64(name string) uint64 {
|
|
val := x.configValue(name)
|
|
if val == nil {
|
|
return 0
|
|
}
|
|
|
|
res, err := decodeConfigValueUint64(val)
|
|
if err != nil {
|
|
// potential panic is OK since value MUST be correct since it is
|
|
// verified in ReadFromV2 or set by provided method.
|
|
panic(err)
|
|
}
|
|
|
|
return res
|
|
}
|
|
|
|
const configAuditFee = "AuditFee"
|
|
|
|
// SetAuditFee sets the configuration value of the audit fee for the Inner Ring.
|
|
//
|
|
// See also AuditFee.
|
|
func (x *NetworkInfo) SetAuditFee(fee uint64) {
|
|
x.setConfigUint64(configAuditFee, fee)
|
|
}
|
|
|
|
// AuditFee returns audit fee set using SetAuditFee.
|
|
//
|
|
// Zero NetworkInfo has zero audit fee.
|
|
func (x NetworkInfo) AuditFee() uint64 {
|
|
return x.configUint64(configAuditFee)
|
|
}
|
|
|
|
const configStoragePrice = "BasicIncomeRate"
|
|
|
|
// SetStoragePrice sets the price per gigabyte of data storage that data owners
|
|
// pay to storage nodes.
|
|
//
|
|
// See also StoragePrice.
|
|
func (x *NetworkInfo) SetStoragePrice(price uint64) {
|
|
x.setConfigUint64(configStoragePrice, price)
|
|
}
|
|
|
|
// StoragePrice returns storage price set using SetStoragePrice.
|
|
//
|
|
// Zero NetworkInfo has zero storage price.
|
|
func (x NetworkInfo) StoragePrice() uint64 {
|
|
return x.configUint64(configStoragePrice)
|
|
}
|
|
|
|
const configContainerFee = "ContainerFee"
|
|
|
|
// SetContainerFee sets fee for the container creation that creator pays to
|
|
// each Alphabet node.
|
|
//
|
|
// See also ContainerFee.
|
|
func (x *NetworkInfo) SetContainerFee(fee uint64) {
|
|
x.setConfigUint64(configContainerFee, fee)
|
|
}
|
|
|
|
// ContainerFee returns container fee set using SetContainerFee.
|
|
//
|
|
// Zero NetworkInfo has zero container fee.
|
|
func (x NetworkInfo) ContainerFee() uint64 {
|
|
return x.configUint64(configContainerFee)
|
|
}
|
|
|
|
const configNamedContainerFee = "ContainerAliasFee"
|
|
|
|
// SetNamedContainerFee sets fee for creation of the named container creation
|
|
// that creator pays to each Alphabet node.
|
|
//
|
|
// See also NamedContainerFee.
|
|
func (x *NetworkInfo) SetNamedContainerFee(fee uint64) {
|
|
x.setConfigUint64(configNamedContainerFee, fee)
|
|
}
|
|
|
|
// NamedContainerFee returns container fee set using SetNamedContainerFee.
|
|
//
|
|
// Zero NetworkInfo has zero container fee.
|
|
func (x NetworkInfo) NamedContainerFee() uint64 {
|
|
return x.configUint64(configNamedContainerFee)
|
|
}
|
|
|
|
const configEigenTrustAlpha = "EigenTrustAlpha"
|
|
|
|
// SetEigenTrustAlpha sets alpha parameter for EigenTrust algorithm used in
|
|
// reputation system of the storage nodes. Value MUST be in range [0, 1].
|
|
//
|
|
// See also EigenTrustAlpha.
|
|
func (x *NetworkInfo) SetEigenTrustAlpha(alpha float64) {
|
|
if alpha < 0 || alpha > 1 {
|
|
panic(fmt.Sprintf("EigenTrust alpha parameter MUST be in range [0, 1], got %.2f", alpha))
|
|
}
|
|
|
|
x.setConfigUint64(configEigenTrustAlpha, math.Float64bits(alpha))
|
|
}
|
|
|
|
// EigenTrustAlpha returns EigenTrust parameter set using SetEigenTrustAlpha.
|
|
//
|
|
// Zero NetworkInfo has zero alpha parameter.
|
|
func (x NetworkInfo) EigenTrustAlpha() float64 {
|
|
alpha := math.Float64frombits(x.configUint64(configEigenTrustAlpha))
|
|
if alpha < 0 || alpha > 1 {
|
|
panic(fmt.Sprintf("unexpected invalid %s parameter value %.2f", configEigenTrustAlpha, alpha))
|
|
}
|
|
|
|
return alpha
|
|
}
|
|
|
|
const configEigenTrustNumberOfIterations = "EigenTrustIterations"
|
|
|
|
// SetNumberOfEigenTrustIterations sets number of iterations of the EigenTrust
|
|
// algorithm to perform. The algorithm is used by the storage nodes for
|
|
// calculating the reputation values.
|
|
//
|
|
// See also NumberOfEigenTrustIterations.
|
|
func (x *NetworkInfo) SetNumberOfEigenTrustIterations(num uint64) {
|
|
x.setConfigUint64(configEigenTrustNumberOfIterations, num)
|
|
}
|
|
|
|
// NumberOfEigenTrustIterations returns number of EigenTrust iterations set
|
|
// using SetNumberOfEigenTrustIterations.
|
|
//
|
|
// Zero NetworkInfo has zero iteration number.
|
|
func (x NetworkInfo) NumberOfEigenTrustIterations() uint64 {
|
|
return x.configUint64(configEigenTrustNumberOfIterations)
|
|
}
|
|
|
|
const configEpochDuration = "EpochDuration"
|
|
|
|
// SetEpochDuration sets NeoFS epoch duration measured in number of blocks of
|
|
// the NeoFS Sidechain.
|
|
//
|
|
// See also EpochDuration.
|
|
func (x *NetworkInfo) SetEpochDuration(blocks uint64) {
|
|
x.setConfigUint64(configEpochDuration, blocks)
|
|
}
|
|
|
|
// EpochDuration returns epoch duration set using SetEpochDuration.
|
|
//
|
|
// Zero NetworkInfo has zero iteration number.
|
|
func (x NetworkInfo) EpochDuration() uint64 {
|
|
return x.configUint64(configEpochDuration)
|
|
}
|
|
|
|
const configIRCandidateFee = "InnerRingCandidateFee"
|
|
|
|
// SetIRCandidateFee sets fee for Inner Ring entrance paid by a new member.
|
|
//
|
|
// See also IRCandidateFee.
|
|
func (x *NetworkInfo) SetIRCandidateFee(fee uint64) {
|
|
x.setConfigUint64(configIRCandidateFee, fee)
|
|
}
|
|
|
|
// IRCandidateFee returns IR entrance fee set using SetIRCandidateFee.
|
|
//
|
|
// Zero NetworkInfo has zero fee.
|
|
func (x NetworkInfo) IRCandidateFee() uint64 {
|
|
return x.configUint64(configIRCandidateFee)
|
|
}
|
|
|
|
const configMaxObjSize = "MaxObjectSize"
|
|
|
|
// SetMaxObjectSize sets maximum size of the object stored locally on the
|
|
// storage nodes (physical objects). Binary representation of any physically
|
|
// stored object MUST NOT overflow the limit.
|
|
//
|
|
// See also MaxObjectSize.
|
|
func (x *NetworkInfo) SetMaxObjectSize(sz uint64) {
|
|
x.setConfigUint64(configMaxObjSize, sz)
|
|
}
|
|
|
|
// MaxObjectSize returns maximum object size set using SetMaxObjectSize.
|
|
//
|
|
// Zero NetworkInfo has zero maximum size.
|
|
func (x NetworkInfo) MaxObjectSize() uint64 {
|
|
return x.configUint64(configMaxObjSize)
|
|
}
|
|
|
|
const configWithdrawalFee = "WithdrawFee"
|
|
|
|
// SetWithdrawalFee sets fee for withdrawals from the NeoFS accounts that
|
|
// account owners pay to each Alphabet node.
|
|
//
|
|
// See also WithdrawalFee.
|
|
func (x *NetworkInfo) SetWithdrawalFee(sz uint64) {
|
|
x.setConfigUint64(configWithdrawalFee, sz)
|
|
}
|
|
|
|
// WithdrawalFee returns withdrawal fee set using SetWithdrawalFee.
|
|
//
|
|
// Zero NetworkInfo has zero fee.
|
|
func (x NetworkInfo) WithdrawalFee() uint64 {
|
|
return x.configUint64(configWithdrawalFee)
|
|
}
|