anyhash

anyhash

A Go hashing library that supports 60 hash algorithms selected by name. Unlike Go's standard crypto packages, anyhash accepts algorithm names as strings and provides a Clone() method to duplicate hash state at any point during computation.

Features

• String-based algorithm selection — New("sha256") instead of importing crypto/sha256
• Name normalization — case-insensitive, hyphens ignored: "SHA-256", "sha256", "SHA256" all work
• Cloneable state — Clone() creates an independent copy of the hash mid-computation
• Continue after Sum — calling Sum() does not reset the hash; you can keep writing
• HMAC support — NewHMAC("sha256", key) with full Clone/continue-after-Sum support
• HKDF support — NewHKDF("sha256", ikm, length, info, salt) for key derivation (RFC 5869)
• Zero external dependencies — all algorithms implemented using only the Go standard library
• PHP compatible — algorithm names and output match PHP's hash() function

Installation

go get github.com/KarpelesLab/anyhash

Usage

package main

import (
    "encoding/hex"
    "fmt"
    "github.com/KarpelesLab/anyhash"
)

func main() {
    // Create a hash by name
    h, err := anyhash.New("sha256")
    if err != nil {
        panic(err)
    }
    h.Write([]byte("hello "))

    // Clone the state
    h2 := h.Clone()

    // Continue writing to both independently
    h.Write([]byte("world"))
    h2.Write([]byte("there"))

    fmt.Println(hex.EncodeToString(h.Sum(nil)))  // sha256("hello world")
    fmt.Println(hex.EncodeToString(h2.Sum(nil))) // sha256("hello there")

    // HMAC
    mac, _ := anyhash.NewHMAC("sha256", []byte("secret"))
    mac.Write([]byte("message"))
    fmt.Println(hex.EncodeToString(mac.Sum(nil)))

    // HKDF (RFC 5869)
    key, _ := anyhash.NewHKDF("sha256", []byte("input key"), 32, []byte("info"), nil)
    fmt.Println(hex.EncodeToString(key))

    // List all supported algorithms
    fmt.Println(anyhash.List())
}

Supported Algorithms

Performance

Throughput on 64 KiB payloads (Intel i9-14900K, Go 1.25, single core):

Run benchmarks yourself with:

go test -run=^$ -bench=BenchmarkHash -benchtime=1s ./...

API

// Hash extends hash.Hash with cloning support.
type Hash interface {
    hash.Hash
    Clone() Hash
}

// New creates a hash by algorithm name.
func New(algo string) (Hash, error)

// NewHMAC creates an HMAC by algorithm name.
func NewHMAC(algo string, key []byte) (Hash, error)

// NewHKDF derives key material using HKDF (RFC 5869).
func NewHKDF(algo string, key []byte, length int, info []byte, salt []byte) ([]byte, error)

// List returns all supported algorithm names, sorted.
func List() []string

License

MIT