Een fout van ons, gevonden door de gebruiker bij de tweede eigenaar: "Expected tab leader port.". createEvoluDeps vraagt via navigator.locks het slot "tab" aan en kondigt de houder aan als tab leader, en dat slot kan er maar een hebben. openStore maakte per eigenaar een eigen stel afhankelijkheden, dus de tweede werd nooit leider. Nu een stel per proces met een teller, zodat het pas opgeruimd wordt als de laatste store sluit. Dit stond al als valstrik 2 in PLAN.md 4e en was er alsnog in geslopen; de toets met twee eigenaars tegelijk brengt hem terug zodra iemand dit ongedaan maakt. Twee dingen erbij om te kunnen zien wat er met de relay gebeurt: - spiegel <naam> opent dezelfde eigenaar in een lege database naast de bestaande. Alles wat daar binnenkomt heeft de heen- en terugreis over de relay gemaakt, en dat is de enige manier waarop de clientkant kan bewijzen dat er werkelijk iets op de relay staat; lees toont je altijd je eigen rijen. - onWebSocket meldt welke URL geopend wordt en wat ermee gebeurt. Zonder dat ziet een relay die de socket dichtgooit er hetzelfde uit als een trage relay. Dat luikje gaf meteen het antwoord: de socket komt nooit open, 1006, in een herhaallus, en met het ws-pakket ernaast staat er wat de globale WebSocket verzwijgt: 401. Twee eigenaars die eerder allebei 101 gaven zijn dus uit de allowlist van de relay verdwenen. Dat is een vraag over de server-app en staat als open punt 9, met vier verklaringen en wat ze uit elkaar houdt. Suite: 478 goed, 0 fout. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
6.3 KiB
Voortgang - Testclient
09-09-2026 - plan geschreven, gepromoveerd, en de samenstelling werkt
Het masterplan is geschreven en dezelfde dag gepromoveerd naar Actief/003-Testclient/, op verzoek van de
gebruiker. Bij het schrijven ging §4b eerst over de verkeerde vraag: "alles vanuit één scherm" werd gelezen
als een scherm over cliënt én relay. De server-app blijft ongemoeid en synchroniseert met Trezor Suite op
de Mac, dus dat is herschreven naar wat het scherm zelf doet.
Fase 1 is af, en dat was de stap waarvan het plan zei dat hij eerst moest. @evolu/nodejs bevat geen
cliënt, alleen de relay plus losse bouwstenen; createEvolu krijgt zijn afhankelijkheden nu uit
tools/relay-client/src/evolu-node.js, samengesteld uit de in-memory workers van @evolu/common. Vier
dingen zaten in de weg, alle vier stil falend: de ontbrekende installPolyfills() (Node 24 mist
Map.getOrInsertComputed), createEvoluDeps overslaan ("Expected tab leader port."), de
AsyncDisposableStack van initSharedWorker laten vallen, en workers zonder eigen reportDefect. Dat
laatste is waarom de andere drie te vinden waren; zonder dat zegt elke fout hetzelfde en noemt geen oorzaak.
Bewezen met een wegwerpproef: eigenaar aanmaken, transports: [], een rij met een Uint8Array-kolom
wegschrijven en teruglezen. De bytes komen er ongeschonden uit en het proces sluit schoon af.
Nog niet geprobeerd: praten met de relay. Daar is het adres van de Umbrel voor nodig en dat komt van de gebruiker; het gaat niet in deze publieke repo.
09-09-2026 - de cliënt staat: opdrachtregel, bedieningsvlak en twee starters
Fase 2, 3 en 5 in één sessie. Er is een register (owners.json met naam, mnemonic en OwnerId), een
opdrachtregel met acht opdrachten, en een bedieningsvlak op http://127.0.0.1:4380 met per eigenaar de
knoppen uit PLAN.md §4b. Start.bat en Start.command erbij op verzoek van de gebruiker: die draaien
npm install als het nodig is, waarschuwen als .env ontbreekt en openen de browser.
OPEN.md punt 1 is opgelost voordat het een probleem werd. src/probe.js doet de WebSocket-upgrade met
node:http in plaats van met de WebSocket van Node, want die laatste geeft je bij een weigering een
error en geen statuscode. De opdracht klop en de knop "Aankloppen" tonen dus 101 of 401.
Twee echte fouten gevonden en vastgezet in een toets. De eerste: de databasemap werd niet aangemaakt, en
omdat better-sqlite3 dat in een worker meldt was het symptoom een lees die nooit antwoordde. De tweede,
en die is er een om te onthouden: evolu.insert geeft meteen een id terug en zet de schrijfactie in de
wachtrij van de worker, dus wie vlak daarna afsluit is de rij kwijt. Het symptoom was een lees die
"nog geen blobs" meldde over een blob die zojuist bevestigd was. schrijf wacht nu op een query erachter,
en de toets sluit af en heropent.
In de browser nagekeken: een blob schrijven en teruglezen werkt vanuit de pagina, de gegevens zijn dezelfde als die van de opdrachtregel, en licht en donker kloppen allebei.
Wat er nu ligt te wachten is één regel in .env. Alles wat de relay raakt is gebouwd en niets ervan is
beproefd, en dat blijft zo tot het adres er is.
09-09-2026 - de eerste proef, en hij slaagde
De gebruiker vulde .env in en de eerste poging faalde met ECONNREFUSED, op een adres van de vorm
wss://host:3852. Dat is een tegenstrijdigheid: poort 3852 is waar de relay zelf luistert in plat ws
binnen het netwerk, terwijl het certificaat op de reverse proxy zit en die op 443 luistert. Zonder poort
werkt het, en die valstrik staat nu in .env.sample.
Daarmee is de eerste proef uit PLAN.md §4c gedaan, en hij bevestigt wat er tot nu toe alleen beredeneerd
was: twee onbekende eigenaars krijgen allebei HTTP 401 op de WebSocket-upgrade. Zie §10 van
Upstream-evolu-relay.md, waar dat uit de broncode was
afgeleid. Gratis erbij bewezen: de reverse proxy laat de WebSocket-upgrade door en het certificaat klopt,
dus de relay is over wss:// bruikbaar. Dat raakt het masterplan Bereikbaarheid.
Wat deze cliënt niet kan zien, en dus bij de gebruiker ligt: staan die twee eigenaars in de weigerlijst op de statuspagina van de app?
09-09-2026 - een eigen fout, en daarna een vraag aan de relay
De gebruiker liet beide eigenaars toe en kreeg meteen een defect op de tweede: "Expected tab leader port.".
Een fout van ons, en precies de valstrik die in PLAN.md §4e als nummer 2 staat opgeschreven.
createEvoluDeps vraagt via navigator.locks het slot "tab" aan en kondigt de houder aan als tab leader;
dat slot kan er maar één hebben. openStore maakte per eigenaar een eigen stel afhankelijkheden, dus de
tweede werd nooit leider. In een browser is dit vanzelf goed: daar is er één tabblad met één gedeelde
worker. Nu één stel per proces, met een teller zodat het pas opgeruimd wordt als de laatste store sluit,
en een toets met twee eigenaars tegelijk die de fout terugbrengt zodra iemand dat ongedaan maakt.
Daarna bleek er niets te synchroniseren. Twee dingen erbij gebouwd om dat überhaupt te kúnnen zien:
spiegel <naam>opent dezelfde eigenaar in een lege database naast de bestaande. Alles wat daar binnenkomt heeft de heenreis en de terugreis over de relay gemaakt, en dat is de enige manier waarop de cliëntkant kan bewijzen dat er werkelijk iets op de relay staat.leestoont je namelijk altijd je eigen rijen, ook als de relay ze nooit gezien heeft;- een luikje op de WebSocket (
onWebSocket), dat meldt welke URL er geopend wordt en wat ermee gebeurt. Zonder dat ziet een relay die de socket dichtgooit er hetzelfde uit als een relay die traag is: Evolu probeert het gewoon opnieuw.
Dat luikje gaf het antwoord in één keer: de socket komt nooit open, WebSocketConnectError en sluitcode
1006, in een herhaallus. Met het ws-pakket ernaast gelegd staat er wat de globale WebSocket verzwijgt:
HTTP 401. En klop zegt dat inmiddels ook, voor allebei de eigenaars, terwijl diezelfde opdracht
kort daarvoor nog twee keer 101 gaf.
Daarmee ligt de vraag bij de relay en niet meer bij de cliënt: twee eigenaars die toegelaten waren zijn uit de allowlist verdwenen. Wat er op de statuspagina van staat is "turned away". Wat dit kan zijn staat in OPEN.md punt 10; het antwoord zit in de logregels van de relay-container en die kan alleen de gebruiker lezen.