V6.0.0

- Added support for BIP-327: MuSig2 for BIP340-compatible multi-signatures
- Implemented BIP-174: Partially Signed Bitcoin Transaction (PSBT) format
- Integrated BIP-370: PSBT Version 2 enhancements
- Included BIP-371: Taproot fields for PSBT
- Extended support for BIP-373: MuSig2-related PSBT fields

Author: mrtnetwork

CHANGELOG.md

@@ -1,3 +1,11 @@
+## 6.0.0
+
+- Added support for BIP-327: MuSig2 for BIP340-compatible multi-signatures
+- Implemented BIP-174: Partially Signed Bitcoin Transaction (PSBT) format
+- Integrated BIP-370: PSBT Version 2 enhancements
+- Included BIP-371: Taproot fields for PSBT
+- Extended support for BIP-373: MuSig2-related PSBT fields
+
 ## 5.3.0
 
 * Update dependencies

README.md

@@ -80,6 +80,21 @@ Using this package, you can create a Bitcoin transaction in two ways: either thr
 
 - P2SH(SEGWIT): A P2SH (Pay-to-Script-Hash) Segregated Witness (SegWit) address in Bitcoin combines the benefits of P2SH and SegWit technologies, allowing for enhanced transaction security, reduced fees, and improved scalability.
 
+### MuSig2 BIP-327: MuSig2 for BIP340-compatible Multi-Signatures
+  You can find the examples here.
+
+ - Sign/Verify: Supports signing and verifying multisignature transactions using MuSig2
+ - NonceAgg: Aggregates nonces from multiple participants for secure signature generation.
+ - KeyAgg: Combines multiple public keys into a single aggregated public key for efficient multisignature verification
+
+### PSBT
+  You can find the examples here.
+
+- BIP-0174: Partially Signed Bitcoin Transaction Format
+- BIP-0370: PSBT Version 2
+- BIP-0371: Taproot Fields for PSBT
+- BIP-0373: MuSig2 PSBT Fields
+
 ### Addresses specific to Bitcoin Cash
 
 - P2SH32: Pay to Script Hash 32

example/lib/bitcoin_cash/burn_token_example.dart

@@ -61,8 +61,7 @@ void main() async {
   if (sumOfUtxo == BigInt.zero) {
     return;
   }
-  // print(sumOfUtxo);
-  // return;
+
   /// CashToken{bitfield: 16, commitment: null, amount: 2000, category: 4e7873d4529edfd2c6459139257042950230baa9297f111b8675829443f70430}
   final CashToken token = elctrumUtxos
       .firstWhere((e) =>

example/lib/bitcoin_cash/create_cash_token_example.dart

@@ -64,8 +64,6 @@ void main() async {
     /// if we dont have utxos with index 0 we must create them with some estimate transaction before create transaction
     return;
   }
-  // print("vout $vout0Hash");
-  // return;
   final bchTransaction = ForkedTransactionBuilder(
       outPuts: [
         BitcoinTokenOutput(

example/lib/global/old_examples/bitcoin_example.dart

@@ -181,7 +181,7 @@ void _spendFromP2pkhTo10DifferentType() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   /// https://mempool.space/testnet/tx/05411dce1a1c9e3f44b54413bdf71e7ab3eff1e2f94818a3568c39814c27b258
@@ -427,7 +427,7 @@ void _spendFrom10DifferentTypeToP2pkh() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   /// https://mempool.space/testnet/tx/3e697e0993a6882689ff9b66ff73cdf53e4a3029664ec4a516da2b291e1cd8a6

example/lib/global/old_examples/litecoin_example/litecoin_example.dart

@@ -141,7 +141,7 @@ void _spendLTCP2pkhAddress() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   await _broadcastTransaction(tr.serialize());
@@ -287,7 +287,7 @@ void _spendFrom2P2shAddressAndOneMultiSigP2shAddress() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   await _broadcastTransaction(tr.serialize());
@@ -399,7 +399,7 @@ void _spendFromNestedSegwitP2WPKHInP2SH() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   await _broadcastTransaction(tr.serialize());
@@ -519,7 +519,7 @@ void _spendFromSegwitP2WPKHAddress() async {
   /// Calculate the size of the transaction in bytes.
   /// You can determine the transaction fee by multiplying the transaction size
   /// Formula: transaction fee = (transaction size in bytes * fee rate in bytes)
-  final size = tr.hasSegwit ? tr.getVSize() : tr.getSize();
+  final size = tr.hasWitness ? tr.getVSize() : tr.getSize();
 
   /// broadcast transaction
   await _broadcastTransaction(tr.serialize());

example/lib/global/old_examples/spending_with_scripts/spending_builders.dart

@@ -32,8 +32,7 @@ BtcTransaction buildP2wpkTransaction({
 
   // create BtcTransaction instance with inputs, outputs and segwit
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, we need to set 'hasSegwit' to true.
-  BtcTransaction tx =
-      BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: true);
+  BtcTransaction tx = BtcTransaction(inputs: txin, outputs: txOut);
 
   for (int i = 0; i < txin.length; i++) {
     // For SegWit transactions (excluding P2TR), we use the 'getTransactionSegwitDigit' method
@@ -47,7 +46,7 @@ BtcTransaction buildP2wpkTransaction({
         amount: utxo[i].utxo.value);
     // sign transaction
     final signedTx =
-        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.SIGHASH_ALL);
+        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.sighashAll);
 
     // create unlock script
 
@@ -98,8 +97,7 @@ BtcTransaction buildP2WSHTransaction({
 
   // create BtcTransaction instance with inputs, outputs and segwit
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, we need to set 'hasSegwit' to true.
-  BtcTransaction tx =
-      BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: true);
+  BtcTransaction tx = BtcTransaction(inputs: txin, outputs: txOut);
   for (int i = 0; i < txin.length; i++) {
     // For SegWit transactions (excluding P2TR), we use the 'getTransactionSegwitDigit' method
     // to obtain the input digest for signing.
@@ -113,7 +111,7 @@ BtcTransaction buildP2WSHTransaction({
 
     // sign transaction
     final signedTx = sign(txDigit, utxo[i].public().toP2wshScript().toHex(),
-        BitcoinOpCodeConst.SIGHASH_ALL);
+        BitcoinOpCodeConst.sighashAll);
 
     // create unlock script
 
@@ -156,7 +154,7 @@ BtcTransaction buildP2pkhTransaction({
       .toList();
 
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, in this case we need to set 'hasSegwit' to false.
-  final tx = BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: false);
+  final tx = BtcTransaction(inputs: txin, outputs: txOut);
   for (int i = 0; i < txin.length; i++) {
     // For None-SegWit transactions, we use the 'getTransactionDigest' method
     // to obtain the input digest for signing.
@@ -169,7 +167,7 @@ BtcTransaction buildP2pkhTransaction({
 
     // sign transaction
     final signedTx =
-        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.SIGHASH_ALL);
+        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.sighashAll);
 
     // set unlocking script for current index
     txin[i].scriptSig = Script(script: [signedTx, utxo[i].public().toHex()]);
@@ -202,7 +200,7 @@ BtcTransaction buildP2shNoneSegwitTransaction({
       .toList();
 
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, in this caase we need to set 'hasSegwit' to false.
-  final tx = BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: false);
+  final tx = BtcTransaction(inputs: txin, outputs: txOut);
   for (int i = 0; i < txin.length; i++) {
     final ownerPublic = utxo[i].public();
     final scriptPubKey =
@@ -219,7 +217,7 @@ BtcTransaction buildP2shNoneSegwitTransaction({
     );
     // sign transaction
     final signedTx =
-        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.SIGHASH_ALL);
+        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.sighashAll);
 
     // set unlocking script for current index
     switch (utxo[i].ownerDetails.address.type) {
@@ -269,7 +267,7 @@ BtcTransaction buildP2SHSegwitTransaction({
   final List<TxWitnessInput> witnesses = [];
 
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, we need to set 'hasSegwit' to true.
-  final tx = BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: true);
+  final tx = BtcTransaction(inputs: txin, outputs: txOut);
 
   for (int i = 0; i < txin.length; i++) {
     final ownerPublic = utxo[i].public();
@@ -290,7 +288,7 @@ BtcTransaction buildP2SHSegwitTransaction({
 
     // sign transaction
     final signedTx =
-        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.SIGHASH_ALL);
+        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.sighashAll);
 
     // In a SegWit P2SH (Pay-to-Script-Hash) transaction, you will find both a scriptSig field and a witness field.
     //  This combination is used to maintain compatibility with non-SegWit Bitcoin nodes while taking advantage
@@ -347,8 +345,7 @@ BtcTransaction buildP2trTransaction({
       .toList();
 
   // For P2TR, P2WPKH, P2WSH, and P2SH (SegWit) transactions, we need to set 'hasSegwit' to true.
-  BtcTransaction tx =
-      BtcTransaction(inputs: txin, outputs: txOut, hasSegwit: true);
+  BtcTransaction tx = BtcTransaction(inputs: txin, outputs: txOut);
 
   // in a SegWit (Segregated Witness) transaction, the witness data serves as the unlocking script
   // for the transaction inputs. In traditional non-SegWit transactions,
@@ -373,16 +370,12 @@ BtcTransaction buildP2trTransaction({
           utxo.map((e) => e.ownerDetails.address.toScriptPubKey()).toList(),
       amounts: utxo.map((e) => e.utxo.value).toList(),
 
-      // The tapleaf script that we are spending (ext_flag=1)
-      script: null,
-      sighash: BitcoinOpCodeConst.TAPROOT_SIGHASH_ALL,
-      // default is 0; 1 is for script spending (BIP342)
-      extFlags: 0,
+      sighash: BitcoinOpCodeConst.sighashDefault,
     );
 
     // sign transaction using `signTapRoot` method of thransaction
     final signedTx =
-        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.SIGHASH_ALL);
+        sign(txDigit, utxo[i].public().toHex(), BitcoinOpCodeConst.sighashAll);
 
     // add witness for current index
     witnesses.add(TxWitnessInput(stack: [signedTx]));

example/lib/global/old_examples/spending_with_transaction_builder/multi_sig_transactions.dart

@@ -282,7 +282,7 @@ void main() async {
 
   // we check if transaction is segwit or not
   // When one of the input UTXO addresses is SegWit, the transaction is considered SegWit.
-  final isSegwitTr = transaction.hasSegwit;
+  final isSegwitTr = transaction.hasWitness;
 
   // transaction id
   final transactionId = transaction.txId();

example/lib/global/old_examples/spending_with_transaction_builder/transaction_builder_example.dart

@@ -229,7 +229,7 @@ void main() async {
 
   // we check if transaction is segwit or not
   // When one of the input UTXO addresses is SegWit, the transaction is considered SegWit.
-  final isSegwitTr = transaction.hasSegwit;
+  final isSegwitTr = transaction.hasWitness;
 
   // transaction id
   // ignore: unused_local_variable

example/lib/musig/methods.dart

@@ -0,0 +1,88 @@
+import 'package:bitcoin_base/bitcoin_base.dart';
+import 'package:example/services_examples/electrum/electrum_ssl_service.dart';
+
+Future<ElectrumProvider> getProvider(
+    {String url = "testnet4-electrumx.wakiyamap.dev:51002"}) async {
+  final service = await ElectrumSSLService.connect(
+      "testnet4-electrumx.wakiyamap.dev:51002");
+  return ElectrumProvider(service);
+}
+
+class PsbtUtxoRequest {
+  final BitcoinBaseAddress address;
+  final Script? p2shRedeemScript;
+  final Script? witnessScript;
+  final TapLeafMerkleProof? merkleProof;
+  final TaprootTree? treeScript;
+  final TaprootLeaf? leafScript;
+  final List<int>? xOnlyOrInternalPubKey;
+  final List<int>? merkleRoot;
+  final List<TapLeafMerkleProof>? leafScripts;
+  final List<ECPrivate> privateKeys;
+  final List<PsbtInputMuSig2ParticipantPublicKeys>? muSig2ParticipantPublicKeys;
+  final List<PsbtInputRipemd160>? ripemd160;
+  final List<PsbtInputSha256>? sha256;
+  final List<PsbtInputHash160>? hash160;
+  final List<PsbtInputHash256>? hash256;
+  const PsbtUtxoRequest(
+      {required this.address,
+      this.p2shRedeemScript,
+      this.witnessScript,
+      this.leafScript,
+      this.merkleProof,
+      this.treeScript,
+      this.xOnlyOrInternalPubKey,
+      this.merkleRoot,
+      this.leafScripts,
+      this.privateKeys = const [],
+      this.muSig2ParticipantPublicKeys,
+      this.ripemd160,
+      this.hash160,
+      this.hash256,
+      this.sha256});
+}
+
+Future<List<PsbtUtxo>> getPsbtUtxo(
+    {required List<PsbtUtxoRequest> addresses,
+    bool local = true,
+    List<Map<String, dynamic>>? data}) async {
+  final provider = await getProvider();
+
+  final utxos = await Future.wait(addresses.map((e) async {
+    return await provider.request(ElectrumRequestScriptHashListUnspent(
+        scriptHash: e.address.pubKeyHash()));
+  }));
+
+  final utxoss = List.generate(utxos.length, (i) async {
+    final request = addresses[i];
+    final accountUtxos = utxos[i];
+    final er = await Future.wait(accountUtxos
+        .map((e) => provider.request(ElectrumRequestGetRawTransaction(e.txId)))
+        .toList());
+    return List.generate(
+      accountUtxos.length,
+      (index) {
+        return PsbtUtxo(
+            utxo: accountUtxos[index].toUtxo(request.address.type),
+            p2shRedeemScript: request.p2shRedeemScript,
+            p2wshWitnessScript: request.witnessScript,
+            tx: er[index],
+            scriptPubKey: request.address.toScriptPubKey(),
+            leafScript: request.leafScript,
+            leafScripts: request.leafScripts,
+            merkleProof: request.merkleProof,
+            treeScript: request.treeScript,
+            merkleRoot: request.merkleRoot,
+            privateKeys: request.privateKeys,
+            xOnlyOrInternalPubKey: request.xOnlyOrInternalPubKey,
+            muSig2ParticipantPublicKeys: request.muSig2ParticipantPublicKeys,
+            hash160: request.hash160,
+            hash256: request.hash256,
+            ripemd160: request.ripemd160,
+            sha256: request.sha256);
+      },
+    );
+  });
+  final e = await Future.wait(utxoss);
+  return e.expand((e) => e).toList();
+}