AstraGuard.SDK 1.0.0

🛡️ AstraGuard.SDK - Stripe for Software Licensing

The modern .NET SDK for protecting your applications with license management.

🚀 Quick Start

Installation

dotnet add package AstraGuard.SDK

Basic Usage (One-Liner)

using AstraGuard.SDK;

var guard = new AstraGuardClient(
    apiUrl: "https://api.astraguard.io",
    productId: "YOUR-PRODUCT-ID"
);

// One-liner protection: Verify license or exit automatically
await guard.VerifyOrExit(userLicenseKey);

// ✅ Your application code runs here - license is valid!
RunYourApplication();

That's it! Your application is now protected.

📦 Features

✅ License Validation

• HWID Binding: Lock licenses to specific devices
• Auto-Verification: Automatic hardware ID generation
• Instant Validation: Fast API verification

📡 Cloud Configuration

• Remote Control: Change settings without redistributing
• Kill Switch: Emergency shutdown capability
• Feature Toggles: Enable/disable features remotely
• Live Updates: Configuration updates during runtime

🔒 Security Features

• Anti-Debug: Detect and block debuggers
• Code Integrity: Detect file tampering
• Heartbeat Monitoring: Continuous license validation
• Event Handlers: React to security events

🎯 Developer-Friendly

• One-Liner Protection: Minimal integration code
• Full Control: Advanced API for custom workflows
• Type-Safe: Full C# type safety
• Well-Documented: Comprehensive examples

💡 Usage Examples

1. Basic Protection

var guard = new AstraGuardClient("https://api.astraguard.io", "PRODUCT-ID");

// Simple verify and exit
await guard.VerifyOrExit(licenseKey);

// Your app runs here
Console.WriteLine("✅ Licensed application running!");

2. Advanced Protection with All Features

var guard = new AstraGuardClient("https://api.astraguard.io", "PRODUCT-ID");

// Enable security features
guard.EnableAntiDebug();
// guard.EnableCodeIntegrity("YOUR-EXECUTABLE-HASH");

// Event handlers
guard.OnLicenseInvalid += (s, e) => Console.WriteLine("License invalid!");
guard.OnCloudConfigUpdated += (s, config) => UpdateFeatures(config);

// Verify license
var result = await guard.VerifyLicense(licenseKey);
if (!result.Valid)
{
    Console.WriteLine($"Invalid: {result.Error}");
    return;
}

// Start heartbeat for continuous validation
guard.StartHeartbeat(TimeSpan.FromMinutes(5));

// Your application
RunApp();

// Cleanup
guard.StopHeartbeat();
guard.Dispose();

3. Cloud Configuration

// Check maintenance mode (kill switch)
if (guard.IsMaintenanceMode())
{
    Console.WriteLine("App is in maintenance - exiting");
    return;
}

// Get custom variables
string? motd = guard.GetCloudVariable("motd");
Console.WriteLine($"Message: {motd}");

// Feature toggles
bool premiumEnabled = guard.GetCloudVariable("premium_mode") == "true";
if (premiumEnabled)
{
    EnablePremiumFeatures();
}

// Access all variables
foreach (var kvp in guard.CloudConfig)
{
    Console.WriteLine($"{kvp.Key} = {kvp.Value}");
}

4. Custom HWID

// Use auto-generated HWID
await guard.VerifyLicense(licenseKey);

// Or provide custom HWID
string customHwid = "MY-CUSTOM-DEVICE-ID";
await guard.VerifyLicense(licenseKey, customHwid);

// Get the auto-generated HWID
string hwid = AstraGuardClient.GetMachineId();
Console.WriteLine($"Device ID: {hwid}");

🌐 Cloud Configuration Examples

Set these in your AstraGuard Dashboard → Products → Cloud Config:

Message of the Day

Key: motd
Value: 🎉 Welcome to Summer Sale! Get 20% off upgrades!

Kill Switch (Maintenance Mode)

Key: status
Value: maintenance

Feature Toggles

Key: premium_mode
Value: true

API Endpoints

Key: api_endpoint
Value: https://api.yourservice.com/v2

Game Hacking: Memory Offsets

Key: OFFSET_PLAYER_BASE
Value: 0x1A2B3C4D

🔐 Security Features

Anti-Debug Protection

guard.EnableAntiDebug(onDetected: () =>
{
    Console.WriteLine("Debugger detected!");
    // Custom action before exit
});

Code Integrity Verification

// Get your app's hash (run once, store on server)
string hash = CodeIntegrity.GetExecutableHash();
Console.WriteLine($"Hash: {hash}");

// Enable integrity checking
guard.EnableCodeIntegrity(hash, onTampered: () =>
{
    Console.WriteLine("App has been modified!");
});

Heartbeat Monitoring

// Continuous validation every 5 minutes
guard.StartHeartbeat(
    interval: TimeSpan.FromMinutes(5),
    onInvalid: () =>
    {
        Console.WriteLine("License became invalid!");
        // App will auto-exit
    }
);

📊 API Reference

AstraGuardClient

Constructor

AstraGuardClient(string apiUrl, string productId)

Methods

• Task<LicenseResponse> VerifyLicense(string key, string? hwid = null)
• Task VerifyOrExit(string key, string? hwid = null, string? exitMessage = null)
• void StartHeartbeat(TimeSpan? interval = null, Action? onInvalid = null)
• void StopHeartbeat()
• void EnableAntiDebug(Action? onDetected = null)
• void EnableCodeIntegrity(string expectedHash, Action? onTampered = null)
• string? GetCloudVariable(string key)
• bool IsMaintenanceMode()
• static string GetMachineId()

Properties

• Dictionary<string, string> CloudConfig - All cloud variables
• LicenseDetails? CurrentLicense - Current license info

Events

• EventHandler? OnLicenseInvalid
• EventHandler<Dictionary<string, string>>? OnCloudConfigUpdated

🎯 Integration Workflow

1. Developer (Hans Peter) creates account on AstraGuard
2. Creates product in Dashboard (gets Product ID)
3. Generates license keys for customers
4. Integrates SDK into his application:

   await guard.VerifyOrExit(licenseKey);
   

5. Distributes app to customers
6. Customer enters license key → App validates → Runs!
7. Hans Peter can:
   • Revoke licenses remotely
   • Send messages via Cloud Config
   • Enable/disable features
   • Emergency shutdown (kill switch)

🛠️ Error Handling

var result = await guard.VerifyLicense(licenseKey);

if (!result.Valid)
{
    switch (result.Error)
    {
        case "Key not found":
            Console.WriteLine("Invalid license key");
            break;
        case "Key is revoked":
            Console.WriteLine("License has been revoked");
            break;
        case "HWID mismatch":
            Console.WriteLine("License bound to another device");
            break;
        default:
            Console.WriteLine($"Error: {result.Error}");
            break;
    }
    return;
}

📞 Support

• Docs: https://docs.astraguard.io
• Discord: https://discord.gg/4AZRBNgVp6
• Email: support@astraguard.io
• GitHub: https://github.com/astraguard/sdk

📄 License

MIT License - See LICENSE file for details

Made with 💜 by AstraGuard

Stripe for Software Licensing