{"content":{"title":"【源码讲解】Ordinals Inscription铸造过程解析","body":"作者：团长（<https://twitter.com/quentangle_>）\r\n\r\n我们直接从代码层面来看看一个Ordinals Inscription的交易过程是怎样的。首先我们需要明确一些概念:\r\n\r\n* OutPoint\r\n\r\n比特币中的交易是基于 UTXO（未花费的交易输出）模型构建的，这意味着每个交易输出都有一个唯一的 OutPoint，可以被引用作为未来交易输入的来源。当一个交易被确认后，它的输出被解锁，并成为新的未花费的交易输出，可以被之后的交易引用。所以OutPoint是一个引用之前交易中的一个输出的结构体，它由两个字段组成：\r\n\r\n1. `TxHash`：这是一个 32 字节的哈希值，表示之前交易的哈希值。\r\n2. `Index`：这是一个 4 字节的整数，表示之前交易中的对应输出的索引。\r\n\r\n* SatPoint\r\n\r\nOrdinals协议通过对比特币的最小单位进行编号来实现对每一个单位进行区分，而所有Satoshi都是通过UTXO实现的，SatPoint就是在UTXO上定义不同的sat，它的结构是：\r\n\r\n1. `OutPoint` 即上面定时的输出点\r\n2. `offset` 在输出点之上的偏移量\r\n\r\n通过OutPoint和offset，就能唯一的定位到任何一个sat。\r\n\r\n\\#1 首先需要准备铸造的内容和可以用的utxo\r\n\r\n```rust\r\nlet inscription = Inscription::from_file(options.chain(), &self.file)?;\r\nlet mut utxos = index.get_unspent_outputs(Wallet::load(&options)?)?;\r\n```\r\n\r\n\\#2 接下来就是构建铭文交易，用到的参数有：\r\n\r\n```rust\r\nsatpoint: Option<SatPoint>, // 指定铭文所在的OutPoint，如果不指定则会中utxo中选取\r\ninscription: Inscription, // 铭文内容\r\ninscriptions: BTreeMap<SatPoint, InscriptionId> // 用于检查satpoint是否已经有铭文铸造\r\nnetwork: Network, // 比特币网络\r\nBTreeMap<OutPoint, Amount> // utxo\r\nchange: [Address; 2] // 找零地址\r\ndestination: Address, // 目标地址\r\ncommit_fee_rate: FeeRate, // commit交易费率\r\nreveal_fee_rate: FeeRate, // reveal交易费率\r\nno_limit: bool, // 设置为默认值即可\r\n```\r\n\r\n铭文交易是由两部分构成`commit_tx`和`reveal_tx`。其中`commit_tx`用于提交锁定脚本，`reveal_tx`用于揭示脚本内容。\r\n\r\n详细来讲：由于自来taproot脚本的花费只能从现有的taproot输出中进行，所以铭文是用一个两阶段的提交commit/揭示reveal程序来进行的。首先，在Commit交易中，创建了一个提交给包含铭文内容的脚本的taproot输出。其次，在reveal交易中，由commit交易创建的输出被花费，揭示链上的铭文内容。\r\n\r\n比特币基于UTXO的交易模型有一个特点，就是在输出方，只会包含证明，这个证明可以是公钥哈希（P2PKH），也可以是脚本哈希（P2SH），在ordinals交易中是（P2TR）。而验证的过程是会放在输入方一侧，也就是在花费的时候去验证。所以构建真正的Ordinals数据内容是在reveal脚本中可以查看到。比如在这笔交易（`fcd5e53300cafa578c79c79a4718642fde25c8da9cdf88eb6af0dff4df2c5801`）中，input中的witness字段包含有铭文内容，而这个花费的来源则是上一笔普通的交易的输出：\r\n\r\n![](https://miro.medium.com/v2/resize:fit:1400/format:webp/1\\*dqM71GvvyM9PNGeJAw_T1w.png)\r\n\r\n![](https://miro.medium.com/v2/resize:fit:1400/format:webp/1\\*2GNMnl0zP9n1c2wZPfOPTg.png)\r\n\r\n这个方法的返回值就是两个交易变量和构建taproot交易产生的密钥`(unsigned_commit_tx, reveal_tx, recovery_key_pair)`\r\n\r\n\\#3 `create_inscription_transactions` 我们来看一下创建铭文的交易中的逻辑。首先需要获得一个SatPoint，也就是铭文所在的OutPoint。\r\n\r\n```\r\nlet satpoint = if let Some(satpoint) = satpoint {\r\n    satpoint // 如果参数中指定则直接使用\r\n  } else {   // 如果没有指定则在UTXO中获得一个不包含铭文的OutPoint\r\n    let inscribed_utxos = inscriptions\r\n      .keys()\r\n      .map(|satpoint| satpoint.outpoint)\r\n      .collect::<BTreeSet<OutPoint>>();\r\n    utxos\r\n      .keys()\r\n      .find(|outpoint| !inscribed_utxos.contains(outpoint))\r\n      .map(|outpoint| SatPoint {\r\n        outpoint: *outpoint,\r\n        offset: 0,\r\n      })\r\n      .ok_or_else(|| anyhow!(\"wallet contains no cardinal utxos\"))?\r\n  };\r\n```\r\n\r\n\\#4 接下来需要检查这个OutPoint是否铭刻过：\r\n\r\n```\r\nfor (inscribed_satpoint, inscription_id) in &inscriptions {\r\n    if inscribed_satpoint == &satpoint {\r\n      return Err(anyhow!(\"sat at {} already inscribed\", satpoint));\r\n    }\r\n    if inscribed_satpoint.outpoint == satpoint.outpoint {\r\n      return Err(anyhow!(\r\n        \"utxo {} already inscribed with inscription {inscription_id} on sat {inscribed_satpoint}\",\r\n        satpoint.outpoint,\r\n      ));\r\n    }\r\n  }\r\n```\r\n\r\n\\#5 接下来获取一个`secp256k1`的密钥对，用来构建`reveal_tx`:\r\n\r\n```\r\nlet secp256k1 = Secp256k1::new();\r\nlet key_pair = UntweakedKeyPair::new(&secp256k1, &mut rand::thread_rng());\r\nlet (public_key, _parity) = XOnlyPublicKey::from_keypair(&key_pair);\r\n```\r\n\r\n\\#6 接下来重头戏，构建reveal脚本，铭文内容就是写在这个脚本里面。需要先创建一个脚本构建者`script::Builder`。这个builder需要首先包含基础的转账交易内容：\r\n\r\n```\r\nscript::Builder::new()\r\n  .push_slice(&public_key.serialize()) // 上一步的创建的密钥对中的公钥\r\n  .push_opcode(opcodes::all::OP_CHECKSIG)\r\n```\r\n\r\n\\#7 然后需要将铭文内容以Ordinals协议定义的格式写入到脚本中：\r\n\r\n```\r\nbuilder = builder\r\n  .push_opcode(opcodes::OP_FALSE)\r\n  .push_opcode(opcodes::all::OP_IF)\r\n  .push_slice(PROTOCOL_ID); // b\"ord\"\r\n\r\nif let Some(content_type) = &self.content_type {\r\n  builder = builder\r\n    .push_slice(CONTENT_TYPE_TAG)\r\n    .push_slice(content_type);\r\n}if let Some(body) = &self.body {\r\n  builder = builder.push_slice(BODY_TAG);\r\n  for chunk in body.chunks(520) {\r\n    builder = builder.push_slice(chunk);\r\n  }\r\n}builder.push_opcode(opcodes::all::OP_ENDIF)\r\n```\r\n\r\n这里的脚本构建过程就是[Ordinals文档](https://docs.ordinals.com/inscriptions.html)中定义的格式写入到脚本中：\r\n\r\n```\r\nOP_FALSE\r\nOP_IF\r\n  OP_PUSH \"ord\"  // PROTOCOL_ID\r\n  OP_1\r\n  OP_PUSH \"text/plain;charset=utf-8\" // content_type\r\n  OP_0\r\n  OP_PUSH \"Hello, world!\"   // body\r\nOP_ENDIF\r\n```\r\n\r\n\\#8 接下来需要构建taproot花费脚本（taproot spend script），将刚才构造的reveal脚本添加到脚本的leaf上\r\n\r\n```\r\nlet taproot_spend_info = TaprootBuilder::new()\r\n  .add_leaf(0, reveal_script.clone())\r\n  .expect(\"adding leaf should work\")\r\n  .finalize(&secp256k1, public_key)\r\n  .expect(\"finalizing taproot builder should work\");\r\n\r\nlet control_block = taproot_spend_info\r\n  .control_block(&(reveal_script.clone(), LeafVersion::TapScript))\r\n  .expect(\"should compute control block\");\r\n```\r\n\r\n\\#9 接下来需要从这个花费脚本中获得tweaked key。当一个 Taproot 交易被广播到比特币网络中时，它需要提供一个用于验证的公钥。这个公钥被称为“Taproot 输出公钥”（output public key），它是通过对 Taproot 花费脚本的公钥进行调整（tweak keypair）生成的。这个调整的过程使用一个随机数（tweak）进行计算，从而生成一个新的公钥。这个新的公钥与传统的公钥相比，具有更高的隐私和灵活性，因为它可以根据不同的条件和限制生成不同的公钥，这是属于shnorr签名的内容，想要详细了解这部分内容请参阅文末的参考链接。\r\n\r\n```\r\nlet commit_tx_address = Address::p2tr_tweaked(taproot_spend_info.output_key(), network);\r\n```\r\n\r\n\\#10 接下来是计算reveal交易的费用，由于只是计算费用，不实际构建交易，所以参数中的input传入的是空的OutPoint。\r\n\r\n```\r\nlet (_, reveal_fee) = Self::build_reveal_transaction(\r\n  &control_block,\r\n  reveal_fee_rate,\r\n  OutPoint::null(), // null input\r\n  TxOut {\r\n    script_pubkey: destination.script_pubkey(),\r\n    value: 0,\r\n  },\r\n  &reveal_script,\r\n);\r\n```\r\n\r\n\\#11 接下来是用上面几步得到的一些参数构建commit交易：\r\n\r\n```\r\nlet unsigned_commit_tx = TransactionBuilder::build_transaction_with_value(\r\n  satpoint,     // from #3 \r\n  inscriptions, // function input param\r\n  utxos,        // function input param\r\n  commit_tx_address.clone(), // from #9\r\n  change,       // function input param\r\n  commit_fee_rate, // function input param\r\n  reveal_fee +  // from #10\r\n  TransactionBuilder::TARGET_POSTAGE, // 交易转账数额\r\n)?;\r\n```\r\n\r\n\\#12 commit交易是reveal的交易的输入，reveal交易会解锁commit交易的脚本，所以我们可以利用commit交易来构建reveal交易：\r\n\r\n```\r\nlet (vout, output) = unsigned_commit_tx\r\n  .output\r\n  .iter()\r\n  .enumerate()\r\n  .find(|(_vout, output)| output.script_pubkey == commit_tx_address.script_pubkey())\r\n  .expect(\"should find sat commit/inscription output\");\r\n\r\nlet (mut reveal_tx, fee) = Self::build_reveal_transaction(\r\n  &control_block, // from #8\r\n  reveal_fee_rate, // from #10\r\n  OutPoint { // real input outpoint(utxo)\r\n    txid: unsigned_commit_tx.txid(),\r\n    vout: vout.try_into().unwrap(),\r\n  },\r\n  TxOut {\r\n    script_pubkey: destination.script_pubkey(),\r\n    value: output.value, // real output value, which is reveal_fee + TARGET_POSTAGE\r\n  },\r\n  &reveal_script,\r\n);\r\n```\r\n\r\n\\#13 下面需要对`reveal_tx`进行数量检查，确定`commit_tx`提供的费用超过dust最低值并且足够支持交易费和：\r\n\r\n```\r\nreveal_tx.output[0].value = reveal_tx.output[0]\r\n  .value\r\n  .checked_sub(fee.to_sat())\r\n  .context(\"commit transaction output value insufficient to pay transaction fee\")?;\r\nif reveal_tx.output[0].value < reveal_tx.output[0].script_pubkey.dust_value().to_sat() {\r\n  bail!(\"commit transaction output would be dust\");\r\n}\r\n```\r\n\r\n\\#14 下面需要计算签名哈希\r\n\r\n```\r\nlet mut sighash_cache = SighashCache::new(&mut reveal_tx);\r\nlet signature_hash = sighash_cache\r\n  .taproot_script_spend_signature_hash(\r\n    0,\r\n    &Prevouts::All(&[output]),\r\n    TapLeafHash::from_script(&reveal_script, LeafVersion::TapScript),\r\n    SchnorrSighashType::Default,\r\n  )\r\n  .expect(\"signature hash should compute\");let signature = secp256k1.sign_schnorr(\r\n  &secp256k1::Message::from_slice(signature_hash.as_inner())\r\n    .expect(\"should be cryptographically secure hash\"),\r\n  &key_pair,\r\n);\r\n```\r\n\r\n\\#15 将签名哈希推入见证数据\r\n\r\n```\r\nlet witness = sighash_cache\r\n  .witness_mut(0)\r\n  .expect(\"getting mutable witness reference should work\");\r\nwitness.push(signature.as_ref());\r\nwitness.push(reveal_script);\r\nwitness.push(&control_block.serialize());\r\n```\r\n\r\n\\#16 最后，用钱包对`commit_tx`进行签名，然后吧`commit_tx`和`reveal_tx`发送到`btc`节点即可\r\n\r\n```\r\nlet signed_raw_commit_tx = client\r\n  .sign_raw_transaction_with_wallet(&unsigned_commit_tx, None, None)?\r\n  .hex;\r\nlet commit = client\r\n  .send_raw_transaction(&signed_raw_commit_tx)\r\n  .context(\"Failed to send commit transaction\")?;let reveal = client\r\n  .send_raw_transaction(&reveal_tx)\r\n  .context(\"Failed to send reveal transaction\")?;\r\n```\r\n\r\n总结（by Notion AI）：\r\n\r\n这个文档介绍了使用 Ordinals 协议铸造铭文的过程。铭文是一段文本或数据，可以通过 Ordinals 协议对其进行编号，然后将其铸造成比特币的未花费交易输出。在铭文交易中，commit_tx 用于提交锁定脚本，reveal_tx 用于揭示脚本内容。铭文交易是由两部分构成的，其中 reveal 脚本包含了铭文内容。\r\n\r\n铭文交易的构建过程包含以下步骤：\r\n\r\n1. 准备铸造的内容和可用的 UTXO。\r\n2. 构建铭文交易，包括 commit_tx 和 reveal_tx。\r\n3. 创建一个 SatPoint，也就是铭文所在的 OutPoint。\r\n4. 检查这个 OutPoint 是否已经铭刻过。\r\n5. 获取一个 secp256k1 的密钥对，用于构建 reveal_tx。\r\n6. 构建 reveal 脚本，将铭文内容写入其中。\r\n7. 构建 Taproot 花费脚本（taproot spend script），将 reveal 脚本添加到脚本的 leaf 上。\r\n8. 从花费脚本中获取 tweaked key。\r\n9. 计算 reveal 交易的费用。\r\n10. 构建 commit 交易。\r\n11. 用 commit 交易构建 reveal 交易。\r\n12. 对 reveal 交易进行数量检查。\r\n13. 计算签名哈希。\r\n14. 将签名哈希推入 witness 数据。\r\n15. 用钱包对 commit_tx 进行签名，发送 commit_tx 和 reveal_tx 到比特币网络。\r\n\r\n铭文交易的构建过程非常复杂，需要涉及到多个参数和计算，但是这个过程也非常精妙和有趣。\r\n\r\n***\r\n\r\n参考：\r\n\r\n[ord/inscribe.rs at master · casey/ord](https://github.com/casey/ord/blob/master/src/subcommand/wallet/inscribe.rs)\r\n\r\n[ord/inscribe.rs at master · casey/ord](https://github.com/casey/ord/blob/master/src/subcommand/wallet/inscribe.rs)\r\n\r\n[👁‍🗨 Rare and exotic sats. Contribute to casey/ord development by creating an account on GitHub.](https://github.com/casey/ord/blob/master/src/subcommand/wallet/inscribe.rs)\r\n\r\n[github.com](https://github.com/casey/ord/blob/master/src/subcommand/wallet/inscribe.rs)\r\n\r\n[Inscriptions - Ordinal Theory Handbook](https://docs.ordinals.com/inscriptions.html)\r\n\r\n[docs.ordinals.com](https://docs.ordinals.com/inscriptions.html)\r\n\r\n[More on Taproot](https://dev.to/eunovo/more-on-taproot-41g8)\r\n\r\n[In a previous article, I gave a brief intro Taproot and shared some examples utilizing Taproot...](https://dev.to/eunovo/more-on-taproot-41g8)\r\n\r\n[dev.to](https://dev.to/eunovo/more-on-taproot-41g8)\r\n\r\n[Taproot on Bitcoin](https://xiaohuiliu.medium.com/taproot-on-bitcoin-d52fce9201e4)\r\n\r\n[Taproot on Bitcoin](https://xiaohuiliu.medium.com/taproot-on-bitcoin-d52fce9201e4)\r\n\r\n[Contractless Contract + MAST](https://xiaohuiliu.medium.com/taproot-on-bitcoin-d52fce9201e4)\r\n\r\n[xiaohuiliu.medium.com](https://xiaohuiliu.medium.com/taproot-on-bitcoin-d52fce9201e4)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0114.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0114.mediawiki)\r\n\r\n[Bitcoin Improvement Proposals. Contribute to bitcoin/bips development by creating an account on GitHub.](https://github.com/bitcoin/bips/blob/master/bip-0114.mediawiki)\r\n\r\n[github.com](https://github.com/bitcoin/bips/blob/master/bip-0114.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0340.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0340.mediawiki)\r\n\r\n[Bitcoin Improvement Proposals. Contribute to bitcoin/bips development by creating an account on GitHub.](https://github.com/bitcoin/bips/blob/master/bip-0340.mediawiki)\r\n\r\n[github.com](https://github.com/bitcoin/bips/blob/master/bip-0340.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)\r\n\r\n[Bitcoin Improvement Proposals. Contribute to bitcoin/bips development by creating an account on GitHub.](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)\r\n\r\n[github.com](https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0342.mediawiki)\r\n\r\n[bips/bip-0342.mediawiki at master · bitcoin/bips](https://github.com/bitcoin/bips/blob/master/bip-0342.mediawiki)\r\n\r\n[Bitcoin Improvement Proposals. Contribute to bitcoin/bips development by creating an account on GitHub.](https://github.com/bitcoin/bips/blob/master/bip-0342.mediawiki)\r\n\r\n[github.com](https://github.com/bitcoin/bips/blob/master/bip-0342.mediawiki)\r\n\r\n[bitcoinops.org](https://bitcoinops.org/img/posts/taproot-workshop/taproot-workshop.pdf)\r\n\r\n[bitcoinops.org](https://bitcoinops.org/img/posts/taproot-workshop/taproot-workshop.pdf)"},"author":{"user":"https://learnblockchain.cn/people/320","address":null},"history":null,"timestamp":1683873066,"version":1}