HashLib4Pascal is a comprehensive hashing library for Object Pascal, providing an easy-to-use interface for computing hashes, checksums, MACs, KDFs, and XOFs with support for state-based (incremental) hashing, released under the permissive MIT License.

Table of Contents

• Features
• Available Algorithms
• Getting Started
• Quick Examples
• Running Tests
• Contributing
• Other Implementations
• Tip Jar
• License

Features

• Extensive hash coverage -- CRC (all standard variants from CRC3 to CRC64), non-cryptographic (Murmur, XXHash, SipHash, etc.), and cryptographic (SHA-2, SHA-3, Blake2, Blake3, and more)
• State-based (incremental) hashing -- feed data in chunks via TransformBytes / TransformString, then finalize with TransformFinal
• One-shot convenience -- ComputeString, ComputeBytes, ComputeFile, ComputeStream for single-call hashing
• Password hashing / KDFs -- Argon2 (2i/2d/2id), Scrypt, PBKDF2-HMAC
• MACs -- HMAC (all supported hashes), KMAC (128/256), Blake2BMAC, Blake2SMAC
• Extendable output functions (XOFs) -- Shake, CShake, Blake2X, KMACXOF, Blake3XOF
• Cloneable state -- clone any hash instance mid-computation for parallel/divergent processing
• Cross-platform -- Delphi and FreePascal on Windows, Linux, macOS, and more

Available Algorithms

Getting Started

Prerequisites

Installation

Delphi

1. Open and install the package: HashLib/src/Packages/Delphi/HashLib4PascalPackage.dpk
2. Add the HashLib/src subdirectories to your project's search path.

FreePascal / Lazarus

1. Open and install the package: HashLib/src/Packages/FPC/HashLib4PascalPackage.lpk

Quick Examples

SHA-256 Hash

uses
  SysUtils, HlpHashFactory;

var
  LHash: String;
begin
  LHash := THashFactory.TCrypto.CreateSHA2_256()
    .ComputeString('Hello HashLib4Pascal', TEncoding.UTF8)
    .ToString();

  WriteLn(LHash);
end;

Incremental (Streaming) Hash

uses
  SysUtils, HlpIHash, HlpHashFactory;

var
  LHashInstance: IHash;
begin
  LHashInstance := THashFactory.TCrypto.CreateBlake2B_256();
  LHashInstance.Initialize();

  LHashInstance.TransformString('chunk one', TEncoding.UTF8);
  LHashInstance.TransformString('chunk two', TEncoding.UTF8);
  LHashInstance.TransformString('chunk three', TEncoding.UTF8);

  WriteLn(LHashInstance.TransformFinal().ToString());
end;

HMAC

uses
  SysUtils, HlpIHashInfo, HlpHashFactory, HlpConverters;

var
  LHMAC: IHMAC;
begin
  LHMAC := THashFactory.THMAC.CreateHMAC(
    THashFactory.TCrypto.CreateSHA2_256(),
    TConverters.ConvertStringToBytes('secret key', TEncoding.UTF8));

  WriteLn(LHMAC.ComputeString('message', TEncoding.UTF8).ToString());
end;

Scrypt KDF

uses
  SysUtils, HlpHashFactory, HlpConverters;

var
  LDerivedKey: TBytes;
begin
  LDerivedKey := TKDF.TPBKDF_Scrypt.CreatePBKDF_Scrypt(
    TConverters.ConvertStringToBytes('password', TEncoding.UTF8),
    TConverters.ConvertStringToBytes('salt', TEncoding.UTF8),
    1024, 8, 1)
    .GetBytes(32);

  WriteLn(TConverters.ConvertBytesToHexString(LDerivedKey));
end;

Running Tests

Tests use DUnit (Delphi) and FPCUnit (FreePascal).

• Delphi: Open HashLib.Tests/Delphi.Tests/HashLib.Tests.dpr in the IDE and run.
• FreePascal / Lazarus: Open HashLib.Tests/FreePascal.Tests/HashLib.Tests.lpi in the IDE and run.

Contributing

Contributions are welcome. Please open an issue for bug reports or feature requests, and submit pull requests.

Other Implementations

If you want implementations in other languages, you can check out these:

• HashLib4CPP by Mbadiwe Nnaemeka Ronald

Tip Jar

If you find this library useful and would like to support its continued development, tips are greatly appreciated! 🙏

Cryptocurrency	Wallet Address
Bitcoin (BTC)	bc1quqhe342vw4ml909g334w9ygade64szqupqulmu
Ethereum (ETH)	0x53651185b7467c27facab542da5868bfebe2bb69
Solana (SOL)	BPZHjY1eYCdQjLecumvrTJRi5TXj3Yz1vAWcmyEB9Miu

License

HashLib4Pascal is released under the MIT License.