|
| 1 | +NIO MASQUERADE & DIRECTORY MODULE — MODULE.txt |
| 2 | +================================================= |
| 3 | +Version: 2911.14.2 |
| 4 | +Date: 2026-06-23 |
| 5 | +Owner: Maximilian Eric Alexander Rupplin von Keffikon — MEARVK LLC |
| 6 | +Contact: https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/discussions |
| 7 | +Email: mearvk@mearvk.us | mearvk@outlook.com |
| 8 | + |
| 9 | + |
| 10 | +MODULE RATIONALE |
| 11 | +---------------- |
| 12 | + This module introduces a NIO-based masquerade front layer and port 2000 |
| 13 | + directory server to the NitroWebExpress™ platform. It enables non-blocking |
| 14 | + I/O bridging to the existing blocking architecture, XML-based port |
| 15 | + forwarding, and automatic discovery/registration of all MEARVK LLC modules. |
| 16 | + |
| 17 | + |
| 18 | +COMPONENTS |
| 19 | +---------- |
| 20 | + NioMasqueradeEngine — NIO Selector engine. Binds 127.0.0.1 through 127.0.0.17. |
| 21 | + Bridges NIO connections to existing blocking servers. |
| 22 | + Port range: standard (0-65535) or extended (0-1048576). |
| 23 | + Source: source/strernary/NioMasqueradeEngine.java |
| 24 | + |
| 25 | + NioModuleScanner — Startup discovery. Reads nwe-config.xml and masquerade-modules.xml. |
| 26 | + Extracts all enabled module port values (0 to MAX_PORT). |
| 27 | + Registers masquerade-aware modules in the NIO routing table. |
| 28 | + Source: source/strernary/NioModuleScanner.java |
| 29 | + |
| 30 | + StrernaryDirectoryServer — Port 2000 directory/menu server. |
| 31 | + Interactive menu: query port 20000/49152 server IPs. |
| 32 | + XML forwarding: <nwe-route><port>N</port><payload>...</payload></nwe-route> |
| 33 | + Rank 4 JWSTNJ21 server registration (public.key required). |
| 34 | + Source: source/strernary/StrernaryDirectoryServer.java |
| 35 | + |
| 36 | + |
| 37 | +PORT ASSIGNMENTS |
| 38 | +---------------- |
| 39 | + 2000 StrernaryDirectoryServer (directory menu + XML forwarding) |
| 40 | + 0-* NioMasqueradeEngine (all managed ports, mode-dependent) |
| 41 | + |
| 42 | + |
| 43 | +CONFIGURATION FILES |
| 44 | +------------------- |
| 45 | + configuration/nio-masquerade-config.xml — NIO settings, port range mode, bindings |
| 46 | + configuration/masquerade-modules.xml — Module registry with auto-discovery |
| 47 | + configuration/port-2000-directory-config.xml — Port 2000 access control, NationalID rules |
| 48 | + |
| 49 | + |
| 50 | +RANK UPGRADES |
| 51 | +------------- |
| 52 | + Rank 4 (International/Free) servers may register with a running NWE instance by |
| 53 | + submitting the public.key via port 2000 menu option 3. Registration verifies the |
| 54 | + key byte-for-byte against the canonical GitHub copy: |
| 55 | + https://raw.githubusercontent.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/main/psychiatry/secrets/public.key |
| 56 | + |
| 57 | + Rank upgrades follow the immutable edition system: |
| 58 | + Rank 8 — Personal Executive Edition |
| 59 | + Rank 6 — National Edition |
| 60 | + Rank 4 — International / Free Edition |
| 61 | + |
| 62 | + To request a rank upgrade or discuss licensing: |
| 63 | + https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/discussions |
| 64 | + |
| 65 | + |
| 66 | +INSTALLER IDS |
| 67 | +------------- |
| 68 | + Modules accepted by the ModuleInstallationService (port 49166) and |
| 69 | + ModuleLoaderDaemon (port 49188) must carry a valid Installer ID: |
| 70 | + |
| 71 | + Installer ID: Max Rupplin - MEARVK LLC |
| 72 | + |
| 73 | + Technical Installer IDs (for third-party integrators) and personal public.keys |
| 74 | + can be requested via: |
| 75 | + https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/discussions |
| 76 | + |
| 77 | + Requirements for Installer ID issuance: |
| 78 | + - Valid NationalID on file |
| 79 | + - Moral Rating >= "Very Good" |
| 80 | + - IQ >= 126 |
| 81 | + - Signed acknowledgment of software authorization terms |
| 82 | + |
| 83 | + |
| 84 | +PUBLIC KEY REQUESTS |
| 85 | +------------------- |
| 86 | + Personal public.keys for module signing, Rank 4 server registration, and |
| 87 | + third-party integration can be requested at: |
| 88 | + https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/discussions |
| 89 | + |
| 90 | + The Owner (Max Rupplin, MEARVK LLC) issues keys at sole discretion. |
| 91 | + All issued keys are bound to the recipient's NationalID. |
| 92 | + |
| 93 | + |
| 94 | +PORT RANGE MODES |
| 95 | +---------------- |
| 96 | + Standard (default): |
| 97 | + Range: 0-65535 |
| 98 | + Binding: All managed ports on 127.0.0.1 |
| 99 | + Config: <port-range-mode>standard</port-range-mode> |
| 100 | + |
| 101 | + Extended: |
| 102 | + Range: 0-1048576 |
| 103 | + Binding: 65536 ports per IP across 127.0.0.1 through 127.0.0.17 |
| 104 | + IP mapping: |
| 105 | + 127.0.0.1 = ports 0-65535 |
| 106 | + 127.0.0.2 = ports 65536-131071 |
| 107 | + ... |
| 108 | + 127.0.0.16 = ports 983040-1048575 |
| 109 | + 127.0.0.17 = overflow/control |
| 110 | + Config: <port-range-mode>extended</port-range-mode> |
| 111 | + |
| 112 | + |
| 113 | +XML FORWARDING PROTOCOL |
| 114 | +------------------------ |
| 115 | + Clients connect to port 2000 and send: |
| 116 | + <nwe-route><port>20000</port><payload>ASK|What is life?</payload></nwe-route> |
| 117 | + |
| 118 | + The directory server parses the XML, resolves the target local IP via the |
| 119 | + NIO masquerade engine, forwards the payload, and relays the response. |
| 120 | + |
| 121 | + |
| 122 | +DEPENDENCIES |
| 123 | +------------ |
| 124 | + None beyond standard JDK 21+ (java.nio.channels, javax.xml.parsers). |
| 125 | + No additional jars required for this module. |
| 126 | + |
| 127 | + |
| 128 | +AUTHOR |
| 129 | +------ |
| 130 | + Max Rupplin — MEARVK LLC |
| 131 | + https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/discussions |
| 132 | + mearvk@mearvk.us | mearvk@outlook.com |
0 commit comments