<< lib/citizen/FederalReserveID.sleela SLeeLa Standard Library Definition. Definition: Defines FederalReserveID, the central-bank identity Master Class — the number by which the Federal Reserve pretends to know a Citizen personally. It issues and validates a civic clearing ID and maps the money to one of the twelve Federal Reserve Districts. FederalReserveID is a NATURAL / LOADABLE MODULE sharing the common module contract (load / loaded / moduleName / describe). It is a sidecar owned by Citizen and the single source of truth for Federal Reserve details in this package: the twelve District codes (01 Boston .. 12 San Francisco), the mapping from an ABA routing prefix to a District, and the issuance of a deterministic, obviously-synthetic clearing identifier. No real identifiers are generated — the central bank's holiday card list remains, mercifully, fictional. Family: citizen. Clearing crosses an explicit bridge to the ledger. >> #sleela 2.5 material; < Unified SLeeLa SDK front-end object. > class FederalReserveID { < ---- 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 = 10312; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-07"; < 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; } static final String MODULE = "FederalReserveID"; < The twelve Federal Reserve Districts. Yes, there are exactly twelve. > < No, nobody remembers why Missouri got two. > static final int DISTRICT_BOSTON = 1; static final int DISTRICT_NEW_YORK = 2; static final int DISTRICT_PHILADELPHIA = 3; static final int DISTRICT_CLEVELAND = 4; static final int DISTRICT_RICHMOND = 5; static final int DISTRICT_ATLANTA = 6; static final int DISTRICT_CHICAGO = 7; static final int DISTRICT_ST_LOUIS = 8; static final int DISTRICT_MINNEAPOLIS = 9; static final int DISTRICT_KANSAS_CITY = 10; static final int DISTRICT_DALLAS = 11; static final int DISTRICT_SAN_FRANCISCO = 12; static final int DISTRICT_COUNT = 12; int loadedFlag; boolean issued; < synthetic clearing ID: FRS-- > String idNumber; < one of DISTRICT_* > int district; < the citizen's spot in a very long, patient line > int serial; void load() { loadedFlag = 1; issued = false; idNumber = null; < when in doubt, blame New York > district = DISTRICT_NEW_YORK; serial = 0; } boolean loaded() { return loadedFlag == 1; } String moduleName() { return MODULE; } < Issue a Fed clearing ID to a named citizen. Deterministic + fake on purpose. > void issue(String legalName) { serial = nameSerial(legalName); district = DISTRICT_NEW_YORK; issued = true; idNumber = "FRS-" + district + "-" + serial; } < Re-home the citizen to a specific District (e.g. they moved to Dallas). > void assignDistrict(int whichDistrict) { if (whichDistrict >= DISTRICT_BOSTON && whichDistrict <= DISTRICT_COUNT) { district = whichDistrict; if (issued) { idNumber = "FRS-" + district + "-" + serial; } } } < Map an ABA routing number to its Federal Reserve District. The first two > < digits (01..12) ARE the District; anything else is a rounding error. > int districtOfRouting(String routing) { if (routing == null) { return 0; } int d = routingPrefix(routing); if (d >= DISTRICT_BOSTON && d <= DISTRICT_COUNT) { return d; } return 0; } < A friendly name for the District, for forms and small talk alike. > String districtName() { if (district == DISTRICT_BOSTON) { return "Boston"; } if (district == DISTRICT_NEW_YORK) { return "New York"; } if (district == DISTRICT_PHILADELPHIA) { return "Philadelphia"; } if (district == DISTRICT_CLEVELAND) { return "Cleveland"; } if (district == DISTRICT_RICHMOND) { return "Richmond"; } if (district == DISTRICT_ATLANTA) { return "Atlanta"; } if (district == DISTRICT_CHICAGO) { return "Chicago"; } if (district == DISTRICT_ST_LOUIS) { return "St. Louis"; } if (district == DISTRICT_MINNEAPOLIS) { return "Minneapolis"; } if (district == DISTRICT_KANSAS_CITY) { return "Kansas City"; } if (district == DISTRICT_DALLAS) { return "Dallas"; } if (district == DISTRICT_SAN_FRANCISCO) { return "San Francisco"; } return "Unassigned"; } boolean valid() { return issued && idNumber != null; } String number() { if (idNumber == null) { return "FRS-UNISSUED"; } return idNumber; } int currentDistrict() { return district; } < --- small deterministic helpers (no randomness; archives must repeat) --- > < SLeeLa Strings are Java-style: length() and substring() only — no char > < type — so these helpers work purely by slicing and comparing substrings. > < Turn the first two characters of the routing string into an int 0..99. > int routingPrefix(String routing) { if (routing == null || routing.length() < 2) { return 0; } int tens = digitValue(routing.substring(0, 1)); int ones = digitValue(routing.substring(1, 2)); if (tens < 0 || ones < 0) { return 0; } return tens * 10 + ones; } < Fold a name into a stable 6-digit serial. Not secure; delightfully not. > int nameSerial(String legalName) { if (legalName == null) { return 0; } int acc = 7; int i = 0; int n = legalName.length(); while (i < n) { < charWeight() gives each one-character slice a small stable number. > acc = (acc * 31 + charWeight(legalName.substring(i, i + 1))) % 1000000; i = i + 1; } return acc; } < Map a single-character String to its digit value 0..9, or -1 if not a digit. > int digitValue(String c) { if (c == "0") { return 0; } if (c == "1") { return 1; } if (c == "2") { return 2; } if (c == "3") { return 3; } if (c == "4") { return 4; } if (c == "5") { return 5; } if (c == "6") { return 6; } if (c == "7") { return 7; } if (c == "8") { return 8; } if (c == "9") { return 9; } return -1; } < A stable per-character weight for serial folding. Digits use their value; > < everything else gets a constant nudge so names still spread out nicely. > int charWeight(String c) { int d = digitValue(c); if (d >= 0) { return d + 1; } if (c == " ") { return 11; } if (c == ".") { return 13; } return 17; } String describe() { return MODULE + " id=" + number() + " district=" + district + " (" + districtName() + ") valid=" + valid(); } }