mldsa

package standard library

go1.26.0 Latest Latest Go to latest Published: Feb 10, 2026 License: BSD-3-Clause Imports: 12 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

cs.opensource.google/go/go

Links

Report a Vulnerability

Documentation ¶

Index ¶

Constants
func Sign(priv *PrivateKey, msg []byte, context string) ([]byte, error)
func SignDeterministic(priv *PrivateKey, msg []byte, context string) ([]byte, error)
func SignExternalMu(priv *PrivateKey, μ []byte) ([]byte, error)
func SignExternalMuDeterministic(priv *PrivateKey, μ []byte) ([]byte, error)
func TestingOnlyPrivateKeySemiExpandedBytes(priv *PrivateKey) []byte
func TestingOnlySignExternalMuWithRandom(priv *PrivateKey, μ []byte, random []byte) ([]byte, error)
func TestingOnlySignWithRandom(priv *PrivateKey, msg []byte, context string, random []byte) ([]byte, error)
func Verify(pub *PublicKey, msg, sig []byte, context string) error
func VerifyExternalMu(pub *PublicKey, μ []byte, sig []byte) error
type PrivateKey
type PublicKey

Constants ¶

View Source

const (
	R  = 4294967296 // 2³²
	RR = 2365951    // R² mod q, aka R in the Montgomery domain

)

View Source

const (
	PrivateKeySize = 32

	PublicKeySize44 = 32 + 4*n*10/8
	PublicKeySize65 = 32 + 6*n*10/8
	PublicKeySize87 = 32 + 8*n*10/8

	SignatureSize44 = 128/4 + 4*n*(17+1)/8 + 80 + 4
	SignatureSize65 = 192/4 + 5*n*(19+1)/8 + 55 + 6
	SignatureSize87 = 256/4 + 7*n*(19+1)/8 + 75 + 8
)

Variables ¶

This section is empty.

Functions ¶

func Sign ¶

func Sign(priv *PrivateKey, msg []byte, context string) ([]byte, error)

func SignDeterministic ¶

func SignDeterministic(priv *PrivateKey, msg []byte, context string) ([]byte, error)

func SignExternalMu ¶

func SignExternalMu(priv *PrivateKey, μ []byte) ([]byte, error)

func SignExternalMuDeterministic ¶

func SignExternalMuDeterministic(priv *PrivateKey, μ []byte) ([]byte, error)

func TestingOnlyPrivateKeySemiExpandedBytes ¶

func TestingOnlyPrivateKeySemiExpandedBytes(priv *PrivateKey) []byte

func TestingOnlySignExternalMuWithRandom ¶

func TestingOnlySignExternalMuWithRandom(priv *PrivateKey, μ []byte, random []byte) ([]byte, error)

func TestingOnlySignWithRandom ¶

func TestingOnlySignWithRandom(priv *PrivateKey, msg []byte, context string, random []byte) ([]byte, error)

func Verify ¶

func Verify(pub *PublicKey, msg, sig []byte, context string) error

func VerifyExternalMu ¶

func VerifyExternalMu(pub *PublicKey, μ []byte, sig []byte) error

Types ¶

type PrivateKey ¶

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

func GenerateKey44 ¶

func GenerateKey44() *PrivateKey

func GenerateKey65 ¶

func GenerateKey65() *PrivateKey

func GenerateKey87 ¶

func GenerateKey87() *PrivateKey

func NewPrivateKey44 ¶

func NewPrivateKey44(seed []byte) (*PrivateKey, error)

func NewPrivateKey65 ¶

func NewPrivateKey65(seed []byte) (*PrivateKey, error)

func NewPrivateKey87 ¶

func NewPrivateKey87(seed []byte) (*PrivateKey, error)

func TestingOnlyNewPrivateKeyFromSemiExpanded ¶

func TestingOnlyNewPrivateKeyFromSemiExpanded(sk []byte) (*PrivateKey, error)

TestingOnlyNewPrivateKeyFromSemiExpanded creates a PrivateKey from a semi-expanded private key encoding, for testing purposes. It rejects inconsistent keys.

PrivateKey.Bytes must NOT be called on the resulting key, as it will produce a random value.

func (*PrivateKey) Bytes ¶

func (priv *PrivateKey) Bytes() []byte

func (*PrivateKey) Equal ¶

func (priv *PrivateKey) Equal(x *PrivateKey) bool

func (*PrivateKey) PublicKey ¶

func (priv *PrivateKey) PublicKey() *PublicKey

type PublicKey ¶

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

func NewPublicKey44 ¶

func NewPublicKey44(pk []byte) (*PublicKey, error)

func NewPublicKey65 ¶

func NewPublicKey65(pk []byte) (*PublicKey, error)

func NewPublicKey87 ¶

func NewPublicKey87(pk []byte) (*PublicKey, error)

func (*PublicKey) Bytes ¶

func (pub *PublicKey) Bytes() []byte

func (*PublicKey) Equal ¶

func (pub *PublicKey) Equal(x *PublicKey) bool

func (*PublicKey) Parameters ¶

func (pub *PublicKey) Parameters() string

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL