Warden.Sdk 0.2.0

Warden SDK

The Warden SDK activates license keys and validates offline access for your app.

https://authwarden.app/docs

Install

dotnet add package Warden.Sdk

Quickstart

using Warden.Sdk.Clients;

// Windows-only (DPAPI)
var client = LicenseClient.CreateDefaultForLicense("YOUR-LICENSE-KEY");

// First run (online)
var activation = await client.ActivateAsync("YOUR-LICENSE-KEY");
if (!activation.IsSuccess)
{
    // show activation.Message to user
    return;
}

// Every startup (offline-first)
var status = await client.ValidateAsync();
if (!status.IsValid)
{
    // show error to user
}

Offline storage

• Windows: ProtectedFileOfflineAccessStore (DPAPI, Windows-only)
• Cross-platform: AesFileOfflineAccessStore (AES-GCM)

Manual storage examples:

using Warden.Sdk.Clients;
using Warden.Sdk.Storage;

// Windows (DPAPI)
var store = new ProtectedFileOfflineAccessStore();
var client = LicenseClient.CreateDefault(null, store);

// Cross-platform (AES-GCM)
var store = new AesFileOfflineAccessStore("your-passphrase");
var client = LicenseClient.CreateDefault(null, store);

Multiple products on one machine

Each license key gets its own encrypted store automatically.

Windows-only (DPAPI):

using Warden.Sdk.Clients;

var client = LicenseClient.CreateDefaultForLicense("LICENSE-KEY-A");

Cross-platform (Windows/macOS/Linux):

using Warden.Sdk.Clients;

var client = LicenseClient.CreateDefaultForLicense("LICENSE-KEY-B", "your-passphrase");

Remember last license key (Windows + cross-platform)

If you want to avoid prompting every launch, the SDK includes a cache helper.

Windows (DPAPI):

using Warden.Sdk.Clients;
using Warden.Sdk.Utilities;

var cached = LicenseKeyCache.LoadLastLicenseKey();
if (!string.IsNullOrWhiteSpace(cached))
{
    var client = LicenseClient.CreateDefaultForLicense(cached);
}

// After a successful activation:
LicenseKeyCache.SaveLastLicenseKey("YOUR-LICENSE-KEY");

Cross-platform (AES-GCM):

using Warden.Sdk.Clients;
using Warden.Sdk.Utilities;

var cached = LicenseKeyCache.LoadLastLicenseKey("your-passphrase");
if (!string.IsNullOrWhiteSpace(cached))
{
    var client = LicenseClient.CreateDefaultForLicense(cached, "your-passphrase");
}

LicenseKeyCache.SaveLastLicenseKey("YOUR-LICENSE-KEY", "your-passphrase");

Air-gapped activation

using Warden.Sdk.Clients;

var json = File.ReadAllText("warden-offline-KEY.json");
await client.LoadOfflineLicenseAsync(json);
var status = await client.ValidateAsync();

Notes

• Client apps should not embed API keys.
• Use license keys for activation and activation tokens for refresh.