Nockchain Wallet 转账完整教程（v0 → v1 & v1 → v1）

本教程包含两种转账方式：

• 从 v0 地址转到 v1 地址
• 从 v1 地址转到 v1 地址

无论你的地址是什么版本，你都可以照着本文逐步完成转账。

下面是 已经整合你刚刚新增的提示内容、并放在教程最前面的 正式版本提示语（可直接放进文档）：

---

✅ 重要提示（强烈建议）

为了避免在转账过程中遇到编译版本差异、RPC 兼容性、依赖版本问题等导致的 不可预测错误，
强烈建议你使用 GoldenMiner 发布的已编译版本 nockchain-wallet：

wget https://github.com/GoldenMinerNetwork/nockchain-wallet/releases/download/v1.1/nockchain-wallet
chmod +x nockchain-wallet

这样可以确保你在进行 v0 → v1 或 v1 → v1 转账时，运行的是最新、稳定、经过验证的版本，避免因为本地编译环境不同导致的失败。

---

一、基本概念说明

🧩 1. Notes（代币 UTXO）

Nockchain 的代币是以 note 的方式存储。
每个 note 有两个关键字段：

• Name：note 的唯一 ID（转账时需要用到）
• Assets：该 note 拥有多少 nick
  👉 1 nock = 65,536 nick

🪪 2. 地址版本

• v0 地址：旧版钱包地址
• v1 地址：新版钱包地址（PKH 格式）

v0 只能转给 v1，不能 v0 → v0。

---

二、准备工作

1. 使用助记词导入地址

导入 v0 地址

nockchain-wallet import-keys --seedphrase "<助记词>" --version 0

导入 v1 地址

nockchain-wallet import-keys --seedphrase "<助记词>" --version 1

---

2. 确认当前激活地址（非常重要）

nockchain-wallet list-active-addresses

确保你的地址出现在：

Addresses -- Signing

如果不是，请设置：

nockchain-wallet set-active-master-address <地址>

（不设置的话后续所有操作可能失败）

---

3. 查询该地址所有 notes

查看这个地址拥有的代币（notes）：

nockchain-wallet list-notes-by-address <地址>

注意：
❗ 必须先设置该地址为 active，否则会显示“No notes found”。

---

三、转账教程

---

📘 章节 A：从 v0 地址转账到 v1 地址（v0 → v1）

（根据 v0-v1.md 整合）

---

A-1. 准备要使用的 note

找到你要花费的 note：

示例：

Name: DfZUG7gUzWU8fq4EwhEHQpUkCpSVothcrbvZ9rN5jhXLjzDSKYo17bt
Assets: 20000000 nick

---

A-2. 创建交易 create-tx

通用格式：

nockchain-wallet create-tx \
  --names "[<name>]" \
  --recipient "<recipient-pkh>:<gift>" \
  --fee <fee> \
  --refund-pkh <refund-pkh>

示例：

nockchain-wallet create-tx \
--names "[DfZUG7gUzWU8fq4EwhEHQpUkCpSVothcrbvZ9rN5jhXLjzDSKYo17bt]" \
--recipient "DHEeLKDm3B76oweumfWKWWsmDLoRNQgDogdLQeG97CK4ts8esHzCGU6:655360" \
--fee 1900544 \
--refund-pkh DHEeLKDm3B76oweumfWKWWsmDLoRNQgDogdLQeG97CK4ts8esHzCGU6

参数说明：

• gift: 转账数量（单位 nick）
• fee：手续费
  👉 当前网络：1 note ≈ 29 nock = 1,900,544 nick
• refund-pkh：找零地址，只能填 v1 地址
• names：输入你要花费的 note name

---

A-3. 发送交易 send-tx

系统会生成文件：
txs/<tx-id>.tx

发送：

nockchain-wallet send-tx "txs/<tx-id>.tx"

示例：

nockchain-wallet send-tx "txs/ALhww8kS8CWapwRYinKegBrfVFGuAAVSB1AvcZmYUFWuZApws4k8Sure.tx"

---

A-4. 检查交易是否成功

由于区块浏览器暂不支持 v1 解析，只能用 CLI 查询：

等待约半小时后：

nockchain-wallet list-notes-by-address <接收者 v1 地址>

如果出现新 note，即转账成功。

---

📗 章节 B：从 v1 地址转账到 v1 地址（v1 → v1）

（来自 v1-v1.md 整合）

---

B-1. 查看该 v1 地址的 notes

nockchain-wallet list-notes-by-address <v1 地址>

记录你要花费的 note Name 和 Assets。

---

B-2. 创建交易（v1 → v1）

格式：

nockchain-wallet create-tx \
  --names "[<name>]" \
  --recipient "<recipient-pkh>:<gift>" \
  --fee <fee>

（v1 → v1 不需要 refund-pkh 字段，系统会自动处理）

---

示例：

nockchain-wallet create-tx \
--names "[CfmRQUzYBy5x3Z2W1AhcTq2Dw8CRvTDFL9dccchUFy26MmjmDLGmuq2]" \
--recipient "Bvb9eXwQ5y3BJNrqfU8ou6gnse6ydgdYaMJFzVrEHPm55V1m9BHbSvQ:655360" \
--fee 2883584

当前手续费：

• 1 note = 44 nock = 2,883,584 nick

---

B-3. 发送交易

nockchain-wallet send-tx "txs/<tx-id>.tx"

示例：

nockchain-wallet send-tx "txs/ALhww8kS8CWapwRYinKegBrfVFGuAAVSB1AvcZmYUFWuZApws4k8hFp.tx"

---

B-4. 检查是否到账

nockchain-wallet list-notes-by-address <接收者 v1 地址>

看到新 note 即成功。

---

四、常见问题 FAQ

❓ 1. 为什么 list-notes-by-address 显示 No notes found？

原因如下：

• 你没有把该地址设为 active
  → 用 set-active-master-address 解决

• 你输入的地址不是 pkh 格式（v1）

---

❓ 2. v0 地址能否转给 v0？

不能。
v0 → v1
v1 → v1（正常）

---

❓ 3. 手续费为什么这么高？

当前网络手续费基于：

• 每个 note 需要固定消耗 nock
• note 数越多，费用越高

建议尽量合并大 note 进行操作。

---

五、总结

场景	是否支持	说明
v0 → v1	✔ 支持	主流升级方式
v1 → v1	✔ 支持	正常转账
v0 → v0	❌ 不支持	必须转到 v1

---