HarmenandClaude Opus 5
b3b1881af2
Negen punten uit echt gebruik met 0.4.0, alle negen gedaan. Twee ervan waren onderzoeksvragen en die staan onderaan. Evolu Relay 0.5.0 - Een tijdvenster van twee minuten voor nieuwe eigenaars, met een stopknop. De teller zit in het relay-proces en niet in de pagina: een teller in een tabblad dat je sluit, sluit de deur niet. policy.js kreeg learningUntil, isLearningOpen en expireLearning. - decideOwner kijkt naar isLearningOpen en niet naar het veld learning. De lus die een verlopen venster opruimt loopt elke twee seconden, en in dat gat zou een onbekende alsnog binnenkomen. - Zonder STATE_VERSION te verhogen, met een toets die dat verdedigt: een verhoging zou de allowlist van de draaiende installatie laten afwijzen en de deur sluiten voor eigenaars die er al in stonden. - Labels op een eigenaar-id, in een eigen labels.json met de agent als enige schrijver. Een label zegt niets over toegang, dus de relay hoeft het niet te weten; het is daardoor meteen opgeslagen en werkt ook als de relay omligt. - Geblokkeerde en geweigerde eigenaars in een kader, met een badge die zegt welke van de twee het is. De badge staat buiten het hover-blok, anders is dat onderscheid onzichtbaar tenzij je over de regel gaat. - Maatvoering gelijk aan Electrum Gate: 1760px, hetzelfde raster, icoon van 64 pixels, dezelfde kop, versienummer erachter. Uitleg uit de kaders, knoppen pas bij hover, geen voetregel. Electrum Gate 0.0.24 - Menu-item "About this app", in beide apps. - De statuswidget zei "Answering" met "answered in 7 ms, from inside the app" en zegt nu "Running" met de meting eronder. De nuance dat de controle van container naar container loopt is verplaatst naar een eigen kopje in die dialoog, waar er ruimte voor is; vier woorden waren te weinig. Toetsen en gereedschap - tests/test_relay_agent.py (nieuw, 65 toetsen) en tests/test_paginas_parsen.mjs (nieuw). Muteertests gedraaid op de beslissende regels. - Een dollarteken-toets in test_appstore_vorm.py. Het commentaar in drie bestanden beweerde al dat die test bestond; nu is dat waar. - Een toets dat er geen werkbestanden in een app-map staan. umbreld kopieert de hele map naar het apparaat en in de back-up. - tools/voorbeeldpagina.mjs maakt van een *.template een pagina die je in een browser kunt openen. Dat vond meteen twee echte opmaakfouten. De twee onderzoeksvragen - Een geweigerde eigenaar komt niet in de database: isOwnerAllowed zit in de WebSocket-upgrade, dus het is een 401 en een gesloten socket. Het gewenste gevolg treedt wel op, via de client: die is local-first en levert bij toelating de hele geschiedenis. Blokkeren werkt daarentegen pas bij de volgende verbinding, en dat staat als open punt. - De blobs zijn niet met een xpub te ontcijferen; een OwnerId komt daar niet uit. Met de SLIP-21-node van het apparaat kan het wel, maar die geeft volledige zeggenschap, dus dat hoort niet in een relay. Als plan-punt opgenomen bij de tool in HomeGit/Trezor. Nog niet uitgerold: de image 0.5.0 moet gebouwd en geduwd worden. De digest staat daarom niet in de compose, want een oude digest onder een nieuwe tag levert stil de oude relay. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
UmbrelApps
A community app store for Umbrel, store id whatsnext. Add it in umbrelOS under
App Store → Community App Stores, using the clone URL of this repository.
Apps
Electrum Gate
Reach your own Electrum server from outside your network, over TLS. An Electrum server speaks plain TCP; a wallet on the road wants TLS. This app puts a proxy in between, using the certificate a reverse proxy on the same Umbrel already manages.
Two containers, both on an off-the-shelf image, both configured from a *.template.
| Container | What it does |
|---|---|
server (nginx:alpine) |
terminates TLS on 50022 and forwards plain to the Electrum server; serves the dashboard on port 80 behind the umbrelOS app proxy |
agent (python:3-alpine) |
writes status.json every minute, reads the certificates from the mounted folders, queries the Electrum server, and accepts the certificate choice |
The agent cannot reload nginx itself, as that would need the Docker socket and it is deliberately absent.
It writes cert.conf with the chosen paths and drops a flag file; the nginx container reloads itself. A
reload keeps existing wallet connections alive.
| Port | For |
|---|---|
| 50022 | TLS for Electrum wallets. Not the conventional 50002: Fulcrum occupies that on the host, and with Fulcrum as the backend the container would not start |
| 3850 | the web UI, through the umbrelOS app proxy |
Electrs, Fulcrum and ElectrumX all work, switchable in the umbrelOS settings: the app declares the dependency and uses the address it is handed. Details, with sources, in Docs/Referenties/Umbrel-appstore-spec.md §4.
Tor or TLS. The privacy win is in running your own server, and you have that the moment you do. Tor remains the better choice for privacy; TLS wins on speed, on mobile, and on networks that block Tor. The trade-off is written out in Docs/Referenties/Clients.md §1.
Evolu Relay
Packaged, never installed. The manifest and compose are here; nothing has run on an Umbrel yet.
Trezor Suite syncs labels and account names between devices, and by default that runs through a server operated by Trezor. That server is open source and called Evolu Relay. This app runs it on your own machine. The data is end to end encrypted on the device, so self-hosting does not change that guarantee, it only changes who holds the encrypted copy.
Three containers, two images.
| Container | What it does |
|---|---|
relay |
the sync relay on 4000, reached through the app proxy on 3851 |
quota-manager |
same image, different command; registers the storage limit the relay requires |
db (postgres:17-alpine) |
storage, under ${APP_DATA_DIR}/data/postgres |
The app proxy runs with PROXY_AUTH_ADD: "false", because Trezor Suite is not a browser with a session
cookie. That is the same pattern Umbrel's own nostr-relay app uses. The flip side: anything that can reach
port 3851 reaches the relay without signing in. What limits the damage is that the relay refuses any owner
without a storage limit registered in its database.
Trezor publishes no image, so it is built from their Dockerfile, pinned to a commit, by tools/evolu-relay/build.sh. Run that before installing.
Still unverified: whether Trezor Suite accepts this address, whether the database schema creates itself, and how an owner gets registered. See Docs/Referenties/Upstream-evolu-relay.md.
Documentatie
Alles staat in Docs/. Begin bij Docs/CONTINUE_HERE.md; dat is de index die naar de volgende stap wijst.
| Waar je heen wilt | Waar het staat |
|---|---|
| Wat er nu speelt en wat de volgende stap is | Docs/CONTINUE_HERE.md |
| Wat umbrelOS van een app store verwacht | Docs/Referenties/Umbrel-appstore-spec.md |
| Hoe Electrum Gate vandaag in elkaar zit | Docs/Referenties/Architectuur-huidig.md |
| Welke wallets hierheen kunnen wijzen, en wanneer Tor beter is | Docs/Referenties/Clients.md |
| Wat er over de sync-server van Trezor bekend is | Docs/Referenties/Upstream-evolu-relay.md |
| Versiegeschiedenis van Electrum Gate | Docs/CHANGELOG-electrum-gate.md |
| Waar documentatie hoort | Docs/README.md |
Tests
python tests/test_appstore_vorm.py
Die gaat over de store en vindt zijn apps zelf: id gelijk aan mapnaam, store-voorvoegsel, veldvolgorde in
het manifest, en een app_proxy die naar een bestaande service wijst. Daarnaast twee suites voor Electrum
Gate:
python tests/test_agent_certificates.py
Losse scripts, geen afhankelijkheden. Let op de regels met OVERGESLAGEN: die toetsen hebben de
certificaatwinkel van het besturingssysteem of netwerk nodig, en zijn dan niet bewezen.
Licentie
De apps zijn dunne lagen om bestaande onderdelen: nginx en Alpine Linux (BSD/MIT) voor Electrum Gate, en straks de relay van Trezor, die zijn eigen licentie houdt. Voor de verpakking zelf is nog geen licentie gekozen.