HarmenandClaude Opus 5
3f7da42388
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>
93 lines
6.3 KiB
Markdown
93 lines
6.3 KiB
Markdown
# 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](../../../Referenties/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. `lees` toont 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](OPEN.md) punt 10; het antwoord zit in de logregels van de relay-container en die kan alleen de
|
|
gebruiker lezen.
|