Cover photo

BTC Chain Ordinal Inscription/NFT零基础指南

BTC-Ordinal Inscription基础知识

Digital Artifacts

BTC链上的 NFT 准确叫法是 Inscription (铭文),它通过 Ordinal 序数理论/协议,赋予单个 satoshis (比特币的最小单位 “聪” ,1 BTC = 100,000,000 Satoshis) 任意内容,这些内容包括文字、图片、音频等数据,并且这些数据是真正存储在BTC区块链上的,无法被篡改,也永远不会消失。Ordinal 序数理论/协议不需要侧链,也不会产生任何代币,是完全基于BTC区块链本身,属于真正意义上的Digital Artifacts!

对比:ETH链上的NFT本质上也是一种代币(ERC721/1155),其包含的数据实际上并没有直接存储在ETH的区块链上,而是存储在第三方的IPFS或Arweave上,甚至有些低成本项目直接将数据存储在单一云盘内,这些数据很难保证不被篡改和丢失。

UTXO

UTXO 是 Unspent Transaction Output 的缩写,即”未花费的交易输出“,UTXO是BTC网络的交易模型(记账模型),**它记录交易事件,而不记录最终状态。**每一笔BTC交易都是由若干个交易输入和输出组成,交易输入是资金来源,交易输出是资金去向,每一笔交易都要从交易输入中花费出去一部分,而剩余没有花出去的部分就会变成另一个新的UTXO“未花费的交易输出” 。每一次的交易输入都可以追溯到之前的UTXO,直至最初的挖矿所得。

在BTC网络交易中 UTXO 是基本单位,一个 UTXO 一旦被创建就不可被继续分割,只能当作是下一笔交易的输入被花费掉,花费后产生新的 UTXO,这样周而复始地交易实现BTC的价值转移。所以我们在比特币钱包中所看到的账户余额,实际上是钱包通过扫描区块链并聚合所有属于该用户的UTXO计算得来的。

说明:BTC网络交易中,UTXO无法被分割,只能被消耗和重新创建。比如:大哥有一个2.5BTC的UTXO,大哥要给弟弟转账0.5个BTC,那么这一笔交易的过程是:2.5BTC的UTXO被整体“花掉”,其中0.5BTC支付给弟弟,剩下的2BTC找零给自己(大哥本人);交易后产生两个新的UTXO,大哥得到一个2BTC的UTXO,弟弟得到一个0.5BTC的UTXO。并且大哥之前的2.5BTC的UTXO将不能再被其他交易引用。

BTC交易过程示意图
BTC交易过程示意图

延伸:BTC网络中每个区块中的首个交易,是由挖矿所得创建的比特币交易,又称之为 Coinbase 交易,它是由矿工创建,没有“父交易”,也就没有上一笔交易输出。

对比:ETH等EVM网络采用的交易模型是“帐户/余额模型”,在进行一笔交易时,是直接从本账户的余额中扣减转账数额,但无法确定所扣减的数额全部/部分来源于先前哪一笔交易,有哪些前置的消费条件,从而无法进行转账前的业务逻辑校验。

Ordinal Theory & Inscription

Ordinal Theory即序数理论,序数就是 satoshis 的编号方案,允许跟踪和传输单个 sat 。Satoshis 按照它们被开采的顺序编号,从交易输入转移到交易输出,遵循先进先出原则。编号和转账都依赖于顺序,编号依赖于挖矿的顺序,而转账依赖于交易的输入和输出顺序。

Inscription铭文是将特定元数据与特定UTXO关联的机制。铭文是将任意数据附加到比特币UTXO的方法,同时确保该数据的所有权可以随UTXO的所有权一起传递。铭刻/Inscribe就是在UTXO上创建铭文的过程。当创建新的Inscription时,在UTXO上铭刻铭文,就可以将元数据与UTXO关联起来。铭刻包括将铭文数据转换为比特币脚本,以便将其添加到UTXO的解锁脚本中。铭刻后,UTXO就可以被认为是一个NFT,并且该NFT的所有权可以通过UTXO的转移来转移。【铭刻/Inscribe可以理解为ETH链NFT的铸造/Mint概念】

Full Node & Inscribe

1.安装Bitcoin Core钱包

BTC全节点文件占用空间约465G,且还在继续增加。因此需要至少1T硬盘来创建并运行BTC全节点。

在Bitcore Core官方网站下载对应系统版本的软件(必须在24.0.0版本以上)。

                   按照对应系统选择下载,要求高于24.0.0版本
按照对应系统选择下载,要求高于24.0.0版本

根据提示安装软件,在最后一步完成后会自动弹出一个设置界面,此时要注意,一定要把 Limit block chain storage to 2GB 的选项取消选择,否则会导致Ordinal无法同步index。BTC的节点数据存储位置可以根据自己的硬盘情况自行更改。

一定要把Limit block chain storage to取消选择
一定要把Limit block chain storage to取消选择

进入软件后,会自动开始同步区块链数据,第一次安装会有14年的滞后数据需要下载,大约需要3天的时间进行数据下载同步。

安装后会自动开始同步区块链数据
安装后会自动开始同步区块链数据

区块链数据同步完成后,同步界面会自动隐藏,此时软件右下角会出现✔图标。

同步完成,右下角出现✔
同步完成,右下角出现✔

2.安装Ordinal协议

在Ordinal的Github下载对应系统版本的Ordinal协议,当前最新版本为0.13.1。

post image

把下载好的压缩文件解压缩至Bitcoin Core软件的根目录下,建议解压缩出的文件夹重命名为ord。

把Ordinal解压缩至Bitcoin Core根目录下,并更名ord
把Ordinal解压缩至Bitcoin Core根目录下,并更名ord

3.创建新钱包

在ord文件夹内,win10用户直接在地址栏输入cmd回车 | win11用户直接右键打开cmd进入Ordinal CLI

2中方法进入Ordinal CLI 控制台
2中方法进入Ordinal CLI 控制台

运行 .\ord.exe wallet create 命令创建Taproot协议钱包。会发现报错,报错原因是RPC节点服务器配置错误,此时需要配置区块链数据文件存放路径以及cookie文件存放路径,当然如果没有报错就可以直接创建。

RPC节点服务器配置错误
RPC节点服务器配置错误

运行 .\ord.exe help 命令,查看相关指令。

同时使用

--bitcoin-data-dir <BITCOIN_DATA_DIR> & --data-dir <DATA_DIR>

来配置正确的区块链数据以及cookie位置。

<BITCOIN_DATA_DIR> 是实际存放区块链数据的文件路径

<DATA_DIR> 是实际存放cookie的文件路径

输入 .
输入 .

运行

.\ord.exe --bitcoin-data-dir "E:\Bitcoin\blocks" --cookie-file "E:\Bitcoin\.cookie" --wallet test wallet create

创建一个名为 test 的钱包(可以改为自己需要的名字),记录并妥善保管助记词。路径请根据自己的实际情况修改。

创建钱包
创建钱包

运行

.\ord.exe --bitcoin-data-dir "E:\Bitcoin\blocks" --cookie-file "E:\Bitcoin\.cookie" --wallet test wallet receive

创建一个新的收款地址,用于接收BTC,可以通过交易所把BTC转入这个地址。

创建一个新的接收地址
创建一个新的接收地址

如果需要把Unisat或者Xverse已有ord钱包导入的,可以使用下面命令:

.\ord.exe --bitcoin-data-dir "E:\Bitcoin\blocks" --cookie-file "E:\Bitcoin.cookie" --wallet NAME wallet restore "助记词”

其中NAME这里替换为你想要的钱包名字,助记词两端需要加“”,每个词之间有一个空格。

*********************************************************************************

2023年11月29日更新:

目前全节点除了ordinals协议使用,还有Atomicals协议、闪电网络、Taproot Assets会用到。为了方便都会使用rpcuser&rpcpassword的认证方式来验证全节点连接。

如果搭配了其他协议一起使用全节点,本教程中的.cookie文件验证方式就会失效,需要把--cookie-file "E:\Bitcoin.cookie"命令参数替换为--bitcoin-rpc-pass pass --bitcoin-rpc-user user,根据conf文件设置的rpc用户名&密码替换至命令中即可,这样才能保证ordinals在可以正常连接全节点。

*********************************************************************************

4.Bitcoin core钱包Index索引

新钱包创建好,并转入BTC后,在第一次通过Wallet Balance命令查询余额时,会出现index同步报错,此时需要在bitcoin core软件设置。(因为我已经配置好,所以没有报错的截图。)

打开Bitcoin core,打开Settings标签下的Options选项。

依次打开Settings-->Option
依次打开Settings-->Option

点击Open Configuration File,打开配置文件。

点击Open Configuration File,打开配置文件。
点击Open Configuration File,打开配置文件。
点Continue
点Continue

配置文件里的内容很多(有些人可能是空白),找到txindex=1这条,并把前面的#删除,使得txindex=1生效。如果是空白,可手动添加该条配置。

设置完保存,并重启Bitcoin core软件。

删除txindex=1前面的#,或者手动添加该配置条目
删除txindex=1前面的#,或者手动添加该配置条目

验证设置是否成功,在Bitcoin core软件找到Console并打开。

打开Console控制台
打开Console控制台

在Console控制台运行getindexinfo命令,如果返回的结果为true,同时显示了区块高度,则表示index错误修复已经完成。

运行getindexinfo命令,如果返回结果为true,并显示当前区块高度,则修复完成
运行getindexinfo命令,如果返回结果为true,并显示当前区块高度,则修复完成

运行

.\ord.exe --bitcoin-data-dir "E:\Bitcoin\blocks" --cookie-file "E:\Bitcoin\.cookie" --wallet test wallet balance

短暂的index扫描检测后,即可显示正确的余额。

自动扫描
自动扫描
正确显示余额
正确显示余额

5.Inscribe

准备好要铭刻的文件,这里我就以一张图片为例来演示。

运行

.\ord.exe --bitcoin-data-dir "E:\Bitcoin\blocks" --cookie-file "E:\Bitcoin.cookie" --wallet ordNFT wallet inscribe "C:\Users\sslis\Desktop\7588.png" --fee-rate 25

这里我设置的费率是25,这个费率与交易的确认速度有关,费率设置越高,确认的越快,如果费率设置的过低,可能会导致一直无法确认而卡在链上的情况。建议通过Mempool网站查询当前的费率水平,并根据情况适时调整。

其中,7588.png就是我要铭刻的文件,把例子中的文件路径替换为你的文件即可。运行后会返回四个数据:Commit Hash | Inscription ID | Reveal Hash | Fees

其中Commit和Reveal是两条上链记录,包含了执行操作以及创建铭文的操作,2条操作的费用是单独支付的,交易状态和Fee通过Mempool查询。

post image

Inscription就是你铭刻的铭文的ID,交易确认后,可以在Ordinal官网查询。

运行铭刻命令来进行铭刻
运行铭刻命令来进行铭刻
铭刻后会返回3个数据
铭刻后会返回3个数据
在Mempool查询交易状态和费用(本列是很早Inscribe的,所以确认数目已经很多)
在Mempool查询交易状态和费用(本列是很早Inscribe的,所以确认数目已经很多)
通过Ordinal官网查询铭文详情
通过Ordinal官网查询铭文详情

至此,就完成了铭文的铭刻!

需要注意的是:铭刻的元数据体积与费用是成正比的,体积越大,费用越高。超过100K的图片,铭刻的费用就高达200U,所以在铭刻之前一定要看清楚自己的文件大小,以避免损失。推荐一个查询文件与费用的换算网站:https://hub.cryptocell.guru/ordinalsturbo/

换算网站
换算网站

6.Sell Inscription

BTC铭文还处于早期,二级交易市场并不完善,主要的交易市场有:

OrdSwap:https://ordswap.io Ordinals Wallet : https://ordinalswallet.com Luminex:https://www.luminex.io

Ordinal常用命令

Ordinal版本查询:.\ord.exe --version

创建默认名钱包:.\ord.exe wallet create (创建名为ord的钱包,系统默认)
创建自命名钱包:.\ord.exe --wallet name wallet create (name就是钱包名称)
返回值为[助记词],后期无法查询,要即使记录保存

创建收款地址:.\ord.exe wallet receive(默认钱包用)
创建收款地址:.\ord.exe --wallet name wallet receive(自命名钱包用)
返回值为[bc1开头的收款地址],地址可无限生成

查询钱包余额:.\ord.exe wallet balance(默认钱包用)
查询钱包余额:.\ord.exe --wallet name wallet balance(自命名钱包用)
返回值为["cardinal":XXXXXXX],XXXXX是数值,单位是sats/聪

查询交易记录:.\ord.exe wallet transactions(默认钱包用)
查询交易记录:.\ord.exe --wallet name wallet transactions(自命名钱包用)
返回值为[transactions:Hash,confirmations xxx]

查询铭文:.\ord.exe wallet inscriptions(默认钱包用)
查询铭文:.\ord.exe --wallet name wallet inscriptions(自命名钱包用)
返回值为[Inscription :ID | location : | explorer:]

铭刻:.\ord.exe wallet inscribe FilePath(默认钱包用)
铭刻:.\ord.exe --wallet name wallet inscribe FilePath(自命名钱包用)
返回值为[commit:| inscription:| reveal:| Fees:]

注意,遇到本文第2部分RPC错误的,需要在命令中加入正确的区块链数据以及cookie位置来使用上述命令,否则会报错。

BTC-Ordinal相关网站

Ordinal官网:

Ordinal官方手册:

Ordinal下载Github:

Bitcoin Core钱包官网:

Mempool区块查询网站:

总结

BTC链作为加密货币的始祖公链,具有不可替代的地位。BTC链的铭刻方式所创作的Digital Artifacts,无需使用侧链,无需创造新的代币,所有元数据都保存在区块链上,永不丢失、无法篡改,属于真正意义上的数字资产。期待BTC链的“NFT”铭文能够创造出更大的价值。