crypto

README

TinyCrypto

A lightweight Go library for cryptographic operations, designed for WebAssembly and small devices using TinyGo.

Features

• Simple API: Easy-to-use API for symmetric and asymmetric encryption, and digital signatures.
• TinyGo Optimized: Designed to produce small binaries when compiled with TinyGo.
• WebAssembly Ready: Can be used in browser environments.
• Zero Dependencies on Go Standard Library: Uses github.com/tinywasm/fmt for string, number, and error handling to minimize binary size.

Basic Usage

To use the library, create a new TinyCrypto engine and call its methods:

package main

import (
	"fmt"

	"github.com/tinywasm/crypto"
)

func main() {
	// Create a new crypto engine
	crypto := tinycrypto.New()

	// Symmetric encryption
	key := make([]byte, 32) // AES-256 key
	plaintext := []byte("hello world")
	ciphertext, err := crypto.Encrypt(plaintext, key)
	if err != nil {
		panic(err)
	}
	decrypted, err := crypto.Decrypt(ciphertext, key)
	if err != nil {
		panic(err)
	}
	fmt.Println("Symmetric decrypted:", string(decrypted))

	// Asymmetric signatures
	pub, priv, err := crypto.GenerateKeyPair()
	if err != nil {
		panic(err)
	}
	message := []byte("this is a test message")
	signature, err := crypto.Sign(message, priv)
	if err != nil {
		panic(err)
	}
	ok, err := crypto.Verify(message, signature, pub)
	if err != nil {
		panic(err)
	}
	fmt.Println("Signature verified:", ok)
}

Documentation

The detailed API documentation is organized into the following sections:

• Symmetric Encryption
• Asymmetric Encryption
• Digital Signatures

Documentation

Index

• type TinyCrypto
  • func New() *TinyCrypto
  • func (c *TinyCrypto) Decrypt(ciphertext, key []byte) (plaintext []byte, err error)
  • func (c *TinyCrypto) DecryptAsymmetric(ciphertext, privateKey []byte) (plaintext []byte, err error)
  • func (c *TinyCrypto) Encrypt(plaintext, key []byte) (ciphertext []byte, err error)
  • func (c *TinyCrypto) EncryptAsymmetric(plaintext, publicKey []byte) (ciphertext []byte, err error)
  • func (c *TinyCrypto) GenerateKeyPair() (publicKey []byte, privateKey []byte, err error)
  • func (c *TinyCrypto) Sign(message, privateKey []byte) (signature []byte, err error)
  • func (c *TinyCrypto) Verify(message, signature, publicKey []byte) (ok bool, err error)

Types

type TinyCrypto

type TinyCrypto struct{}

TinyCrypto is the engine for cryptographic operations.

func New

func New() *TinyCrypto

New creates a new TinyCrypto engine.

func (*TinyCrypto) Decrypt

func (c *TinyCrypto) Decrypt(ciphertext, key []byte) (plaintext []byte, err error)

Decrypt performs symmetric decryption of ciphertext using AES-GCM with a 32-byte key.

func (*TinyCrypto) DecryptAsymmetric

func (c *TinyCrypto) DecryptAsymmetric(ciphertext, privateKey []byte) (plaintext []byte, err error)

DecryptAsymmetric decrypts ciphertext with a private key.

func (*TinyCrypto) Encrypt

func (c *TinyCrypto) Encrypt(plaintext, key []byte) (ciphertext []byte, err error)

Encrypt performs symmetric encryption of plaintext using AES-GCM with a 32-byte key. It returns the ciphertext, which includes the nonce and the encrypted data.

func (*TinyCrypto) EncryptAsymmetric

func (c *TinyCrypto) EncryptAsymmetric(plaintext, publicKey []byte) (ciphertext []byte, err error)

EncryptAsymmetric encrypts plaintext for a given public key using ECIES (ECDH + AES-GCM). The returned ciphertext includes the ephemeral public key needed for decryption.

func (*TinyCrypto) GenerateKeyPair

func (c *TinyCrypto) GenerateKeyPair() (publicKey []byte, privateKey []byte, err error)

GenerateKeyPair generates a new ECDSA key pair for asymmetric cryptography using the P-256 curve.

func (*TinyCrypto) Sign

func (c *TinyCrypto) Sign(message, privateKey []byte) (signature []byte, err error)

Sign creates a digital signature for a message using a private key (ECDSA with P-256 and SHA-256).

func (*TinyCrypto) Verify

func (c *TinyCrypto) Verify(message, signature, publicKey []byte) (ok bool, err error)

Verify checks a digital signature of a message using a public key.