Update MockNetworkProvider and its docs

Author: rkalis

packages/cashscript/src/network/MockNetworkProvider.ts

@@ -6,16 +6,16 @@ import { addressToLockScript, libauthTokenDetailsToCashScriptTokenDetails } from
 import { DEFAULT_VM_TARGET } from '../libauth-template/utils.js';
 
 export interface MockNetworkProviderOptions {
-  updateUtxoSet: boolean;
+  updateUtxoSet?: boolean;
   vmTarget?: VmTarget;
 }
 
 export default class MockNetworkProvider implements NetworkProvider {
   // we use lockingBytecode hex as the key for utxoMap to make cash addresses and token addresses interchangeable
   private utxoSet: Array<[string, Utxo]> = [];
   private transactionMap: Record<string, string> = {};
+  private blockHeight: number = 133700;
   public network: Network = Network.MOCKNET;
-  public blockHeight: number = 133700;
   public options: MockNetworkProviderOptions;
   public vmTarget: VmTarget;
 

website/docs/releases/release-notes.md

@@ -23,6 +23,7 @@ This release contains several breaking changes, please refer to the [migration n
 - :sparkles: Add support for `p2s` contract type.
 - :sparkles: Add `lockingBytecode` property to `Contract` class.
 - :sparkles: Add `getUtxosForLockingBytecode()` method to `ElectrumNetworkProvider` class and `MockNetworkProvider` interface.
+- :sparkles: In the `MockNetworkProvider`, `addUtxo()` now also allows UTXOs to be added by locking bytecode.
 - :hammer_and_wrench: **BREAKING**: Rename `addressType` option on `Contract` constructor to `contractType`.
 - :hammer_and_wrench: **BREAKING**: Remove undocumented `redeemScript` property from `Contract` class.
 - :hammer_and_wrench: Update default VM target to `BCH_2026_05`.

website/docs/sdk/other-network-providers.md

@@ -19,6 +19,22 @@ interface MockNetworkProviderOptions {
   updateUtxoSet?: boolean;
   vmTarget?: VmTarget;
 }
+
+interface MockNetworkProvider extends NetworkProvider {
+  options: MockNetworkProviderOptions;
+  vmTarget: VmTarget;
+
+  constructor(options?: Partial<MockNetworkProviderOptions>) {}
+
+  // Hardcode the block height
+  setBlockHeight(newBlockHeight: number): void;
+
+  // Add a UTXO to the UTXO set of the mock network
+  addUtxo(addressOrLockingBytecode: string, utxo: Utxo): void;
+
+  // Reset the UTXO set and transaction list of the mock network
+  reset(): void;
+}
 ```
 
 The `updateUtxoSet` option is used to determine whether the UTXO set should be updated after a transaction is sent. If `updateUtxoSet` is `true` (default), the UTXO set will be updated to reflect the new state of the mock network. If `updateUtxoSet` is `false`, the UTXO set will not be updated.