restructure project, add claudemd

This commit is contained in:
2026-07-08 16:36:17 -04:00
parent a7964f9410
commit 2a5fbffaa2
315 changed files with 81075 additions and 0 deletions

228
go/security/crypt.go Normal file
View File

@@ -0,0 +1,228 @@
package security
import (
"bytes"
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"crypto/sha512"
"encoding/base64"
"encoding/gob"
"fmt"
"io"
"log"
"time"
"github.com/btcsuite/btcutil/base58"
"github.com/minio/highwayhash"
"github.com/google/uuid"
"golang.org/x/crypto/bcrypt"
)
// dataHashKey is NOT used for hashing passwords or securing session data over
// the wire. It is ONLY used for quick, non-security-sensitive file and string
// hashes (HighwayHash needs a fixed 32-byte key). Kept in the framework because
// the value must stay stable across builds and is identical in every app.
const dataHashKey = "01234567890123456789012345678901"
////////////////////////////////
// Encoding Wrappers
////////////////////////////////
func EncodeBase64(in []byte) string {
return base64.StdEncoding.EncodeToString(in)
}
func DecodeBase64(in string) []byte {
out, _ := base64.StdEncoding.DecodeString(in)
return out
}
func EncodeBase58(in []byte) string {
return base58.Encode(in)
}
func DecodeBase58(in string) []byte {
return base58.Decode(in)
}
////////////////////////////////
// HASH FUNCTIONS
////////////////////////////////
// Hash with SHA512 and output a Base58 string
func SHA512_58(in string) string {
hasher := sha512.New()
hasher.Write([]byte(in))
hashBytes := hasher.Sum(nil)
hashString := base58.Encode(hashBytes)
return hashString
}
func HighwayHash58(in string) (string, error) {
key := []byte(dataHashKey)
hasher, err := highwayhash.New(key)
if err != nil {
log.Println("Error generating hasher.")
return "", err
}
hasher.Write([]byte(in))
hash := hasher.Sum(nil)
encodedData := base58.Encode(hash)
return encodedData, nil
}
func HighwayHash(in string) (string, error) {
key := []byte(dataHashKey)
hasher, err := highwayhash.New(key)
if err != nil {
log.Println("Error generating hasher.")
return "", err
}
hasher.Write([]byte(in))
hash := hasher.Sum(nil)
return base64.StdEncoding.EncodeToString(hash), nil
}
// Hash password using bcrypt
func HashPassword(password string) (string, error) {
bytes, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost)
return string(bytes), err
}
// Compare password with hash using bcrypt
func ComparePasswords(password string, hash string) bool {
err := bcrypt.CompareHashAndPassword([]byte(hash), []byte(password))
return err == nil
}
func RandBase58String(entropyBytes int) string {
b := make([]byte, entropyBytes)
rand.Read(b)
return base58.Encode(b)
}
////////////////////////////////
// Serialization FUNCTIONS
////////////////////////////////
func GobSerialize[T any](data *T) ([]byte, error) {
gob.Register(time.Time{})
gob.Register(uuid.UUID{})
b := bytes.Buffer{}
e := gob.NewEncoder(&b)
err := e.Encode(data)
if err != nil {
return nil, err
}
return b.Bytes(), nil
}
func GobDeserialize[T any](data []byte) (*T, error) {
dest := new(T)
b := bytes.Buffer{}
b.Write(data)
gob.Register(time.Time{})
gob.Register(uuid.UUID{})
d := gob.NewDecoder(&b)
err := d.Decode(dest)
if err != nil {
return nil, err
}
return dest, nil
}
////////////////////////////////
// Encryption FUNCTIONS
////////////////////////////////
// AES Encrypt
func EncryptSecret(data []byte, passKey string) ([]byte, error) {
key := make([]byte, 32)
copy(key, passKey)
block, err := aes.NewCipher(key)
if err != nil {
return nil, err
}
gcm, err := cipher.NewGCM(block)
if err != nil {
return nil, err
}
nonce := make([]byte, gcm.NonceSize())
if _, err := io.ReadFull(rand.Reader, nonce); err != nil {
return nil, err
}
encryptedData := gcm.Seal(nonce, nonce, data, nil)
return encryptedData, nil
}
// AES Decrypt
func DecryptSecret(encryptedData []byte, passKey string) ([]byte, error) {
key := make([]byte, 32)
copy(key, passKey)
block, err := aes.NewCipher(key)
if err != nil {
return nil, err
}
gcm, err := cipher.NewGCM(block)
if err != nil {
return nil, err
}
nonceSize := gcm.NonceSize()
if len(encryptedData) < nonceSize {
return nil, fmt.Errorf("ciphertext too short")
}
nonce, encryptedData := encryptedData[:nonceSize], encryptedData[nonceSize:]
decryptedData, err := gcm.Open(nil, nonce, encryptedData, nil)
if err != nil {
return nil, err
}
return decryptedData, nil
}
func EncryptData[T any](data *T, key string) ([]byte, error) {
serialized, err := GobSerialize(data)
if err != nil {
return nil, err
}
return EncryptSecret(serialized, key)
}
func DecryptData[T any](data []byte, key string) (*T, error) {
decrypted, err := DecryptSecret(data, key)
if err != nil {
return nil, err
}
return GobDeserialize[T](decrypted)
}