Update migration notes for v0.12

Author: rkalis

website/docs/releases/migration-notes.md

@@ -2,6 +2,53 @@
 title: Migration Notes
 ---
 
+## v0.11 to v0.12
+
+There are several breaking changes to the SDK in this release.
+
+### CashScript SDK
+
+#### Old Transaction Builder Removal
+
+The most impactful breaking change is the removal of the deprecated 'Simple Transaction Builder'. See [below for steps to migrate to the new transaction builder](/docs/releases/migration-notes#sdk-transaction-builder).
+
+#### Contract constructor
+Before, the `provider` option was optional in the `Contract` constructor. This is no longer the case.
+
+```ts
+// Before: defaults to mainnet ElectrumNetworkProvider
+const contract = new Contract(artifact, constructorArgs);
+
+// After: explicitly specify the provider
+const provider = new ElectrumNetworkProvider('mainnet');
+const contract = new Contract(artifact, constructorArgs, { provider });
+```
+
+#### Transaction Builder Max Fee
+Before, the `setMaxFee()` method was used to set the maximum fee for the transaction. This was replaced with the `maximumFeeSatoshis` option in the constructor. Additionally, the `maximumFeeSatsPerByte` option was added.
+
+```ts
+// Before: setMaxFee() was used to set the maximum fee
+const builder = new TransactionBuilder({ provider }).setMaxFee(1000n);
+
+// After: maximumFeeSatoshis option was added to the constructor
+const builder = new TransactionBuilder({ provider, maximumFeeSatoshis: 1000n });
+```
+
+#### MockNetworkProvider
+
+Before, the `updateUtxoSet` option was `false` by default for the `MockNetworkProvider`. This is now `true` by default to better match real-world network behaviour.
+
+```ts
+// Before: updateUtxoSet is false by default
+const provider = new MockNetworkProvider();
+
+// After: updateUtxoSet is true by default, if you want to keep the old behaviour, set it to false
+const provider = new MockNetworkProvider({ updateUtxoSet: false });
+```
+
+Earlier, the `MockNetworkProvider` also automatically added some test UTXOs to the provider, which is no longer the case. Make sure to add any UTXOs you need manually.
+
 ## v0.10 to v0.11
 
 There are several breaking changes to the compiler and SDK in this release. They are listed below in their own sections.

website/docs/releases/release-notes.md

@@ -4,16 +4,16 @@ title: Release Notes
 
 ## v0.12.0
 
-#### CashScript SDK
-- :boom: **BREAKING**: Set `updateUtxoSet` to `true` by default for `MockNetworkProvider`.
-- :boom: **BREAKING**: Make `provider` a required option in `Contract` constructor.
-- :boom: **BREAKING**: Remove deprecated "old" transaction builder (`contract.functions`).
-- :boom: **BREAKING**: No longer seed the MockNetworkProvider with any test UTXOs.
-- :boom: **BREAKING**: Replace `setMaxFee()` method on `TransactionBuilder` with `TransactionBuilderOptions` on the constructor.
+#### CashScript SDK`TransactionBuilderOptions` on the constructor.
 - :sparkles: Add `maximumFeeSatsPerByte` and `allowImplicitFungibleTokenBurn` options to `TransactionBuilder` constructor.
 - :sparkles: Add a configurable `vmTarget` option to `MockNetworkProvider`.
 - :sparkles: Add support for ECDSA signatures in contract unlockers for `sig` and `datasig` parameters.
 - :sparkles: Add `signMessageHash()` method to `SignatureTemplate` to allow for signing of non-transaction messages.
+- :boom: **BREAKING**: Remove deprecated "old" transaction builder (`contract.functions`).
+- :boom: **BREAKING**: Make `provider` a required option in `Contract` constructor.
+- :boom: **BREAKING**: Set `updateUtxoSet` to `true` by default for `MockNetworkProvider`.
+- :boom: **BREAKING**: No longer seed the MockNetworkProvider with any test UTXOs.
+- :boom: **BREAKING**: Replace `setMaxFee()` method on `TransactionBuilder` with
 - :hammer_and_wrench: Improve libauth template generation.
 - :bug: Fix bug where `SignatureTemplate` would not accept private key hex strings as a signer.