frostfs-sdk-go/crypto/signer.go

package neofscrypto

import (
	"fmt"
)

// Scheme represents digital signature algorithm with fixed cryptographic hash function.
//
// Negative values are reserved and depend on context (e.g. unsupported scheme).
type Scheme int32

//nolint:revive
const (
	_ Scheme = iota - 1

	ECDSA_SHA512               // ECDSA with SHA-512 hashing (FIPS 186-3)
	ECDSA_DETERMINISTIC_SHA256 // Deterministic ECDSA with SHA-256 hashing (RFC 6979)
)

// maps Scheme to blank PublicKey constructor.
var publicKeys = make(map[Scheme]func() PublicKey)

// RegisterScheme registers a function that returns a new blank PublicKey
// instance for the given Scheme. This is intended to be called from the init
// function in packages that implement signature schemes.
//
// RegisterScheme panics if function for the given Scheme is already registered.
func RegisterScheme(scheme Scheme, f func() PublicKey) {
	_, ok := publicKeys[scheme]
	if ok {
		panic(fmt.Sprintf("scheme %v is already registered", scheme))
	}

	publicKeys[scheme] = f
}

// Signer is an interface of entities that can be used for signing operations
// in NeoFS. Unites secret and public parts. For example, an ECDSA private key
// or external auth service.
//
// See also PublicKey.
type Signer interface {
	// Scheme returns corresponding signature scheme.
	Scheme() Scheme

	// Sign signs digest of the given data. Implementations encapsulate data
	// hashing that depends on Scheme. For example, if scheme uses SHA-256, then
	// Sign signs SHA-256 hash of the data.
	Sign(data []byte) ([]byte, error)

	// MaxPublicKeyEncodedSize returns maximum size required for binary-encoded
	// public key.
	//
	// MaxPublicKeyEncodedSize MUST NOT return value greater than any return of
	// EncodePublicKey.
	MaxPublicKeyEncodedSize() int

	// EncodePublicKey encodes public key into buf. Returns number of bytes
	// written.
	//
	// EncodePublicKey MUST panic if buffer size is insufficient and less than
	// MaxPublicKeyEncodedSize (*). EncodePublicKey MUST return negative value
	// on any failure except (*).
	//
	// EncodePublicKey is expected to be compatible with PublicKey.Decode for
	// similar signature schemes.
	EncodePublicKey(buf []byte) int
}

// PublicKey represents a public key using fixed signature scheme supported by
// NeoFS.
//
// See also Signer.
type PublicKey interface {
	// Decode decodes binary public key.
	//
	// Decode is expected to be compatible with Signer.EncodePublicKey for
	// similar signature schemes.
	Decode([]byte) error

	// Verify checks signature of the given data. True means correct signature.
	Verify(data, signature []byte) bool
}