AquilaCipher 1.0.9

AquilaCipher .NET Client A professional .NET client library for seamless integration with Aquila Innovations' encryption API services. Provides both JSON and plain text encryption capabilities.

📦 NuGet Package bash Install-Package AquilaCipher

or

dotnet add package AquilaCipher 🚀 Quick Start Installation Install the NuGet package:

bash Install-Package AquilaCipher Add the namespace:

csharp using AquilaCipher; Basic Usage csharp // Encrypt text (returns JSON) string encryptedJson = ACipher.Encrypt("Hello World"); // Returns: {"encrypted": "encrypted_data_here"}

// Plain text encryption string plainEncrypted = ACipher.PlainEncrypt("Secret Message"); // Returns: "encrypted_string"

// Match verification (returns JSON) string matchResult = ACipher.Match(encryptedData, "Hello World"); // Returns: {"match": true}

// Plain match verification string plainMatchResult = ACipher.PlainMatch(plainEncrypted, "Secret Message"); // Returns: "true" 📖 API Reference JSON Response Methods Encrypt(string text) Encrypts text using Aquila Cipher algorithm.

Returns: string - JSON object with encrypted data

json {"encrypted": "encrypted_data"} Match(string encrypted, string plain) Verifies if encrypted text matches plain text.

Returns: string - JSON object with match result

json {"match": true} Plain Text Response Methods PlainEncrypt(string text) Performs plain encryption.

Returns: string - Direct encrypted string

PlainMatch(string encrypted, string plain) Verifies plain-encrypted match.

Returns: string - "true" or "false"

🎯 Advanced Usage JSON Response Parsing csharp using System.Text.Json;

// Encrypt and parse response string jsonResponse = ACipher.Encrypt("sensitive data"); using JsonDocument doc = JsonDocument.Parse(jsonResponse); string encryptedText = doc.RootElement.GetProperty("encrypted").GetString();

// Match verification with parsing string matchJson = ACipher.Match(encryptedText, "sensitive data"); var matchData = JsonSerializer.Deserialize<MatchResult>(matchJson); bool isMatch = matchData.Match;

public class MatchResult { public bool Match { get; set; } } Error Handling csharp try { string result = ACipher.Encrypt("My data"); // Process result } catch (HttpRequestException ex) { Console.WriteLine($"API communication error: {ex.Message}"); } catch (JsonException ex) { Console.WriteLine($"JSON parsing error: {ex.Message}"); } 🔧 Configuration HttpClient Configuration The library uses a static HttpClient. For custom configuration:

csharp // Custom timeout (optional) ACipher.Client.Timeout = TimeSpan.FromSeconds(30); Dependencies .NET Support: .NET Standard 2.0+, .NET Framework 4.7.2+, .NET Core 3.1+

NuGet Packages:

System.Net.Http

System.Text.Json (for JSON parsing)

🌐 API Endpoint Communicates with Aquila Innovations' secure API:

📊 Response Format Summary Method Return Format Example Output Encrypt() JSON {"encrypted": "a1b2c3d4"} Match() JSON {"match": true} PlainEncrypt() Plain Text "a1b2c3d4" PlainMatch() Plain Text "true" ⚠️ Error Handling The library throws standard exceptions:

HttpRequestException - API communication failures

JsonException - JSON parsing errors (for JSON methods)

🔒 Security Notes All communications use HTTPS encryption

No sensitive data stored locally

Recommended for secure data transmission

Ensure proper exception handling in production

📋 Requirements .NET Standard 2.0+ compatible project

Internet connectivity for API calls

Valid network permissions

🆕 Version History v1.0.0 (Current)

Initial release

Encryption support only (no decryption)

JSON and plain text response handling

Comprehensive error handling

❓ Support For issues and questions:

Check this documentation

Review exception messages

Contact Aquila Innovations support

📄 License Proprietary license. See package details for terms of use.