103 lines
2.6 KiB
Go
103 lines
2.6 KiB
Go
package reputation
|
|
|
|
import (
|
|
"bytes"
|
|
"errors"
|
|
"fmt"
|
|
|
|
"github.com/mr-tron/base58"
|
|
"github.com/nspcc-dev/neofs-api-go/v2/reputation"
|
|
)
|
|
|
|
// PeerID represents unique identifier of the peer participating in the NeoFS
|
|
// reputation system.
|
|
//
|
|
// ID is mutually compatible with github.com/nspcc-dev/neofs-api-go/v2/reputation.PeerID
|
|
// message. See ReadFromV2 / WriteToV2 methods.
|
|
//
|
|
// Instances can be created using built-in var declaration.
|
|
type PeerID struct {
|
|
m reputation.PeerID
|
|
}
|
|
|
|
// ReadFromV2 reads PeerID from the reputation.PeerID message. Returns an
|
|
// error if the message is malformed according to the NeoFS API V2 protocol.
|
|
//
|
|
// See also WriteToV2.
|
|
func (x *PeerID) ReadFromV2(m reputation.PeerID) error {
|
|
val := m.GetPublicKey()
|
|
if len(val) == 0 {
|
|
return errors.New("missing ID bytes")
|
|
}
|
|
|
|
x.m = m
|
|
|
|
return nil
|
|
}
|
|
|
|
// WriteToV2 writes PeerID to the reputation.PeerID message.
|
|
// The message must not be nil.
|
|
//
|
|
// See also ReadFromV2.
|
|
func (x PeerID) WriteToV2(m *reputation.PeerID) {
|
|
*m = x.m
|
|
}
|
|
|
|
// SetPublicKey sets PeerID as a binary-encoded public key which authenticates
|
|
// the participant of the NeoFS reputation system.
|
|
//
|
|
// Argument MUST NOT be mutated, make a copy first.
|
|
//
|
|
// See also CompareKey.
|
|
func (x *PeerID) SetPublicKey(key []byte) {
|
|
x.m.SetPublicKey(key)
|
|
}
|
|
|
|
// PublicKey return public key set using SetPublicKey.
|
|
//
|
|
// Zero PeerID has zero key which is incorrect according to NeoFS API
|
|
// protocol.
|
|
//
|
|
// Return value MUST NOT be mutated, make a copy first.
|
|
func (x PeerID) PublicKey() []byte {
|
|
return x.m.GetPublicKey()
|
|
}
|
|
|
|
// ComparePeerKey checks if the given PeerID corresponds to the party
|
|
// authenticated by the given binary public key.
|
|
func ComparePeerKey(peer PeerID, key []byte) bool {
|
|
return bytes.Equal(peer.PublicKey(), key)
|
|
}
|
|
|
|
// EncodeToString encodes ID into NeoFS API protocol string.
|
|
//
|
|
// Zero PeerID is base58 encoding of PeerIDSize zeros.
|
|
//
|
|
// See also DecodeString.
|
|
func (x PeerID) EncodeToString() string {
|
|
return base58.Encode(x.m.GetPublicKey())
|
|
}
|
|
|
|
// DecodeString decodes string into PeerID according to NeoFS API protocol.
|
|
// Returns an error if s is malformed.
|
|
//
|
|
// See also DecodeString.
|
|
func (x *PeerID) DecodeString(s string) error {
|
|
data, err := base58.Decode(s)
|
|
if err != nil {
|
|
return fmt.Errorf("decode base58: %w", err)
|
|
}
|
|
|
|
x.m.SetPublicKey(data)
|
|
|
|
return nil
|
|
}
|
|
|
|
// String implements fmt.Stringer.
|
|
//
|
|
// String is designed to be human-readable, and its format MAY differ between
|
|
// SDK versions. String MAY return same result as EncodeToString. String MUST NOT
|
|
// be used to encode ID into NeoFS protocol string.
|
|
func (x PeerID) String() string {
|
|
return x.EncodeToString()
|
|
}
|