Seminar Fedimint Entwicklung in Rust

Inhaltsverzeichnis

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

Abstract
Dieses Entwicklerseminar vermittelt die praktische Entwicklung rund um Fedimint in Rust. Behandelt werden Architekturprinzipien, Modulkonzepte, Client- und Server-Schnittstellen, zustandsmaschinenorientiertes Denken, Teststrategien sowie die Erstellung und Integration eigener Module. Ein besonderer Fokus liegt auf korrekter Zustands- und Fehlerbehandlung, stabilen Schnittstellen und sicherer Erweiterbarkeit. Die Übungen führen von einer lauffähigen Entwicklungsumgebung über das Grundgerüst eines Moduls bis hin zu Integration, Tests und operativen Überlegungen. Ergebnis ist ein funktionsfähiger Prototyp einer Erweiterung inklusive Build-, Test- und Review-Checkliste.

Zielgruppe
Rust-Entwicklung, Backend-Engineering, protokollnahe Teams sowie Wallet- und Infrastruktur-Builder.

Voraussetzungen
Solide Rust-Grundlagen, sicherer Git-Workflow sowie Erfahrung mit Build- und Testprozessen. Fedimint-Grundlagen werden empfohlen.

Lernziele

• Das Modulkonzept und relevante Erweiterungspunkte sicher anwenden.
• Eigene Funktionalität als Modul skizzieren, implementieren und testen.
• Ein sauberes Fehler- und Zustandsmodell entwerfen.
• Review- und Qualitätskriterien für protokollnahen Code anwenden.
• Integrationspfade in Clients und im Betrieb berücksichtigen.

Inhalte und Ablauf nach Tagen

Tag 1
Architekturüberblick und Entwicklungsumgebung. Repository-Struktur, Komponenten und Build-Prozess. Ableitung einer Modulidee mit Inputs, Outputs, Konsensdaten und State Machines. Teststrategien mit Unit-, Integrations- und Simulationstests.

Tag 2
Modulentwicklung mit Aufsetzen des Modulgerüsts. Definition von Datenmodellen, Serialisierung und Fehlerklassen. Client-Integration und API-Design.

Tag 3
Qualität, Sicherheit und Betrieb. Determinismus, Validierung und Systemgrenzen. Observability-Hooks für Module. Release-Readiness mit Migration, Kompatibilität und Dokumentation.

Step-by-step Labs

• Einrichtung des Development-Setups mit Toolchain, Build und lokaler Testumgebung.
• Erstellung eines Modul-Scaffolds mit minimalem Modultyp, Konfiguration und Registry-Einbindung.
• Definition neuer Transaction Types mit Validierungslogik.
• Implementierung der State Machine mit Zuständen, Übergängen, Fehlerpfaden und Retry-Logik.
• Durchführung von Invarianten-Tests und Integrationstests mit lokaler Föderation.
• Review-Gate mit Checkliste zu Sicherheit, Determinismus und Migration.

Ergebnisartefakte

• Ein Modul-Prototyp inklusive Tests.
• Ein API- und Datenmodell-Dokument.
• Eine Review-Checkliste mit Release-Kriterien.
• Integrationsnotizen für Betrieb und Monitoring.