JunkieKeySystem.CSharp 2.0.2

JunkieKeySystem.CSharp

Official C# SDK for the Junkie Development Key System.
Handles key verification, hardware fingerprinting, and key-link generation in a single package.

Installation

dotnet add package JunkieKeySystem.CSharp

Or via Package Manager:

Install-Package JunkieKeySystem.CSharp

Requirements

• .NET Standard 2.0+ (works with .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5/6/7/8+)
• API Key from the Junkie Development Dashboard

Quick Start

Verify a Key

bool valid = await JunkieKeySystem.VerifyKeyAsync(
    apiKey:     "your-api-key",
    identifier: 1,              // your user ID
    key:        "KEY_-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    service:    "MyService"
);

if (valid)
    Console.WriteLine("Access granted.");

Verify with Details

var result = await JunkieKeySystem.VerifyKeyDetailedAsync(
    apiKey:     "your-api-key",
    identifier: 1,
    key:        "KEY_-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    service:    "MyService"
);

if (result.Valid)
{
    Console.WriteLine($"Expires: {result.ExpiresAt?.ToString("yyyy-MM-dd") ?? "lifetime"}");
    Console.WriteLine($"Premium: {result.IsPremium}");
    Console.WriteLine($"Discord: {result.DiscordUsername}");
}
else
{
    Console.WriteLine($"Denied: {result.Message}");
}

Generate a Key Link

Returns a URL the end-user can open to complete the key flow:

string? link = await JunkieKeySystem.GetKeyLinkAsync(
    apiKey:     "your-api-key",
    identifier: 1,
    service:    "MyService",
    provider:   "Mixed"
);

if (link != null)
    Console.WriteLine($"Open this link: {link}");

Hardware Fingerprint

The SDK auto-generates a hardware fingerprint when verifying keys.
You can also retrieve it manually:

string hwid = JunkieKeySystem.GenerateHardwareId();

To pass a custom fingerprint instead:

var result = await JunkieKeySystem.VerifyKeyDetailedAsync(
    apiKey:      "your-api-key",
    identifier:  1,
    key:         "KEY_-...",
    service:     "MyService",
    fingerprint: "custom-fingerprint-value"
);

API Reference

JunkieKeySystem (static)

SignatureVerifyResult

Parameters

All verify methods share these parameters:

Compatibility

License

MIT — see LICENSE for details.