Removes operator-private material from the shipped tree, corrects documentation
that had drifted from the code, deletes dead code, and applies a consistent
prose style.
Private material moved out of the public tree (docs/private/, git-ignored):
- the wallet keyfile recovery runbook and its helper scripts, which together
published the mainnet wallet file path, the service account, backup snapshot
filenames, and the wallet RPC listener state. The helper duplicated the same
constants, so relocating the document alone would not have removed them.
- the stagenet parallel-candidate runbook and its fixtures.
- the dated production-state record, the internal remediation plan, and the
TODO list. None are reference documentation for an outside reader.
Redacted or genericised:
- operator home-directory paths in shipped scripts and units. The asset build
script now takes KENNEY_ASSETS_DIR instead of a hard-coded path.
- private LAN addresses in tests, env examples and deploy docs, replaced with
RFC 5737 documentation addresses.
- the default alert sender and the notification hub example.
- the Monero wallet unit now matches the Wownero one: a dedicated service
account and a config file, instead of the operator's login account with the
wallet password in argv where any local user can read it from /proc.
Ignore rules now cover every .env variant rather than the bare name, plus local
agent state. The deployment docs instruct operators to create .env.mainnet and
.env.stagenet, which the exact-name rule would have allowed to be committed.
Documentation corrected against the code: per-chain dungeon level counts, the
premium unlock rule, Tavern chat scope, backup retention, the chain-profile
fallback, the environment template location, and several sections describing
shipped work as pending.
Dead code removed: configPersistence, rpccalls, a duplicate vendored ROT.js
bundle, the unused tile-picker overlay, the unreachable legacy game-size path
and its vestigial parameter, spectator stubs that shadowed the real
SpectatorManager, and commented-out debugging. nip98 now imports the shared
nostr loader rather than duplicating it.
Prose style: em-dashes removed throughout in favour of colons, semicolons and
commas; comments restated as present-tense descriptions of the code rather than
narration of past changes.
127 suites / 1015 tests pass.
9.8 KiB
Production disclosures and paid-action gate
The server derives its public disclosures from its own runtime switches, so the words shown to a player describe the free, paid-prestige, payout, test-network, and PvP configuration that instance actually runs. Nothing here asserts that a deployment is licensed or lawful in a particular place. Obtain jurisdiction-specific advice before accepting assets with real value.
Implementation: src/config/commerceDisclosurePolicy.js (disclosure generation and acknowledgement
validation), src/config/operatedProductProfiles.js (operated-product contracts),
src/config/environmentValidator.js (startup and preflight checks),
html/js/legal/commerceConsent.js (browser acknowledgement), src/views/legalPages.js
(/terms, /privacy, /responsible-play).
Operated-product boundary
Such Software (apps@such.software) operates two public services and nothing else.
| Profile | Service | Policy version | Scope |
|---|---|---|---|
such-play-wow-prestige |
play.wowne.ro |
2026-07-22-v1, effective 2026-07-22 |
Wownero mainnet free play plus pay-for-credits leaderboard and prestige play. Credits are non-redeemable service entitlements. No prizes, payouts, cash-out, or crypto racing, and the service is not offered or marketed as gambling. Legal classification depends on applicable law. |
such-monerogue-stagenet |
monerogue.app |
2026-07-23-v2, effective 2026-07-23 |
Monero stagenet direct-entry solo play only. The single-player 2x and 3x outcomes are test gambling mechanics using test coins with NO REAL VALUE. Purchased-credit entry and crypto-match payouts are off. Never mainnet XMR. |
Setting OPERATED_PRODUCT_PROFILE to one of those identifiers opts a deployment into a fail-closed
startup contract. Preflight (npm run preflight) and normal startup reject any drift from the
profile in:
HOSTED_BYpublic root,OPERATOR_NAME,OPERATOR_CONTACT_URL,OPERATOR_CONTACT_LABEL;LEGAL_POLICY_VERSIONandTERMS_EFFECTIVE_DATE;CRYPTO_TYPE,MONERO_NETWORK,GAME_MODE, andPAYMENT_MODES;- direct/credits mode switches, every payout switch, and
ALLOW_MAINNET_PAYOUTS; - the stagenet product's exact
DIRECT_PAYOUT_ESCAPE=2andDIRECT_PAYOUT_TREASURE=3multipliers; - the product catalog: no standalone products, and a credit package may grant only its top-level
credits and bonus. The whole
grantsobject is rejected, including keys added later, so a new entitlement cannot silently widen the public product contract.
Independent MIT self-hosts leave OPERATED_PRODUCT_PROFILE unset and configure a truthful operator
identity of their own; none of the profile constraints apply to them. Reference environments are
src/.env.mainnet.example and src/.env.stagenet.example; the full annotated template is
src/.env.example.
Open-source and operator disclaimer
MIT permission to use, copy, modify, merge, publish, distribute, sublicense, and sell copies is
subject to retaining the copyright and permission notice in all copies or substantial portions. The
software is provided "AS IS", without warranty of any kind, as stated in LICENSE. The MIT License
governs rights in the source. Documentation, examples, and disclosure copy are informational only;
they are not legal advice or a determination that a deployment complies with applicable law.
A third-party or self-hosted operator is solely responsible for its deployment, product design, legal compliance, funds, players, representations, and support. The MIT License does not make that deployment a Such Software service or authorize it to claim Such Software sponsorship or endorsement. Such Software does not operate, supervise, endorse, or accept responsibility for third-party deployments.
Required production settings
With NODE_ENV=production and payments resolved as enabled, startup and preflight fail unless each
of these is explicit and valid:
OPERATOR_NAME=Truthful responsible operator name
OPERATOR_CONTACT_URL=mailto:support@example.com
LEGAL_POLICY_VERSION=2026-07-22-v1
TERMS_EFFECTIVE_DATE=2026-07-22
MINIMUM_AGE=18
PAID_ACKNOWLEDGEMENT_REQUIRED=true
Constraints: OPERATOR_NAME is 2 to 120 characters and may not contain placeholder text;
OPERATOR_CONTACT_URL must parse as an https: or mailto: URL without placeholder text;
LEGAL_POLICY_VERSION is 1 to 64 characters of [A-Za-z0-9._-] starting alphanumeric;
TERMS_EFFECTIVE_DATE is a real YYYY-MM-DD date; MINIMUM_AGE is an integer from 18 through 120.
OPERATOR_CONTACT_LABEL is optional. Without it the disclosure derives a label from the contact
URL. An operated product profile does require its exact configured value.
RESTRICTED_LOCATIONS_NOTICE is optional application copy. Add it only after legal review; text is
not geofencing.
Changing the terms or any material disclosure requires a new LEGAL_POLICY_VERSION. That
invalidates every prior browser-session acknowledgement.
Match fairness timing
Production with MATCH_ENABLED=true also requires explicit paid-fairness timing, even when only
prestige credits are exposed:
MATCH_PAID_ENTROPY_DELAY_BLOCKS=2
MATCH_PAID_ENTROPY_CONFIRMATIONS=2
Both are safe integers from 2 through 100. A paid match freezes its entry set, commits to a target
block DELAY_BLOCKS ahead, and derives its seed only from a header confirmed to the configured
depth. The persisted proof records the derivation, the confirmation requirement, the minimum
confirmed tip height, and the pre-commit daemon-tip witness with its timestamp, so changing these
settings later cannot reinterpret an already-frozen match.
Enforcement contract
/api/disclosuresreturns non-secret,no-storepolicy data derived from runtime switches./terms,/privacy, and/responsible-playrender the active mode and operator metadata.- Before a payment invoice, paid solo or credit entry, or a paid PvP queue join, the browser presents unchecked age, terms-read, and risk boxes and enables the continue button only when all are selected. Test networks add a mainnet/test-coin box.
- Acceptance is a five-field canonical record:
policyVersionplusageEligible,termsRead,riskAccepted, andtestnetUnderstood. It lives insessionStorage, so it is scoped to the browser tab and to the exact policy version, and it is cleared on cancel, on a version mismatch, and on socket disconnect. - The server independently validates the exact current version and every boolean before consuming a fairness offer, opening an invoice, consuming a credit, or escrowing a paid PvP entry. The check runs at each of those handlers, so a modified client cannot bypass it.
- The paid-action requirement does not lapse when invoice intake is paused: already-purchased credits and race tickets still carry value and are still gated.
- Free entry stays available without a paid acknowledgement where the instance offers it. Early entry is treated as free only on a free-only instance, because mixed and credits instances may consume a credit.
The acknowledgement is a player statement. It does not verify identity, age, capacity, or location.
Mode language
| Runtime mode | Player-facing contract |
|---|---|
| Free | No entry payment; free leaderboard; no free payout |
| Paid, payouts off | Entry, credits, or product purchase and paid prestige leaderboard; no cryptocurrency prize |
| Paid, solo payouts on | The full entry can be lost; only outcomes and amounts shown before entry qualify |
| Crypto PvP on | Paid ticket escrow and the configured winner/fee contract; separate from free and prestige PvP |
| XMR stagenet/testnet | Valueless test currency; explicit warning never to send mainnet XMR |
For the operated products the generic rows narrow further: play.wowne.ro exposes purchased credits
only, offers no payout or cash-out, and is not marketed as gambling; monerogue.app labels its
direct-entry 2x and 3x stagenet mechanics as NO REAL VALUE and keeps purchased-credit entry and
crypto-match payouts disabled.
Operator decisions before enabling real-value modes
Disclosure copy and checkboxes are product safety controls, not a substitute for the following. A responsible operator records decisions on each before exposing a real-value mode:
- entity and operator identity, licences and registrations, permitted and excluded locations;
- age and location verification appropriate to those locations;
- consumer terms: refunds, late, under, and overpayments, complaints, dispute venue, and downtime;
- privacy roles, processors, retention and deletion schedule, user-rights procedure, breach response, and whether a privacy-minimized durable acknowledgement record is legally required;
- responsible-play features such as account-level deposit, time, and loss limits, and durable self-exclusion;
- tax, sanctions and AML, accounting, and cryptocurrency reporting obligations;
- an independent review of game rules, advertised multipliers, house fee, bankroll, and provable-fair claims.
Stagenet exercises end-to-end mechanics without representing test coins as money. Mainnet payouts are a separate, explicit operational and legal decision.
Front-end dependency notes
The same-origin jQuery copy is 3.7.1 from the Ubuntu libjs-jquery package; exact provenance and
SHA-256 are in html/js/lib/jquery-3.7.1.PROVENANCE.md. No runtime CDN or package-registry request
is needed to serve it.
Third-party renderer code executes with the same privileges as the game and payment UI, so CDN
execution is off unless an operator sets RENDERER_CDN_ENABLED=true. Enabling it adds
cdn.jsdelivr.net to script-src and connect-src and logs a warning in production. The
Three.js build served from /vendor/three/<version> is same-origin.
The CSP permits inline script and style because current pages depend on them. A nonce migration has to move every inline handler and script first; a partial tightening removes payment and game controls from the page.