👁 Image
Tharga.Toolkit 1.15.25

Tharga.Toolkit

👁 NuGet
👁 Nuget

Modern .NET toolkit (net8.0+) with hashing, claims, API keys, and more. Includes all features from .

Installation

dotnet add package Tharga.Toolkit

Features

Hash

Compute hashes from strings, byte arrays, URIs, and streams. Supports MD5, SHA1, SHA256, SHA384, and SHA512.

// String hash
var hash = "hello".ToHash(HashType.SHA256);

// Formatted output
var hex = "hello".ToHash(HashFormat.HexLower, HashType.SHA256);

// Stream hash
await using var stream = File.OpenRead("file.dat");
var streamHash = await stream.ToHashAsync(HashFormat.Base64, HashType.SHA256);

// Change format
var base32 = hex.ChangeFormat(HashFormat.Base32);

Base32 Encoding

RFC 4648 Base32 encoding and decoding.

var encoded = Base32Encoding.Encode(Encoding.UTF8.GetBytes("hello"));
var decoded = Base32Encoding.Decode(encoded);

Claims Extensions

Extract and verify identity keys from claims principals.

// Get a portable identity key
var key = claimsPrincipal.GetKey();

// Verify against a known identity
bool match = key.VerifyKey("user-123", "sub");

// Extract all identities
var identities = key.GetIdentities();

URI Extensions

var uri = new Uri("https://example.com/path?page=1&sort=name");

// Remove query string
var clean = uri.RemoveQuery(); // https://example.com/path

// Get specific query values
var values = uri.GetQueryValue("sort"); // ["name"]

Async Enumerable Extensions

// Pick a random element from an async stream
var item = await asyncEnumerable.TakeRandomAsync();

// Shuffle an async stream
await foreach (var x in asyncEnumerable.RandomOrderAsync())
{
 // ...
}

API Key Service

Build, encrypt, and verify API keys with dependency injection support.

// Register in DI with code-based options
services.RegisterApiKeyService(options =>
{
 options.SaltSize = 32;
 options.Iterations = 20000;
});

// Or bind options from IConfiguration (default section name: "ApiKey")
services.RegisterApiKeyService(configuration);
services.RegisterApiKeyService(configuration, "MyApiKeySection");

// Use via IApiKeyService
var apiKey = apiKeyService.BuildApiKey("username");
var encrypted = apiKeyService.Encrypt(apiKey);
bool valid = apiKeyService.Verify(apiKey, encrypted);
var username = apiKeyService.GetUsername(apiKey);

Example appsettings.json:

{
 "ApiKey": {
 "SaltSize": 32,
 "HashSize": 32,
 "Iterations": 20000
 }
}

👁 GitHub repo