opnet 1.8.1 → 1.8.3

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## [v1.8.2] - 2026-03-07
+
+- No changes
+
+
+## [v1.8.1] - 2026-03-07
+
+### Breaking Changes
+
+- breaking: upgraded deps, refactor buffer -> uint8array for consistency, upgraded eslint v10. ([#134](https://github.com/btc-vision/opnet/pull/134)) by @BlobMaster41
+
+### Features
+
+- Rename targetHash to checksumRoot in epoch interfaces ([#120](https://github.com/btc-vision/opnet/pull/120)) by @BlobMaster41
+- Upgrade/deps add http threader ([#121](https://github.com/btc-vision/opnet/pull/121)) by @BlobMaster41
+- Fix/react native ([#126](https://github.com/btc-vision/opnet/pull/126)) by @BlobMaster41
+- Add constant/payable validation to CallResult ([#131](https://github.com/btc-vision/opnet/pull/131)) by @BlobMaster41
+- breaking: upgraded deps, refactor buffer -> uint8array for consistency, upgraded eslint v10. ([#134](https://github.com/btc-vision/opnet/pull/134)) by @BlobMaster41
+- Normalize hex strings; strip 0x prefix safely ([#135](https://github.com/btc-vision/opnet/pull/135)) by @BlobMaster41
+- feat: add mempool API and WebSocket support ([#136](https://github.com/btc-vision/opnet/pull/136)) by @BlobMaster41
+- Rework/mempool ([#137](https://github.com/btc-vision/opnet/pull/137)) by @BlobMaster41
+
+### Bug Fixes
+
+- Upgrade/deps add http threader ([#121](https://github.com/btc-vision/opnet/pull/121)) by @BlobMaster41
+- Fix/react native ([#126](https://github.com/btc-vision/opnet/pull/126)) by @BlobMaster41
+- Normalize hex strings; strip 0x prefix safely ([#135](https://github.com/btc-vision/opnet/pull/135)) by @BlobMaster41
+
+### Documentation
+
+- Upgrade/deps add http threader ([#121](https://github.com/btc-vision/opnet/pull/121)) by @BlobMaster41
+- Add constant/payable validation to CallResult ([#131](https://github.com/btc-vision/opnet/pull/131)) by @BlobMaster41
+- docs: add ABI flags and update contract APIs ([#132](https://github.com/btc-vision/opnet/pull/132)) by @BlobMaster41
+- breaking: upgraded deps, refactor buffer -> uint8array for consistency, upgraded eslint v10. ([#134](https://github.com/btc-vision/opnet/pull/134)) by @BlobMaster41
+- feat: add mempool API and WebSocket support ([#136](https://github.com/btc-vision/opnet/pull/136)) by @BlobMaster41
+
+### Other Changes
+
+- Refactor ABI interfaces and events for OPNet and stablecoins ([#110](https://github.com/btc-vision/opnet/pull/110)) by @BlobMaster41
+- Update docs for mnemonic-based wallet usage and add tables of contents ([#114](https://github.com/btc-vision/opnet/pull/114)) by @BlobMaster41
+- Bump version to 1.8.0 ([#115](https://github.com/btc-vision/opnet/pull/115)) by @BlobMaster41
+- Add security policy, templates, and extended ABI support ([#118](https://github.com/btc-vision/opnet/pull/118)) by @BlobMaster41
+- update motochef factory and template motochef abi/interface ([#117](https://github.com/btc-vision/opnet/pull/117)) by @icedevera
+- Bump version to 1.8.1-alpha.0 ([#119](https://github.com/btc-vision/opnet/pull/119)) by @BlobMaster41
+- ⬆️(deps-dev): Bump vite-plugin-node-polyfills from 0.24.0 to 0.25.0 in the dev-deps group ([#116](https://github.com/btc-vision/opnet/pull/116)) by @dependabot[bot]
+- Bump btc-vision deps and relax signer type ([#124](https://github.com/btc-vision/opnet/pull/124)) by @BlobMaster41
+- Tuple/implmentation ([#127](https://github.com/btc-vision/opnet/pull/127)) by @BlobMaster41
+- Bump version and disable threaded parsing ([#128](https://github.com/btc-vision/opnet/pull/128)) by @BlobMaster41
+- Added constant to ABI ([#133](https://github.com/btc-vision/opnet/pull/133)) by @BlobMaster41
+- Bump version and relax getPublicKeyInfo return ([#141](https://github.com/btc-vision/opnet/pull/141)) by @BlobMaster41
+- ⬆️(deps): Bump bignumber.js from 9.3.1 to 10.0.2 ([#140](https://github.com/btc-vision/opnet/pull/140)) by @dependabot[bot]
+
+
+
+
 ## [v1.8.1-rc.17] - 2026-02-27
 
 - No changes

package/README.md

@@ -7,7 +7,8 @@
 
 [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
 
-The official client library for building Bitcoin-based applications on OPNet. Full TypeScript support with type-safe contract interactions.
+The official client library for building Bitcoin-based applications on OPNet.
+Full TypeScript support with type-safe contract interactions.
 
 ## Security Audit
 
@@ -26,7 +27,8 @@ The official client library for building Bitcoin-based applications on OPNet. Fu
   </a>
 </p>
 
-This library has been professionally audited by [Verichains](https://verichains.io).
+This library has been professionally audited
+by [Verichains](https://verichains.io).
 
 See [SECURITY.md](./SECURITY.md) for details.
 
@@ -41,18 +43,22 @@ npm install opnet @btc-vision/transaction @btc-vision/bitcoin
 Check out the full documentation in [`/docs`](./docs)!
 
 - [Getting Started](./docs/getting-started/quick-start.md)
-- [Providers](./docs/providers/json-rpc-provider.md) - JSON-RPC & WebSocket connections
-- [Smart Contracts](./docs/contracts/overview.md) - Contract interactions & transactions
+- [Providers](./docs/providers/json-rpc-provider.md) - JSON-RPC & WebSocket
+  connections
+- [Smart Contracts](./docs/contracts/overview.md) - Contract interactions &
+  transactions
 - [UTXO Management](./docs/bitcoin/utxos.md) - Bitcoin UTXO handling
 - [Offline Signing](./docs/contracts/offline-signing.md) - Cold wallet support
-- [ABI Reference](./docs/abi-reference/abi-overview.md) - OP20, OP721, MotoSwap ABIs
+- [ABI Reference](./docs/abi-reference/abi-overview.md) - OP20, OP721, MotoSwap
+  ABIs
 - [API Reference](./docs/api-reference/provider-api.md) - Full API documentation
 
 ## RPC Endpoints
 
-| Network | URL |
-|---------|-----|
+| Network | URL                         |
+|---------|-----------------------------|
 | Mainnet | `https://mainnet.opnet.org` |
+| Testnet | `https://testnet.opnet.org` |
 | Regtest | `https://regtest.opnet.org` |
 
 ## Quick Start
@@ -63,16 +69,17 @@ import { AddressTypes, Mnemonic, MLDSASecurityLevel } from '@btc-vision/transact
 import { networks } from '@btc-vision/bitcoin';
 
 // Connect to OPNet
-const provider = new JSONRpcProvider('https://regtest.opnet.org', networks.regtest);
+const provider = new JSONRpcProvider('https://testnet.opnet.org', networks.
+opnetTestnet);
 
 // Create wallet from mnemonic
 const mnemonic = new Mnemonic(
     'your twenty four word seed phrase goes here ...',
     '',
-    networks.regtest,
+    networks.opnetTestnet,
     MLDSASecurityLevel.LEVEL2,
 );
-const wallet = mnemonic.deriveUnisat(AddressTypes.P2TR, 0);
+const wallet = mnemonic.deriveOPWallet(AddressTypes.P2TR, 0);
 const myAddress = wallet.address;
 
 // Interact with a token contract
@@ -80,7 +87,7 @@ const token = getContract<IOP20Contract>(
     'op1...', // contract address
     OP_20_ABI,
     provider,
-    networks.regtest,
+    networks.opnetTestnet,
     myAddress
 );
 
@@ -105,7 +112,7 @@ const tx = await simulation.sendTransaction({
     refundTo: wallet.p2tr,
     maximumAllowedSatToSpend: 50000n,
     feeRate: 10,
-    network: networks.regtest,
+    network: networks.opnetTestnet,
 });
 
 console.log('TX ID:', tx.transactionId);
@@ -133,12 +140,15 @@ npm run build
 4. Run tests: `npm test`
 5. Submit a pull request
 
-See the [pull request template](./.github/PULL_REQUEST_TEMPLATE.md) for requirements.
+See the [pull request template](./.github/PULL_REQUEST_TEMPLATE.md) for
+requirements.
 
 ## Reporting Issues
 
-- **Bugs**: Use the [bug report template](https://github.com/btc-vision/opnet/issues/new?template=bug_report.yml)
-- **Security**: See [SECURITY.md](./SECURITY.md) - do not open public issues for vulnerabilities
+- **Bugs**: Use
+  the [bug report template](https://github.com/btc-vision/opnet/issues/new?template=bug_report.yml)
+- **Security**: See [SECURITY.md](./SECURITY.md) - do not open public issues for
+  vulnerabilities
 
 ## License
 

package/browser/_version.d.ts

@@ -1 +1 @@
-export declare const version = "1.8.1";
+export declare const version = "1.8.3";

package/browser/contracts/interfaces/IProviderForCallResult.d.ts

@@ -2,6 +2,7 @@ import { Network } from '../../../node_modules/@btc-vision/bitcoin/build/index.j
 import { Address, ChallengeSolution, IP2WSHAddress } from '../../../node_modules/@btc-vision/transaction/build/index.js';
 import { UTXO, UTXOs } from '../../bitcoin/UTXOs.js';
 import { BroadcastedTransaction } from '../../transactions/interfaces/BroadcastedTransaction.js';
+import { BroadcastedTransactionPackage } from '../../transactions/interfaces/BroadcastedTransactionPackage.js';
 import { RequestUTXOsParamsWithAmount } from '../../utxos/interfaces/IUTXOsManager.js';
 export interface IUTXOManagerForCallResult {
     getUTXOsForAmount(params: RequestUTXOsParamsWithAmount): Promise<UTXO[]>;
@@ -13,5 +14,6 @@ export interface IProviderForCallResult {
     readonly utxoManager: IUTXOManagerForCallResult;
     getChallenge(): Promise<ChallengeSolution>;
     sendRawTransaction(tx: string, psbt: boolean): Promise<BroadcastedTransaction>;
+    sendRawTransactionPackage(txs: string[], isPackage?: boolean): Promise<BroadcastedTransactionPackage>;
     getCSV1ForAddress(address: Address): IP2WSHAddress;
 }

package/browser/index.js

@@ -1,7 +1,7 @@
 import { d as decompile, f as fromHex, A as Address, b as fromBase64, N as NetEvent, B as BinaryWriter, c as BinaryReader, e as AddressTypes, h as AddressVerificator, t as toHex, C as ChallengeSolution, r as regtest, o as opnetTestnet, i as testnet, j as bitcoin, T as TransactionFactory, k as BufferHelper, l as AddressMap, m as toBase64, p as pLimit, n as process$1, L as Logger, q as Long, s as abiTypeToSelectorString, u as ABICoder, v as isAbiTuple, w as isAbiStruct, x as ABIDataTypes, y as BigNumber, z as fromBech32, P as P2MR_MS, D as P2TR_MS } from './vendors.js';
 import { p as protobuf } from './protobuf.js';
 
-const version = "1.8.1";
+const version = "1.8.3";
 
 var OPNetTransactionTypes = /* @__PURE__ */ ((OPNetTransactionTypes2) => {
   OPNetTransactionTypes2["Generic"] = "Generic";
@@ -953,6 +953,19 @@ class TransactionHelper {
 }
 
 const factory = new TransactionFactory();
+function extractPackageFailures(packageResult) {
+  const failures = [];
+  const results = packageResult.txResults;
+  for (const [submittedTxid, result] of Object.entries(results)) {
+    if (result.error) {
+      failures.push(`tx ${submittedTxid} failed: ${result.error}`);
+    }
+  }
+  if (failures.length === 0 && packageResult.packageMsg !== "success") {
+    failures.push(`package rejected: ${packageResult.packageMsg}`);
+  }
+  return failures;
+}
 class CallResult {
   result;
   accessList;
@@ -1052,6 +1065,13 @@ class CallResult {
           )
         );
       },
+      sendRawTransactionPackage: () => {
+        return Promise.reject(
+          new Error(
+            "Cannot broadcast from offline CallResult. Export signed transaction and broadcast online."
+          )
+        );
+      },
       getCSV1ForAddress: () => {
         if (!data.csvAddress) {
           throw new Error("CSV address not available in offline data");
@@ -1215,43 +1235,69 @@ class CallResult {
   }
   /**
    * Broadcasts a pre-signed interaction transaction.
+   * Uses sendRawTransactionPackage for atomic broadcast when a funding tx is present,
+   * falls back to sendRawTransaction for P2WDA (interaction-only) transactions.
    * @param {SignedInteractionTransactionReceipt} signedTx - The signed transaction data.
    * @returns {Promise<InteractionTransactionReceipt>} The transaction receipt with broadcast results.
    */
   async sendPresignedTransaction(signedTx) {
-    if (!signedTx.utxoTracking.isP2WDA) {
-      if (!signedTx.fundingTransactionRaw) {
-        throw new Error("Funding transaction not created");
-      }
-      const tx1 = await this.#provider.sendRawTransaction(
-        signedTx.fundingTransactionRaw,
+    if (signedTx.utxoTracking.isP2WDA || !signedTx.fundingTransactionRaw) {
+      const tx = await this.#provider.sendRawTransaction(
+        signedTx.interactionTransactionRaw,
         false
       );
-      if (!tx1 || tx1.error) {
-        throw new Error(`Error sending transaction: ${tx1?.error || "Unknown error"}`);
+      if (!tx || tx.error) {
+        throw new Error(`Error sending transaction: ${tx?.error || "Unknown error"}`);
+      }
+      if (!tx.result) {
+        throw new Error("No transaction ID returned");
       }
-      if (!tx1.success) {
-        throw new Error(`Error sending transaction: ${tx1.result || "Unknown error"}`);
+      if (!tx.success) {
+        throw new Error(`Error sending transaction: ${tx.result || "Unknown error"}`);
       }
+      this.#processUTXOTracking(signedTx);
+      return {
+        interactionAddress: signedTx.interactionAddress,
+        transactionId: tx.result,
+        peerAcknowledgements: tx.peers || 0,
+        newUTXOs: signedTx.nextUTXOs,
+        estimatedFees: signedTx.estimatedFees,
+        challengeSolution: signedTx.challengeSolution,
+        rawTransaction: signedTx.interactionTransactionRaw,
+        fundingUTXOs: signedTx.fundingUTXOs,
+        fundingInputUtxos: signedTx.fundingInputUtxos,
+        compiledTargetScript: signedTx.compiledTargetScript
+      };
     }
-    const tx2 = await this.#provider.sendRawTransaction(
-      signedTx.interactionTransactionRaw,
-      false
+    const result = await this.#provider.sendRawTransactionPackage(
+      [signedTx.fundingTransactionRaw, signedTx.interactionTransactionRaw],
+      true
     );
-    if (!tx2 || tx2.error) {
-      throw new Error(`Error sending transaction: ${tx2?.error || "Unknown error"}`);
+    if (!result.success) {
+      throw new Error(
+        `Error sending transaction package: ${result.error || "Unknown error"}`
+      );
     }
-    if (!tx2.result) {
-      throw new Error("No transaction ID returned");
+    if (result.packageResult) {
+      const failures = extractPackageFailures(result.packageResult);
+      if (failures.length > 0) {
+        throw new Error(`Transaction package failed:
+${failures.join("\n")}`);
+      }
     }
-    if (!tx2.success) {
-      throw new Error(`Error sending transaction: ${tx2.result || "Unknown error"}`);
+    const interactionSeqResult = result.sequentialResults?.[1];
+    if (interactionSeqResult && !interactionSeqResult.success) {
+      throw new Error(
+        `Interaction transaction failed: ${interactionSeqResult.error || "Unknown error"}`
+      );
     }
+    const interactionTxId = interactionSeqResult?.txid || signedTx.interactionTransactionRaw;
+    const peers = interactionSeqResult?.peers || 0;
     this.#processUTXOTracking(signedTx);
     return {
       interactionAddress: signedTx.interactionAddress,
-      transactionId: tx2.result,
-      peerAcknowledgements: tx2.peers || 0,
+      transactionId: interactionTxId,
+      peerAcknowledgements: peers,
       newUTXOs: signedTx.nextUTXOs,
       estimatedFees: signedTx.estimatedFees,
       challengeSolution: signedTx.challengeSolution,
@@ -1949,6 +1995,7 @@ var JSONRpcMethods = /* @__PURE__ */ ((JSONRpcMethods2) => {
   JSONRpcMethods2["GAS"] = "btc_gas";
   JSONRpcMethods2["GET_TRANSACTION_BY_HASH"] = "btc_getTransactionByHash";
   JSONRpcMethods2["BROADCAST_TRANSACTION"] = "btc_sendRawTransaction";
+  JSONRpcMethods2["BROADCAST_TRANSACTION_PACKAGE"] = "btc_sendRawTransactionPackage";
   JSONRpcMethods2["TRANSACTION_PREIMAGE"] = "btc_preimage";
   JSONRpcMethods2["PUBLIC_KEY_INFO"] = "btc_publicKeyInfo";
   JSONRpcMethods2["GET_UTXOS"] = "btc_getUTXOs";
@@ -1977,7 +2024,7 @@ class UTXOsManager {
     this.provider = provider;
   }
   /**
-   * Holds all address-specific data so we don’t mix up UTXOs between addresses/wallets.
+   * Holds all address-specific data so we don't mix up UTXOs between addresses/wallets.
    */
   dataByAddress = {};
   /**
@@ -2112,11 +2159,14 @@ class UTXOsManager {
    * Fetch UTXOs for a specific amount needed, from a single address,
    * merging from pending and confirmed UTXOs.
    *
+   * Prioritizes normal UTXOs first, only falling back to CSV UTXOs
+   * if the normal ones cannot cover the requested amount.
+   *
    * @param {object} options
    * @param {string} options.address The address to fetch UTXOs for
    * @param {bigint} options.amount The needed amount
    * @param {boolean} [options.optimize=true] Optimize the UTXOs
-   * @param {boolean} [options.csvAddress] Use CSV UTXOs in priority
+   * @param {boolean} [options.csvAddress] Use CSV UTXOs as fallback
    * @param {boolean} [options.mergePendingUTXOs=true] Merge pending
    * @param {boolean} [options.filterSpentUTXOs=true] Filter out spent
    * @param {boolean} [options.throwErrors=false] Throw error if insufficient
@@ -2135,52 +2185,47 @@ class UTXOsManager {
     maxUTXOs = 5e3,
     throwIfUTXOsLimitReached = false
   }) {
-    const utxosPromises = [];
-    if (csvAddress) {
-      utxosPromises.push(
-        this.getUTXOs({
-          address: csvAddress,
-          optimize: true,
-          mergePendingUTXOs: false,
-          filterSpentUTXOs: true,
-          olderThan: 1n,
-          isCSV: true
-        })
-      );
-    }
-    utxosPromises.push(
-      this.getUTXOs({
-        address,
-        optimize,
-        mergePendingUTXOs,
-        filterSpentUTXOs,
-        olderThan
-      })
-    );
-    const combinedUTXOs = (await Promise.all(utxosPromises)).flat();
-    const utxoUntilAmount = [];
+    const selected = [];
     let currentValue = 0n;
-    for (const utxo of combinedUTXOs) {
-      if (maxUTXOs && utxoUntilAmount.length >= maxUTXOs) {
-        if (throwIfUTXOsLimitReached) {
-          throw new Error(
-            `Woah. You must consolidate your UTXOs (${combinedUTXOs.length})! This transaction is too large.`
-          );
-        }
-        break;
-      }
-      utxoUntilAmount.push(utxo);
-      currentValue += utxo.value;
-      if (currentValue >= amount) {
-        break;
-      }
+    const normalUTXOs = await this.getUTXOs({
+      address,
+      optimize,
+      mergePendingUTXOs,
+      filterSpentUTXOs,
+      olderThan
+    });
+    currentValue = this.selectUTXOsGreedily(
+      normalUTXOs,
+      selected,
+      currentValue,
+      amount,
+      maxUTXOs,
+      throwIfUTXOsLimitReached
+    );
+    if (currentValue < amount && csvAddress) {
+      const csvUTXOs = await this.getUTXOs({
+        address: csvAddress,
+        optimize: true,
+        mergePendingUTXOs: false,
+        filterSpentUTXOs: true,
+        olderThan: 1n,
+        isCSV: true
+      });
+      currentValue = this.selectUTXOsGreedily(
+        csvUTXOs,
+        selected,
+        currentValue,
+        amount,
+        maxUTXOs,
+        throwIfUTXOsLimitReached
+      );
     }
     if (currentValue < amount && throwErrors) {
       throw new Error(
         `Insufficient UTXOs to cover amount. Available: ${currentValue}, Needed: ${amount}`
       );
     }
-    return utxoUntilAmount;
+    return selected;
   }
   /**
    * Fetch UTXOs for multiple addresses in a single batch request.
@@ -2254,6 +2299,33 @@ class UTXOsManager {
     }
     return result;
   }
+  /**
+   * Sort UTXOs by value descending and greedily append to `selected` until
+   * `currentValue >= amount` or the pool is exhausted. Mutates `candidates`
+   * (sort in-place) and `selected` (pushes chosen UTXOs). Returns the
+   * updated cumulative value.
+   */
+  selectUTXOsGreedily(candidates, selected, currentValue, amount, maxUTXOs, throwIfLimitReached) {
+    candidates.sort((a, b) => {
+      if (b.value > a.value) return 1;
+      if (b.value < a.value) return -1;
+      return 0;
+    });
+    for (const utxo of candidates) {
+      if (currentValue >= amount) break;
+      if (maxUTXOs && selected.length >= maxUTXOs) {
+        if (throwIfLimitReached) {
+          throw new Error(
+            `Woah. You must consolidate your UTXOs (${candidates.length + selected.length})! This transaction is too large.`
+          );
+        }
+        break;
+      }
+      selected.push(utxo);
+      currentValue += utxo.value;
+    }
+    return currentValue;
+  }
   /**
    * Fetch UTXOs for multiple addresses in a single batch RPC call.
    * @private
@@ -2914,6 +2986,32 @@ class AbstractRpcProvider {
       return rawTx.result;
     });
   }
+  /**
+   * Broadcast a package of raw transactions atomically.
+   * @description Submits an ordered array of raw transactions via Bitcoin Core's submitpackage
+   * RPC for atomic acceptance, or falls back to validated sequential broadcast.
+   * @param {string[]} txs The raw transactions to send as hex strings (max 25)
+   * @param {boolean} [isPackage=true] Whether to use atomic package submission (submitpackage)
+   *        or validated sequential broadcast (testmempoolaccept + sendrawtransaction)
+   * @returns {Promise<BroadcastedTransactionPackage>} The result of the package broadcast
+   * @throws {Error} If something went wrong while broadcasting the package
+   */
+  async sendRawTransactionPackage(txs, isPackage = true) {
+    if (!txs.length) {
+      throw new Error("sendRawTransactionPackage: txs array must not be empty");
+    }
+    for (let i = 0; i < txs.length; i++) {
+      if (!/^[0-9A-Fa-f]+$/.test(txs[i])) {
+        throw new Error(`sendRawTransactionPackage: txs[${i}] is not a valid hex string`);
+      }
+    }
+    const payload = this.buildJsonRpcPayload(
+      JSONRpcMethods.BROADCAST_TRANSACTION_PACKAGE,
+      [txs, isPackage]
+    );
+    const result = await this.callPayloadSingle(payload);
+    return result.result;
+  }
   /**
    * Get block witnesses.
    * @description This method is used to get the witnesses of a block. This proves that the actions executed inside a block are valid and confirmed by the network. If the minimum number of witnesses are not met, the block is considered as potentially invalid.
@@ -3965,6 +4063,7 @@ var WebSocketRequestOpcode = /* @__PURE__ */ ((WebSocketRequestOpcode2) => {
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["GET_TRANSACTION_BY_HASH"] = 32] = "GET_TRANSACTION_BY_HASH";
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["GET_TRANSACTION_RECEIPT"] = 33] = "GET_TRANSACTION_RECEIPT";
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["BROADCAST_TRANSACTION"] = 34] = "BROADCAST_TRANSACTION";
+  WebSocketRequestOpcode2[WebSocketRequestOpcode2["BROADCAST_TRANSACTION_PACKAGE"] = 39] = "BROADCAST_TRANSACTION_PACKAGE";
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["GET_PREIMAGE"] = 35] = "GET_PREIMAGE";
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["GET_MEMPOOL_INFO"] = 36] = "GET_MEMPOOL_INFO";
   WebSocketRequestOpcode2[WebSocketRequestOpcode2["GET_PENDING_TRANSACTION"] = 37] = "GET_PENDING_TRANSACTION";
@@ -3999,6 +4098,7 @@ var WebSocketResponseOpcode = /* @__PURE__ */ ((WebSocketResponseOpcode2) => {
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["TRANSACTION"] = 160] = "TRANSACTION";
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["TRANSACTION_RECEIPT"] = 161] = "TRANSACTION_RECEIPT";
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["BROADCAST_RESULT"] = 162] = "BROADCAST_RESULT";
+  WebSocketResponseOpcode2[WebSocketResponseOpcode2["BROADCAST_PACKAGE_RESULT"] = 167] = "BROADCAST_PACKAGE_RESULT";
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["PREIMAGE"] = 163] = "PREIMAGE";
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["MEMPOOL_INFO"] = 164] = "MEMPOOL_INFO";
   WebSocketResponseOpcode2[WebSocketResponseOpcode2["PENDING_TRANSACTION"] = 165] = "PENDING_TRANSACTION";
@@ -4077,6 +4177,12 @@ const METHOD_MAPPINGS = {
     requestType: "BroadcastTransactionRequest",
     responseType: "BroadcastTransactionResponse"
   },
+  [JSONRpcMethods.BROADCAST_TRANSACTION_PACKAGE]: {
+    requestOpcode: WebSocketRequestOpcode.BROADCAST_TRANSACTION_PACKAGE,
+    responseOpcode: WebSocketResponseOpcode.BROADCAST_PACKAGE_RESULT,
+    requestType: "BroadcastTransactionPackageRequest",
+    responseType: "BroadcastTransactionPackageResponse"
+  },
   [JSONRpcMethods.TRANSACTION_PREIMAGE]: {
     requestOpcode: WebSocketRequestOpcode.GET_PREIMAGE,
     responseOpcode: WebSocketResponseOpcode.PREIMAGE,
@@ -4724,6 +4830,11 @@ class WebSocketRpcProvider extends AbstractRpcProvider {
           2: params[0],
           3: params[1] ?? false
         };
+      case JSONRpcMethods.BROADCAST_TRANSACTION_PACKAGE:
+        return {
+          2: params[0],
+          3: params[1] ?? true
+        };
       case JSONRpcMethods.TRANSACTION_PREIMAGE:
         return {};
       case JSONRpcMethods.GET_BALANCE:

package/browser/opnet.d.ts

@@ -70,6 +70,7 @@ export * from './storage/interfaces/IStorageValue.js';
 export * from './storage/StoredValue.js';
 export * from './contracts/interfaces/IRawContract.js';
 export * from './transactions/interfaces/BroadcastedTransaction.js';
+export * from './transactions/interfaces/BroadcastedTransactionPackage.js';
 export * from './transactions/interfaces/ITransaction.js';
 export * from './transactions/interfaces/ITransactionReceipt.js';
 export * from './transactions/metadata/TransactionReceipt.js';

package/browser/providers/AbstractRpcProvider.d.ts

@@ -18,6 +18,7 @@ import { OPNetTransactionTypes } from '../interfaces/opnet/OPNetTransactionTypes
 import { MempoolTransactionData } from '../mempool/MempoolTransactionData.js';
 import { StoredValue } from '../storage/StoredValue.js';
 import { BroadcastedTransaction } from '../transactions/interfaces/BroadcastedTransaction.js';
+import { BroadcastedTransactionPackage } from '../transactions/interfaces/BroadcastedTransactionPackage.js';
 import { TransactionReceipt } from '../transactions/metadata/TransactionReceipt.js';
 import { TransactionBase } from '../transactions/Transaction.js';
 import { UTXOsManager } from '../utxos/UTXOsManager.js';
@@ -59,6 +60,7 @@ export declare abstract class AbstractRpcProvider {
     gasParameters(): Promise<BlockGasParameters>;
     sendRawTransaction(tx: string, psbt: boolean): Promise<BroadcastedTransaction>;
     sendRawTransactions(txs: string[]): Promise<BroadcastedTransaction[]>;
+    sendRawTransactionPackage(txs: string[], isPackage?: boolean): Promise<BroadcastedTransactionPackage>;
     getBlockWitness(height?: BigNumberish, trusted?: boolean, limit?: number, page?: number): Promise<BlockWitnesses>;
     getReorg(fromBlock?: BigNumberish, toBlock?: BigNumberish): Promise<ReorgInformation[]>;
     abstract _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<JsonRpcCallResult>;

package/browser/providers/interfaces/JSONRpcMethods.d.ts

@@ -8,6 +8,7 @@ export declare enum JSONRpcMethods {
     GAS = "btc_gas",
     GET_TRANSACTION_BY_HASH = "btc_getTransactionByHash",
     BROADCAST_TRANSACTION = "btc_sendRawTransaction",
+    BROADCAST_TRANSACTION_PACKAGE = "btc_sendRawTransactionPackage",
     TRANSACTION_PREIMAGE = "btc_preimage",
     PUBLIC_KEY_INFO = "btc_publicKeyInfo",
     GET_UTXOS = "btc_getUTXOs",

package/browser/providers/websocket/types/WebSocketOpcodes.d.ts

@@ -10,6 +10,7 @@ export declare enum WebSocketRequestOpcode {
     GET_TRANSACTION_BY_HASH = 32,
     GET_TRANSACTION_RECEIPT = 33,
     BROADCAST_TRANSACTION = 34,
+    BROADCAST_TRANSACTION_PACKAGE = 39,
     GET_PREIMAGE = 35,
     GET_MEMPOOL_INFO = 36,
     GET_PENDING_TRANSACTION = 37,
@@ -43,6 +44,7 @@ export declare enum WebSocketResponseOpcode {
     TRANSACTION = 160,
     TRANSACTION_RECEIPT = 161,
     BROADCAST_RESULT = 162,
+    BROADCAST_PACKAGE_RESULT = 167,
     PREIMAGE = 163,
     MEMPOOL_INFO = 164,
     PENDING_TRANSACTION = 165,

package/browser/transactions/interfaces/BroadcastedTransactionPackage.d.ts

@@ -0,0 +1,48 @@
+export interface SequentialBroadcastTxResult {
+    readonly txid: string;
+    readonly success: boolean;
+    readonly error?: string;
+    readonly peers?: number;
+}
+export interface BroadcastedTransactionPackage {
+    readonly success: boolean;
+    readonly error?: string;
+    readonly testResults?: readonly TestMempoolAcceptResult[];
+    readonly packageResult?: PackageResult;
+    readonly sequentialResults?: readonly SequentialBroadcastTxResult[];
+    readonly fellBackToSequential?: boolean;
+}
+export interface TestMempoolAcceptResult {
+    readonly txid: string;
+    readonly wtxid: string;
+    readonly allowed?: boolean;
+    readonly vsize?: number;
+    readonly packageError?: string;
+    readonly rejectReason?: string;
+    readonly rejectDetails?: string;
+    readonly fees?: TestMempoolAcceptFees;
+}
+export interface TestMempoolAcceptFees {
+    readonly base: number;
+    readonly effectiveFeerate: number;
+    readonly effectiveIncludes: readonly string[];
+}
+export interface PackageTxResult {
+    readonly txid: string;
+    readonly otherWtxid?: string;
+    readonly vsize?: number;
+    readonly fees?: PackageTxFees;
+    readonly error?: string;
+}
+export interface PackageTxFees {
+    readonly base: number;
+    readonly effectiveFeerate?: number;
+    readonly effectiveIncludes?: readonly string[];
+}
+export interface PackageResult {
+    readonly packageMsg: string;
+    readonly txResults: {
+        readonly [wtxid: string]: PackageTxResult;
+    };
+    readonly replacedTransactions?: readonly string[];
+}

package/browser/utxos/UTXOsManager.d.ts

@@ -11,6 +11,7 @@ export declare class UTXOsManager {
     getUTXOs({ address, isCSV, optimize, mergePendingUTXOs, filterSpentUTXOs, olderThan, }: RequestUTXOsParams): Promise<UTXOs>;
     getUTXOsForAmount({ address, amount, csvAddress, optimize, mergePendingUTXOs, filterSpentUTXOs, throwErrors, olderThan, maxUTXOs, throwIfUTXOsLimitReached, }: RequestUTXOsParamsWithAmount): Promise<UTXOs>;
     getMultipleUTXOs({ requests, mergePendingUTXOs, filterSpentUTXOs, }: RequestMultipleUTXOsParams): Promise<Record<string, UTXOs>>;
+    private selectUTXOsGreedily;
     private fetchMultipleUTXOs;
     private getAddressData;
     private maybeFetchUTXOs;

package/build/_version.d.ts

@@ -1 +1 @@
-export declare const version = "1.8.1";
+export declare const version = "1.8.3";

package/build/_version.js

@@ -1 +1 @@
-export const version = '1.8.1';
+export const version = '1.8.3';