The Domestic System

Ein schönes, terminalbasiertes Ethereum-Wallet und Smart-Contract-Browser, entwickelt für Souveränität, Sicherheit und Stil.

━━━━━━━━━━━━━━━━━━━━
 domestic system
━━━━━━━━━━━━━━━━━━━━

Übersicht

The Domestic System ist eine Terminal-Benutzeroberfläche (TUI) zum Durchsuchen von Ethereum (EVM)-Konten und Smart Contracts. Es vereint drei Kernprinzipien, die die terminalbasierte Interaktion mit der Blockchain nicht nur praktisch, sondern auch bevorzugenswert machen.

Philosophie

🏛️ Souverän

Nur clientseitig. Keine zentralen Server. Nur du und die Blockchain.

The Domestic System verbindet sich direkt mit den von dir gewählten Ethereum-RPC-Endpunkten. Keine Zwischenhändler. Keine Analytik. Kein Tracking. Deine Interaktion mit der Blockchain ist direkt und unvermittelt. So sollte Web3 funktionieren.

🔐 Sicher

Kein Private-Key-Management. Hardware-Wallet bereit.

Deine privaten Schlüssel berühren diese Anwendung nie. Alle Transaktionen werden als QR-Codes gemäß EIP-4527 generiert, die speziell für die Signierung mit Hardware-Wallet-Geräten ausgelegt sind. Zeige deine Konten an, bereite Transaktionen vor und signiere sie sicher auf deinem Hardware-Wallet.

✨ Retro-Ästhetik

Entwickelt mit Charm.sh. Terminal-Oberflächen, wunderschön umgesetzt.

Unter Verwendung des großartigen Charm.land-Ökosystems (Bubble Tea, Lip Gloss, Huh) beweist The Domestic System, dass CLIs nicht spartanisch sein müssen. Reichhaltige Farben, flüssige Interaktionen und durchdachtes UI-Design verleihen der Blockchain-Interaktion eine Retro-Future-Ästhetik.

Warum Terminal?

Diese drei Prinzipien – Souveränität, Sicherheit und Ästhetik – treffen im Terminal perfekt aufeinander. Terminalanwendungen sind:

• Leichtgewichtig: Keine aufgeblähten Electron-Apps oder Browsererweiterungen
• Transparent: Open-Source-Code, den du überprüfen kannst
• Portabel: Funktioniert über SSH, auf Servern, auf minimalen Systemen
• Fokussiert: Keine Ablenkungen, nur die Informationen, die du brauchst
• Zeitlos: Terminal-UIs altern elegant

The Domestic System besetzt eine einzigartige Schnittstelle von Nischenanwendungen und richtet sich an diejenigen, die Kontrolle, Sicherheit und Handwerkskunst schätzen.

Funktionen

• 📊 Multi-Wallet-Verwaltung: Mehrere Ethereum-Adressen gleichzeitig verfolgen
• 💰 Token-Salden anzeigen: Native ETH- und ERC-20-Token-Unterstützung mit anpassbaren Watchlists
• 🌐 Multi-RPC-Konfiguration: Verbindung mit jedem Ethereum-RPC-Endpunkt (Mainnet, L2s, Testnets)
• 🔄 Echtzeit-Updates: Live-Salden- und Netzwerkstatus-Updates
• 🎨 Schöne TUI: Gestaltet mit Bubble Tea und Lip Gloss für ein außergewöhnliches Terminalerlebnis
• 🦄 Uniswap-Integration: Token direkt vom Terminal tauschen
• 📱 DApp-Browser: Dezentrale Anwendungen durchsuchen und mit ihnen interagieren
• ⚡ Transaktionserstellung: Transaktions-QR-Codes für Hardware-Wallet-Signierung generieren (EIP-4527)
• 📋 Zwischenablage-Integration: Einfaches Kopieren von Adressen und ENS-Auflösung
• ⚙️ Persistente Konfiguration: Einstellungen und Wallet-Listen werden lokal gespeichert
• 🔑 Transaktionssignierer: Natives Go-Signing-Modul + eigenständige Python-CLI für Air-Gapped-EIP-4527-Workflows

Installation

Voraussetzungen

• Go 1.21 oder höher
• Ein Terminal mit True-Color-Unterstützung (die meisten modernen Terminals)

Aus Quellcode erstellen

git clone https://github.com/yourusername/domestic-system.git
cd domestic-system
go build
go run .

Konfiguration

The Domestic System speichert seine Konfiguration in ~/.charm-wallet-config.json.

RPC-Endpunkte

Füge Ethereum-RPC-Endpunkte auf der Einstellungsseite „s“ hinzu oder setze die Umgebungsvariable ETH_RPC_URL:

export ETH_RPC_URL="https://eth.llamarpc.com"
go run .

Token-Überwachungsliste

Passe an, welche ERC-20-Token angezeigt werden sollen, indem du die Token-Watchlist in main.go bearbeitest (UI-Konfiguration in Kürze verfügbar).

Verwendung

Navigation

• Pfeiltasten / hjkl: Menüs und Listen navigieren
• Enter: Auswählen / Bestätigen
• Esc: Zurück / Abbrechen
• Tab: Zwischen Eingabefeldern wechseln
• Ctrl+C: Anwendung beenden
• Doppelklick: Doppelklick auf die aktive Adresse im Header öffnet das Popup zur Kontenliste und erlaubt schnelles Wechseln zwischen Konten

Seiten

• Accounts (Konten): Verwalte deine Watchlist mit Ethereum-Adressen
• Details: Zeige Salden und Tokenbestände der aktiven Adresse an
• Settings (Einstellungen): Konfiguriere RPC-Endpunkte und Anwendungseinstellungen
• DApps: Durchstöbere und interagiere mit dezentralen Anwendungen
• Uniswap: Token-Tauschoberfläche
• Signer (x von Accounts): Signierschlüssel verwalten, EIP-4527-QR-Codes per Webcam scannen und Transaktionen signieren

Konten hinzufügen

1. Navigiere zur Seite „Wallets“
2. Drücke a, um ein neues Wallet hinzuzufügen
3. Gib eine Ethereum-Adresse oder einen ENS-Namen ein
4. Gib optional einen Spitznamen an
5. Drücke Enter zum Speichern

Konten wechseln

Das aktive Konto (markiert mit ★) bestimmt, welches Wallet für Transaktionen verwendet wird. So wechselst du Konten:

1. Doppelklick auf die aktive Adresse im globalen Header (funktioniert aus jeder Ansicht)
2. Wähle mit den Pfeiltasten (↑/↓) ein anderes Konto aus
3. Drücke Enter, um das ausgewählte Konto zu aktivieren
4. Drücke Esc, um abzubrechen

Alternativ kannst du zur Seite „Wallets“ navigieren und auf ein beliebiges Wallet drücken, um dessen Details anzuzeigen und es zu aktivieren.

Transaktionen senden

1. Wähle ein Wallet mit ETH-Saldo
2. Tab & Klicke auf die Schaltfläche „Send“
3. Gib die Empfängeradresse und den Betrag ein
4. Generiere einen QR-Code für die Hardware-Wallet-Signierung

Transaktionssignierer

The Domestic System enthält einen vollständigen EIP-4527-Transaktionssignatur-Workflow, der sowohl innerhalb der TUI als auch unabhängig vom Terminal genutzt werden kann.

So funktioniert's

TUI (beliebige Seite)  →  packt unsignierte Tx  →  zeigt EIP-4527-QR-Code an
                                                        ↓
                                          Signer-Seite scannt QR per Webcam
                                                        ↓
                                          Dekodiert UR → signiert mit gespeichertem Schlüssel
                                                        ↓
                                          Zeigt rohe signierte Transaktions-Hex an

Private-Key-Speicher

Schlüssel werden in ~/.charm-wallet-private-keys.json gespeichert (Modus 600, außerhalb des Repos). Beim ersten Start wird automatisch ein NotForProduction-Demo-Schlüssel erstellt und seine Adresse in ~/.charm-wallet-config.json registriert.

{
  "private_keys": [
    {
      "address": "0x29c73B201bEE86C4d1Fe4f598C4355Bb210251e3",
      "name": "NotForProduction",
      "private_key": "0xc0054..."
    }
  ]
}

TUI-Signiererseite

Drücke x auf der Seite „Accounts“, um den Signierer zu öffnen. Von dort:

Taste	Aktion
↑/↓	Signierschlüssel auswählen
s	Webcam öffnen — signiert automatisch den ersten erkannten EIP-4527-QR
a	Schlüssel von der Festplatte neu laden
c	Aktuelles Ergebnis löschen
Esc	Zurück zu „Accounts“

Die signierte Transaktion (rohes Hex, Tx-Hash, r/s/v) wird sofort nach dem Scannen angezeigt.

Eigenständige Python-CLI (signer/eth_signer.py)

Der Python-Signierer läuft unabhängig von der TUI. Installiere die Abhängigkeiten einmalig:

pip install -r requirements.txt