Seminar Fedimint Client Integration und WebSDK

Inhaltsverzeichnis

• Abstract
• Zielgruppe
• Voraussetzungen
• Lernziele
• Inhalte und Ablauf
• Step-by-step Labs
• Ergebnisartefakte

Abstract
Dieses Seminar richtet sich an Teams, die Fedimint in Anwendungen integrieren wollen, insbesondere im Web- oder App-Kontext. Vermittelt werden Client-Architektur, State-Handling, sichere Speicherung sowie UX-nahe Flows wie Join Federation, Backup und Recovery, Send und Receive sowie Gebührenanzeigen. Zusätzlich wird die Integration über SDKs behandelt. Der Schwerpunkt liegt auf zuverlässiger Client-Logik, robusten Fehlerpfaden und einer sauberen Trennung zwischen UI, Business-Logik und Protokollzugriff. Die Übungen führen zu einer lauffähigen Referenzintegration mit klar definierten Integrationspunkten für Produktfeatures.

Zielgruppe
Frontend- und App-Entwicklung, Produktengineering, Wallet-Builder sowie Integrationsarchitektur.

Voraussetzungen
Erfahrung mit JavaScript oder TypeScript beziehungsweise einem Mobile-Stack sowie ein Grundverständnis von Payment-Flows. Fedimint-Grundlagen werden empfohlen.

Lernziele

• Client-Flows sauber modellieren und implementieren.
• Die Nutzung von SDKs in eine stabile Architektur einbetten.
• State- und Storage-Risiken minimieren.
• Fehlerfälle robust behandeln und die UX stabil halten.
• Eine Minimalintegration produktionsnah vorbereiten.

Inhalte und Ablauf

Tag 1
Client-Komponenten und Datenflüsse. SDK-Integration mit Projektstruktur, Initialisierung und Federation-Join. Send- und Receive-Flows inklusive Gebühren- und Statusmodell. Storage-Strategien für sichere Persistenz, Sessions und Device-Wechsel.

Tag 2
Backup- und Recovery-Patterns sowie Support-Flow-Design. Fehlerrobustheit mit Timeouts, Retries und Partial Failures. Observability im Client mit Events, Fehlertelemetrie und Support-Diagnostik. Security-Basics zu Secrets, Logging und UX-Schutz gegen Social Engineering.

Step-by-step Labs

• Aufsetzen eines Projektgerüsts mit Client-App-Skeleton und klaren Layern.
• Umsetzung des Federation-Join-Flows mit Eingabe, Validierung und Persistenz.
• Implementierung des Payment-Flows mit Send, Receive, Statusanzeigen und Abbruchpfaden.
• Realisierung des Recovery-Flows mit Backup-Erzeugung, Restore-Tests und UX-Fallstricken.
• Simulation von Netzwerkstörungen zur Prüfung von Retry-Policies und UI-Degradation.

Ergebnisartefakte

• Eine lauffähige Referenzintegration mit klarer Layer-Architektur.
• Flow-Definitionen und Zustandsdiagramme in Textform.
• Ein Fehler- und Telemetrie-Katalog.
• Eine Checkliste zur Client Release Readiness.