Il Sistema Domestico

Un wallet Ethereum bello, basato su terminale e browser di smart contract costruito per sovranità, sicurezza e stile.

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

Panoramica

Il Sistema Domestico è un'interfaccia utente a terminale (TUI) progettata per navigare account e smart contract di Ethereum (EVM). Riunisce tre principi fondamentali che rendono l'interazione con la blockchain da terminale non solo pratica, ma preferibile.

Filosofia

🏛️ Sovrano

Solo lato client. Nessun server centralizzato. Solo tu e la blockchain.

Il Sistema Domestico si connette direttamente agli endpoint RPC di Ethereum che scegli. Nessun intermediario. Nessuna analisi. Nessun tracciamento. La tua interazione con la blockchain è diretta e senza mediazioni. È così che Web3 doveva funzionare.

🔐 Sicuro

Nessuna gestione di chiavi private. Pronto per hardware wallet.

Le tue chiavi private non toccano mai questa applicazione. Tutte le transazioni sono generate come codici QR seguendo EIP-4527, progettato specificamente per la firma con dispositivi hardware wallet. Visualizza i tuoi account, prepara le transazioni e firmale in sicurezza sul tuo hardware wallet.

✨ Estetica Retrò

Costruito con Charm.sh. Interfacce da terminale, splendidamente realizzate.

Utilizzando il magnifico ecosistema Charm.land (Bubble Tea, Lip Gloss, Huh), Il Sistema Domestico dimostra che le CLI non devono essere austere. Colori ricchi, interazioni fluide e un design UI ponderato portano un'estetica retrò-futuristica all'interazione con la blockchain.

Perché il Terminale?

Questi tre principi—sovranità, sicurezza ed estetica—convergono perfettamente nel terminale. Le applicazioni da terminale sono:

• Leggere: Niente app Electron gonfiate o estensioni del browser
• Trasparenti: Codice open source che puoi verificare
• Portabili: Funzionano via SSH, su server, su sistemi minimi
• Focalizzate: Nessuna distrazione, solo le informazioni di cui hai bisogno
• Senze tempo: Le UI da terminale invecchiano con grazia

Il Sistema Domestico occupa un'intersezione unica di casi d'uso di nicchia, servendo coloro che apprezzano controllo, sicurezza e artigianalità.

Caratteristiche

• 📊 Gestione Multi-wallet: Tieni traccia di più indirizzi Ethereum contemporaneamente
• 💰 Visualizzazione Saldi Token: Supporto nativo per ETH e token ERC-20 con watchlist personalizzabili
• 🌐 Configurazione Multi-RPC: Connettiti a qualsiasi endpoint RPC Ethereum (Mainnet, L2, testnet)
• 🔄 Aggiornamenti in Tempo Reale: Aggiornamenti in tempo reale dei saldi e dello stato della rete
• 🎨 TUI Splendida: Realizzata con Bubble Tea e Lip Gloss per un'esperienza terminale eccezionale
• 🦄 Integrazione Uniswap: Scambia token direttamente dal terminale
• 📱 Browser DApp: Naviga e interagisci con applicazioni decentralizzate
• ⚡ Costruzione Transazioni: Genera codici QR per la firma con hardware wallet (EIP-4527)
• 📋 Integrazione Appunti: Copia facile degli indirizzi e risoluzione ENS
• ⚙️ Configurazione Persistente: Impostazioni e liste wallet salvate localmente
• 🔑 Firmatario Transazioni: Modulo di firma nativo in Go + CLI Python standalone per flussi di lavoro EIP-4527 air-gapped

Installazione

Prerequisiti

• Go 1.21 o superiore
• Un terminale con supporto true color (la maggior parte dei terminali moderni)

Compilazione dal Sorgente

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

Configurazione

Il Sistema Domestico memorizza la sua configurazione in ~/.charm-wallet-config.json.

Endpoint RPC

Aggiungi endpoint RPC Ethereum nella pagina delle impostazioni "s" oppure impostando la variabile d'ambiente ETH_RPC_URL:

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

Watchlist Token

Personalizza quali token ERC-20 visualizzare modificando la watchlist token in main.go (la configurazione UI sarà presto disponibile).

Utilizzo

Navigazione

• Tasti Freccia / hjkl: Naviga nei menu e nelle liste
• Invio: Seleziona / Conferma
• Esc: Indietro / Annulla
• Tab: Passa tra i campi di input
• Ctrl+C: Esci dall'applicazione
• Doppio clic: Doppio clic sull'indirizzo attivo nell'intestazione per aprire il popup della lista account e passare rapidamente tra gli account

Pagine

• Account: Gestisci la tua watchlist di indirizzi Ethereum
• Dettagli: Visualizza saldi e possedimenti token per l'indirizzo attivo
• Impostazioni: Configura endpoint RPC e impostazioni dell'applicazione
• DApp: Sfoglia e interagisci con applicazioni decentralizzate
• Uniswap: Interfaccia per lo scambio di token
• Firmatario (x dalla pagina Account): Gestisci le chiavi di firma, scansiona i codici QR EIP-4527 tramite webcam e firma le transazioni

Aggiungere Account

1. Naviga alla pagina Wallets
2. Premi a per aggiungere un nuovo wallet
3. Inserisci un indirizzo Ethereum o un nome ENS
4. Fornisci facoltativamente un soprannome
5. Premi Invio per salvare

Cambiare Account

L'account attivo (contrassegnato con ★) determina quale wallet viene utilizzato per le transazioni. Per cambiare account:

1. Fai doppio clic sull'indirizzo attivo mostrato nell'intestazione globale (funziona da qualsiasi vista)
2. Usa i tasti freccia (↑/↓) per selezionare un account diverso
3. Premi Invio per attivare l'account selezionato
4. Premi Esc per annullare

In alternativa, naviga alla pagina Wallets e premi Invio su qualsiasi wallet per visualizzarne i dettagli e attivarlo.

Inviare Transazioni

1. Seleziona un wallet con saldo ETH
2. Premi Tab e fai clic sul pulsante Invia
3. Inserisci indirizzo del destinatario e importo
4. Genera codice QR per la firma con hardware wallet

Firmatario Transazioni

Il Sistema Domestico include un flusso di lavoro completo per la firma di transazioni EIP-4527 utilizzabile sia all'interno della TUI che indipendentemente dal terminale.

Come funziona

TUI (qualsiasi pagina)  →  impacchetta tx non firmata  →  mostra codice QR EIP-4527
                                                        ↓
                                          Pagina Firmatario scansiona QR tramite webcam
                                                        ↓
                                          Decodifica UR → firma con chiave memorizzata
                                                        ↓
                                          Mostra hex della transazione firmata non elaborata

Archiviazione chiave privata

Le chiavi sono memorizzate in ~/.charm-wallet-private-keys.json (modalità 600, al di fuori del repository). Al primo avvio, una chiave demo NotForProduction viene avviata automaticamente e il suo indirizzo viene registrato in ~/.charm-wallet-config.json.

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

Pagina Firmatario TUI

Premi x dalla pagina Account per aprire il Firmatario. Da lì:

Tasto	Azione
↑/↓	Seleziona chiave di firma
s	Apri webcam — firma automaticamente il primo QR EIP-4527 rilevato
a	Ricarica le chiavi dal disco
c	Cancella il risultato corrente
Esc	Torna agli Account

La transazione firmata (hex non elaborato, hash tx, r/s/v) viene mostrata immediatamente dopo la scansione.

CLI Python Standalone (signer/eth_signer.py)

Il firmatario Python funziona in modo indipendente senza la TUI. Installa le dipendenze una volta:

pip install -r requirements.txt