The Domestic System

A beautiful, terminal-based Ethereum wallet and smart contract browser built for sovereignty, security, and style.

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

Обзор

The Domestic System — это терминальный пользовательский интерфейс (TUI), предназначенный для просмотра аккаунтов и смарт-контрактов Ethereum (EVM). Он объединяет три основных принципа, которые делают взаимодействие с блокчейном в терминале не просто практичным, но и предпочтительным.

Философия

🏛️ Суверенитет

Только на стороне клиента. Никаких централизованных серверов. Только вы и блокчейн.

The Domestic System подключается напрямую к выбранным вами RPC-конечным точкам Ethereum. Никаких посредников. Никакой аналитики. Никакого отслеживания. Ваше взаимодействие с блокчейном является прямым и неопосредованным. Именно так должна работать Web3.

🔐 Безопасность

Без управления приватными ключами. Готовность к аппаратным кошелькам.

Ваши приватные ключи никогда не попадают в это приложение. Все транзакции генерируются в виде QR-кодов в соответствии с EIP-4527, специально разработанных для подписания с помощью аппаратных кошельков. Просматривайте аккаунты, подготавливайте транзакции и подписывайте их безопасно на вашем аппаратном кошельке.

✨ Ретро-эстетика

Сделано с Charm.sh. Терминальные интерфейсы, выполненные с изяществом.

Используя великолепную экосистему Charm.land (Bubble Tea, Lip Gloss, Huh), The Domestic System доказывает, что CLI не обязаны быть строгими. Насыщенные цвета, плавные взаимодействия и продуманный дизайн интерфейса привносят ретро-футуристическую эстетику во взаимодействие с блокчейном.

Почему Терминал?

Эти три принципа — суверенитет, безопасность и эстетика — идеально сходятся в терминале. Терминальные приложения:

• Легковесны: Никаких раздутых Electron-приложений или расширений браузера
• Прозрачны: Открытый исходный код, который можно проверить
• Портативны: Работают через SSH, на серверах, на минимальных системах
• Сфокусированы: Никаких отвлекающих факторов, только необходимая информация
• Вневременны: Терминальные интерфейсы стареют достойно

The Domestic System занимает уникальное пересечение нишевых сценариев использования, обслуживая тех, кто ценит контроль, безопасность и мастерство исполнения.

Возможности

• 📊 Управление несколькими кошельками: Отслеживание нескольких адресов Ethereum одновременно
• 💰 Просмотр балансов токенов: Поддержка нативного ETH и ERC-20 токенов с настраиваемыми списками наблюдения
• 🌐 Множественные RPC-настройки: Подключение к любому RPC-узлу Ethereum (Mainnet, L2, тестнеты)
• 🔄 Обновления в реальном времени: Актуальные балансы и статус сети
• 🎨 Красивый TUI: Создан с помощью Bubble Tea и Lip Gloss для исключительного терминального опыта
• 🦄 Интеграция Uniswap: Обмен токонами прямо из терминала
• 📱 DApp-браузер: Навигация и взаимодействие с децентрализованными приложениями
• ⚡ Создание транзакций: Генерация QR-кодов транзакций для подписания на аппаратном кошельке (EIP-4527)
• 📋 Интеграция с буфером обмена: Легкое копирование адресов и разрешение ENS
• ⚙️ Постоянная конфигурация: Настройки и списки кошельков сохраняются локально
• 🔑 Подписыватель транзакций: Нативный Go-модуль для подписания + автономный Python CLI для air-gapped рабочих процессов EIP-4527

Установка

Предварительные требования

• Go 1.21 или выше
• Терминал с поддержкой true color (большинство современных терминалов)

Сборка из исходного кода

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

Конфигурация

The Domestic System хранит свою конфигурацию в ~/.charm-wallet-config.json.

RPC-конечные точки

Добавляйте RPC-конечные точки Ethereum на странице настроек "s" или с помощью переменной окружения ETH_RPC_URL:

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

Список отслеживания токенов

Настройте отображаемые ERC-20 токены, отредактировав список токенов в main.go (настройка через интерфейс появится позже).

Использование

Навигация

• Стрелки / hjkl: Навигация по меню и спискам
• Enter: Выбор / Подтверждение
• Esc: Назад / Отмена
• Tab: Переключение между полями ввода
• Ctrl+C: Выход из приложения
• Двойной клик: Двойной клик по активному адресу в заголовке открывает всплывающее окно со списком аккаунтов для быстрого переключения

Страницы

• Accounts (Аккаунты): Управление списком отслеживаемых адресов Ethereum
• Details (Детали): Просмотр балансов и токенов для активного адреса
• Settings (Настройки): Настройка RPC-конечных точек и параметров приложения
• DApps: Просмотр и взаимодействие с децентрализованными приложениями
• Uniswap: Интерфейс обмена токенов
• Signer (Подписание) (x на странице Accounts): Управление ключами подписания, сканирование QR-кодов EIP-4527 через веб-камеру и подписание транзакций

Добавление аккаунтов

1. Перейдите на страницу Wallets (Кошельки)
2. Нажмите a, чтобы добавить новый кошелек
3. Введите адрес Ethereum или ENS-имя
4. При желании укажите псевдоним
5. Нажмите Enter для сохранения

Переключение аккаунтов

Активный аккаунт (отмечен ★) определяет, какой кошелек используется для транзакций. Чтобы переключить аккаунт:

1. Двойным кликом на активном адресе в глобальном заголовке (работает с любого экрана)
2. Используйте стрелки (↑/↓) для выбора другого аккаунта
3. Нажмите Enter для активации выбранного аккаунта
4. Нажмите Esc для отмены

Также можно перейти на страницу Wallets и нажать Enter на любом кошельке для просмотра его деталей и активации.

Отправка транзакций

1. Выберите кошелек с балансом ETH
2. Нажмите Tab и кликните по кнопке Send (Отправить)
3. Заполните адрес получателя и сумму
4. Сгенерируйте QR-код для подписания на аппаратном кошельке

Подписыватель транзакций

The Domestic System включает полный рабочий процесс подписания транзакций EIP-4527, который можно использовать как внутри TUI, так и независимо в терминале.

Как это работает

TUI (любая страница)  →  упаковывает неподписанную транзакцию  →  отображает QR-код EIP-4527
                                                        ↓
                                          Страница Signer сканирует QR через веб-камеру
                                                        ↓
                                          Декодирует UR → подписывает сохранённым ключом
                                                        ↓
                                          Отображает сырую подписанную транзакцию в hex

Хранение приватных ключей

Ключи хранятся в ~/.charm-wallet-private-keys.json (режим доступа 600, вне репозитория). При первом запуске автоматически создаётся демо-ключ NotForProduction, его адрес регистрируется в ~/.charm-wallet-config.json.

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

Страница Signer в TUI

Нажмите x на странице Accounts, чтобы открыть Signer. В нём:

Клавиша	Действие
↑/↓	Выбор ключа подписания
s	Открыть веб-камеру — автоматически подписывает первый обнаруженный QR EIP-4527
a	Перезагрузить ключи с диска
c	Очистить текущий результат
Esc	Вернуться к Accounts

Подписанная транзакция (сырой hex, хэш tx, r/s/v) отображается сразу после сканирования.

Автономный Python CLI (signer/eth_signer.py)

Python-подписыватель работает независимо от TUI. Установите зависимости один раз:

pip install -r requirements.txt