Merge pull request #1207 from Daniel6075/main

feat: add OP_CAT

BTC/Advanced/OP_CAT/README.md

@@ -0,0 +1,46 @@
+`OP_CAT` 是比特币脚本中的一个操作码（opcode），它用于将两个或多个元素连接在一起。这一功能在比特币的原生脚本语言中并不存在，因此 `OP_CAT` 的引入是为了增强比特币脚本的灵活性和功能，特别是在智能合约和复杂交易的应用场景中。
+
+### `OP_CAT` 的背景和用途
+
+1. **操作码（Opcode）概述**：
+   - 比特币的脚本语言是栈式的，操作码是脚本的基本组成部分。每个操作码执行特定的功能，如加法、签名验证和数据操作等。
+   - `OP_CAT` 用于将两个栈顶元素连接（concatenate）成一个更大的元素。这对于构建复杂数据结构和处理更复杂的脚本逻辑非常有用。
+
+2. **为何需要 `OP_CAT`**：
+   - 在比特币早期的脚本语言中，没有直接的连接字符串或数据的功能。这限制了某些智能合约和复杂交易的实现。
+   - 引入 `OP_CAT` 使得开发者能够更灵活地操作和组合数据，增强了比特币脚本的表达能力。
+
+### `OP_CAT` 的功能
+
+- **连接功能**：`OP_CAT` 将两个元素从栈中取出，并将它们连接成一个新的元素。举例来说，如果栈顶的元素是字符串 "Hello" 和 "World"，执行 `OP_CAT` 后，栈顶元素将变成 "HelloWorld"。
+- **应用场景**：
+  - **智能合约**：在构建智能合约时，可以利用 `OP_CAT` 组合数据，形成更复杂的数据结构。
+  - **多签名交易**：在多签名场景中，可以将多个公钥或签名连接在一起，以便在验证时进行处理。
+  - **数据打包**：当需要将多个输入数据合并成一个输出时，`OP_CAT` 是一个重要工具。
+
+### 示例
+
+假设我们有两个元素在栈中，分别为 "Data1" 和 "Data2"。使用 `OP_CAT` 的过程如下：
+
+1. **栈状态**：
+   ```
+   Top -> Data2
+         Data1
+   ```
+
+2. **执行 `OP_CAT`**：
+   - 栈顶的两个元素 "Data1" 和 "Data2" 被取出，并连接在一起。
+
+3. **结果栈状态**：
+   ```
+   Top -> Data1Data2
+   ```
+
+### 安全性和实现
+
+- **安全性**：虽然 `OP_CAT` 增强了脚本的灵活性，但也可能引入一些复杂性。合约的开发者需要确保合约逻辑的安全性和正确性，避免潜在的漏洞。
+- **实现**：`OP_CAT` 的实现需要对比特币的脚本引擎进行修改，因此需要在比特币核心代码中进行添加和测试，确保它与现有的操作码兼容。
+
+### 结论
+
+`OP_CAT` 的引入为比特币的脚本语言增加了重要的功能，使得在智能合约和复杂交易的开发中可以更灵活地处理数据。尽管比特币的脚本设计注重安全性和简单性，但通过引入 `OP_CAT`，开发者能够实现更丰富的逻辑和应用场景。随着比特币生态系统的发展，像 `OP_CAT` 这样的操作码可能会变得越来越重要。

BTC/Advanced/OP_CAT/example/README.md

@@ -0,0 +1,60 @@
+你是对的，我在之前的示例中没有明确给出与 `OP_EQUAL` 验证的内容。在比特币脚本中，`OP_EQUAL` 用于验证栈顶两个元素是否相等。因此，我们需要在脚本中明确指定连接后的结果，并与这个结果进行比较。
+
+### 完整示例
+
+下面是一个更新后的示例，展示如何使用 `OP_CAT` 实现智能合约，并在脚本中验证连接后的结果是否等于 "HelloWorld"：
+
+```javascript
+const bitcoin = require('bitcoinjs-lib');
+
+// 创建一个包含 OP_CAT 的脚本
+function createScript() {
+    // 连接的目标结果
+    const target = Buffer.from('HelloWorld');
+
+    const script = bitcoin.script.compile([
+        bitcoin.opcodes.OP_DUP,
+        bitcoin.opcodes.OP_HASH160,
+        Buffer.from('...'), // 使用适当的公钥哈希
+        bitcoin.opcodes.OP_EQUALVERIFY,
+        bitcoin.opcodes.OP_CHECKSIG,
+        // 连接两个字符串
+        Buffer.from('Hello'), // 第一个元素
+        Buffer.from('World'),  // 第二个元素
+        bitcoin.opcodes.OP_CAT, // 连接操作
+        target, // 连接后的目标结果
+        bitcoin.opcodes.OP_EQUAL // 验证连接结果是否等于 'HelloWorld'
+    ]);
+
+    return script;
+}
+
+// 创建和打印 P2SH 地址
+function createP2SHAddress() {
+    const script = createScript();
+    const { address } = bitcoin.payments.p2sh({ redeem: { output: script, network: bitcoin.networks.bitcoin } });
+
+    console.log('P2SH Address:', address);
+}
+
+createP2SHAddress();
+```
+
+### 代码解析
+
+1. **连接后的目标结果**：
+   - 我们定义了一个 `target` 变量，表示连接后的目标结果 `HelloWorld`。在脚本中，我们将这个目标结果与连接后的结果进行比较。
+
+2. **脚本逻辑**：
+   - `OP_CAT` 将 `Buffer.from('Hello')` 和 `Buffer.from('World')` 连接起来，结果是 `HelloWorld`。
+   - 然后，`target`（即 `HelloWorld`）被推入栈中。
+   - 最后，`OP_EQUAL` 用于检查连接的结果是否与 `target` 相等。
+
+### 注意事项
+
+- **脚本验证**：在比特币的环境中，脚本通常是在执行交易时被验证。因此，这段脚本需要在合适的环境中进行测试。
+- **公钥哈希**：在实际应用中，`Buffer.from('...')` 应替换为实际的公钥哈希。
+
+### 结论
+
+现在这个脚本清楚地验证了连接后的结果是否与预期值 `HelloWorld` 相等。这种方式展示了如何在比特币脚本中使用 `OP_CAT` 进行数据连接和验证。虽然比特币的脚本语言有一定的限制，但通过合理组合操作码，依然可以实现复杂的逻辑。

BTC/Advanced/OP_CAT/example/index.js

@@ -0,0 +1,33 @@
+const bitcoin = require('bitcoinjs-lib');
+
+// 创建一个包含 OP_CAT 的脚本
+function createScript() {
+    // 连接的目标结果
+    const target = Buffer.from('HelloWorld');
+
+    const script = bitcoin.script.compile([
+        bitcoin.opcodes.OP_DUP,
+        bitcoin.opcodes.OP_HASH160,
+        Buffer.from('...'), // 使用适当的公钥哈希
+        bitcoin.opcodes.OP_EQUALVERIFY,
+        bitcoin.opcodes.OP_CHECKSIG,
+        // 连接两个字符串
+        Buffer.from('Hello'), // 第一个元素
+        Buffer.from('World'),  // 第二个元素
+        bitcoin.opcodes.OP_CAT, // 连接操作，必须在两个字符串之后
+        target, // 连接后的目标结果
+        bitcoin.opcodes.OP_EQUAL // 验证连接结果是否等于 'HelloWorld'
+    ]);
+
+    return script;
+}
+
+// 创建和打印 P2SH 地址
+function createP2SHAddress() {
+    const script = createScript();
+    const { address } = bitcoin.payments.p2sh({ redeem: { output: script, network: bitcoin.networks.bitcoin } });
+
+    console.log('P2SH Address:', address);
+}
+
+createP2SHAddress();