ErduranLib 1.0.101.221

ErduranLib

The "Black Box" Banking Engine - A high-performance, zero-trust .NET 10 library designed for the most critical banking and financial data lifecycles.

📌 Overview

ErduranLib is built on the philosophy that financial data is sacred. It acts as a "Black Box" between your application logic and the database, ensuring that every byte of data is validated, encrypted, audited, and persisted with absolute atomicity.

By leveraging the latest features of .NET 10 and C# 14, ErduranLib provides enterprise-grade performance (SIMD, Compiled Queries, Zero-Allocation Spans) while maintaining a surface API so simple an engineer can be productive in minutes.

🚀 Key Features

🛡️ Guardian Pattern (Zero Data Loss)

• Persistent Journaling: Every operation is logged to a write-ahead journal before hitting the main tables. Recover from power failures or crashes with RecoverAsync().
• Mandatory Snapshot Isolation: Automatically uses the most robust isolation levels to prevent phantom reads and race conditions.
• Idempotency Built-in: Prevents double-spending or duplicate transactions automatically via unique TransactionId tracking.

⚡ Extreme Performance

• Pre-Compiled Query Hot-Paths: Bypasses EF Core expression translation overhead for 2-3x faster lookups.
• SIMD/Vectorized Calculations: High-frequency financial math (sums, averages, running balances) utilizes AVX-512/AVX2 hardware acceleration.
• Zero-Allocation Logic: Massive use of Span<T>, MemoryMarshal, and stack allocation for high-throughput scenarios.

🔒 Enterprise Security

• Transparent Field Encryption: Protect PII and sensitive amounts with AES-256 by simply adding the [ErduranEncrypted] attribute.
• Defense-In-Depth Validation: Automated SQL Injection detection and business rule enforcement on every write.
• Immutable Auditing: Every change is cryptographically hashed and logged to an tamper-evident audit trail.

📦 Installation

dotnet add package ErduranLib

🛠️ Quick Start

1. Simple Configuration

Configure your services with a fluent API that sets up safe defaults.

services.AddErduranLib<MyBankingContext>(options =>
{
    options.EnableJournaling = true;
    options.EnableAuditLogging = true;
    options.WriteIsolationLevel = IsolationLevel.Snapshot;
    options.EncryptionProvider = new AesEncryptionProvider("YOUR_MASTER_KEY_32_CHARS");
});

2. The Entity

Inherit from ErduranEntityBase to get auditing, concurrency, and idempotency features for free.

public class WireTransfer : ErduranEntityBase
{
    [ErduranEncrypted] // Automatically encrypted in DB!
    public required string SenderIban { get; set; }
    
    public decimal Amount { get; set; }
    
    [ErduranJson] // Stored as jsonb in PostgreSQL
    public TransferMetadata Metadata { get; set; }
}

3. The "Black Box" API

Use ErduranManager to handle the entire lifecycle. You don't need try-catch—the library returns a robust ErduranResult.

public async Task ProcessTransfer(WireTransfer transfer)
{
    var result = await _manager.ProcessTransactionAsync(transfer, 
        validationRule: t => t.Amount > 0);

    result.Match(
        onSuccess: saved => Console.WriteLine($"Success! ID: {saved.Id}"),
        onFailure: error => Console.WriteLine($"Error [{error.Code}]: {error.Message}")
    );
}

📈 Performance Benchmarks

ErduranLib is optimized for high-frequency environments:

🧪 Production Readiness Checklist

Before going live, ensure:

• Master Key: Your encryption key is stored securely (Vault/KeyStore).
• PostgreSQL: jsonb support is enabled if using [ErduranJson].
• Auditing: An AuditSecret is provided for tamper-evident logs.
• Recovery: A background worker calls RecoverAsync() on startup to handle interrupted transactions.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

We welcome contributions from the community! Please read our Contributing Guide to get started.