AncientCovenant.Net 1.0.1

AncientCovenant.Net is a reusable software covenant library focused on deterministic verification, tamper detection, and clear oracle-style validation outcomes.

Features

• Deterministic covenant key generation and verification.
• Company-bound verification with normalized kingdom name checks.
• Expiry detection with structured oracle output.
• Typing mistake detection using checksum validation.
• Tamper detection using custom mathematical transforms combined with HMACSHA256.

Installation

Install from NuGet:

dotnet add package AncientCovenant.Net

NuGet package page: https://www.nuget.org/packages/AncientCovenant.Net/

Usage

Forge a Covenant Key

IArkSeedKeeper secretProvider = new CovenantSeedKeeper("your-secret-seed");
ForgeOfRa generator = new ForgeOfRa(secretProvider);

PharaohEdict edict = new PharaohEdict
{
    KingdomName = "ACME CORP",
    CovenantTier = PantheonTier.Pharaoh,
    SunsetDate = new DateTime(2027, 12, 31, 0, 0, 0, DateTimeKind.Utc),
    ChosenScribes = 250,
    TempleAltars = 600,
    ScribeName = "Ancient Operations",
    HighPriestName = "Chief Scribe",
    DawnIssuedAt = DateTime.UtcNow
};

string covenantKey = generator.ForgeRoyalSeal(edict);

PharaohEdict Property Meanings

• KingdomName: The company or organization that owns the covenant.
• CovenantTier: The covenant level (Pilgrim, Temple, or Pharaoh).
• SunsetDate: The UTC expiry date for the covenant.
• ChosenScribes: Maximum allowed users/seats.
• TempleAltars: Maximum allowed devices/endpoints.
• ScribeName: Person or system that generated the covenant.
• HighPriestName: Person or authority that approved the covenant.
• DawnIssuedAt: UTC timestamp when the covenant was issued.

Verify a Covenant Key

CovenantVerification verifier = new CovenantVerification(secretProvider);
OracleVerdict prophecy = verifier.Verify(covenantKey, "ACME CORP");

bool isBlessed = prophecy.IsBlessed;
bool hasExpiredCurse = prophecy.HasExpiredCurse;
PantheonTier tier = prophecy.CovenantTier;
DateTime sunsetDate = prophecy.SunsetDate;
int chosenScribes = prophecy.ChosenScribes;
int templeAltars = prophecy.TempleAltars;
int sunsRemaining = prophecy.SunsRemaining;
string oracleMessage = prophecy.OracleMessage;

Security Notes

• Keep secret seeds out of client applications where possible.
• Prefer generating covenant keys in trusted backend systems.
• Rotate algorithm and secret material with versioning when needed.

More Info

• How it works

License

This project is licensed under the MIT License. See the LICENSE file for details.