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:

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

Die gesamte Ausgabe erfolgt als JSON. Der --scan-Modus öffnet ein OpenCV-Fenster mit dem Live-Kamerabild und gibt signierte Transaktionen auf stdout aus, sobald sie erkannt werden.

End-to-End-Tx-Signiertest-CLI (cmd/txtest)

Führt den vollständigen Pack → Dekodieren → Signieren Round-Trip mit den Go-Modulen direkt aus:

# Offline (hartcodierte Testparameter — kein RPC erforderlich)
go run ./cmd/txtest

# Mit Live-Nonce/gasPrice/chainId von einem RPC-Endpunkt
go run ./cmd/txtest --rpc https://eth.llamarpc.com

# Benutzerdefinierter Empfänger und Betrag
go run ./cmd/txtest --to 0xYourAddr --value 0.5 --chainid 11155111

Die Ausgabe zeigt beide Schritte deutlich:

STEP 1 — Pack unsigned transaction (EIP-4527)
─────────────────────────────────────────────
Transaction fields: { "from": "0x29c7...", "to": "0xd8dA...", ... }
UR: ur:eth-sign-request/onadtpdagd...

STEP 2 — Decode + sign with stored key
───────────────────────────────────────
Decoded transaction: { "from": "0x29c7...", "value": "0.001000 ETH", ... }
Signed transaction:  { "txHash": "0x5989...", "raw_transaction": "0xf86b...", ... }

✓  Round-trip complete

Entwicklung

Zugriff auf einen entfernten Knoten per SSH

1. Stelle sicher, dass der Knoten läuft. Standardmäßig ist der RPC-Port oft 8545. Überprüfe dies auf dem Knoten-Rechner mit:

    ss -ntlp | grep 8545 

2. Erstelle auf deinem Anwendungsrechner einen persistenten SSH-Tunnel zum Knoten-Rechner.

    ssh -N -L 8545:localhost:8545 user@node_machine_ip_address # für http
    ssh -N -L 8546:localhost:8546 user@node_machine_ip_address # für ws websocket

Deine Anwendung, die auf dem Anwendungsrechner läuft, kann nun auf das RPC des Ethereum-Knotens über http://localhost:8545 zugreifen.

Uniswap v4 Listener als ausführbares Hilfsmodul unter uniswap_v4_listener.go. Sie können es nun über das Terminal ausführen mit:

go run helpers/uniswap_v4_listener.go -ws <wss-url> -poolmanager <address> [-from <block>]

Nur auf neue Events hören

go run ./cmd/v4listener
-ws ws://localhost:8546
-poolmanager 0x000000000004444c5dc75cB358380D2e3dE08A90

Mit Backfill ab einem bestimmten Block

go run ./cmd/v4listener
-ws ws://localhost:8546 \ # oder ws://mainnet.infura.io/ws/v3/YOUR_KEY
-poolmanager 0x000000000004444c5dc75cB358380D2e3dE08A90
-from 21688000

Projektstruktur

domestic-system/
├── main.go              # Einstiegspunkt – verbindet Bubble Tea Programm
├── model.go             # App-Status-Struct + Init()
├── update.go            # Alle Update()-Nachrichtenhandler
├── view.go              # Top-Level View()-Dispatcher
├── cmd/
│   ├── txtest/          # End-to-End Pack → Sign Test CLI
│   └── v4listener/      # Eigenständiger Uniswap V4 Event Listener
├── config/              # JSON-Konfiguration laden/speichern, Typdefinitionen
├── helpers/             # ENS-Auflösung, Adressformatierung, Uniswap V2/V4
├── rpc/                 # Ethereum RPC-Client, EIP-4527 Transaktionspaketierung
├── signer/
│   ├── signer.go        # Go-Paket: Schlüsselverwaltung, EIP-4527 Dekodierung, ECDSA-Signierung
│   └── eth_signer.py    # Eigenständige Python-CLI (gleiche Funktionalität)
├── styles/              # Lip Gloss Farben und gemeinsame Styles
├── views/               # Seiten-Renderer
│   ├── wallets/
│   ├── details/
│   ├── settings/
│   ├── dapps/
│   ├── uniswap/
│   ├── terra/
│   └── signer/          # Signierer-Seiten-Renderer
└── webcam/              # Kameraerfassung und Half-Block-Videorendering

Tests ausführen

# RPC-Paket-Tests (erfordert RPC-Endpunkt)
ETH_RPC_URL="https://eth.llamarpc.com" go test ./rpc -v

# Alle Tests
go test ./... -v

Mitwirken

Beiträge sind willkommen! Dieses Projekt schätzt:

• Minimalismus: Füge Funktionen hinzu, die der Kernphilosophie entsprechen
• Sicherheit: Keine Abkürzungen bei Benutzergeldern oder -daten
• Feinschliff: Terminal-UIs verdienen Liebe zum Detail

Bitte eröffne ein Issue, bevor du mit größeren Arbeiten beginnst.

Roadmap

• Start-Dashboard mit Portfoliobersicht
• Transaktionshistorie anzeigen
• EIP-4527 QR-Code Generierung
• EIP-4527 QR-Code Signierung (TUI Signer-Seite + Python CLI)
• NFT-Anzeigeunterstützung
• Weitere DApp-Integrationen
• Direkte Ledger/Trezor-Integration (optional)
• Mausunterstützung zum Klicken auf Adressen/Schaltflächen

Lizenz

MIT-Lizenz – siehe LICENSE-Datei für Details

Danksagungen

Erstellt mit:

• Bubble Tea – Terminal-UI-Framework
• Lip Gloss – Stildefinitionen für TUIs
• Huh – Terminal-Formulare
• go-ethereum – Ethereum-Clientbibliothek

Inspiriert vom Ethos der Selbstsouveränität und der Ästhetik der Retro-Computing.

The Domestic System: Dein Terminal, deine Schlüssel, deine Blockchain.