WaffleAuth Documentation

Initial Configuration

Configure WaffleAuth at the start of your application:

// Required configuration
WaffleAuthFuncs.SetInitials("APP");
WaffleAuthFuncs.SetURL("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents");
WaffleAuthFuncs.SetEndPoint("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents:runQuery?key=");
WaffleAuthFuncs.SetAPIKey("YOUR-API-KEY");
WaffleAuthFuncs.SetActivationKey("KEY-HERE"); // Required activation key
WaffleAuthFuncs.Mode = "key"; // Set authentication mode
WaffleAuthFuncs.MsgBoxes(true);

Firebase Collections Setup

WaffleAuth requires two collections in your Firebase Firestore database:

• licenses - Collection for storing license key data
• accounts - Collection for storing user account data when using account mode

SetInitials(string userInitials)

Sets the prefix for generated license keys. This will appear before the hyphen in all generated keys.

WaffleAuthFuncs.SetInitials("APP");

Result format: APP-XXXXXXXXXXXXX

SetURL(string userURL)

Sets the Firestore database URL where license information will be stored. The URL should be in this format:

https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents

WaffleAuthFuncs.SetURL("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents");

SetEndPoint(string endpointuser)

Sets the API endpoint used for license validation and queries.

WaffleAuthFuncs.SetEndPoint("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents:runQuery?key=");

SetAPIKey(string userapikey)

Sets the Firebase API key for authentication and database access.

WaffleAuthFuncs.SetAPIKey("YOUR-API-KEY");

SetActivationKey(string activationKey)

Sets the activation key required for the system to function. This must be set before using any other functionality.

WaffleAuthFuncs.SetActivationKey("KEY-HERE");

Mode(string mode)

Sets the authentication mode - either "key" for license key system or "account" for username/password authentication.

WaffleAuthFuncs.Mode = "key";     // Use license key system
WaffleAuthFuncs.Mode = "account"; // Use account system

MsgBoxes(bool showMsgBoxes)

Controls whether the system shows message box notifications for various events.

WaffleAuthFuncs.MsgBoxes(true);  // Enable notifications
WaffleAuthFuncs.MsgBoxes(false); // Disable notifications

Discord Rich Presence Configuration (Optional)

Set up Discord Rich Presence integration if desired:

// Configure Discord RPC (Optional)
WaffleAuthFuncs.SetRPCAppID("1320047337518928004"); // Your Discord App ID

// Initialize Rich Presence
WaffleAuthFuncs.InitializeDiscordRP(
    "Your Subtitle",      // Subtitle text
    "Your Description",   // Description text
    "large_image",        // Large image asset name
    "Large Image Text",   // Large image hover text 
    "small_image",        // Small image asset name
    "Small Image Text"    // Small image hover text
);

GenerateEarningKey(string keyType, string websiteUrl, int timeInSeconds, int customDurationInHours)

Generates a license key after the user visits a specified website for a set duration.

string key = await WaffleAuthFuncs.GenerateEarningKey(
    "free",                // Key type  
    "https://example.com", // Website to visit
    30,                    // Wait time in seconds
    24                     // License duration in hours
);

GenerateKey(string keyType, int customDurationInHours)

Generates a license key immediately with specified duration.

string key = await WaffleAuthFuncs.GenerateKey(
    "premium",            // Key type
    24                    // License duration in hours
);

CheckKey(string licenseKey)

Validates a license key independently. Use this for manual key validation.

bool isValid = await WaffleAuthFuncs.CheckKey("APP-XXXXXXXXXXXXX");

Initialize()

Checks for any existing valid licenses on the current machine. Useful for automatic login.

private void Init()
{
    bool hasExistingLicense = await WaffleAuthFuncs.Initialize();
    {
        if (hasExistingLicense)
        {
            // Your code here for valid license
        }
    }
}

Key Information Functions

Access current key details:

// Get the current key type
string keyType = await WaffleAuthFuncs.GetType();

// Get the current key string
string currentKey = WaffleAuthFuncs.CurrentLogin;
// Can be used like: label1.Text = WaffleAuthFuncs.CurrentLogin;

Basic Form Implementation

Here's a complete example of implementing WaffleAuth in a Windows Forms application:

using WaffleAuth;

namespace Le_Login_Tester
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            WaffleAuthFuncs.Mode = "accounts";
            WaffleAuthFuncs.SetActivationKey("KEY-HERE");
            WaffleAuthFuncs.SetURL("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents");
            WaffleAuthFuncs.SetEndPoint("https://firestore.googleapis.com/v1/projects/your-project-name/databases/(default)/documents:runQuery?key=");
            WaffleAuthFuncs.SetAPIKey("YOUR-API-KEY");
            WaffleAuthFuncs.MsgBoxes(true);
            WaffleAuthFuncs.Initialize();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            bool success = await WaffleAuthFuncs.CreateAccount("free", UsernameCreate.Text, PasswordCreate.Text);
        }

        private void button2_Click(object sender, EventArgs e)
        {
            bool isValid = await WaffleAuthFuncs.CheckAccount(UsernameLogin.Text, PasswordLogin.Text);
        }

        private void button3_Click(object sender, EventArgs e)
        {
            CurrentLabel.Text = WaffleAuthFuncs.CurrentLogin;
        }

        private async void button4_Click(object sender, EventArgs e)
        {
            TypeLabel.Text = await WaffleAuthFuncs.GetType();
        }

        private async void button6_Click(object sender, EventArgs e)
        {
            string key = await WaffleAuthFuncs.GenerateKey("free", 10);
            textBox2.Text = key;
        }

        private void button5_Click(object sender, EventArgs e)
        {
            bool isValid = await WaffleAuthFuncs.CheckKey(keybox.Text);
        }
    }
}

CreateAccount(string accountType, string username, string password)

Creates a new user account with the specified type and credentials.

bool success = await WaffleAuthFuncs.CreateAccount(
    "free",             // Account type
    "username",         // Username 
    "password"          // Password
);

CheckAccount(string username, string password)

Validates user account credentials.

bool isValid = await WaffleAuthFuncs.CheckAccount(
    "username",         // Username
    "password"          // Password
);

Account Information Functions

Access current account details:

// Get the current account type
string accountType = await WaffleAuthFuncs.GetType();

// Get the current logged in username 
string currentUser = WaffleAuthFuncs.CurrentLogin;

Loading Addons

WaffleAuth supports loading external addons via DLL files. Place addon DLLs in the automatically created "Addons" folder.

Running Addon Methods

Use the AddonManager to execute methods from loaded addons:

// Basic method call
AddonManager.RunAddonMethod("MyAddon.dll", "MethodName");

// With parameters
AddonManager.RunAddonMethod("MyAddon.dll", "MethodName", "param1", true, 42);

Creating Custom Addons

Here's a basic template for creating your own WaffleAuth addon:

using System;
using System.Windows.Forms;

namespace ExampleAddon
{
    public class MainClass
    {
        public static void PrintMessage(string message)
        {
            MessageBox.Show($"Test: {message}");
        }
    }
}