🥮 mooncakes.io

    ed25519

    A pure MoonBit Ed25519 signing and verification package.

    ed25519
    signature
    crypto
    license
    Download zip
    Author
    Version
    0.1.1
    License
    Apache-2.0
    Repository
    Last updated
    6 months ago
    Downloads
    18K

    #hustcer/ed25519

    A pure MoonBit implementation of plain Ed25519 signing and verification.

    The package implements deterministic Ed25519 over Array[UInt] byte arrays. It is intended for small payloads such as locally signed license data, plus tests and interoperability checks against RFC 8032 vectors and OpenSSL.

    This package is not audited and is not written to be constant-time. Use a mature audited cryptography library for high-volume, network-facing, or side-channel-sensitive signing systems.

    #Module

    Add the module dependency in moon.mod.json:

    {
  "deps": {
    "hustcer/ed25519": "0.1.1"
  }
}

    Import it from moon.pkg with an alias:

    import {
      "hustcer/ed25519" @ed25519,
    }

    This repository itself depends on Tigls/mb-hash for SHA-512.

    #API

    The public API is generated in pkg.generated.mbti and currently consists of:

    pub fn derive_public_key(Array[UInt]) -> Result[Array[UInt], String]
    pub fn sign(Array[UInt], Array[UInt]) -> Result[Array[UInt], String]
    pub fn verify(Array[UInt], Array[UInt], Array[UInt]) -> Bool
    pub fn verify_result(Array[UInt], Array[UInt], Array[UInt]) -> Result[Bool, String]

    pub struct SigningKey
    pub fn SigningKey::from_seed(Array[UInt]) -> Result[SigningKey, String]
    pub fn SigningKey::public_key(SigningKey) -> Array[UInt]
    pub fn SigningKey::sign(SigningKey, Array[UInt]) -> Result[Array[UInt], String]

    pub struct VerifyingKey
    pub fn VerifyingKey::from_public_key(Array[UInt]) -> Result[VerifyingKey, String]
    pub fn VerifyingKey::public_key(VerifyingKey) -> Array[UInt]
    pub fn VerifyingKey::verify(VerifyingKey, Array[UInt], Array[UInt]) -> Bool
    pub fn VerifyingKey::verify_result(
      VerifyingKey,
      Array[UInt],
      Array[UInt]
    ) -> Result[Bool, String]

    #Data Model

    • Private keys are 32-byte Ed25519 seeds.
    • Public keys are 32 bytes.
    • Signatures are 64 bytes.
    • Messages are Array[UInt].
    • Every byte value in seeds, public keys, messages, and signatures must be in 0..255.

    The implementation validates byte lengths and byte ranges. The Result returning functions report malformed inputs as Err(String).

    verify and VerifyingKey::verify return false on malformed input or an invalid signature. Use verify_result or VerifyingKey::verify_result when the caller needs to distinguish malformed input from a valid-but-rejected signature.

    #Usage

    One-off signing and verification:

    let seed : Array[UInt] = [
      0x9d, 0x61, 0xb1, 0x9d, 0xef, 0xfd, 0x5a, 0x60,
      0xba, 0x84, 0x4a, 0xf4, 0x92, 0xec, 0x2c, 0xc4,
      0x44, 0x49, 0xc5, 0x69, 0x7b, 0x32, 0x69, 0x19,
      0x70, 0x3b, 0xac, 0x03, 0x1c, 0xae, 0x7f, 0x60,
    ]
    let message : Array[UInt] = [0x6c, 0x69, 0x63, 0x65, 0x6e, 0x73, 0x65]

    let public_key = @ed25519.derive_public_key(seed).unwrap()
    let signature = @ed25519.sign(seed, message).unwrap()
    let ok = @ed25519.verify(public_key, message, signature)

    For repeated signing with the same seed, create a SigningKey once. It caches the expanded scalar, prefix, and derived public key:

    let signing_key = @ed25519.SigningKey::from_seed(seed).unwrap()
    let public_key = signing_key.public_key()
    let signature = signing_key.sign(message).unwrap()

    For repeated verification with the same public key, create a VerifyingKey once. It caches the decoded public key and verification table:

    let verifying_key = @ed25519.VerifyingKey::from_public_key(public_key).unwrap()
    let ok = verifying_key.verify(message, signature)

    #Implementation Notes

    This is a plain Ed25519 implementation using SHA-512 from Tigls/mb-hash. It does not expose Ed25519ph or Ed25519ctx variants.

    The curve arithmetic uses MoonBit BigInt, extended Edwards coordinates, 5-bit scalar windows, a cached basepoint table, and an interleaved double-scalar verification path. The cached key types avoid repeated setup work when signing or verifying multiple messages with the same key material.

    #Development

    Useful commands from the repository root:

    moon fmt
moon check
moon test
moon info

    moon info regenerates pkg.generated.mbti, which is the easiest way to review public API changes.

    Run benchmarks with:

    moon bench --release

    See BENCHMARK.md for the benchmark cases and local historical measurements. Benchmark numbers are local measurements, not performance guarantees.

    #OpenSSL Interop Check

    The interop check requires Nushell and OpenSSL:

    nu scripts/openssl-interop.nu

    The script generates an OpenSSL Ed25519 key, extracts the 32-byte seed, signs a payload with OpenSSL and this package, compares public keys and signatures, and verifies signatures in both directions.

    #License

    Apache-2.0. See LICENSE.

    SigningKey

    source
    pub struct SigningKey {
      // private fields
    }

    Expanded Ed25519 signing key for repeated signing with the same seed.

    SigningKey::from_seed

    source
    fn SigningKey::from_seed(seed : Array[UInt]) -> Result[SigningKey, String]

    Create an expanded signing key from a 32-byte Ed25519 private seed.

    SigningKey::public_key

    source
    fn SigningKey::public_key(self : SigningKey) -> Array[UInt]

    Return a copy of the 32-byte public key for this signing key.

    SigningKey::sign

    source
    fn SigningKey::sign(self : SigningKey, message : Array[UInt]) -> Result[Array[UInt], String]

    Sign a message with a pre-expanded Ed25519 signing key.

    VerifyingKey

    source
    pub struct VerifyingKey {
      // private fields
    }

    Expanded Ed25519 verifying key for repeated verification.

    VerifyingKey::from_public_key

    source
    fn VerifyingKey::from_public_key(public_key : Array[UInt]) -> Result[VerifyingKey, String]

    Create an expanded verifying key from a 32-byte Ed25519 public key.

    VerifyingKey::public_key

    source
    fn VerifyingKey::public_key(self : VerifyingKey) -> Array[UInt]

    Return a copy of the 32-byte public key for this verifying key.

    VerifyingKey::verify

    source
    fn VerifyingKey::verify(self : VerifyingKey, message : Array[UInt], signature : Array[UInt]) -> Bool

    Verify a signature with a pre-expanded verifying key.

    VerifyingKey::verify_result

    source
    fn VerifyingKey::verify_result(self : VerifyingKey, message : Array[UInt], signature : Array[UInt]) -> Result[Bool, String]

    Verify a signature with a pre-expanded verifying key and report malformed inputs.

    derive_public_key

    source
    fn derive_public_key(seed : Array[UInt]) -> Result[Array[UInt], String]

    Derive a 32-byte Ed25519 public key from a 32-byte private seed.

    sign

    source
    fn sign(seed : Array[UInt], message : Array[UInt]) -> Result[Array[UInt], String]

    Sign a message with a 32-byte Ed25519 private seed.

    verify

    source
    fn verify(public_key : Array[UInt], message : Array[UInt], signature : Array[UInt]) -> Bool

    Verify a 64-byte Ed25519 signature for a message and 32-byte public key.

    verify_result

    source
    fn verify_result(public_key : Array[UInt], message : Array[UInt], signature : Array[UInt]) -> Result[Bool, String]

    Verify a signature and return an error for malformed public inputs.

    Source Files

    Powered by MoonBit

    Site sourceReport issueModulesSkillsCLIBuild queueStatistics

    © 2026 mooncakes.io