Runes学习

官方文档：

https://docs.ordinals.com/runes.html

概念

Runestones (符石）

即协议消息，保存在比特币交易的output里。

一个transaction最多只能有一个符石。

符石总是以 OP_RETURN开头，然后跟着OP_13，然后是一堆data push，它们被认为是一串128bit的integer连接的数据，被解码为符石。

一个符石可能是铭刻（部署）一个新的符文，也可能是mint一个符文，也可能是转账符文。

tx的output里可以包含任意数量的符文

符文被ID标识，ID是由铭刻（部署）这个符文的块高和其交易index组成的，记为：BLOCK:TX。例如一个由第500个块的第20个交易铭刻的符文，标记为500：20

Ething(蚀刻）

Runes是通过Ethe来创造（部署）的，创造时提供的参数：

• 名字，A-Z组成，长度1-26之间，可能包含间隔符，如UNCOMMON•GOODS。 间隔符仅仅方便可读而已，不计入字符数字，必须在两个字符之间。不被认为是名字的一部分。
• Divisibility。表示小数点位数
• Symble，单个unicode符号，显示在数量之后，如$、⧉。通用符号：¤
• premine：预挖，部署者可以直接为自己预挖数量
• Terms(条款）:符文可能任何人都可以参与挖掘，需要满足一些条款才能挖掘，例如：
• • Cap,允许mint的次数上限
  • Amount，每次mint时的固定数量
  • Start Height，按比特币块高算
  • End Height
  • Start Offset,按从符文被蚀刻的块开始算
  • End Offset

Mint

当mint开放后，任何人都能参与，需遵守Terms

Transafer

Edicts（法令）：一个符石可能包含任意数量的Edicts，一个Edicts包含Rune ID，数量，output number。Edicts按顺序处理，把符文分配给outputs

Pointer：Edicts被处理完后，没分配的符文被默认分配到第一个非OP-RETURN的output。符石里也可能会设置一个默认输出

Burning：转给OP_RETURN的output，就是烧掉了

Cenotaph（纪念碑）

符石可能会因各种原因而出错，比如无法识别的错误格式等。这种错误的符石被称为纪念碑

• 发送到纪念碑的符文会被烧掉。
• 如果是蚀刻交易，则这种符文无法mint
• 如果是mint交易，则它计入上限，但mint出来的符文立刻被烧掉了

纪念碑可以被用作一种协议升级机制，因此新的协议上可以看到符文的用途，而运行旧协议的，会认为被烧掉了。

规范：符文没有规范

符文的实现参考代码：ord，就是符文的规范，它没有文本规范

符石数据结构

解析流程

1. 找到tx的output中的第一个以OP_RETURN OP_13开头的解锁脚本。
2. 从有效负载中解码128位的LEB128数据，把数据解析为untyped msg
3. 把数据解释为符石，解码出错就变成纪念碑

Edict里的RuneId里的区块高度和输出index都是按相对数字来编码的（应该是为了省空间）。 Edict rune ID的解码中，块高是从base高度（84000）开始的，交易的index是从0开始。

所以Edict必须以Rune ID排序（要不就没法节省空间了）。

例如一笔交易里有如下Edict：

先按block和tx的index排序：

然后按相对位置方式编码：

解析符石时，需要使用下面这些tag：

这些tag是按奇偶分组的，无法识别的奇数tag会被忽略，甚至无法识别的tag会产生纪念碑。 所有未使用的tag做保留，且不得使用。

• Body，作为field的结尾，其后面的内容被解释为法令edicts
• Flag，它的值：1 << FLAG_VALUE

• • Etching：表示这个tx包含一个etching（蚀刻）
  • Terms：表示这个tx的etching中有Terms（能open mint)
  • Turbo：这个etching采用未来的协议更新，这可能会增加轻客户端的验证成本。
  • Cenotaph：无法识别.如果删除能识别标志后，标志字段的值不为零，则这个符石是纪念碑

• Rune:要铭刻的符文的名字。如果有设置Etching flag，但没设置Rune，则使用默认名字。

• Premine：要预挖的数量

• Cap：允许mint的次数的上限

• Amount：每次mint能收到的数量

• HeightStart和HeightEnd：允许mint的BTC区块块高上下限

• OffsetStart和OffsetEnd：允许mint的BTC区块，计数方式为从铭刻的那个块高开始。

• Mint：包含本次mint的符文的ID

• Pointer：未被edicts指定的符文要被transfer到哪个output。如果这个位没有，则未被指定的符文会被transfer到第一个非OP_RETURN的输出

• Cenotaph：不识别

• Divisibility：十进制的小数点，例如1234，如果Divisibility是2，那就是12.34

• Spacers:名字的分隔符。表示从最低有效位开始，是否在符文名字从左往右第N和N+1之间现实分隔符.例如AAAA: (没太看懂，怎么区分11是3，还是1，1?)\

• Symbol：用Unicode表示的符文符号
• Nop：无法识别

Etch

名字：

名字的编码方式：

然后持续...

AAAAAAAAAAAAAAAAAAAAAAAAAAA及更高的名字被保留用作自动名字：

如果没指定名字，则会产生一个自动的： fn reserve(block: u64, tx: u32) -> Rune {

Rune(

6402364363415443603228541259936211926

+ (u128::from(block) << 32 | u128::from(tx))

)

}

上面6402364363415443603228541259936211926就是AAAAAAAAAAAAAAAAAAAAAAAAAAA

符文协议从840000块开始激活，最初13位到上面保留名字之间的被解锁（也就是可以etch)。此后，每17,500个区块周期，不断解锁下一个最短长度的符文名称。因此，在区块 840,000 和区块 857,500 之间，十二字符符文名称被解锁，在区块 857,500 和区块 875,000 之间，十一个字符符文名称被解锁，以此类推，直到区块之间一字符符文名称被解锁。

防抢跑

为了防止抢跑交易，即把别人要etch的，已经发出来但还没被打包的交易给抢跑了，需要在etch时必须包含一个承诺（在输入的utxo里）。这个承诺是个TapScript （花费掉一个utxo），它的解锁脚本包含符文名称的data push，小端编码，省略后面的0；它要花费的utxo已经至少有6个确认。

Mint

可以在符石里mint位包含Rune ID来mint一个符文。

如果Mint开放，则Mint Amount将添加到交易input中的未分配符文中。这些符文可以使用edict进行转移，否则将被转移到第一个非 OP_RETURN output，或由Point指定的输出。

Mint可以在雕刻后的任何交易中进行，包括同一个区块内。需符合Term规定

Transfer

Transfer通过edict进行：

一个符石可以包含任意数量edict，按顺序处理。

输入的符文是unlocated，每个edict把unlocated符文变成located。

如果一个edict要分配的符文，比剩下的未分配符文要多，那实际分配的就是当前未分配数量。

因为一个符文在上链之前，不知道block和tx的index，所以如果要在铭刻这个符文的交易里表示这个符文，就用0:0作为其ID

如果一个edict的amount是0，则它会把当前rune ID的所有剩下的符文都分配出去。

如果一个edict的output等于该tx的output数量，则它会把amount分配个每个非OP_RETURN的output （OP_RETURN也计入output数量吗？）

一个Amount为零且output等于交易output数量的edict会将ID的所有未分配单位分配给每个非 OP_RETURN 输出。如果未分配的符文数量不能被非 OP_RETURN 输出的数量整除，那么多余的 符文将被分配给第 R 个非 OP_RETURN 输出，其中 R 是未分配的符文ID单位的余数除以非 OP_RETURN 输出的数量后的余数。

如果edict里，id的block是0而index是非0，或output大于tx的output数量，则这是个纪念碑。

一些例子：

runealpha.xyz

etching:

https://runealpha.xyz/txs/de52156262b35b9c741ecb4ba4ef5e31d55b97c5c9190d576a13bd29799d4a3b

mint：

https://runealpha.xyz/txs/3578c086c9b4acc900cd69f28d3af4da7a81e3a2e074244190da3e3d7d1d235c

Transfer：

https://runealpha.xyz/txs/6acff1810abfa3a78687df5b188ea0836a8173c81c368a231ecc2c2f75cf11a2

直接把拥有符文的utxo转账，输出在第一个非OP_RETURN的output

https://runealpha.xyz/txs/63b416898452e859fb1d5f06162ba93936b962d990183f845f7b62f14b298c73

把一个符文拆分，通过OP_RETURN规定拆出的量和output index，剩下的在第一个非OP_RETURN的output里。