feature: encode & decode example

Author: decentraldev1

BTC/Psbt/encode.md

@@ -27,3 +27,112 @@ PSBT的编码过程包括将交易的各个部分转换成可序列化的格式
 2. **反序列化数据**：解析字节流，根据PSBT的键值对结构恢复出每个部分的数据。
 3. **重建交易信息**：使用解码的数据重建完整的交易视图，包括所有输入和输出的详细信息。
 4. **验证和签名**：在交易数据完全恢复后，参与者可以验证交易的有效性，并在必要时添加自己的签名。
+
+## PSBT 创建
+以下是一个使用JavaScript和`bitcoinjs-lib`库来处理PSBT（Partially Signed Bitcoin Transaction）的基本示例。这个例子展示了如何创建一个PSBT，添加输入和输出，进行签名，并最终导出为可以广播的比特币交易。
+
+### 环境设置
+
+首先，你需要确保已经安装了`bitcoinjs-lib`。如果尚未安装，可以通过npm进行安装：
+
+```bash
+npm install bitcoinjs-lib
+```
+
+### 创建和签名PSBT的案例
+
+```javascript
+const bitcoin = require('bitcoinjs-lib');
+
+// 设置网络，这里以比特币测试网为例
+const network = bitcoin.networks.testnet;
+
+// 创建一个新的比特币密钥对
+const keyPair = bitcoin.ECPair.makeRandom({ network: network });
+const { address } = bitcoin.payments.p2pkh({ pubkey: keyPair.publicKey, network: network });
+
+console.log(`New address: ${address}`);
+
+// 创建一个新的PSBT
+let psbt = new bitcoin.Psbt({ network: network });
+
+// 假设这是UTXO的详细信息，你需要从区块链或钱包获取这些信息
+const utxo = {
+    hash: 'transaction-hash-of-utxo-here',  // 事务哈希
+    index: 0,                               // 输出索引
+    value: 100000                           // Satoshis
+};
+
+// 添加输入，这里假设UTXO已经知道
+psbt.addInput({
+    hash: utxo.hash,
+    index: utxo.index,
+    nonWitnessUtxo: Buffer.from('raw-transaction-hex-here', 'hex')
+});
+
+// 添加输出，指定接收地址和金额（satoshis）
+psbt.addOutput({
+    address: 'recipient-address-here',
+    value: 90000  // 减去手续费
+});
+
+// 对PSBT进行签名
+psbt.signInput(0, keyPair);
+
+// 验证签名是否正确
+psbt.validateSignaturesOfInput(0);
+
+// 最终确认PSBT
+psbt.finalizeAllInputs();
+
+// 导出可以广播的交易
+const tx = psbt.extractTransaction().toHex();
+
+console.log(`Transaction ready to be broadcasted: ${tx}`);
+```
+
+### 解释
+
+1. **初始化**：首先创建一个比特币网络的环境，并生成一个新的密钥对和地址。
+2. **创建PSBT**：实例化一个PSBT对象，为添加输入和输出做准备。
+3. **添加输入**：添加一个UTXO作为输入。这通常需要事务的原始数据，这里使用`nonWitnessUtxo`字段传入原始交易的hex字符串。
+4. **添加输出**：添加一个输出，指定收款地址和金额。
+5. **签名**：使用私钥对输入进行签名。
+6. **验证签名**：验证输入的签名是否有效。
+7. **完成PSBT**：完成所有输入，锁定PSBT，使之准备好转换为最终的交易格式。
+8. **导出交易**：将PSBT转换为一个标准的比特币交易，并将其转换为hex格式，准备广播到网络。
+
+
+## PSBT 解析
+要解析PSBT（Partially Signed Bitcoin Transaction）并查看其详细内容，你可以使用`bitcoinjs-lib`库在JavaScript环境中执行这一任务。下面的示例将展示如何读取一个PSBT，解析其内容，以及如何查看关键信息，如输入和输出详情。
+
+### 示例：解析PSBT
+
+```javascript
+const bitcoin = require('bitcoinjs-lib');
+
+// 假设这是一个已经存在的PSBT的Base64编码字符串
+const psbtBase64 = 'cHNidP8BAHECAAAAAZtuEiavDmeZR6WUjIhjFbkFh7m+yywCfHlni6uTrgH/////AZD+GwAAAAAAF6kU9BeD5tGIzjL0VzU3+kEUNw+HME3/////8C0wbdQAAAAAAF6kUAAAAAAAAiACATWsYQSE/C85hv5jZVDezl0l4AAAAAAAEBKxAnAAAAAAAAFgAUjVv8Fy0Qdk84W/oBhiMllC+HIHg=';
+
+// 将Base64编码的PSBT解码
+const psbt = bitcoin.Psbt.fromBase64(psbtBase64);
+
+// 遍历PSBT的输入和输出
+psbt.data.inputs.forEach((input, index) => {
+    console.log(`Input ${index}:`);
+    console.log(input);
+});
+
+psbt.data.outputs.forEach((output, index) => {
+    console.log(`Output ${index}:`);
+    console.log(output);
+});
+
+// 如果需要更详细地查看某个特定的输入或输出，可以根据实际需要提取更多信息
+```
+
+### 解释
+
+1. **解码PSBT**：首先使用`bitcoinjs-lib`的`Psbt.fromBase64`方法将Base64编码的PSBT字符串解码成一个PSBT对象。
+2. **遍历输入和输出**：通过访问`psbt.data.inputs`和`psbt.data.outputs`数组，可以查看每个输入和输出的详细信息。这包括UTXO信息、脚本、签名等。
+3. **打印信息**：在控制台打印每个输入和输出的详细信息，这有助于开发者理解和调试PSBT。