# Alice 钱包创建与使用教程（v2.0）

更新时间：2026-03-09  
适用对象：Alice Miner v2.0 矿工

---

## 0. 先说结论

在 v2.0 里，矿工挖矿只需要：

- `--address a...`

**不需要**在矿机上保存私钥或签名钱包。

---

## 1. 两种方式拿到地址

## 方式 A（推荐）：使用你已有 Alice 地址

如果你已有 `a...` 地址（钱包/交易所/冷钱包），直接用它启动矿工：

```bash
python3 alice_miner.py \
  --ps-url https://ps.aliceprotocol.org \
  --address a1YourAddress... \
  --allow-insecure
```

---

## 方式 B：本地创建一个新钱包（建议在安全机器）

> 不建议在公共云矿机直接生成主钱包。建议在你自己的安全设备创建。

### 1) 安装依赖

```bash
pip install substrate-interface
```

### 2) 创建钱包

```bash
python3 alice_wallet.py create
```

会输出：

- `Address: a...`
- `Mnemonic: ...`
- 文件保存到：`~/.alice/wallet.json`

### 3) 备份助记词（最重要）

请离线保存助记词。丢失=资产无法找回。

---

## 2. 钱包常用命令

查看余额：

```bash
python3 alice_wallet.py balance
```

查看钱包与链信息：

```bash
python3 alice_wallet.py info
```

转账：

```bash
python3 alice_wallet.py transfer a2xxxx... 100
```

---

## 3. v2.0 与钱包的关系

v2.0 注册是一步式，不再 challenge 签名：

- `POST /register` 直接返回 token
- `/register/verify` 已废弃

也就是说：

- 矿机运行只要地址即可
- 你可以把私钥完全留在安全设备

---

## 4. 推荐安全实践

1. **主资产地址不要放矿机**
2. 可使用独立收款地址专门挖矿
3. 助记词至少做两份离线备份
4. 不要把 `wallet.json` 上传到群聊或云盘公开目录
5. 云机建议只放地址，不放私钥

---

## 5. 常见问题

### Q1：地址格式要求？
Alice 地址一般以 `a` 开头，例如 `a2...`。

### Q2：矿机需要 wallet.json 吗？
v2.0 不需要。矿工只用 `--address`。

### Q3：可以收款地址和运行机器分离吗？
可以，推荐这么做。

---

## 6. 一条命令开挖（最终）

单设备：

```bash
python3 alice_miner.py --ps-url https://ps.aliceprotocol.org --address a1YourAddress... --allow-insecure
```

多卡：

```bash
./start_mining.sh --address a1YourAddress... --gpus 0,1,2,3 --ps-url https://ps.aliceprotocol.org
```