← COMP5521 全部讲次
Lab6 · 第 8 周

Lab6 在 Regtest 上发比特币:挖币、钱包转账、手工拼一笔原始交易

用 Bitcoin Core 在私有测试链上走完一笔交易的生命周期,讲清 UTXO、找零和手续费从哪来,以及照抄课件会踩的四个坑。

一句话版

在一条只属于你的比特币测试链上挖币、用钱包转账,再手工拼、签、发一笔交易,最后翻开区块看看这些交易长什么样。

先认识这几个词

词 全称 / 读法 一句人话
Bitcoin Core 比特币官方节点软件 能挖块、管钱包、发交易的那个程序
Regtest regression test 模式 只在你电脑上跑的私有比特币链
BTC / sat 比特币 / 聪 比特币的单位;聪(satoshi)是最小单位
UTXO Unspent Transaction Output,未花费的交易输出 一张还没花掉的「支票」,比特币的钱就是一堆这种支票
txid / vout transaction ID / 输出序号 哪一笔交易的第几个输出,合起来定位一张支票
coinbase 区块的第一笔交易 凭空发给矿工的出块奖励
mempool memory pool,内存池 已发出、还没被打包进块的交易排队的地方
hex hexadecimal,十六进制 交易被编码成的一长串 0–9、a–f 字符

题目地图

整节不写代码,只敲命令。用的软件是 Bitcoin Core,跑在 Regtest 模式下。命令可以在 GUI 的控制台(Window → Console)里直接敲。用命令行的话,每条前面要补 bitcoin-cli -regtest -rpcwallet=<钱包名>。课件里的命令大多按 GUI 写法省略了这段前缀。

段落 做什么 主要失分点
安装与启动 装 Bitcoin Core,配置 regtest=1 配置没生效,节点去同步主网
准备 建钱包、建地址、挖 101 块 照抄 -testnet;只挖 100 块余额为 0
钱包转账 sendtoaddress 发 12 BTC,挖块确认 不填 fee_rate 报错
原始交易 拼输入输出、签名、广播 忘写找零;广播了未签名的 hex
查区块与交易 getblock、getrawtransaction 把 coinbase 当成自己的交易

本页的命令没有在本机实测(未安装 Bitcoin Core)。截图里的金额、手续费、区块高度已互相验算,结果都对得上。

概念卡

1. Regtest:只有你一个人的链

人话定义:它解决「练习时不想同步、不想等、不想去领币」。比特币有三类网络:主网(真钱),testnet(公共测试网,币不值钱,但要同步、要去水龙头领币),regtest(只在你电脑上跑的私有链)。Regtest 上你是唯一的矿工,一条命令就能出块,交易什么时候确认你说了算。

例子:在 bitcoin.conf 里写一行 regtest=1,启动后 getblockchaininfo 显示 chain 为 “regtest”、blocks 为 0。地址以 bcrt1 开头,testnet 是 tb1,主网是 bc1。

常见误解

以为课件建钱包那页的 -testnet 也能用。那是笔误,会连到公共测试网,和前面的 Regtest 设置对不上。截图里的地址是 bcrt1 开头,说明课件作者实际是在 Regtest 上做的。

回讲义:L09b 手续费和出块奖励:少掉的那一截归矿工

2. coinbase 与成熟期

人话定义:它解决「新挖出的币什么时候能花」。每个块的第一笔交易叫 coinbase,是凭空发给矿工的奖励,Regtest 前期每块 50 BTC。这笔钱要等后面再出约 100 个块才能花,防止块被回滚时奖励已经被花掉。

例子:generatetoaddress 101 <挖矿地址> 挖 101 块。getbalances 显示 trusted 50、immature 5000。意思是第 1 块成熟可花,第 2 到 101 块共 100 块还没成熟,100 × 50 = 5000。

常见误解

以为挖 100 块就够了。钱包要求 coinbase 往后数一共 101 个确认(含它自己所在的块)。所以截图里那笔 50 BTC 的 confirmations 正好是 101;只挖 100 块时可花余额仍是 0。答题按课件「100 confirmations」写即可。

回讲义:L09a 比特币交易长什么样:钱住在输出里,输入只是指针

3. UTXO:钱是一张张支票

人话定义:它回答「比特币的余额存在哪」。比特币没有账户余额,钱包里是一张张 UTXO,每张由产生它的交易编号(txid)和它在那笔交易里的序号(vout)定位。花钱时必须把整张拿来当输入,付给对方一部分,剩下的写一个找零输出转回自己。

例子:钱包用第 1 块那张 50 BTC 付 12 BTC。listunspent 里出现两张新 UTXO:给 receiver 的 12.00000000,和找零 37.99998590。

常见误解

以为 getbalances 的余额是链上存着的一个数。它是钱包把所有可花 UTXO 加起来算出来的,链上只有一笔笔输出。

回讲义:L09d UTXO 集合:全网的零钱袋,一块一块地变

4. 手续费 = 输入 − 输出

人话定义:它回答「手续费写在交易哪里」。交易里没有「手续费」字段。输入总额减去输出总额,差额自动归打包这笔交易的矿工。手续费率按每虚拟字节多少聪(sat/vB)计。

例子:钱包转账那笔反算:50 − 12 − 37.99998590 = 0.00001410 BTC = 1410 sat。查交易时显示 vsize 141 vB,1410 ÷ 141 = 10 sat/vB,正好是转账命令里填的 fee_rate。手工交易:输入 12,付 9,找零 2.999,差额 0.001 BTC 是手续费。

常见误解

以为手工交易里写了收款就够了。不写找零,12 − 9 = 3 BTC 全变成手续费。Bitcoin Core 默认会拒绝费率过高的广播,算是一道保险,但不能依赖。

回讲义:L09b 手续费和出块奖励:少掉的那一截归矿工

5. mempool 与确认

人话定义:它解释「交易发出后为什么不是马上生效」。交易发出后先进 mempool,等矿工把它打包进块。进块那一刻算 1 个确认,之后每多一个块多一个确认。

例子:sendtoaddress 返回 txid 后,getrawmempool 能看到这个 txid。generatetoaddress 1 挖一块后再查,mempool 为空。

常见误解

以为「6 个确认才算最终」是协议规则(课件脚注提过)。那是比特币圈常用的经验安全线,协议本身只看进没进块。

回讲义:L09d UTXO 集合:全网的零钱袋,一块一块地变

逐题拆解

启动。配置文件写 regtest=1。找配置文件最省事的办法是 GUI 里 Settings → Options → Open Configuration File。启动后先跑 getblockchaininfo,chain 显示 “main” 就说明配置没生效,立刻停下检查。

建钱包和地址。把课件的 -testnet 换成 -regtest:

bitcoin-cli -regtest createwallet "lab6"
bitcoin-cli -regtest -rpcwallet=lab6 getnewaddress "miningaddr"

GUI 用户可以跳过第一条。钱包名课件文字写 lab6,截图里是 comp5521,随便起,前后一致即可。

挖初始币。generatetoaddress 101 <miningaddr 的地址>,然后 getbalances 看 trusted 50、immature 5000。listunspent 会看到一张 50 BTC、101 个确认的 UTXO。

钱包转账

先 getnewaddress "receiver" 建收款地址,再发 12 BTC:

sendtoaddress <receiver_address> 12 "" "" false true null "unset" null 10

中间那串参数依次是:两个备注、是否从金额里扣手续费、是否允许 RBF 加价替换、目标确认块数、估费模式、避免地址复用。全是为了把第 10 个位置的 fee_rate 占到。Regtest 上没有历史交易可供估费,Bitcoin Core 默认又关闭了后备费率,所以必须手动指定。命令行下有两种更省事的写法:-named sendtoaddress address=<addr> amount=12 fee_rate=10;或在 bitcoin.conf 里加 fallbackfee=0.0001。

确认。getrawmempool 看到 txid → generatetoaddress 1 <挖矿地址> → 再查 mempool 为空。listunspent 出现 12 BTC 和 37.9999859 BTC 两张新 UTXO。此时第 2 块的 coinbase 也刚好成熟,列表里还会多一张 50 BTC。

一步一步看

目标:跟着 12 BTC 的转账从选输入走到被打包,看出 50 那张怎样整张花掉换成两张,手续费又怎么算。

  1. 挖完 101 块,钱包里能花的只有第 1 块 coinbase 那张 50 BTC,另外 100 块共 5000 BTC 还没成熟。

    钱包转账第 1 帧:第 1 块 coinbase 的 50 BTC 卡片青绿标出、可以花,旁边灰卡是第 2 到 101 块共 5000 BTC 未成熟,mempool 为空

  2. sendtoaddress 发 12 BTC、fee_rate 10。钱包拿那张 50 当输入,输出 12 给 receiver、37.9999859 找零,交易 38a03c0e… 进 mempool。手续费 50 − 12 − 37.9999859 = 0.0000141 BTC = 1410 sat,等于 10 × 141 vB。

    钱包转账第 2 帧:mempool 框青绿标出,里面是交易 38a03c0e,输入 50,输出 12 和 37.9999859,下方算出手续费 1410 sat

  3. generatetoaddress 1,交易被打包进第 102 块,mempool 清空。50 那张整个花掉,换成 12 和 37.9999859 两张。

    钱包转账第 3 帧:区块高度一栏青绿标出变成 102;mempool 清空,50 那张消失,出现 12 和 37.9999859 两张 UTXO

  4. 同一个块让第 2 块的 coinbase 满了 101 个确认,listunspent 又多一张 50。

    钱包转账第 4 帧:第 2 块 coinbase 刚成熟的 50 BTC 卡片青绿标出,和 12、37.9999859 两张并排

拼原始交易

先建两个地址:getnewaddress "receiver2" 和 getnewaddress "changeaddr"。再从 listunspent 复制那张 12 BTC 的 txid 和 vout(截图是 38a03c0e…,vout 0)。然后:

createrawtransaction '[{"txid":"<txid>","vout":0}]' '{"<receiver2 地址>": 9, "<changeaddr 地址>": 2.999}'

返回一串以 02000000 开头的十六进制,这是还没签名的交易。补充一个读 hex 的细节:开头 0200000001 后面那段 0608d798…3ca038,是 txid 38a03c…0806 按字节倒过来写。交易内部存 txid 用小端序(低位字节在前)。

签名。signrawtransactionwithwallet <上一步的 hex>,返回一个 JSON。其中 hex 是签好名的交易,complete 为 true 表示所有输入都签好了。

广播并确认。sendrawtransaction <签名结果里的 hex>,返回新交易 ID(截图是 1a1ba0f2…)。再挖一块,mempool 为空,listunspent 里 12 BTC 那张消失,多出 9 和 2.999 两张。

一步一步看

目标:用 RPC 命令手工拼一笔原始交易,看出输入只写 txid 和 vout,手续费就是输入减输出的差额。

  1. 从 listunspent 抄下 12 BTC 那张的 txid 38a03c0e… 和 vout 0,输入只写这两样。

    原始交易第 1 帧:左边一张 12 BTC 的 UTXO 青绿标出,编号 38a03c0e 冒号 0,右边交易框还没拼

  2. createrawtransaction 写两个输出:9 给 receiver2,2.999 找零给 changeaddr。差额 12 − 9 − 2.999 = 0.001 BTC 是手续费。返回 02000000 开头的未签名 hex。

    原始交易第 2 帧:右边交易框青绿标出,是 02000000 开头的未签名 hex,输入 12,输出 9 和 2.999,下方算出手续费 0.001 BTC

  3. signrawtransactionwithwallet 签名,complete 为 true。

    原始交易第 3 帧:右边交易框青绿标出,签名结果 complete 为 true,所有输入都签好了,要广播的是这里的 hex

  4. sendrawtransaction 传签名后的 hex,返回新交易 ID 1a1ba0f2…,交易进 mempool。

    原始交易第 4 帧:右边 mempool 框青绿标出,里面是新交易 1a1ba0f2,输入 12,输出 9 和 2.999,还没确认

  5. 再挖一块,交易进第 103 块。12 那张消失,多出 9 和 2.999 两张。

    原始交易第 5 帧:12 BTC 那张没了,换成 9 和 2.999 两张 UTXO,区块高度 103,这一步一栏青绿标出

查区块与交易

查区块。getblockcount → getblockhash <高度> → getblock <哈希> 1。截图查的是第 102 块,tx 列表两项:第一项 02717872… 是 coinbase,第二项 38a03c0e… 才是你那笔 12 BTC 交易。

查交易。getrawtransaction <txid> true <blockhash>。截图里 vsize 141、size 222,差别来自隔离见证(SegWit,把签名数据挪到交易主体之外的升级)。签名数据按四分之一计重,手续费按 vsize 算。带 blockhash 是因为节点默认不给所有交易建索引。查自己钱包里的交易也可以用 gettransaction <txid>。

课件里的坑

  • [课件有误] p.8:命令写的是 -testnet,应为 -regtest。p.9 标题「Get TestNet Bitcoins」、p.19 示例地址 tb1qwc.. 也是同一类笔误。
  • [课件有误] p.15:getaddressesbylabel <your_mining_reward_address> 的参数应是标签:getaddressesbylabel "miningaddr"。忘了地址才要查,课件却要你填地址。
  • [课件有误] p.21:问句「找零为什么是 1.999 而不是 2」和命令里的 2.999 对不上,应为「2.999 而不是 3」;答案「剩下 0.001 BTC 成为手续费」是对的。
  • [读图提醒] p.23:sendrawtransaction <tx_hex> 沿用了 p.22 的占位名,但这里必须传签名后的 hex;照字面传 createrawtransaction 的输出会被节点拒绝。
  • [读图提醒] p.25:红框框住的是 tx 列表第一项,那是 coinbase;12 BTC 交易是第二项。截图里 getblockcount 返回 102,是在 p.23 挖确认块之前拍的,完整做下来会是 103,原始交易在第 103 块。

课后 10 分钟:考点复习

这 10 分钟怎么用:先默写必背,再不看页面把「钱包转账」和「原始交易」两条流程各自的命令顺序写出来,然后做完整例题和变式题。

必背

  1. Regtest 是本机私有测试链,bitcoin.conf 写 regtest=1;没有水龙头,靠 generatetoaddress 自己挖币
  2. coinbase 奖励要等约 100 个确认才能花,所以一开始挖 101 个块,第 1 块的 50 BTC 成熟可花
  3. 比特币没有账户余额,只有 UTXO;每个 UTXO 由 txid 加 vout 定位
  4. 交易发出后先进 mempool,挖一个块打包后才算确认
  5. 原始交易的输入只写 txid 和 vout,输出写地址和金额;手续费 = 输入总额 − 输出总额,找零要自己写
  6. 流程:createrawtransaction → signrawtransactionwithwallet → sendrawtransaction(传签名后的 hex)→ 再挖一块确认

完整例题

挖完 101 块后,用钱包给自己的 receiver 地址发 12 BTC,fee_rate 10 sat/vB,交易 vsize 141 vB。问:(1) 发之前 getbalances 的 trusted 和 immature 各是多少?(2) 找零是多少?(3) 挖一块确认后,trusted 是多少?

  1. 101 块各 50 BTC。第 1 块成熟:trusted 50;第 2 到 101 块未成熟:immature 100 × 50 = 5000。
  2. 手续费 = 10 × 141 = 1410 sat = 0.0000141 BTC。找零 = 50 − 12 − 0.0000141 = 37.9999859 BTC,和 p.16 截图一致。
  3. 12 和 37.9999859 两张都在自己钱包里,共 49.9999859;再加上第 2 块 coinbase 刚成熟的 50,trusted = 99.9999859 BTC。

判分点:immature 按 100 块算;手续费 = 费率 × vsize;找零 = 输入 − 付款 − 手续费;第 (3) 问记得新成熟的 coinbase。

变式题(先自己做)

listunspent 里有一张 20 BTC 的 UTXO(txid 记作 T,vout 1)。你要手工付给地址 A 共 7.5 BTC,愿意付 0.0005 BTC 手续费,找零到地址 C。(1) 写出 createrawtransaction 命令;(2) 找零是多少?(3) 如果把 vout 写成 0,会发生什么?

提示

输入只写 txid 和 vout;找零 = 20 − 7.5 − 0.0005。vout 指的是那笔交易的第几个输出,写错就指向了另一张 UTXO。

判分点与答案(非官方评分标准)

(1) createrawtransaction '[{"txid":"T","vout":1}]' '{"A": 7.5, "C": 12.4995}'。(2) 12.4995 BTC。(3) 指向 T 的第 0 个输出:如果那张已经花掉或不属于你的钱包,签名时 complete 为 false 或广播被拒;如果它恰好也是你的但金额不同,手续费会按那张的金额重新算,可能变成一笔巨额手续费。判分点:JSON 格式正确;找零算对;说清 vout 的含义。

闪卡自测

1. Regtest 地址的前缀是什么?

bcrt1;testnet 是 tb1,主网是 bc1。

2. 为什么一开始挖 101 块?

coinbase 要等约 100 个确认才成熟,第 101 块出来后第 1 块的 50 BTC 可花(p.9)。

3. immature 5000 是怎么来的?

第 2 到 101 块共 100 块的奖励尚未成熟,100 × 50(p.10)。

4. 为什么 Regtest 上 sendtoaddress 要手动填 fee_rate?

没有历史交易可供估费,默认又没有后备费率,不填会报 Fee estimation failed(p.13)。

5. 交易发出但没确认时在哪里?用什么命令看?

在 mempool,用 getrawmempool(p.14)。

6. getaddressesbylabel 的参数是什么?

标签名,例如 “miningaddr”(p.15 课件写成地址是错的)。

7. 原始交易的手续费写在哪个字段?

没有这个字段,手续费 = 输入总额 − 输出总额(p.21)。

8. signrawtransactionwithwallet 返回的 complete 是什么意思?

true 表示所有输入都已签名,可以广播(p.22)。

9. 一个块的 tx 列表第一项是什么?

coinbase 交易,给矿工的奖励(p.25)。

10. getrawtransaction 为什么要带 blockhash?

节点默认不给所有交易建索引,要告诉它去哪个块找;开启 txindex 后可省略(p.26)。

下一步

先按课件完整走一遍,在查区块那一步分别看第 102 块和第 103 块,确认 12 BTC 交易和原始交易各在哪里;再故意不写找零跑一次 createrawtransaction 和 sendrawtransaction,看节点返回什么。理论部分对照L08b-2 ECDSA:比特币怎样用椭圆曲线签名:签名那一步用的就是椭圆曲线签名。

下一讲 →
L08a L08a 椭圆曲线:连线、翻折,曲线上的点也能相加

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。