SLNonce.sleela
lib/crypto/SLNonce.sleela · 111 line(s) · sleela
<< lib/crypto/SLNonce.sleela
SLeeLa Standard Library Definition.
Definition: Defines the SLeeLa standard-library type SLNonce used within the crypto library family. >>
#sleela 2.5
material;
< Unified SLeeLa SDK front-end object. >
< Family: crypto. Nonce / IV generator front-end. Native implementation crosses >
< an explicit VM/OS bridge to /crypto. >
< >
< SECURITY NOTE: the native /crypto backend is a correct, specification-faithful >
< REFERENCE implementation. It is NOT guaranteed constant-time and is NOT >
< side-channel resistant. For data that must be protected use an audited library >
< (BoringSSL, OpenSSL, libsodium, liboqs). See crypto/README.md. >
class SLNonce {
< ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- >
<< Eleven catalogued attributes with getter/setter pairs, so a GUI, loader,
or catalog can read and (where appropriate) override this record.
Values are faithful to the subject's real origin where publicly known. >>
String metaVersion = "1.0.0";
int metaId = 600;
String metaAuthor = "Max Rupplin vs. Dr. Mrs. Elisabeth Harkins";
String metaDate = "2026-10-16";
String metaCopyright = "SLeeLa project";
String metaTrademark = "none";
String metaCorporation = "none";
< metaOrigin: National | <nation> | International | Galactic >
String metaOrigin = "International";
String metaBirthDate = "2026-09-28";
< metaScienceRating: maturity/robustness on a 1..10 scale >
int metaScienceRating = 9;
< metaNationalSchedule: a real, citable instrument or "none" >
String metaNationalSchedule = "none";
String getMetaVersion() { return metaVersion; }
void setMetaVersion(String v) { metaVersion = v; }
int getMetaId() { return metaId; }
void setMetaId(int v) { metaId = v; }
String getAuthor() { return metaAuthor; }
void setAuthor(String v) { metaAuthor = v; }
String getDate() { return metaDate; }
void setDate(String v) { metaDate = v; }
String getCopyright() { return metaCopyright; }
void setCopyright(String v) { metaCopyright = v; }
String getTrademark() { return metaTrademark; }
void setTrademark(String v) { metaTrademark = v; }
String getCorporation() { return metaCorporation; }
void setCorporation(String v) { metaCorporation = v; }
String getOrigin() { return metaOrigin; }
void setOrigin(String v) { metaOrigin = v; }
String getBirthDate() { return metaBirthDate; }
void setBirthDate(String v) { metaBirthDate = v; }
int getScienceRating() { return metaScienceRating; }
void setScienceRating(int v) { metaScienceRating = v; }
String getNationalSchedule() { return metaNationalSchedule; }
void setNationalSchedule(String v) { metaNationalSchedule = v; }
< Status codes mirror slcrypto_status in crypto/include/slcrypto.h. >
static final int OK = 0;
static final int ERR_PARAM = -1;
static final int ERR_AUTH = -2;
static final int ERR_UNIMPL = -3;
< AES-GCM recommends a 96-bit (12-byte) nonce (SP 800-38D). >
static final int GCM_NONCE_BYTES = 12;
< e.g. "AES-GCM" >
String algorithm;
< requested nonce length >
int sizeBytes;
< 1 = enabled, 0 = disabled >
int state;
< 1 once an algorithm name has been accepted >
int configured;
< 1 once a valid nonce size has been accepted >
int sizeSet;
< 1 when the native /crypto backend is linked and ready >
int backend;
int configure(String a) {
if (a == null) { configured = 0; return ERR_PARAM; }
algorithm = a;
configured = 1;
return OK;
}
< Nonce length must be positive; reject zero/negative sizes. >
int size(int n) {
if (n >= 1) { sizeBytes = n; sizeSet = 1; return OK; }
sizeSet = 0;
return ERR_PARAM;
}
void bindBackend(int ready) { if (ready == 1) { backend = 1; } else { backend = 0; } }
boolean backendReady() { return backend == 1; }
void enable() { state = 1; }
void disable() { state = 0; }
boolean active() { return state == 1 && configured == 1 && sizeSet == 1 && backend == 1; }
int nonceLength() { return sizeBytes; }
< Draw a fresh random nonce of the configured size from the native CSPRNG. >
int generate() {
if (active() == false) { return ERR_UNIMPL; }
return OK;
}
String securityNote() {
return "Reference-grade: not constant-time, not side-channel resistant; never reuse a nonce under one key. Use an audited library in production.";
}
}