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ì:

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

Tutto l'output è JSON. La modalità --scan apre una finestra OpenCV che mostra il feed live della telecamera ed emette le transazioni firmate su stdout man mano che vengono rilevate.

Test di firma transazione End-to-end CLI (cmd/txtest)

Esegue il round-trip completo di impacchettamento → decodifica → firma utilizzando direttamente i moduli Go:

# Offline (parametri di test hardcoded — nessun RPC necessario)
go run ./cmd/txtest

# Con nonce/gasPrice/chainId live da un endpoint RPC
go run ./cmd/txtest --rpc https://eth.llamarpc.com

# Destinatario e importo personalizzati
go run ./cmd/txtest --to 0xYourAddr --value 0.5 --chainid 11155111

L'output mostra chiaramente entrambi i passaggi:

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

Sviluppo

Accesso a un nodo remoto tramite SSH

1. Assicurati che il nodo sia in esecuzione. Di default, la porta RPC è spesso 8545. Puoi verificarlo eseguendo questo comando sulla macchina del nodo

    ss -ntlp | grep 8545 

2. Sulla tua macchina applicativa, crea un tunnel SSH persistente verso la macchina del nodo.

    ssh -N -L 8545:localhost:8545 user@node_machine_ip_address #per http
    ssh -N -L 8546:localhost:8546 user@node_machine_ip_address #per ws websocket 

La tua applicazione, in esecuzione sulla macchina applicativa, può ora accedere all'RPC del nodo Ethereum tramite http://localhost:8545

Listener Uniswap v4 come modulo helper eseguibile in uniswap_v4_listener.go. Ora puoi eseguirlo dal terminale con:

go run helpers/uniswap_v4_listener.go -ws -poolmanager

Ascolta solo nuovi eventi

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

Con backfill da un blocco specifico

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

Struttura del Progetto

domestic-system/
├── main.go              # Punto di ingresso — programma Bubble Tea
├── model.go             # Struttura stato app + Init()
├── update.go            # Tutti i gestori messaggi Update()
├── view.go              # Dispatch View() di alto livello
├── cmd/
│   ├── txtest/          # Test CLI end-to-end di impacchettamento → firma
│   └── v4listener/      # Listener eventi Uniswap V4 standalone
├── config/              # Caricamento/salvataggio configurazione JSON, definizioni tipi
├── helpers/             # Risoluzione ENS, formattazione indirizzi, Uniswap V2/V4
├── rpc/                 # Client RPC Ethereum, impacchettamento transazioni EIP-4527
├── signer/
│   ├── signer.go        # Pacchetto Go: gestione chiavi, decodifica EIP-4527, firma ECDSA
│   └── eth_signer.py    # CLI Python standalone (stessa funzionalità)
├── styles/              # Colori Lip Gloss e stili condivisi
├── views/               # Renderer per pagina
│   ├── wallets/
│   ├── details/
│   ├── settings/
│   ├── dapps/
│   ├── uniswap/
│   ├── terra/
│   └── signer/          # Renderer pagina Firmatario
└── webcam/              # Acquisizione fotocamera e rendering video a mezzo blocco

Esecuzione dei Test

# Test pacchetto RPC (richiede endpoint RPC)
ETH_RPC_URL="https://eth.llamarpc.com" go test ./rpc -v

# Tutti i test
go test ./... -v

Contributi

I contributi sono benvenuti! Questo progetto valorizza:

• Minimalismo: Aggiungi funzionalità allineate con la filosofia principale
• Sicurezza: Nessuna scorciatoia con fondi o dati degli utenti
• Raffinatezza: Le UI da terminale meritano attenzione ai dettagli

Apri un issue prima di iniziare lavori importanti.

Roadmap

• Dashboard principale con panoramica del portafoglio
• Visualizzazione cronologia transazioni
• Generazione codici QR EIP-4527
• Firma codici QR EIP-4527 (pagina Firmatario TUI + CLI Python)
• Supporto per visualizzazione NFT
• Più integrazioni DApp
• Integrazione diretta Ledger/Trezor (opzionale)
• Supporto mouse per cliccare indirizzi/pulsanti

Licenza

Licenza MIT - Vedi file LICENSE per i dettagli

Ringraziamenti

Costruito con:

• Bubble Tea - Framework UI per terminale
• Lip Gloss - Definizioni di stile per TUI
• Huh - Form per terminale
• go-ethereum - Libreria client Ethereum

Ispirato dall'etica dell'autosovranità e dall'estetica del retrocomputing.

Il Sistema Domestico: Il tuo terminale, le tue chiavi, la tua blockchain.