El Sistema Doméstico

Una hermosa billetera Ethereum y navegador de contratos inteligentes basado en terminal, construido para soberanía, seguridad y estilo.

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

Descripción general

The Domestic System es una interfaz de usuario de terminal (TUI) diseñada para navegar cuentas y contratos inteligentes de Ethereum (EVM). Reúne tres principios fundamentales que hacen que la interacción con la cadena de bloques desde la terminal no solo sea práctica, sino preferible.

Filosofía

🏛️ Soberano

Solo del lado del cliente. Sin servidores centralizados. Solo tú y la cadena de bloques.

The Domestic System se conecta directamente a los endpoints RPC de Ethereum que elijas. Sin intermediarios. Sin analíticas. Sin seguimiento. Tu interacción con la cadena de bloques es directa y sin mediación. Así es como se suponía que funcionara Web3.

🔐 Seguro

Sin administración de claves privadas. Listo para billetera hardware.

Tus claves privadas nunca tocan esta aplicación. Todas las transacciones se generan como códigos QR según EIP-4527, diseñados específicamente para firmar con dispositivos de billetera hardware. Visualiza tus cuentas, prepara transacciones y fírmalas de forma segura en tu billetera hardware.

✨ Estética Retro

Construido con Charm.sh. Interfaces de terminal, bellamente realizadas.

Usando el magnífico ecosistema Charm.land (Bubble Tea, Lip Gloss, Huh), The Domestic System demuestra que las CLIs no tienen por qué ser austeras. Colores vibrantes, interacciones suaves y un diseño de interfaz reflexivo aportan una estética retrofuturista a la interacción con la cadena de bloques.

¿Por qué una Terminal?

Estos tres principios—soberanía, seguridad y estética—convergen perfectamente en la terminal. Las aplicaciones de terminal son:

• Ligeras: Sin aplicaciones Electron infladas ni extensiones de navegador
• Transparentes: Código abierto que puedes auditar
• Portátiles: Funcionan a través de SSH, en servidores, en sistemas mínimos
• Enfocadas: Sin distracciones, solo la información que necesitas
• Atemporales: Las interfaces de terminal envejecen con elegancia

The Domestic System ocupa una intersección única de casos de uso nicho, sirviendo a aquellos que valoran el control, la seguridad y la artesanía.

Características

• 📊 Gestión Multi-billetera: Rastrea múltiples direcciones Ethereum simultáneamente
• 💰 Visualización de Saldos de Tokens: Soporte nativo para ETH y tokens ERC-20 con listas de seguimiento personalizables
• 🌐 Configuración Multi-RPC: Conéctate a cualquier endpoint RPC de Ethereum (Mainnet, L2s, testnets)
• 🔄 Actualizaciones en Tiempo Real: Actualizaciones de saldos y estado de la red en vivo
• 🎨 TUI Hermosa: Elaborada con Bubble Tea y Lip Gloss para una experiencia de terminal excepcional
• 🦄 Integración con Uniswap: Intercambia tokens directamente desde la terminal
• 📱 Navegador DApp: Navega e interactúa con aplicaciones descentralizadas
• ⚡ Construcción de Transacciones: Genera códigos QR de transacciones para firmar con billetera hardware (EIP-4527)
• 📋 Integración de Portapapeles: Copia fácil de direcciones y resolución ENS
• ⚙️ Configuración Persistente: La configuración y las listas de billeteras se guardan localmente
• 🔑 Firmante de Transacciones: Módulo de firma nativo en Go + CLI Python independiente para flujos de trabajo EIP-4527 aislados

Instalación

Requisitos Previos

• Go 1.21 o superior
• Una terminal con soporte de color verdadero (la mayoría de las terminales modernas)

Compilar desde el Código Fuente

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

Configuración

The Domestic System almacena su configuración en ~/.charm-wallet-config.json.

Endpoints RPC

Añade endpoints RPC de Ethereum en la página de configuración "s" o configurando la variable de entorno ETH_RPC_URL:

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

Lista de Seguimiento de Tokens

Personaliza qué tokens ERC-20 mostrar editando la lista de seguimiento de tokens en main.go (próximamente configuración desde la interfaz de usuario).

Uso

Navegación

• Teclas de Flecha / hjkl: Navega por menús y listas
• Enter: Seleccionar / Confirmar
• Esc: Retroceder / Cancelar
• Tab: Cambiar entre campos de entrada
• Ctrl+C: Salir de la aplicación
• Doble clic: Haz doble clic en la dirección activa en el encabezado para abrir la ventana emergente de la lista de cuentas y cambiar rápidamente entre cuentas

Páginas

• Cuentas: Gestiona tu lista de seguimiento de direcciones Ethereum
• Detalles: Visualiza saldos y tenencias de tokens para la dirección activa
• Configuración: Configura endpoints RPC y ajustes de la aplicación
• DApps: Navega e interactúa con aplicaciones descentralizadas
• Uniswap: Interfaz de intercambio de tokens
• Firmante (x desde Cuentas): Gestiona claves de firma, escanea códigos QR EIP-4527 a través de la cámara web y firma transacciones

Añadir Cuentas

1. Navega a la página de Billeteras
2. Presiona a para añadir una nueva billetera
3. Ingresa una dirección Ethereum o nombre ENS
4. Opcionalmente proporciona un apodo
5. Presiona Enter para guardar

Cambiar de Cuenta

La cuenta activa (marcada con ★) determina qué billetera se usa para las transacciones. Para cambiar de cuenta:

1. Haz doble clic en la dirección activa que se muestra en el encabezado global (funciona desde cualquier vista)
2. Usa las teclas de flecha (↑/↓) para seleccionar una cuenta diferente
3. Presiona Enter para activar la cuenta seleccionada
4. Presiona Esc para cancelar

Alternativamente, navega a la página de Billeteras y presiona Enter en cualquier billetera para ver sus detalles y activarla.

Enviar Transacciones

1. Selecciona una billetera con saldo de ETH
2. Tabulador & Haz clic en el botón Enviar
3. Completa la dirección del destinatario y la cantidad
4. Genera un código QR para firmar con la billetera hardware

Firmante de Transacciones

The Domestic System incluye un flujo de trabajo completo de firma de transacciones EIP-4527 utilizable tanto dentro de la TUI como de forma independiente desde la terminal.

Cómo funciona

TUI (cualquier página)  →  empaqueta tx sin firmar  →  muestra código QR EIP-4527
                                                        ↓
                                          La página Firmante escanea el QR con la cámara web
                                                        ↓
                                          Decodifica UR → firma con la clave almacenada
                                                        ↓
                                          Muestra el hex de la transacción firmada en bruto

Almacenamiento de claves privadas

Las claves se almacenan en ~/.charm-wallet-private-keys.json (modo 600, fuera del repositorio). En la primera ejecución, una clave de demostración NotForProduction se inicializa automáticamente y su dirección se registra en ~/.charm-wallet-config.json.

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

Página Firmante en la TUI

Presiona x desde la página de Cuentas para abrir el Firmante. Desde allí: