🚀 🤖 Epic: botkern — wiederverwendbarer Matrix-Bot-Kern mit E2EE #1

Closed
opened 2026-11-15 16:20:08 +01:00 by holm · 4 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ███████░░░ Hoch — E2EE, Krypto-Store, Geräte-Verifikation
Nutzen █████████░ Sehr hoch — mehrere Bots scheitern bisher an verschlüsselten Räumen
Bruchhäufigkeit ████░░░░░░ Mittel — Bibliotheks- und Protokoll-Updates
Nachhaltigkeit ████████░░ Hoch bei gut gepflegter Bibliothek
Dringlichkeit ██████░░░░ Mittel

Ziel

Ein wiederverwendbarer Kern für Matrix-Bots, der in Ende-zu-Ende-verschlüsselten Räumen lesen und schreiben kann. Bots bauen darauf als Module/Plugins auf.

Maßstab für die Bibliothek (Auftraggeber): Community vor Robustheit vor Funktionen — stabil, gut kuratiert, aktiv gepflegt.

Umfang (erste Fassung)

  • E2EE mit persistentem Krypto-Store, Sync mit Wiederaufnahme
  • Befehle, Reaktionen, Antworten/Threads
  • Rechte je Raum/Nutzer
  • Notfall-Zugang (Token-Rotation, Neuverifikation)
  • Konfiguration ausschließlich über Umgebungsvariablen/Secrets — das Repo ist öffentlich: keine Hostnamen, Konten, Raum-IDs oder Tokens im Code, in Tests oder Issues

Erste Schritte

  1. Bibliothekswahl mit Begründung (Kandidaten und Vergleich kommen als Startmaterial vom ersten Verbraucher; zu prüfen u. a.: Krypto-Unterbau — libolm gilt als veraltet, Nachfolger vodozemac).
  2. Gerüst + Minimal-Bot (Echo in verschlüsseltem Raum) als Abnahme.

🤖 angelegt von Claude thinker00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███████░░░` | Hoch — E2EE, Krypto-Store, Geräte-Verifikation | | Nutzen | `█████████░` | Sehr hoch — mehrere Bots scheitern bisher an verschlüsselten Räumen | | Bruchhäufigkeit | `████░░░░░░` | Mittel — Bibliotheks- und Protokoll-Updates | | Nachhaltigkeit | `████████░░` | Hoch bei gut gepflegter Bibliothek | | Dringlichkeit | `██████░░░░` | Mittel | ## Ziel Ein wiederverwendbarer Kern für Matrix-Bots, der in Ende-zu-Ende-verschlüsselten Räumen lesen und schreiben kann. Bots bauen darauf als Module/Plugins auf. Maßstab für die Bibliothek (Auftraggeber): **Community vor Robustheit vor Funktionen** — stabil, gut kuratiert, aktiv gepflegt. ## Umfang (erste Fassung) - E2EE mit persistentem Krypto-Store, Sync mit Wiederaufnahme - Befehle, Reaktionen, Antworten/Threads - Rechte je Raum/Nutzer - Notfall-Zugang (Token-Rotation, Neuverifikation) - Konfiguration ausschließlich über Umgebungsvariablen/Secrets — das Repo ist öffentlich: keine Hostnamen, Konten, Raum-IDs oder Tokens im Code, in Tests oder Issues ## Erste Schritte 1. Bibliothekswahl mit Begründung (Kandidaten und Vergleich kommen als Startmaterial vom ersten Verbraucher; zu prüfen u. a.: Krypto-Unterbau — libolm gilt als veraltet, Nachfolger vodozemac). 2. Gerüst + Minimal-Bot (Echo in verschlüsseltem Raum) als Abnahme. > 🤖 angelegt von Claude thinker00 (API/Token holm)
Author
Owner

Startmaterial: Vergleich Matrix-SDKs mit E2EE für einen Bot-Kern (Stichtag 2026-11-15)

Kriterien in dieser Reihenfolge: Community vor Robustheit vor Features. Quellen: GitHub-API (Releases, Contributors, Quellcode), PyPI/pypistats, npm-Registry, Alpine-Paketindex, matrix.org-Blog, sqlite.org, docs.mau.fi. Rel/12M = Releases seit 2025-11-15.

Kandidat Letzter Release Rel/12M Träger Krypto Cross-Signing / Verifizierung Store Alpine/musl
matrix-rust-sdk 0.19.1 (2026-09-18) 7 matrix-org / Element, ~2360★ vodozemac voll (SAS, Recovery) SQLite (rusqlite) musl-Build nicht belegt
@vector-im/matrix-bot-sdk (Element-Fork) 0.11.0-element.0 (2026-11-11) 11 element-hq (hookshot) matrix-sdk-crypto-nodejs 0.7.0 (Rust) Recovery-Key, interaktives SAS nicht gefunden SQLite / Sled Binaries x64-/arm64-musl
matrix-bot-sdk (turt2live) 0.8.0 (2026-01-16) 1 Einzelperson crypto-nodejs ^0.4 älter wie Fork wie Fork
mautrix-go v0.32.0 (2026-10-16) 12 überwiegend ein Maintainer Standard libolm, goolm per Build-Tag („experimental“ laut Doku) voll SQLite-WAL / Postgres mit olm-dev
maubot v0.6.0 (2025-11-17) 1 ein Maintainer python-olm (libolm) nicht belegt SQLite / Postgres py3-olm (edge)
mautrix-python 0.21.1 (2026-07-05) 2 ein Maintainer python-olm 3.2.16 (2023) nicht belegt SQLite / Postgres nur glibc-Wheels
matrix-nio 0.26.0 (2026-07-23) 1 Community vodozemac seit 0.26.0 Cross-Signing nicht implementiert SQLite (peewee) musl-Wheels
matrix-js-sdk v45.1.0 (2026-11-11) 40 matrix-org Rust-Krypto voll Node-Store nicht belegt —

libolm: von matrix.org am 2024-08-27 für veraltet erklärt (drei CVEs, Timing-Angriffe), Empfehlung vodozemac; Repo matrix-org/olm archiviert. Betroffen: mautrix-go (Standard-Build), mautrix-python, maubot.

Stolpersteine

  • nio: vodozemac-Umstellung jung; alte Pickles < v4 nicht mehr unterstützt; im PR-Thread gemeldet: Rückschritt Verifizierungsanfragen (#567), verbrauchte One-Time-Keys (#582).
  • mautrix-go: bis v0.28 laufend goolm-Fixes, u. a. Absturz bei kaputten Olm-Nachrichten (v0.26).
  • matrix-rust-sdk: < 1.0, Minor-Sprung etwa alle 3 Monate (API-Brüche zu erwarten); API client-orientiert, Bot-Hilfen (Befehle, Reaktionen, Redaktion) selbst bauen.

Krypto-Store auf Netz-Dateisystem: sqlite.org: „WAL does not work over a network filesystem“ (Begründung: gemeinsamer Speicher aller Prozesse auf einem Host). Für einen Einzelschreiber auf einem Host über NFSv4.2 ist das nicht gemessen → vor Betrieb messen; Pflicht: genau ein Schreiber pro Store.

Entscheid (Projektinhaber, 2026-11-15)

  • SDK: matrix-rust-sdk (vodozemac).
  • Krypto-Store auf zentralem NFS mit genau einem Schreiber — Container müssen den Node wechseln können (Portabilität vor lokalem Speicher).
  • Zweitwahl bei Problemen: @vector-im/matrix-bot-sdk; dritte: mautrix-go mit goolm.

🤖 angelegt von Claude v00 (API/Token holm)

## Startmaterial: Vergleich Matrix-SDKs mit E2EE für einen Bot-Kern (Stichtag 2026-11-15) Kriterien in dieser Reihenfolge: **Community vor Robustheit vor Features**. Quellen: GitHub-API (Releases, Contributors, Quellcode), PyPI/pypistats, npm-Registry, Alpine-Paketindex, matrix.org-Blog, sqlite.org, docs.mau.fi. Rel/12M = Releases seit 2025-11-15. | Kandidat | Letzter Release | Rel/12M | Träger | Krypto | Cross-Signing / Verifizierung | Store | Alpine/musl | |---|---|---|---|---|---|---|---| | matrix-rust-sdk | 0.19.1 (2026-09-18) | 7 | matrix-org / Element, ~2360★ | vodozemac | voll (SAS, Recovery) | SQLite (rusqlite) | musl-Build nicht belegt | | @vector-im/matrix-bot-sdk (Element-Fork) | 0.11.0-element.0 (2026-11-11) | 11 | element-hq (hookshot) | matrix-sdk-crypto-nodejs 0.7.0 (Rust) | Recovery-Key, interaktives SAS nicht gefunden | SQLite / Sled | Binaries x64-/arm64-musl | | matrix-bot-sdk (turt2live) | 0.8.0 (2026-01-16) | 1 | Einzelperson | crypto-nodejs ^0.4 | älter | wie Fork | wie Fork | | mautrix-go | v0.32.0 (2026-10-16) | 12 | überwiegend ein Maintainer | Standard libolm, goolm per Build-Tag („experimental“ laut Doku) | voll | SQLite-WAL / Postgres | mit olm-dev | | maubot | v0.6.0 (2025-11-17) | 1 | ein Maintainer | python-olm (libolm) | nicht belegt | SQLite / Postgres | py3-olm (edge) | | mautrix-python | 0.21.1 (2026-07-05) | 2 | ein Maintainer | python-olm 3.2.16 (2023) | nicht belegt | SQLite / Postgres | nur glibc-Wheels | | matrix-nio | 0.26.0 (2026-07-23) | 1 | Community | vodozemac seit 0.26.0 | Cross-Signing nicht implementiert | SQLite (peewee) | musl-Wheels | | matrix-js-sdk | v45.1.0 (2026-11-11) | 40 | matrix-org | Rust-Krypto | voll | Node-Store nicht belegt | — | **libolm:** von matrix.org am 2024-08-27 für veraltet erklärt (drei CVEs, Timing-Angriffe), Empfehlung vodozemac; Repo matrix-org/olm archiviert. Betroffen: mautrix-go (Standard-Build), mautrix-python, maubot. **Stolpersteine** - nio: vodozemac-Umstellung jung; alte Pickles < v4 nicht mehr unterstützt; im PR-Thread gemeldet: Rückschritt Verifizierungsanfragen (#567), verbrauchte One-Time-Keys (#582). - mautrix-go: bis v0.28 laufend goolm-Fixes, u. a. Absturz bei kaputten Olm-Nachrichten (v0.26). - matrix-rust-sdk: < 1.0, Minor-Sprung etwa alle 3 Monate (API-Brüche zu erwarten); API client-orientiert, Bot-Hilfen (Befehle, Reaktionen, Redaktion) selbst bauen. **Krypto-Store auf Netz-Dateisystem:** sqlite.org: „WAL does not work over a network filesystem“ (Begründung: gemeinsamer Speicher aller Prozesse auf einem Host). Für einen Einzelschreiber auf einem Host über NFSv4.2 ist das nicht gemessen → vor Betrieb messen; Pflicht: genau ein Schreiber pro Store. **Entscheid (Projektinhaber, 2026-11-15)** - SDK: **matrix-rust-sdk** (vodozemac). - Krypto-Store auf zentralem NFS mit genau einem Schreiber — Container müssen den Node wechseln können (Portabilität vor lokalem Speicher). - Zweitwahl bei Problemen: @vector-im/matrix-bot-sdk; dritte: mautrix-go mit goolm. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Entscheide des Auftraggebers (2026-11-15)

  1. Bibliothek: matrix-rust-sdk.
  2. Krypto-Store auf zentralem NFS, genau ein Schreiber. Wortlaut: „es muss portierbar bleiben. container müssen den node wechseln können. zentrales nfs darum gesetzt.“

Damit ist die Folgearbeit beauftragt: Gerüst + Minimal-Bot (Echo in verschlüsseltem Raum) bauen.

Zu beachten

  • matrix-rust-sdk nutzt SQLite (rusqlite). sqlite.org: „WAL does not work over a network filesystem“ gilt für Zugriffe von mehreren Hosts. Hier gibt es genau einen Schreiber; trotzdem messen: Journal-Modus, Lock-Verhalten auf NFSv4.2, Verhalten beim Node-Wechsel (alter Container sicher weg, bevor der neue öffnet). Ergebnis als Kommentar hier.
  • Repo ist öffentlich: Konfiguration nur über Umgebungsvariablen/Secrets, keine Hostnamen, Konten, Raum-IDs, Tokens in Code, Tests oder Issues.

Startmaterial: Bibliotheksvergleich (Stichtag 2026-11-15)

Quellen: GitHub-API, PyPI/pypistats, npm, Alpine-Index, matrix.org-Blog, sqlite.org, docs.mau.fi. Rel/12M = Releases seit 2025-11-15.

Kandidat Letzter Release Rel/12M Träger Krypto Cross-Signing/Verif. Store Alpine/musl
matrix-rust-sdk 0.19.1 (2026-09-18) 7 matrix-org/Element vodozemac voll (SAS, Recovery) SQLite (rusqlite) musl nicht belegt
@vector-im/matrix-bot-sdk (Element-Fork) 0.11.0-element.0 (2026-11-11) 11 element-hq crypto-nodejs 0.7.0 (Rust) Recovery-Key, kein interaktives SAS gefunden SQLite/Sled musl-Binaries x64/arm64
matrix-bot-sdk (turt2live) 0.8.0 (2026-01-16) 1 Einzelperson crypto-nodejs ^0.4 älter wie Fork wie Fork
mautrix-go v0.32.0 (2026-10-16) 12 eine Person (Bus-Faktor) libolm Standard, goolm per Build-Tag „experimental“ voll SQLite-WAL/Postgres olm-dev
maubot v0.6.0 (2025-11-17) 1 eine Person python-olm (libolm) nicht belegt SQLite/Postgres py3-olm edge
mautrix-python 0.21.1 (2026-07-05) 2 eine Person python-olm 3.2.16 (2023) nicht belegt SQLite/Postgres nur glibc-Wheels
matrix-nio 0.26.0 (2026-07-23) 1 Community vodozemac seit 0.26.0 Cross-Signing fehlt SQLite musl-Wheels
matrix-js-sdk v45.1.0 (2026-11-11) 40 matrix-org Rust-Krypto voll Node-Store nicht belegt —
  • libolm: von matrix.org am 2024-08-27 für veraltet erklärt (3 CVEs), Repo archiviert.

🤖 angelegt von Claude thinker00 (API/Token holm)

## Entscheide des Auftraggebers (2026-11-15) 1. **Bibliothek: matrix-rust-sdk.** 2. **Krypto-Store auf zentralem NFS, genau ein Schreiber.** Wortlaut: „es muss portierbar bleiben. container müssen den node wechseln können. zentrales nfs darum gesetzt.“ Damit ist die Folgearbeit beauftragt: Gerüst + Minimal-Bot (Echo in verschlüsseltem Raum) bauen. ### Zu beachten - matrix-rust-sdk nutzt SQLite (rusqlite). sqlite.org: „WAL does not work over a network filesystem“ gilt für Zugriffe von mehreren Hosts. Hier gibt es genau einen Schreiber; trotzdem messen: Journal-Modus, Lock-Verhalten auf NFSv4.2, Verhalten beim Node-Wechsel (alter Container sicher weg, bevor der neue öffnet). Ergebnis als Kommentar hier. - Repo ist öffentlich: Konfiguration nur über Umgebungsvariablen/Secrets, keine Hostnamen, Konten, Raum-IDs, Tokens in Code, Tests oder Issues. ## Startmaterial: Bibliotheksvergleich (Stichtag 2026-11-15) Quellen: GitHub-API, PyPI/pypistats, npm, Alpine-Index, matrix.org-Blog, sqlite.org, docs.mau.fi. Rel/12M = Releases seit 2025-11-15. | Kandidat | Letzter Release | Rel/12M | Träger | Krypto | Cross-Signing/Verif. | Store | Alpine/musl | |---|---|---|---|---|---|---|---| | matrix-rust-sdk | 0.19.1 (2026-09-18) | 7 | matrix-org/Element | vodozemac | voll (SAS, Recovery) | SQLite (rusqlite) | musl nicht belegt | | @vector-im/matrix-bot-sdk (Element-Fork) | 0.11.0-element.0 (2026-11-11) | 11 | element-hq | crypto-nodejs 0.7.0 (Rust) | Recovery-Key, kein interaktives SAS gefunden | SQLite/Sled | musl-Binaries x64/arm64 | | matrix-bot-sdk (turt2live) | 0.8.0 (2026-01-16) | 1 | Einzelperson | crypto-nodejs ^0.4 | älter | wie Fork | wie Fork | | mautrix-go | v0.32.0 (2026-10-16) | 12 | eine Person (Bus-Faktor) | libolm Standard, goolm per Build-Tag „experimental“ | voll | SQLite-WAL/Postgres | olm-dev | | maubot | v0.6.0 (2025-11-17) | 1 | eine Person | python-olm (libolm) | nicht belegt | SQLite/Postgres | py3-olm edge | | mautrix-python | 0.21.1 (2026-07-05) | 2 | eine Person | python-olm 3.2.16 (2023) | nicht belegt | SQLite/Postgres | nur glibc-Wheels | | matrix-nio | 0.26.0 (2026-07-23) | 1 | Community | vodozemac seit 0.26.0 | Cross-Signing fehlt | SQLite | musl-Wheels | | matrix-js-sdk | v45.1.0 (2026-11-11) | 40 | matrix-org | Rust-Krypto | voll | Node-Store nicht belegt | — | - libolm: von matrix.org am 2024-08-27 für veraltet erklärt (3 CVEs), Repo archiviert. > 🤖 angelegt von Claude thinker00 (API/Token holm)
Author
Owner

Messung SQLite auf NFSv4.2 abgeschlossen (VM-Testaufbau): Ergebnis in #3 (Kommentar 18510).

  • WAL mit genau einem Schreiber funktioniert auf NFSv4.2.
  • SQLite schützt nicht verlässlich gegen einen zweiten Node, darum ist ein Wächter-Lock (fcntl auf eigener Lock-Datei) vor dem Öffnen des Stores Pflicht im Gerüst.
  • Node-Wechsel nach Absturz oder Trennung: etwa Lease + 5–10 s, bei Default rund 100 s.
  • Offen: Wiederholungsmessung zum fehlenden Commit bei Netztrennung; Nachmessung auf dem realen Storage.

🤖 angelegt von Claude v00-botkern (API/Token holm)

Messung SQLite auf NFSv4.2 abgeschlossen (VM-Testaufbau): Ergebnis in #3 (Kommentar 18510). - WAL mit genau einem Schreiber funktioniert auf NFSv4.2. - SQLite schützt nicht verlässlich gegen einen zweiten Node, darum ist ein Wächter-Lock (fcntl auf eigener Lock-Datei) vor dem Öffnen des Stores Pflicht im Gerüst. - Node-Wechsel nach Absturz oder Trennung: etwa Lease + 5–10 s, bei Default rund 100 s. - Offen: Wiederholungsmessung zum fehlenden Commit bei Netztrennung; Nachmessung auf dem realen Storage. > 🤖 angelegt von Claude v00-botkern (API/Token holm)
holm referenced this issue from a commit 2026-11-16 11:43:45 +01:00
Author
Owner

Umfang der ersten Fassung erledigt, Holm 5a: schließen.

Umfang Issue
E2EE mit persistentem Krypto-Store, Sync mit Wiederaufnahme, ein Schreiber auf NFS #2–#7
Befehle, Reaktionen, Antworten #9 (Brücke), Echo-Modul
Threads #14
Rechte je Nutzer (Einladung) BOTKERN_ALLOWED_USERS
Notfall-Zugang (Token-Rotation, Neuverifikation) #13
Verifizierung #10
Raumverwaltung, sender_name, redaction #12, #15

Volle VM-Abnahme grün (dev 274c46c). Release v0.2.0 folgt (Holm 6a). Folgearbeit bekommt eigene Issues.

🤖 angelegt von Claude v00 (API/Token holm)

Umfang der ersten Fassung erledigt, Holm 5a: schließen. | Umfang | Issue | |---|---| | E2EE mit persistentem Krypto-Store, Sync mit Wiederaufnahme, ein Schreiber auf NFS | #2–#7 | | Befehle, Reaktionen, Antworten | #9 (Brücke), Echo-Modul | | Threads | #14 | | Rechte je Nutzer (Einladung) | `BOTKERN_ALLOWED_USERS` | | Notfall-Zugang (Token-Rotation, Neuverifikation) | #13 | | Verifizierung | #10 | | Raumverwaltung, sender_name, redaction | #12, #15 | Volle VM-Abnahme grün (dev 274c46c). Release v0.2.0 folgt (Holm 6a). Folgearbeit bekommt eigene Issues. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-16 12:08:14 +01:00
holm referenced this issue from a commit 2026-11-16 12:09:13 +01:00
Sign in to join this conversation.
No description provided.