5 Commits
Author SHA1 Message Date
HarmenandClaude Opus 5 89aa06639b Het relay-programma: de relay van Evolu met onze eigen allowlist
tools/evolu-relay/src/ bevat nu een eigen programma dat createRelay uit
@evolu/nodejs aanroept met de twee terugroepfuncties die het bedoelde
uitbreidpunt vormen. De relay zelf komt uit npm en wordt niet nagebouwd of
aangepast; de opstartvolgorde is overgenomen uit apps/relay/src/index.ts van
Evolu zelf.

De opzet is drie bestanden met een harde scheiding, en die scheiding is de reden
dat hier iets te testen valt. policy.js bevat het beleid als pure functies: geen
bestanden, geen netwerk, geen klok. store.js is de enige plek met schijf erin.
index.js doet niets anders dan lezen, doorgeven en opslaan.

Het beleid: de eerste eigenaar die zich meldt wordt geleerd, een schakelaar
bepaalt of er nog nieuwe bij mogen, en een eigenaar is te blokkeren, alsnog toe
te laten of te vergeten. Geweigerde pogingen worden onthouden voor de pagina,
afgekapt op twintig, want elke poging is een id dat de ander zelf verzint. Een
onleesbaar owners.json wordt opzij geschoven en de app gaat dan dicht in plaats
van open: we weten dan niet wie er toegelaten was, en met de leerstand aan zou de
eerstvolgende die verbindt de nieuwe eigenaar worden.

Met test: node tests/test_limiter.mjs, 60 toetsen, en de toetsen gaan over de
guards en niet over het gelukkige pad. De beslissende regel is muteertest gedaan
en de juiste toets viel om: een geblokkeerde eigenaar mag er niet alsnog in
doordat de leerstand aanstaat. Het bestand is .mjs omdat de repo-root geen
package.json heeft en een .js daar als CommonJS gelezen zou worden.

build.sh bouwt niet langer de repo van Trezor maar onze eigen Dockerfile, dus git
is er niet meer voor nodig en de pin zit nu in package.json. De image is
node:24-slim en niet alpine, want better-sqlite3 heeft binaries voor glibc en niet
voor musl. Er is nog geen package-lock.json; het script waarschuwt daarvoor en het
staat als taak.

Onderweg bleek een aanname van vanmiddag fout: de 1 MB uit de gepubliceerde image
geldt per schrijfactie en niet per eigenaar. Er valt dus geen labelgeschiedenis
tegenaan te lopen. Dat is rechtgezet in het plan en in de naslag, en het getal is
overgenomen als bewuste keuze met RELAY_MAX_WRITE_BYTES ernaast.

Wat er niet in zit en ook niet gegokt is: data per eigenaar wissen. Het beleid kan
een eigenaar vergeten, maar zijn berichten staan in de SQLite van de relay, en dat
is andermans schema.

Tests: alle vier groen (32, 54, 39 en 60 goed, 0 fout).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-28 11:12:41 +02:00
HarmenandClaude Opus 5 edb91c4749 Het ontwerp van de limiter en de pagina, en de limiter is klein
createRelay uit @evolu/nodejs neemt twee terugroepfuncties, isOwnerAllowed en
isOwnerWithinQuota, en Trezor doet in createEvoluRelay.ts zelf niets anders. Hun
hele quota-manager met Postgres bestaat alleen om de tabel te vullen die die twee
raadplegen. Wij vullen ze met eigen logica en bouwen niets na. Weg 1 uit
Bereikbaarheid 4b is daarmee veel goedkoper dan daar aangenomen, en dat is wat de
keuze van de gebruiker mogelijk maakt.

De logica zoals hij hem formuleerde: de eerste eigenaar die zich meldt wint, een
schakelaar bepaalt of er nog nieuwe bij mogen, en data is per eigenaar te wissen.
Dat laatste doet het relay-proces zelf, aangestuurd met een vlagbestand vanaf de
pagina; geen tweede container die langszij in de SQLite schrijft en geen
Docker-socket.

Twee feiten uit de broncode van Evolu die het ontwerp sturen en die in de naslag
staan met bron. De gepubliceerde image zet isOwnerWithinQuota op 1 MB per eigenaar
en laat isOwnerAllowed weg, dus een kale relay is niet volledig ongelimiteerd,
maar dat plafond geldt ook voor de echte gebruiker. En de relay-URL van de client
bevat een pad dat letterlijk wordt overgenomen, wat een goedkope proxy-controle
mogelijk maakt; die is bewust niet genomen nu de allowlist er komt.

De poorten gaan om: pagina achter app_proxy met de inlog aan, relay op een eigen
gepubliceerde poort waar Zoraxy met TLS naartoe wijst. Dat lost open punt 2 op
zonder het bezwaar dat daar stond, en het volgt het patroon dat Electrum Gate in
deze repo al gebruikt. De pagina volgt hetzelfde ontwerpsysteem, zonder de Google
Fonts-verwijzing eruit.

Open punt 8 en 2 zijn beslist, fase 5 staat als takenlijst. De gebruiker heeft de
oude installatie van de Umbrel gehaald; er wordt niet geupdatet maar opnieuw
gebouwd.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-28 11:02:51 +02:00
HarmenandClaude Opus 5 6b114475d5 De proef is geslaagd: de kale Evolu-relay praat met Suite
Trezor Suite op de desktop stuurde elf labels naar docker.io/evoluhq/relay:latest
en die kwamen aan: de database in het volume groeide van 40960 naar 49152 bytes en
de tijdstempel verzette. De protocolversie klopt dus, en daarmee is de richting
van 27-08 geen verwachting meer maar een meting. Geen Postgres, geen
quota-manager, geen eigenaarsregistratie, en toch verkeer.

Open punt 6 is daarmee beslist. Het blijft in de lijst staan tot de verbouwing
gedaan is, want het beschrijft de reden waarom het huidige pakket eruit gaat.

Een waarschuwing hoort erbij en staat in het protocol: de relay logt geen enkele
verbinding. Het venster blijft stil terwijl er labels binnenkomen, dus "ik zie
niets gebeuren" is hier geen waarneming maar een eigenschap van de relay. Alleen
het volume vertelt iets, en daarom mag de nulmeting niet overgeslagen worden. Dat
kostte vandaag bijna de verkeerde conclusie.

Twee dingen bleven ongemeten en staan als taak. De leeskant: er is geen tweede
client geweest, dus dat een ander apparaat de labels terugkrijgt is niet gezien.
En iOS maakt geen enkele verbinding, terwijl het veld daar bestaat, valideert op
http(s) en zijn waarde onthoudt. Het vermoeden is TLS, en dat is als open punt 9
opgeschreven met de prijs erbij: een certificaat voor een LAN-adres bestaat niet,
dus de wegen die overblijven lopen via Bereikbaarheid en zijn een eigen
ontwerpvraag. Er is ook een tweede verklaring die even goed past, namelijk dat
het synchroniseren op de telefoon nooit begon, en die is gratis te meten.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-28 10:44:31 +02:00
HarmenandClaude Opus 5 fafea732f9 De relay was al die tijd in orde, de client belde nooit
Het testprotocol voor de kale Evolu-relay staat nu uitgeschreven in PLAN.md §6a,
met de stappen, hoe je een geslaagde van een mislukte uitslag onderscheidt, en de
valkuil dat een label in Suite niets bewijst omdat Evolu eerst lokaal schrijft.

De hoofdvraag is niet beantwoord: er is geen enkele client tot een verbinding
gekomen, dus over de protocolversie weten we nog niets. Wat de serverkant betreft
is er niets te repareren. De relay haalt, start, maakt zijn eigen SQLite-database
aan, en de WebSocket-handshake slaagt zowel op de Umbrel zelf als vanaf een Mac
elders op het netwerk.

Drie meetinstrumenten gaven een vals negatief en zijn onderweg gecorrigeerd, want
alle drie wezen ze een probleem aan dat er niet was. docker diff kijkt niet in een
volume, en /app/data is er een. Een browser of gewone curl krijgt van deze
WS-server niets terug, want hij negeert een verzoek zonder upgrade-headers; dat
ziet er identiek uit aan een dode poort. En healthy komt uit een healthcheck die
alleen een TCP-verbinding opent, dus die zegt niets over werking. Dat laatste is
opgeschreven als eis voor de compose als deze image in het pakket komt.

iOS is voor deze proef afgevallen. Het veld voor de relay-URL bestaat daar, het
valideert op http(s) en onthoudt zijn waarde na een geforceerde afsluiting, maar
de app doet geen enkele verbindingspoging. Of dat aan het platform ligt of aan de
bevestiging op het apparaat is van buitenaf niet te scheiden, dus het wordt een
eigen vraag: anders sluiten we twee onbekenden tegelijk uit. De proef verhuist
naar de desktop-Suite op de Mac.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-28 10:38:33 +02:00
HarmenandClaude Opus 5 b2e9c8fc7a Evolu Relay als tweede app in de store, plus het bouwrecept
De gebruiker koos ervoor het pakket meteen te maken en een installatie te
proberen, met de image lokaal gebouwd en het recept in de repo. Dit is dat
pakket. Er is nog niets gebouwd en niets geinstalleerd; "gebouwd" is hier
nadrukkelijk niet "werkend".

De zwaarste ontwerpvraag is met een precedent beslecht en niet met een gok.
Trezor Suite is geen browser met een sessiecookie en kan dus niet achter de inlog
van umbrelOS; het was onduidelijk of PROXY_AUTH_ADD "false" dan verantwoord is of
een omweg. De eigen nostr-relay-app van Umbrel doet exact hetzelfde, om precies
dezelfde reden, en heeft ook geen eigen ports:. De prijs staat in de compose en in
het plan: wie die poort bereikt, bereikt de relay. Wat de schade beperkt is dat de
relay elke eigenaar zonder limietenrij weigert.

Daarom gaat de quota-manager mee, en dat is geen restje van Trezor's betaalde
hosting: hij is wat die rijen aanmaakt. Relay en quota-manager komen uit dezelfde
image met een ander command, want bovenstrooms is het een codebase met meerdere
startscripts. Het command staat expliciet en leunt niet op de CMD van de
Dockerfile, waar yarn start staat met bovenstrooms zelf een twijfel erbij.

Het bouwrecept staat in tools/ en niet in de app-map. Dat is geen netheid: een
Dockerfile staat niet in de update-whitelist, dus bouwen-in-de-app zou elke
nieuwe versie een deinstallatie plus herinstallatie kosten. Onder tools/ en niet
onder build/, want dat laatste staat in .gitignore als bouwselmap en het recept
zou stilzwijgend buiten de repo zijn gebleven. Dat kwam pas bij git status aan het
licht.

De poort is 3851 en niet 4000. 4000 is de eigen poort van de relay maar ook een
veelgebruikte poort, en een botsing op de host merk je pas als de app niet start.
Die les komt van 50002 tegen Fulcrum.

Nieuw testbestand test_appstore_vorm.py, en het gaat over de store en niet over
een app: id gelijk aan mapnaam, store-voorvoegsel, veldvolgorde, app_proxy die
naar een bestaande service wijst, en elke gemounte map die in de repo bestaat. Het
vindt zijn apps zelf, dus een derde app valt er automatisch onder. Digests toetst
het expres niet: geen van de twee apps haalt die regel vandaag en een suite die
altijd rood staat wordt niet gelezen.

Mutatie-getest met drie ingrepen: het app-id laten afwijken van de mapnaam,
APP_HOST naar een niet-bestaande service laten wijzen, en de .gitkeep weghalen.
Alle drie vielen om bij de juiste toets, en git diff was daarna leeg.

Umbrelapp is gepromoveerd naar Actief als 008, tussen Proefopstelling en
Appstore, en het masterplan is naar het archief. Wat er in de plannen als open
blijft staan is niet klein: of Trezor Suite dit adres accepteert, of het
databaseschema zichzelf aanmaakt, en hoe je een eigenaar registreert.

Tests: 32 goed 0 fout, 39 goed 0 fout en 54 goed 0 fout, niets overgeslagen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 17:18:22 +02:00