FideliusCrypto 1.0.13

FideliusCrypto 🔐

A .NET library for ECDH cryptography, utilizing Curve25519 and a custom HMAC-based Key Derivation Function to generate AES-GCM keys for secure data encryption and decryption. Its primary purpose is to secure health data within the ABDM ecosystem.

📦 Installation

NuGet Package

Install the package via NuGet:

dotnet add package FideliusCrypto

🔑 KeyPair Generation

var keyPairGen = new FideliusKeyPairGeneration();
var result = keyPairGen.Generate();

🔒 Encryption

var keyPairGen = new FideliusKeyPairGeneration();
var sender = keyPairGen.Generate();
var requester = keyPairGen.Generate();

var encryptionRequest = new FideliusEncryptionRequest(
    sender.PrivateKey,
    sender.Nonce,
    requester.PublicKey,
    requester.Nonce,
    "testString");

var encryptionService = new FideliusEncryptionService();

var response = encryptionService.Encrypt(encryptionRequest);

🔓 Decryption

var keyPairGen = new FideliusKeyPairGeneration();
var sender = keyPairGen.Generate();
var requester = keyPairGen.Generate();

var decryptionRequest = new FideliusDecryptionRequest(
    "G3UUnMPvWxCt3kE7KZ6kSpfakoeo8sn/Fzo=",
    requester.Nonce,
    sender.Nonce,
    requester.PrivateKey,
    sender.PublicKey);

var decryptionService = new FideliusDecryptionService();

var response = decryptionService.Decrypt(decryptionRequest);

📝 Usage Example

Here's a complete example to demonstrate the usage of FideliusCrypto:

using FideliusCrypto;

class Program
{
    static void Main(string[] args)
    {
        var keyPairGen = new FideliusKeyPairGeneration();

        // Generate key pairs for sender and requester
        var sender = keyPairGen.Generate();
        var requester = keyPairGen.Generate();

        // Create encryption request
        var encryptionRequest = new FideliusEncryptionRequest(
            sender.PrivateKey,
            sender.Nonce,
            requester.PublicKey,
            requester.Nonce,
            "This is a secret message.");

        var encryptionService = new FideliusEncryptionService();
        var encryptedResponse = encryptionService.Encrypt(encryptionRequest);

        // Display encrypted message
        Console.WriteLine("Encrypted message: " + encryptedResponse.EncryptedText);

        // Create decryption request
        var decryptionRequest = new FideliusDecryptionRequest(
            encryptedResponse.EncryptedText,
            requester.Nonce,
            sender.Nonce,
            requester.PrivateKey,
            sender.PublicKey);

        var decryptionService = new FideliusDecryptionService();
        var decryptedResponse = decryptionService.Decrypt(decryptionRequest);

        // Display decrypted message
        Console.WriteLine("Decrypted message: " + decryptedResponse.DecryptedText);
    }
}

📦 Dependency Injection Support

FideliusCrypto can be easily registered in .NET Dependency Injection (DI):

using FideliusCrypto;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddFideliusCrypto();
var serviceProvider = services.BuildServiceProvider();

// Resolve services
var keyPairGen = serviceProvider.GetRequiredService<FideliusKeyPairGeneration>();
var encryptionService = serviceProvider.GetRequiredService<FideliusEncryptionService>();
var decryptionService = serviceProvider.GetRequiredService<FideliusDecryptionService>();

🛠 Features

KeyPair Generation: Generate cryptographic key pairs for secure communication.

ECDH Key Exchange: Securely exchange keys using Elliptic Curve Diffie-Hellman (ECDH).

AES-GCM Encryption: Encrypt data with AES-GCM for authenticated encryption.

HKDF Key Derivation: Derive keys using HMAC-based Extract-and-Expand Key Derivation Function (HKDF).

🔗 Links

GitHub Repository: FideliusCrypto

NuGet Package: FideliusCrypto