国内系统

一个美观的、基于终端的以太坊钱包和智能合约浏览器，专为自主权、安全性和风格而构建。

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

概述

国内系统是一个终端用户界面（TUI），设计用于浏览以太坊（EVM）账户和智能合约。它融合了三个核心原则，使基于终端的区块链交互不仅实用，而且更受欢迎。

理念

🏛️ 自主权

仅客户端。无中心化服务器。只有你和区块链。

国内系统直接连接到您选择的以太坊RPC端点。无中介、无分析、无追踪。您与区块链的交互是直接且无中介的。这才是Web3应有的工作方式。

🔐 安全性

不管理私钥。硬件钱包就绪。

您的私钥从未接触此应用程序。所有交易都按照EIP-4527生成二维码，专为硬件钱包设备签名而设计。查看您的账户，准备交易，并在硬件钱包上安全签名。

✨ 复古美学

基于Charm.sh构建。终端界面，精美呈现。

使用华丽的Charm.land生态系统（Bubble Tea、Lip Gloss、Huh），国内系统证明了CLI不必朴素。丰富的色彩、流畅的交互和用心的UI设计为区块链交互带来了复古未来主义美学。

为什么选择终端？

这三个原则——自主权、安全性和美学——在终端中完美融合。终端应用程序具有以下优势：

• 轻量级：无臃肿的Electron应用或浏览器扩展
• 透明：开源代码，可审计
• 可移植：可在SSH、服务器、最小系统上运行
• 专注：无干扰，只提供您需要的信息
• 永恒：终端UI优雅地老去

国内系统占据了小众用例的独特交叉点，服务于重视控制、安全和工艺的用户。

功能

• 📊 多钱包管理：同时跟踪多个以太坊地址
• 💰 代币余额查看：原生ETH和ERC-20代币支持，可自定义观察列表
• 🌐 多RPC配置：连接到任何以太坊RPC端点（主网、L2、测试网）
• 🔄 实时更新：实时余额和网络状态更新
• 🎨 精美的TUI：使用Bubble Tea和Lip Gloss精心打造，提供卓越的终端体验
• 🦄 Uniswap集成：直接从终端交换代币
• 📱 DApp浏览器：浏览并与去中心化应用交互
• ⚡ 交易构建：生成交易二维码，用于硬件钱包签名（EIP-4527）
• 📋 剪贴板集成：轻松复制地址和ENS解析
• ⚙️ 持久配置：设置和钱包列表本地保存
• 🔑 交易签名器：原生Go签名模块 + 独立Python CLI，用于气隙环境下的EIP-4527工作流

安装

先决条件

• Go 1.21或更高版本
• 支持真色彩的终端（大多数现代终端）

从源码构建

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

配置

国内系统将其配置存储在 ~/.charm-wallet-config.json 中。

RPC端点

在设置页中添加以太坊RPC端点，或通过设置 ETH_RPC_URL 环境变量：

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

代币观察列表

通过编辑 main.go 中的代币观察列表来自定义要显示的ERC-20代币（UI配置即将推出）。

使用方法

导航

• 方向键 / hjkl：浏览菜单和列表
• Enter：选择 / 确认
• Esc：返回 / 取消
• Tab：在输入字段之间切换
• Ctrl+C：退出应用程序
• 双击：双击标题中的活动地址，打开账户列表弹窗，快速切换账户

页面

• 账户：管理您的以太坊地址观察列表
• 详情：查看活动地址的余额和代币持有量
• 设置：配置RPC端点和应用程序设置
• DApps：浏览并与去中心化应用交互
• Uniswap：代币交换界面
• 签名器（从账户页按x）：管理签名密钥，通过摄像头扫描EIP-4527二维码，并签名交易

添加账户

1. 导航到钱包页面
2. 按 a 添加新钱包
3. 输入以太坊地址或ENS名称
4. 可选：提供昵称
5. 按 Enter 保存

切换账户

活动账户（标记为★）决定用于交易的哪个钱包。切换账户：

1. 双击全局标题中显示的活动地址（从任何视图均可）
2. 使用方向键（↑/↓）选择不同的账户
3. 按 Enter 激活所选账户
4. 按 Esc 取消

或者，导航到钱包页面，在任何钱包上按 Enter 查看其详情并激活它。

发送交易

1. 选择有ETH余额的钱包
2. Tab并点击发送按钮
3. 填写接收地址和金额
4. 生成二维码，用于硬件钱包签名

交易签名器

国内系统包含完整的EIP-4527交易签名工作流，既可在TUI内部使用，也可独立在终端中使用。

工作原理

TUI（任何页面） → 打包未签名交易 → 显示EIP-4527二维码
                                               ↓
                             签名器页面通过摄像头扫描二维码
                                               ↓
                             解码UR → 使用存储的密钥签名
                                               ↓
                             显示原始签名交易十六进制

私钥存储

密钥存储在 ~/.charm-wallet-private-keys.json（权限模式600，位于仓库外部）。首次运行时，会自动引导一个NotForProduction演示密钥，其地址会注册到~/.charm-wallet-config.json中。

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

TUI签名器页面

从账户页按x打开签名器。在签名器页面：

签名交易（原始十六进制、交易哈希、r/s/v）会在扫描后立即显示。

独立Python CLI（signer/eth_signer.py）

Python签名器独立于TUI运行。首先安装依赖：

pip install -r requirements.txt

所有输出均为JSON格式。--scan模式会打开一个OpenCV窗口显示实时摄像头画面，并在检测到签名交易时将其输出到stdout。

端到端交易签名测试CLI（cmd/txtest）

使用Go模块直接执行完整的打包→解码→签名往返测试：

# 离线模式（硬编码测试参数——无需RPC）
go run ./cmd/txtest

# 从RPC端点获取实时nonce/gasPrice/chainId
go run ./cmd/txtest --rpc https://eth.llamarpc.com

# 自定义接收地址和金额
go run ./cmd/txtest --to 0xYourAddr --value 0.5 --chainid 11155111

输出清晰显示两个步骤：

STEP 1 — 打包未签名交易（EIP-4527）
─────────────────────────────────────────────
交易字段：{ "from": "0x29c7...", "to": "0xd8dA...", ... }
UR: ur:eth-sign-request/onadtpdagd...

STEP 2 — 使用存储密钥解码+签名
───────────────────────────────────────
解码交易：{ "from": "0x29c7...", "value": "0.001000 ETH", ... }
签名交易：{ "txHash": "0x5989...", "raw_transaction": "0xf86b...", ... }

✓  往返完成

开发

通过SSH访问远程节点

1. 确保节点正在运行。默认情况下，RPC端口通常为8545。您可以通过在节点机器上运行以下命令来检查：

    ss -ntlp | grep 8545 

2. 在您的应用程序机器上，创建一个到节点机器的持久SSH隧道。

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

现在，应用程序机器上运行的应用程序可以通过 http://localhost:8545 访问以太坊节点的RPC。

Uniswap v4监听器作为一个可运行的辅助模块，位于uniswap_v4_listener.go。您现在可以从终端运行它：

go run helpers/uniswap_v4_listener.go -ws -poolmanager

仅监听新事件

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

从特定区块回填

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

项目结构

domestic-system/
├── main.go              # 入口点——连接Bubble Tea程序
├── model.go             # 应用状态结构 + Init()
├── update.go            # 所有Update()消息处理器
├── view.go              # 顶层View()分发
├── cmd/
│   ├── txtest/          # 端到端打包→签名测试CLI
│   └── v4listener/      # 独立的Uniswap V4事件监听器
├── config/              # JSON配置加载/保存、类型定义
├── helpers/             # ENS解析、地址格式化、Uniswap V2/V4
├── rpc/                 # 以太坊RPC客户端、EIP-4527交易打包
├── signer/
│   ├── signer.go        # Go包：密钥管理、EIP-4527解码、ECDSA签名
│   └── eth_signer.py    # 独立Python CLI（相同功能）
├── styles/              # Lip Gloss颜色和共享样式
├── views/               # 各页面渲染器
│   ├── wallets/
│   ├── details/
│   ├── settings/
│   ├── dapps/
│   ├── uniswap/
│   ├── terra/
│   └── signer/          # 签名器页面渲染器
└── webcam/              # 摄像头捕获和半块视频渲染

运行测试

# RPC包测试（需要RPC端点）
ETH_RPC_URL="https://eth.llamarpc.com" go test ./rpc -v

# 所有测试
go test ./... -v

贡献

欢迎贡献！本项目重视：

• 极简主义：添加符合核心理念的功能
• 安全性：在用户资金和数据上不偷工减料
• 精致：终端UI值得关注细节

在开始重大工作前，请先创建一个issue。

路线图

• 首页仪表盘，显示投资组合概览
• 交易历史查看
• EIP-4527二维码生成
• EIP-4527二维码签名（TUI签名器页面 + Python CLI）
• NFT查看支持
• 更多DApp集成
• 直接支持Ledger/Trezor（可选）
• 鼠标支持，用于点击地址/按钮

许可

MIT许可证 - 详见LICENSE文件

致谢

构建工具：

• Bubble Tea - 终端UI框架
• Lip Gloss - TUI样式定义
• Huh - 终端表单
• go-ethereum - 以太坊客户端库

灵感来源于自我主权理念和复古计算美学。

国内系统：您的终端，您的密钥，您的区块链。